Chime / Client / create_meeting

create_meeting#

Chime.Client.create_meeting(**kwargs)#

Creates a new Amazon Chime SDK meeting in the specified media Region with no initial attendees. For more information about specifying media Regions, see Amazon Chime SDK Media Regions in the Amazon Chime SDK Developer Guide . For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.

Warning

This API is is no longer supported and will not be updated. We recommend using the latest version, CreateMeeting, in the Amazon Chime SDK.

Using the latest version requires migrating to a dedicated namespace. For more information, refer to Migrating from the Amazon Chime namespace in the Amazon Chime SDK Developer Guide.

Danger

This operation is deprecated and may not function as expected. This operation should not be used going forward and is only kept for the purpose of backwards compatiblity.

See also: AWS API Documentation

Request Syntax

response = client.create_meeting(
    ClientRequestToken='string',
    ExternalMeetingId='string',
    MeetingHostId='string',
    MediaRegion='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    NotificationsConfiguration={
        'SnsTopicArn': 'string',
        'SqsQueueArn': 'string'
    }
)
Parameters:
  • ClientRequestToken (string) –

    [REQUIRED]

    The unique identifier for the client request. Use a different token for different meetings.

    This field is autopopulated if not provided.

  • ExternalMeetingId (string) – The external meeting ID.

  • MeetingHostId (string) – Reserved.

  • MediaRegion (string) –

    The Region in which to create the meeting. Default: us-east-1.

    Available values: af-south-1 , ap-northeast-1 , ap-northeast-2 , ap-south-1 , ap-southeast-1 , ap-southeast-2 , ca-central-1 , eu-central-1 , eu-north-1 , eu-south-1 , eu-west-1 , eu-west-2 , eu-west-3 , sa-east-1 , us-east-1 , us-east-2 , us-west-1 , us-west-2 .

  • Tags (list) –

    The tag key-value pairs.

    • (dict) –

      Describes a tag applied to a resource.

      • Key (string) – [REQUIRED]

        The key of the tag.

      • Value (string) – [REQUIRED]

        The value of the tag.

  • NotificationsConfiguration (dict) –

    The configuration for resource targets to receive notifications when meeting and attendee events occur.

    • SnsTopicArn (string) –

      The SNS topic ARN.

    • SqsQueueArn (string) –

      The SQS queue ARN.

Return type:

dict

Returns:

Response Syntax

{
    'Meeting': {
        'MeetingId': 'string',
        'ExternalMeetingId': 'string',
        'MediaPlacement': {
            'AudioHostUrl': 'string',
            'AudioFallbackUrl': 'string',
            'ScreenDataUrl': 'string',
            'ScreenSharingUrl': 'string',
            'ScreenViewingUrl': 'string',
            'SignalingUrl': 'string',
            'TurnControlUrl': 'string',
            'EventIngestionUrl': 'string'
        },
        'MediaRegion': 'string'
    }
}

Response Structure

  • (dict) –

    • Meeting (dict) –

      The meeting information, including the meeting ID and MediaPlacement .

      • MeetingId (string) –

        The Amazon Chime SDK meeting ID.

      • ExternalMeetingId (string) –

        The external meeting ID.

      • MediaPlacement (dict) –

        The media placement for the meeting.

        • AudioHostUrl (string) –

          The audio host URL.

        • AudioFallbackUrl (string) –

          The audio fallback URL.

        • ScreenDataUrl (string) –

          The screen data URL.

          Warning

          This parameter is is no longer supported and no longer used by the Amazon Chime SDK.

        • ScreenSharingUrl (string) –

          The screen sharing URL.

          Warning

          This parameter is is no longer supported and no longer used by the Amazon Chime SDK..

        • ScreenViewingUrl (string) –

          The screen viewing URL.

          Warning

          This parameter is is no longer supported and no longer used by the Amazon Chime SDK.

        • SignalingUrl (string) –

          The signaling URL.

        • TurnControlUrl (string) –

          The turn control URL.

          Warning

          This parameter is is no longer supported and no longer used by the Amazon Chime SDK.

        • EventIngestionUrl (string) –

          The event ingestion URL to which you send client meeting events.

      • MediaRegion (string) –

        The Region in which you create the meeting. Available values: af-south-1, ap-northeast-1, ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, sa-east-1, us-east-1, us-east-2, us-west-1, us-west-2.

Exceptions

  • Chime.Client.exceptions.BadRequestException

  • Chime.Client.exceptions.ForbiddenException

  • Chime.Client.exceptions.ResourceLimitExceededException

  • Chime.Client.exceptions.ThrottledClientException

  • Chime.Client.exceptions.UnauthorizedClientException

  • Chime.Client.exceptions.ServiceUnavailableException

  • Chime.Client.exceptions.ServiceFailureException