ChimeSDKVoice / Client / create_sip_rule

create_sip_rule#

ChimeSDKVoice.Client.create_sip_rule(**kwargs)#

Creates a SIP rule, which can be used to run a SIP media application as a target for a specific trigger type. For more information about SIP rules, see Managing SIP media applications and rules in the Amazon Chime SDK Administrator Guide.

Request Syntax

response = client.create_sip_rule(
    Name='string',
    TriggerType='ToPhoneNumber'|'RequestUriHostname',
    TriggerValue='string',
    Disabled=True|False,
    TargetApplications=[
        {
            'SipMediaApplicationId': 'string',
            'Priority': 123,
            'AwsRegion': 'string'
        },
    ]
)

Parameters:

Name (string) –
[REQUIRED]

The name of the SIP rule.
TriggerType (string) –
[REQUIRED]

The type of trigger assigned to the SIP rule in TriggerValue, currently RequestUriHostname or ToPhoneNumber.
TriggerValue (string) –
[REQUIRED]

If TriggerType is RequestUriHostname, the value can be the outbound host name of a Voice Connector. If TriggerType is ToPhoneNumber, the value can be a customer-owned phone number in the E164 format. The SipMediaApplication specified in the SipRule is triggered if the request URI in an incoming SIP request matches the RequestUriHostname, or if the To header in the incoming SIP request matches the ToPhoneNumber value.
Disabled (boolean) – Disables or enables a SIP rule. You must disable SIP rules before you can delete them.
TargetApplications (list) –
List of SIP media applications, with priority and AWS Region. Only one SIP application per AWS Region can be used.
- (dict) –
  
  A target SIP media application and other details, such as priority and AWS Region, to be specified in the SIP rule. Only one SIP rule per AWS Region can be provided.
  - SipMediaApplicationId (string) –
    
    The ID of a rule’s target SIP media application.
  - Priority (integer) –
    
    The priority setting of a rule’s target SIP media application.
  - AwsRegion (string) –
    
    The AWS Region of a rule’s target SIP media application.

Return type:

dict

Returns:

Response Syntax

{
    'SipRule': {
        'SipRuleId': 'string',
        'Name': 'string',
        'Disabled': True|False,
        'TriggerType': 'ToPhoneNumber'|'RequestUriHostname',
        'TriggerValue': 'string',
        'TargetApplications': [
            {
                'SipMediaApplicationId': 'string',
                'Priority': 123,
                'AwsRegion': 'string'
            },
        ],
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) –
- SipRule (dict) –
  
  The SIP rule information, including the rule ID, triggers, and target applications.
  - SipRuleId (string) –
    
    A SIP rule’s ID.
  - Name (string) –
    
    A SIP rule’s name.
  - Disabled (boolean) –
    
    Indicates whether the SIP rule is enabled or disabled. You must disable a rule before you can delete it.
  - TriggerType (string) –
    
    The type of trigger set for a SIP rule, either a phone number or a URI request host name.
  - TriggerValue (string) –
    
    The value set for a SIP rule’s trigger type. Either a phone number or a URI hostname.
  - TargetApplications (list) –
    
    The target SIP media application and other details, such as priority and AWS Region, to be specified in the SIP rule. Only one SIP rule per AWS Region can be provided.
    - (dict) –
      
      A target SIP media application and other details, such as priority and AWS Region, to be specified in the SIP rule. Only one SIP rule per AWS Region can be provided.
      - SipMediaApplicationId (string) –
        
        The ID of a rule’s target SIP media application.
      - Priority (integer) –
        
        The priority setting of a rule’s target SIP media application.
      - AwsRegion (string) –
        
        The AWS Region of a rule’s target SIP media application.
  - CreatedTimestamp (datetime) –
    
    The time at which the SIP rule was created, in ISO 8601 format.
  - UpdatedTimestamp (datetime) –
    
    The time at which the SIP rule was updated, in ISO 8601 format.

Exceptions

ChimeSDKVoice.Client.exceptions.BadRequestException
ChimeSDKVoice.Client.exceptions.ForbiddenException
ChimeSDKVoice.Client.exceptions.AccessDeniedException
ChimeSDKVoice.Client.exceptions.UnauthorizedClientException
ChimeSDKVoice.Client.exceptions.ThrottledClientException
ChimeSDKVoice.Client.exceptions.ResourceLimitExceededException
ChimeSDKVoice.Client.exceptions.ConflictException
ChimeSDKVoice.Client.exceptions.ServiceUnavailableException
ChimeSDKVoice.Client.exceptions.ServiceFailureException