Skip to content

create_voice_connector_group async

create_voice_connector_group(
    name: VoiceConnectorGroupName,
    *,
    config_overrides: Optional[AsyncChimeSDKVoiceClientConfig] = None,
    voice_connector_items: Optional[VoiceConnectorItemList] = None,
    call_distribution_type: Optional[CallDistributionType] = None,
) -> CreateVoiceConnectorGroupResponse

Creates an Amazon Chime SDK Voice Connector group under the administrator's AWS account. You can associate Amazon Chime SDK Voice Connectors with the Voice Connector group by including VoiceConnectorItems in the request.

You can include Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.

Parameters:

Raises:

Source code in docs_src/capo_chime_sdk_voice/_services/async_chime_sdk_voice.py
async def create_voice_connector_group(
    self,
    name: "capo_chime_sdk_voice.types.voice_connector_group_name.VoiceConnectorGroupName",
    *,
    config_overrides: Optional[AsyncChimeSDKVoiceClientConfig] = None,
    voice_connector_items: Optional[
        "capo_chime_sdk_voice.types.voice_connector_item_list.VoiceConnectorItemList"
    ] = None,
    call_distribution_type: Optional[
        "capo_chime_sdk_voice.types.call_distribution_type.CallDistributionType"
    ] = None,
) -> "capo_chime_sdk_voice.types.create_voice_connector_group_response.CreateVoiceConnectorGroupResponse":
    """<p>Creates an Amazon Chime SDK Voice Connector group under the administrator's AWS account. You can associate Amazon Chime SDK Voice Connectors with the Voice Connector group by including <code>VoiceConnectorItems</code> in the request. </p> <p>You can include Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.</p>

    Args:
        name: <p>The name of the Voice Connector group.</p>
        voice_connector_items: <p>Lists the Voice Connectors that inbound calls are routed to.</p>

    Raises:
        capo_chime_sdk_voice.errors.access_denied_exception.AccessDeniedException: <p>You don't have the permissions needed to run this action.</p>
        capo_chime_sdk_voice.errors.bad_request_exception.BadRequestException: <p>The input parameters don't match the service's restrictions.</p>
        capo_chime_sdk_voice.errors.forbidden_exception.ForbiddenException: <p>The client is permanently forbidden from making the request.</p>
        capo_chime_sdk_voice.errors.not_found_exception.NotFoundException: <p>The requested resource couldn't be found.</p>
        capo_chime_sdk_voice.errors.resource_limit_exceeded_exception.ResourceLimitExceededException: <p>The request exceeds the resource limit.</p>
        capo_chime_sdk_voice.errors.service_failure_exception.ServiceFailureException: <p>The service encountered an unexpected error.</p>
        capo_chime_sdk_voice.errors.service_unavailable_exception.ServiceUnavailableException: <p>The service is currently unavailable.</p>
        capo_chime_sdk_voice.errors.throttled_client_exception.ThrottledClientException: <p>The number of customer requests exceeds the request rate limit.</p>
        capo_chime_sdk_voice.errors.unauthorized_client_exception.UnauthorizedClientException: <p>The client isn't authorized to request a resource.</p>
        capo_chime_sdk_voice.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_chime_sdk_voice.types.create_voice_connector_group_request.CreateVoiceConnectorGroupRequest]",
    ) -> AsyncOperationResponse[
        "capo_chime_sdk_voice.types.create_voice_connector_group_response.CreateVoiceConnectorGroupResponse"
    ]:
        import capo_chime_sdk_voice._operations.chime_sdk_telephony_service.create_voice_connector_group

        (
            output,
            http_response,
        ) = await capo_chime_sdk_voice._operations.chime_sdk_telephony_service.create_voice_connector_group.async_create_voice_connector_group(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateVoiceConnectorGroup")
    )
    input_: capo_chime_sdk_voice.types.create_voice_connector_group_request.CreateVoiceConnectorGroupRequest = {
        "name": name
    }
    if voice_connector_items is not None:
        input_["voice_connector_items"] = voice_connector_items
    if call_distribution_type is not None:
        input_["call_distribution_type"] = call_distribution_type

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output