get_voice_connector_origination

get_voice_connector_origination(**kwargs)

Retrieves origination setting details for the specified Amazon Chime Voice Connector.

See also: AWS API Documentation

Request Syntax

response = client.get_voice_connector_origination(
    VoiceConnectorId='string'
)
Parameters
VoiceConnectorId (string) --

[REQUIRED]

The Amazon Chime Voice Connector ID.

Return type
dict
Returns
Response Syntax
{
    'Origination': {
        'Routes': [
            {
                'Host': 'string',
                'Port': 123,
                'Protocol': 'TCP'|'UDP',
                'Priority': 123,
                'Weight': 123
            },
        ],
        'Disabled': True|False
    }
}

Response Structure

  • (dict) --
    • Origination (dict) --

      The origination setting details.

      • Routes (list) --

        The call distribution properties defined for your SIP hosts. Valid range: Minimum value of 1. Maximum value of 20. This parameter is not required, but you must specify this parameter or Disabled .

        • (dict) --

          Origination routes define call distribution properties for your SIP hosts to receive inbound calls using your Amazon Chime Voice Connector. Limit: Ten origination routes for each Amazon Chime Voice Connector.

          Note

          The parameters listed below are not required, but you must use at least one.

          • Host (string) --

            The FQDN or IP address to contact for origination traffic.

          • Port (integer) --

            The designated origination route port. Defaults to 5060.

          • Protocol (string) --

            The protocol to use for the origination route. Encryption-enabled Amazon Chime Voice Connectors use TCP protocol by default.

          • Priority (integer) --

            The priority associated with the host, with 1 being the highest priority. Higher priority hosts are attempted first.

          • Weight (integer) --

            The weight associated with the host. If hosts are equal in priority, calls are redistributed among them based on their relative weight.

      • Disabled (boolean) --

        When origination settings are disabled, inbound calls are not enabled for your Amazon Chime Voice Connector. This parameter is not required, but you must specify this parameter or Routes .

Exceptions

  • Chime.Client.exceptions.UnauthorizedClientException
  • Chime.Client.exceptions.NotFoundException
  • Chime.Client.exceptions.ForbiddenException
  • Chime.Client.exceptions.BadRequestException
  • Chime.Client.exceptions.ThrottledClientException
  • Chime.Client.exceptions.ServiceUnavailableException
  • Chime.Client.exceptions.ServiceFailureException