Amazon Chime 2018-05-01
- Client: Aws\Chime\ChimeClient
- Service ID: chime
- Version: 2018-05-01
This page describes the parameters and results for the operations of the Amazon Chime (2018-05-01), and shows how to use the Aws\Chime\ChimeClient object to call the described operations. This documentation is specific to the 2018-05-01 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- AssociatePhoneNumberWithUser ( array $params = [] )
- Associates a phone number with the specified Amazon Chime user.
- AssociatePhoneNumbersWithVoiceConnector ( array $params = [] )
- Associates phone numbers with the specified Amazon Chime Voice Connector.
- AssociatePhoneNumbersWithVoiceConnectorGroup ( array $params = [] )
- Associates phone numbers with the specified Amazon Chime Voice Connector group.
- AssociateSigninDelegateGroupsWithAccount ( array $params = [] )
- Associates the specified sign-in delegate groups with the specified Amazon Chime account.
- BatchCreateAttendee ( array $params = [] )
- Creates up to 100 new attendees for an active Amazon Chime SDK meeting.
- BatchCreateChannelMembership ( array $params = [] )
- Adds a specified number of users to a channel.
- BatchCreateRoomMembership ( array $params = [] )
- Adds up to 50 members to a chat room in an Amazon Chime Enterprise account.
- BatchDeletePhoneNumber ( array $params = [] )
- Moves phone numbers into the Deletion queue.
- BatchSuspendUser ( array $params = [] )
- Suspends up to 50 users from a Team or EnterpriseLWA Amazon Chime account.
- BatchUnsuspendUser ( array $params = [] )
- Removes the suspension from up to 50 previously suspended users for the specified Amazon Chime EnterpriseLWA account.
- BatchUpdatePhoneNumber ( array $params = [] )
- Updates phone number product types or calling names.
- BatchUpdateUser ( array $params = [] )
- Updates user details within the UpdateUserRequestItem object for up to 20 users for the specified Amazon Chime account.
- CreateAccount ( array $params = [] )
- Creates an Amazon Chime account under the administrator's AWS account.
- CreateAppInstance ( array $params = [] )
- Creates an Amazon Chime SDK messaging AppInstance under an AWS account.
- CreateAppInstanceAdmin ( array $params = [] )
- Promotes an AppInstanceUser to an AppInstanceAdmin.
- CreateAppInstanceUser ( array $params = [] )
- Creates a user under an Amazon Chime AppInstance.
- CreateAttendee ( array $params = [] )
- Creates a new attendee for an active Amazon Chime SDK meeting.
- CreateBot ( array $params = [] )
- Creates a bot for an Amazon Chime Enterprise account.
- CreateChannel ( array $params = [] )
- Creates a channel to which you can add users and send messages.
- CreateChannelBan ( array $params = [] )
- Permanently bans a member from a channel.
- CreateChannelMembership ( array $params = [] )
- Adds a user to a channel.
- CreateChannelModerator ( array $params = [] )
- Creates a new ChannelModerator.
- CreateMediaCapturePipeline ( array $params = [] )
- Creates a media capture pipeline.
- CreateMeeting ( array $params = [] )
- Creates a new Amazon Chime SDK meeting in the specified media Region with no initial attendees.
- CreateMeetingDialOut ( array $params = [] )
- Uses the join token and call metadata in a meeting request (From number, To number, and so forth) to initiate an outbound call to a public switched telephone network (PSTN) and join them into a Chime meeting.
- CreateMeetingWithAttendees ( array $params = [] )
- Creates a new Amazon Chime SDK meeting in the specified media Region, with attendees.
- CreatePhoneNumberOrder ( array $params = [] )
- Creates an order for phone numbers to be provisioned.
- CreateProxySession ( array $params = [] )
- Creates a proxy session on the specified Amazon Chime Voice Connector for the specified participant phone numbers.
- CreateRoom ( array $params = [] )
- Creates a chat room for the specified Amazon Chime Enterprise account.
- CreateRoomMembership ( array $params = [] )
- Adds a member to a chat room in an Amazon Chime Enterprise account.
- CreateSipMediaApplication ( array $params = [] )
- Creates a SIP media application.
- CreateSipMediaApplicationCall ( array $params = [] )
- Creates an outbound call to a phone number from the phone number specified in the request, and it invokes the endpoint of the specified sipMediaApplicationId.
- CreateSipRule ( array $params = [] )
- Creates a SIP rule which can be used to run a SIP media application as a target for a specific trigger type.
- CreateUser ( array $params = [] )
- Creates a user under the specified Amazon Chime account.
- CreateVoiceConnector ( array $params = [] )
- Creates an Amazon Chime Voice Connector under the administrator's AWS account.
- CreateVoiceConnectorGroup ( array $params = [] )
- Creates an Amazon Chime Voice Connector group under the administrator's AWS account.
- DeleteAccount ( array $params = [] )
- Deletes the specified Amazon Chime account.
- DeleteAppInstance ( array $params = [] )
- Deletes an AppInstance and all associated data asynchronously.
- DeleteAppInstanceAdmin ( array $params = [] )
- Demotes an AppInstanceAdmin to an AppInstanceUser.
- DeleteAppInstanceStreamingConfigurations ( array $params = [] )
- Deletes the streaming configurations of an AppInstance.
- DeleteAppInstanceUser ( array $params = [] )
- Deletes an AppInstanceUser.
- DeleteAttendee ( array $params = [] )
- Deletes an attendee from the specified Amazon Chime SDK meeting and deletes their JoinToken.
- DeleteChannel ( array $params = [] )
- Immediately makes a channel and its memberships inaccessible and marks them for deletion.
- DeleteChannelBan ( array $params = [] )
- Removes a user from a channel's ban list.
- DeleteChannelMembership ( array $params = [] )
- Removes a member from a channel.
- DeleteChannelMessage ( array $params = [] )
- Deletes a channel message.
- DeleteChannelModerator ( array $params = [] )
- Deletes a channel moderator.
- DeleteEventsConfiguration ( array $params = [] )
- Deletes the events configuration that allows a bot to receive outgoing events.
- DeleteMediaCapturePipeline ( array $params = [] )
- Deletes the media capture pipeline.
- DeleteMeeting ( array $params = [] )
- Deletes the specified Amazon Chime SDK meeting.
- DeletePhoneNumber ( array $params = [] )
- Moves the specified phone number into the Deletion queue.
- DeleteProxySession ( array $params = [] )
- Deletes the specified proxy session from the specified Amazon Chime Voice Connector.
- DeleteRoom ( array $params = [] )
- Deletes a chat room in an Amazon Chime Enterprise account.
- DeleteRoomMembership ( array $params = [] )
- Removes a member from a chat room in an Amazon Chime Enterprise account.
- DeleteSipMediaApplication ( array $params = [] )
- Deletes a SIP media application.
- DeleteSipRule ( array $params = [] )
- Deletes a SIP rule.
- DeleteVoiceConnector ( array $params = [] )
- Deletes the specified Amazon Chime Voice Connector.
- DeleteVoiceConnectorEmergencyCallingConfiguration ( array $params = [] )
- Deletes the emergency calling configuration details from the specified Amazon Chime Voice Connector.
- DeleteVoiceConnectorGroup ( array $params = [] )
- Deletes the specified Amazon Chime Voice Connector group.
- DeleteVoiceConnectorOrigination ( array $params = [] )
- Deletes the origination settings for the specified Amazon Chime Voice Connector.
- DeleteVoiceConnectorProxy ( array $params = [] )
- Deletes the proxy configuration from the specified Amazon Chime Voice Connector.
- DeleteVoiceConnectorStreamingConfiguration ( array $params = [] )
- Deletes the streaming configuration for the specified Amazon Chime Voice Connector.
- DeleteVoiceConnectorTermination ( array $params = [] )
- Deletes the termination settings for the specified Amazon Chime Voice Connector.
- DeleteVoiceConnectorTerminationCredentials ( array $params = [] )
- Deletes the specified SIP credentials used by your equipment to authenticate during call termination.
- DescribeAppInstance ( array $params = [] )
- Returns the full details of an AppInstance.
- DescribeAppInstanceAdmin ( array $params = [] )
- Returns the full details of an AppInstanceAdmin.
- DescribeAppInstanceUser ( array $params = [] )
- Returns the full details of an AppInstanceUser.
- DescribeChannel ( array $params = [] )
- Returns the full details of a channel in an Amazon Chime AppInstance.
- DescribeChannelBan ( array $params = [] )
- Returns the full details of a channel ban.
- DescribeChannelMembership ( array $params = [] )
- Returns the full details of a user's channel membership.
- DescribeChannelMembershipForAppInstanceUser ( array $params = [] )
- Returns the details of a channel based on the membership of the specified AppInstanceUser.
- DescribeChannelModeratedByAppInstanceUser ( array $params = [] )
- Returns the full details of a channel moderated by the specified AppInstanceUser.
- DescribeChannelModerator ( array $params = [] )
- Returns the full details of a single ChannelModerator.
- DisassociatePhoneNumberFromUser ( array $params = [] )
- Disassociates the primary provisioned phone number from the specified Amazon Chime user.
- DisassociatePhoneNumbersFromVoiceConnector ( array $params = [] )
- Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector.
- DisassociatePhoneNumbersFromVoiceConnectorGroup ( array $params = [] )
- Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector group.
- DisassociateSigninDelegateGroupsFromAccount ( array $params = [] )
- Disassociates the specified sign-in delegate groups from the specified Amazon Chime account.
- GetAccount ( array $params = [] )
- Retrieves details for the specified Amazon Chime account, such as account type and supported licenses.
- GetAccountSettings ( array $params = [] )
- Retrieves account settings for the specified Amazon Chime account ID, such as remote control and dialout settings.
- GetAppInstanceRetentionSettings ( array $params = [] )
- Gets the retention settings for an AppInstance.
- GetAppInstanceStreamingConfigurations ( array $params = [] )
- Gets the streaming settings for an AppInstance.
- GetAttendee ( array $params = [] )
- Gets the Amazon Chime SDK attendee details for a specified meeting ID and attendee ID.
- GetBot ( array $params = [] )
- Retrieves details for the specified bot, such as bot email address, bot type, status, and display name.
- GetChannelMessage ( array $params = [] )
- Gets the full details of a channel message.
- GetEventsConfiguration ( array $params = [] )
- Gets details for an events configuration that allows a bot to receive outgoing events, such as an HTTPS endpoint or Lambda function ARN.
- GetGlobalSettings ( array $params = [] )
- Retrieves global settings for the administrator's AWS account, such as Amazon Chime Business Calling and Amazon Chime Voice Connector settings.
- GetMediaCapturePipeline ( array $params = [] )
- Gets an existing media capture pipeline.
- GetMeeting ( array $params = [] )
- This API is is no longer supported and will not be updated.
- GetMessagingSessionEndpoint ( array $params = [] )
- The details of the endpoint for the messaging session.
- GetPhoneNumber ( array $params = [] )
- Retrieves details for the specified phone number ID, such as associations, capabilities, and product type.
- GetPhoneNumberOrder ( array $params = [] )
- Retrieves details for the specified phone number order, such as the order creation timestamp, phone numbers in E.
- GetPhoneNumberSettings ( array $params = [] )
- Retrieves the phone number settings for the administrator's AWS account, such as the default outbound calling name.
- GetProxySession ( array $params = [] )
- Gets the specified proxy session details for the specified Amazon Chime Voice Connector.
- GetRetentionSettings ( array $params = [] )
- Gets the retention settings for the specified Amazon Chime Enterprise account.
- GetRoom ( array $params = [] )
- Retrieves room details, such as the room name, for a room in an Amazon Chime Enterprise account.
- GetSipMediaApplication ( array $params = [] )
- Retrieves the information for a SIP media application, including name, AWS Region, and endpoints.
- GetSipMediaApplicationLoggingConfiguration ( array $params = [] )
- Returns the logging configuration for the specified SIP media application.
- GetSipRule ( array $params = [] )
- Retrieves the details of a SIP rule, such as the rule ID, name, triggers, and target endpoints.
- GetUser ( array $params = [] )
- Retrieves details for the specified user ID, such as primary email address, license type,and personal meeting PIN.
- GetUserSettings ( array $params = [] )
- Retrieves settings for the specified user ID, such as any associated phone number settings.
- GetVoiceConnector ( array $params = [] )
- Retrieves details for the specified Amazon Chime Voice Connector, such as timestamps,name, outbound host, and encryption requirements.
- GetVoiceConnectorEmergencyCallingConfiguration ( array $params = [] )
- Gets the emergency calling configuration details for the specified Amazon Chime Voice Connector.
- GetVoiceConnectorGroup ( array $params = [] )
- Retrieves details for the specified Amazon Chime Voice Connector group, such as timestamps,name, and associated VoiceConnectorItems.
- GetVoiceConnectorLoggingConfiguration ( array $params = [] )
- Retrieves the logging configuration details for the specified Amazon Chime Voice Connector.
- GetVoiceConnectorOrigination ( array $params = [] )
- Retrieves origination setting details for the specified Amazon Chime Voice Connector.
- GetVoiceConnectorProxy ( array $params = [] )
- Gets the proxy configuration details for the specified Amazon Chime Voice Connector.
- GetVoiceConnectorStreamingConfiguration ( array $params = [] )
- Retrieves the streaming configuration details for the specified Amazon Chime Voice Connector.
- GetVoiceConnectorTermination ( array $params = [] )
- Retrieves termination setting details for the specified Amazon Chime Voice Connector.
- GetVoiceConnectorTerminationHealth ( array $params = [] )
- This API is is no longer supported and will not be updated.
- InviteUsers ( array $params = [] )
- Sends email to a maximum of 50 users, inviting them to the specified Amazon Chime Team account.
- ListAccounts ( array $params = [] )
- Lists the Amazon Chime accounts under the administrator's AWS account.
- ListAppInstanceAdmins ( array $params = [] )
- Returns a list of the administrators in the AppInstance.
- ListAppInstanceUsers ( array $params = [] )
- List all AppInstanceUsers created under a single AppInstance.
- ListAppInstances ( array $params = [] )
- Lists all Amazon Chime AppInstances created under a single AWS account.
- ListAttendeeTags ( array $params = [] )
- Lists the tags applied to an Amazon Chime SDK attendee resource.
- ListAttendees ( array $params = [] )
- Lists the attendees for the specified Amazon Chime SDK meeting.
- ListBots ( array $params = [] )
- Lists the bots associated with the administrator's Amazon Chime Enterprise account ID.
- ListChannelBans ( array $params = [] )
- Lists all the users banned from a particular channel.
- ListChannelMemberships ( array $params = [] )
- Lists all channel memberships in a channel.
- ListChannelMembershipsForAppInstanceUser ( array $params = [] )
- Lists all channels that a particular AppInstanceUser is a part of.
- ListChannelMessages ( array $params = [] )
- List all the messages in a channel.
- ListChannelModerators ( array $params = [] )
- Lists all the moderators for a channel.
- ListChannels ( array $params = [] )
- Lists all Channels created under a single Chime App as a paginated list.
- ListChannelsModeratedByAppInstanceUser ( array $params = [] )
- A list of the channels moderated by an AppInstanceUser.
- ListMediaCapturePipelines ( array $params = [] )
- Returns a list of media capture pipelines.
- ListMeetingTags ( array $params = [] )
- Lists the tags applied to an Amazon Chime SDK meeting resource.
- ListMeetings ( array $params = [] )
- Lists up to 100 active Amazon Chime SDK meetings.
- ListPhoneNumberOrders ( array $params = [] )
- Lists the phone number orders for the administrator's Amazon Chime account.
- ListPhoneNumbers ( array $params = [] )
- Lists the phone numbers for the specified Amazon Chime account, Amazon Chime user, Amazon Chime Voice Connector, or Amazon Chime Voice Connector group.
- ListProxySessions ( array $params = [] )
- Lists the proxy sessions for the specified Amazon Chime Voice Connector.
- ListRoomMemberships ( array $params = [] )
- Lists the membership details for the specified room in an Amazon Chime Enterprise account, such as the members' IDs, email addresses, and names.
- ListRooms ( array $params = [] )
- Lists the room details for the specified Amazon Chime Enterprise account.
- ListSipMediaApplications ( array $params = [] )
- Lists the SIP media applications under the administrator's AWS account.
- ListSipRules ( array $params = [] )
- Lists the SIP rules under the administrator's AWS account.
- ListSupportedPhoneNumberCountries ( array $params = [] )
- Lists supported phone number countries.
- ListTagsForResource ( array $params = [] )
- Lists the tags applied to an Amazon Chime SDK meeting and messaging resources.
- ListUsers ( array $params = [] )
- Lists the users that belong to the specified Amazon Chime account.
- ListVoiceConnectorGroups ( array $params = [] )
- Lists the Amazon Chime Voice Connector groups for the administrator's AWS account.
- ListVoiceConnectorTerminationCredentials ( array $params = [] )
- Lists the SIP credentials for the specified Amazon Chime Voice Connector.
- ListVoiceConnectors ( array $params = [] )
- Lists the Amazon Chime Voice Connectors for the administrator's AWS account.
- LogoutUser ( array $params = [] )
- Logs out the specified user from all of the devices they are currently logged into.
- PutAppInstanceRetentionSettings ( array $params = [] )
- Sets the amount of time in days that a given AppInstance retains data.
- PutAppInstanceStreamingConfigurations ( array $params = [] )
- The data streaming configurations of an AppInstance.
- PutEventsConfiguration ( array $params = [] )
- Creates an events configuration that allows a bot to receive outgoing events sent by Amazon Chime.
- PutRetentionSettings ( array $params = [] )
- Puts retention settings for the specified Amazon Chime Enterprise account.
- PutSipMediaApplicationLoggingConfiguration ( array $params = [] )
- Updates the logging configuration for the specified SIP media application.
- PutVoiceConnectorEmergencyCallingConfiguration ( array $params = [] )
- Puts emergency calling configuration details to the specified Amazon Chime Voice Connector, such as emergency phone numbers and calling countries.
- PutVoiceConnectorLoggingConfiguration ( array $params = [] )
- Adds a logging configuration for the specified Amazon Chime Voice Connector.
- PutVoiceConnectorOrigination ( array $params = [] )
- Adds origination settings for the specified Amazon Chime Voice Connector.
- PutVoiceConnectorProxy ( array $params = [] )
- Puts the specified proxy configuration to the specified Amazon Chime Voice Connector.
- PutVoiceConnectorStreamingConfiguration ( array $params = [] )
- Adds a streaming configuration for the specified Amazon Chime Voice Connector.
- PutVoiceConnectorTermination ( array $params = [] )
- Adds termination settings for the specified Amazon Chime Voice Connector.
- PutVoiceConnectorTerminationCredentials ( array $params = [] )
- Adds termination SIP credentials for the specified Amazon Chime Voice Connector.
- RedactChannelMessage ( array $params = [] )
- Redacts message content, but not metadata.
- RedactConversationMessage ( array $params = [] )
- Redacts the specified message from the specified Amazon Chime conversation.
- RedactRoomMessage ( array $params = [] )
- Redacts the specified message from the specified Amazon Chime channel.
- RegenerateSecurityToken ( array $params = [] )
- Regenerates the security token for a bot.
- ResetPersonalPIN ( array $params = [] )
- Resets the personal meeting PIN for the specified user on an Amazon Chime account.
- RestorePhoneNumber ( array $params = [] )
- Moves a phone number from the Deletion queue back into the phone number Inventory.
- SearchAvailablePhoneNumbers ( array $params = [] )
- Searches for phone numbers that can be ordered.
- SendChannelMessage ( array $params = [] )
- Sends a message to a particular channel that the member is a part of.
- StartMeetingTranscription ( array $params = [] )
- Starts transcription for the specified meetingId.
- StopMeetingTranscription ( array $params = [] )
- Stops transcription for the specified meetingId.
- TagAttendee ( array $params = [] )
- Applies the specified tags to the specified Amazon Chime attendee.
- TagMeeting ( array $params = [] )
- Applies the specified tags to the specified Amazon Chime SDK meeting.
- TagResource ( array $params = [] )
- Applies the specified tags to the specified Amazon Chime SDK meeting resource.
- UntagAttendee ( array $params = [] )
- Untags the specified tags from the specified Amazon Chime SDK attendee.
- UntagMeeting ( array $params = [] )
- Untags the specified tags from the specified Amazon Chime SDK meeting.
- UntagResource ( array $params = [] )
- Untags the specified tags from the specified Amazon Chime SDK meeting resource.
- UpdateAccount ( array $params = [] )
- Updates account details for the specified Amazon Chime account.
- UpdateAccountSettings ( array $params = [] )
- Updates the settings for the specified Amazon Chime account.
- UpdateAppInstance ( array $params = [] )
- Updates AppInstance metadata.
- UpdateAppInstanceUser ( array $params = [] )
- Updates the details of an AppInstanceUser.
- UpdateBot ( array $params = [] )
- Updates the status of the specified bot, such as starting or stopping the bot from running in your Amazon Chime Enterprise account.
- UpdateChannel ( array $params = [] )
- Update a channel's attributes.
- UpdateChannelMessage ( array $params = [] )
- Updates the content of a message.
- UpdateChannelReadMarker ( array $params = [] )
- The details of the time when a user last read messages in a channel.
- UpdateGlobalSettings ( array $params = [] )
- Updates global settings for the administrator's AWS account, such as Amazon Chime Business Calling and Amazon Chime Voice Connector settings.
- UpdatePhoneNumber ( array $params = [] )
- Updates phone number details, such as product type or calling name, for the specified phone number ID.
- UpdatePhoneNumberSettings ( array $params = [] )
- Updates the phone number settings for the administrator's AWS account, such as the default outbound calling name.
- UpdateProxySession ( array $params = [] )
- Updates the specified proxy session details, such as voice or SMS capabilities.
- UpdateRoom ( array $params = [] )
- Updates room details, such as the room name, for a room in an Amazon Chime Enterprise account.
- UpdateRoomMembership ( array $params = [] )
- Updates room membership details, such as the member role, for a room in an Amazon Chime Enterprise account.
- UpdateSipMediaApplication ( array $params = [] )
- Updates the details of the specified SIP media application.
- UpdateSipMediaApplicationCall ( array $params = [] )
- Invokes the AWS Lambda function associated with the SIP media application and transaction ID in an update request.
- UpdateSipRule ( array $params = [] )
- Updates the details of the specified SIP rule.
- UpdateUser ( array $params = [] )
- Updates user details for a specified user ID.
- UpdateUserSettings ( array $params = [] )
- Updates the settings for the specified user, such as phone number settings.
- UpdateVoiceConnector ( array $params = [] )
- Updates details for the specified Amazon Chime Voice Connector.
- UpdateVoiceConnectorGroup ( array $params = [] )
- Updates details of the specified Amazon Chime Voice Connector group, such as the name and Amazon Chime Voice Connector priority ranking.
- ValidateE911Address ( array $params = [] )
- Validates an address to be used for 911 calls made with Amazon Chime Voice Connectors.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
- ListAccounts
- ListAppInstanceAdmins
- ListAppInstanceUsers
- ListAppInstances
- ListAttendees
- ListBots
- ListChannelBans
- ListChannelMemberships
- ListChannelMembershipsForAppInstanceUser
- ListChannelMessages
- ListChannelModerators
- ListChannels
- ListChannelsModeratedByAppInstanceUser
- ListMediaCapturePipelines
- ListMeetings
- ListPhoneNumberOrders
- ListPhoneNumbers
- ListProxySessions
- ListRoomMemberships
- ListRooms
- ListSipMediaApplications
- ListSipRules
- ListUsers
- ListVoiceConnectorGroups
- ListVoiceConnectors
- SearchAvailablePhoneNumbers
Operations
AssociatePhoneNumberWithUser
$result = $client->associatePhoneNumberWithUser
([/* ... */]); $promise = $client->associatePhoneNumberWithUserAsync
([/* ... */]);
Associates a phone number with the specified Amazon Chime user.
Parameter Syntax
$result = $client->associatePhoneNumberWithUser([ 'AccountId' => '<string>', // REQUIRED 'E164PhoneNumber' => '<string>', // REQUIRED 'UserId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- E164PhoneNumber
-
- Required: Yes
- Type: string
The phone number, in E.164 format.
- UserId
-
- Required: Yes
- Type: string
The user ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
AssociatePhoneNumbersWithVoiceConnector
$result = $client->associatePhoneNumbersWithVoiceConnector
([/* ... */]); $promise = $client->associatePhoneNumbersWithVoiceConnectorAsync
([/* ... */]);
Associates phone numbers with the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, AssociatePhoneNumbersWithVoiceConnector, 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.
Parameter Syntax
$result = $client->associatePhoneNumbersWithVoiceConnector([ 'E164PhoneNumbers' => ['<string>', ...], // REQUIRED 'ForceAssociate' => true || false, 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- E164PhoneNumbers
-
- Required: Yes
- Type: Array of strings
List of phone numbers, in E.164 format.
- ForceAssociate
-
- Type: boolean
If true, associates the provided phone numbers with the provided Amazon Chime Voice Connector and removes any previously existing associations. If false, does not associate any phone numbers that have previously existing associations.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'PhoneNumberErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'PhoneNumberId' => '<string>', ], // ... ], ]
Result Details
Members
- PhoneNumberErrors
-
- Type: Array of PhoneNumberError structures
If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
AssociatePhoneNumbersWithVoiceConnectorGroup
$result = $client->associatePhoneNumbersWithVoiceConnectorGroup
([/* ... */]); $promise = $client->associatePhoneNumbersWithVoiceConnectorGroupAsync
([/* ... */]);
Associates phone numbers with the specified Amazon Chime Voice Connector group.
This API is is no longer supported and will not be updated. We recommend using the latest version, AssociatePhoneNumbersWithVoiceConnectorGroup, 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.
Parameter Syntax
$result = $client->associatePhoneNumbersWithVoiceConnectorGroup([ 'E164PhoneNumbers' => ['<string>', ...], // REQUIRED 'ForceAssociate' => true || false, 'VoiceConnectorGroupId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- E164PhoneNumbers
-
- Required: Yes
- Type: Array of strings
List of phone numbers, in E.164 format.
- ForceAssociate
-
- Type: boolean
If true, associates the provided phone numbers with the provided Amazon Chime Voice Connector Group and removes any previously existing associations. If false, does not associate any phone numbers that have previously existing associations.
- VoiceConnectorGroupId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector group ID.
Result Syntax
[ 'PhoneNumberErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'PhoneNumberId' => '<string>', ], // ... ], ]
Result Details
Members
- PhoneNumberErrors
-
- Type: Array of PhoneNumberError structures
If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
AssociateSigninDelegateGroupsWithAccount
$result = $client->associateSigninDelegateGroupsWithAccount
([/* ... */]); $promise = $client->associateSigninDelegateGroupsWithAccountAsync
([/* ... */]);
Associates the specified sign-in delegate groups with the specified Amazon Chime account.
Parameter Syntax
$result = $client->associateSigninDelegateGroupsWithAccount([ 'AccountId' => '<string>', // REQUIRED 'SigninDelegateGroups' => [ // REQUIRED [ 'GroupName' => '<string>', ], // ... ], ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- SigninDelegateGroups
-
- Required: Yes
- Type: Array of SigninDelegateGroup structures
The sign-in delegate groups.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
BatchCreateAttendee
$result = $client->batchCreateAttendee
([/* ... */]); $promise = $client->batchCreateAttendeeAsync
([/* ... */]);
Creates up to 100 new attendees for an active Amazon Chime SDK meeting.
This API is is no longer supported and will not be updated. We recommend using the latest version, BatchCreateAttendee, 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.
For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.
Parameter Syntax
$result = $client->batchCreateAttendee([ 'Attendees' => [ // REQUIRED [ 'ExternalUserId' => '<string>', // REQUIRED 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ], // ... ], 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Attendees
-
- Required: Yes
- Type: Array of CreateAttendeeRequestItem structures
The request containing the attendees to create.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
Result Syntax
[ 'Attendees' => [ [ 'AttendeeId' => '<string>', 'ExternalUserId' => '<string>', 'JoinToken' => '<string>', ], // ... ], 'Errors' => [ [ 'ErrorCode' => '<string>', 'ErrorMessage' => '<string>', 'ExternalUserId' => '<string>', ], // ... ], ]
Result Details
Members
- Attendees
-
- Type: Array of Attendee structures
The attendee information, including attendees IDs and join tokens.
- Errors
-
- Type: Array of CreateAttendeeError structures
If the action fails for one or more of the attendees in the request, a list of the attendees is returned, along with error codes and error messages.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
BatchCreateChannelMembership
$result = $client->batchCreateChannelMembership
([/* ... */]); $promise = $client->batchCreateChannelMembershipAsync
([/* ... */]);
Adds a specified number of users to a channel.
This API is is no longer supported and will not be updated. We recommend using the latest version, BatchCreateChannelMembership, 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.
Parameter Syntax
$result = $client->batchCreateChannelMembership([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MemberArns' => ['<string>', ...], // REQUIRED 'Type' => 'DEFAULT|HIDDEN', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel to which you're adding users.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MemberArns
-
- Required: Yes
- Type: Array of strings
The ARNs of the members you want to add to the channel.
- Type
-
- Type: string
The membership type of a user,
DEFAULT
orHIDDEN
. Default members are always returned as part ofListChannelMemberships
. Hidden members are only returned if the type filter inListChannelMemberships
equalsHIDDEN
. Otherwise hidden members are not returned. This is only supported by moderators.
Result Syntax
[ 'BatchChannelMemberships' => [ 'ChannelArn' => '<string>', 'InvitedBy' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'Members' => [ [ 'Arn' => '<string>', 'Name' => '<string>', ], // ... ], 'Type' => 'DEFAULT|HIDDEN', ], 'Errors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'MemberArn' => '<string>', ], // ... ], ]
Result Details
Members
- BatchChannelMemberships
-
- Type: BatchChannelMemberships structure
The list of channel memberships in the response.
- Errors
-
- Type: Array of BatchCreateChannelMembershipError structures
If the action fails for one or more of the memberships in the request, a list of the memberships is returned, along with error codes and error messages.
Errors
- ServiceFailureException:
The service encountered an unexpected error.
- ServiceUnavailableException:
The service is currently unavailable.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
BatchCreateRoomMembership
$result = $client->batchCreateRoomMembership
([/* ... */]); $promise = $client->batchCreateRoomMembershipAsync
([/* ... */]);
Adds up to 50 members to a chat room in an Amazon Chime Enterprise account. Members can be users or bots. The member role designates whether the member is a chat room administrator or a general chat room member.
Parameter Syntax
$result = $client->batchCreateRoomMembership([ 'AccountId' => '<string>', // REQUIRED 'MembershipItemList' => [ // REQUIRED [ 'MemberId' => '<string>', 'Role' => 'Administrator|Member', ], // ... ], 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MembershipItemList
-
- Required: Yes
- Type: Array of MembershipItem structures
The list of membership items.
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[ 'Errors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'MemberId' => '<string>', ], // ... ], ]
Result Details
Members
- Errors
-
- Type: Array of MemberError structures
If the action fails for one or more of the member IDs in the request, a list of the member IDs is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
BatchDeletePhoneNumber
$result = $client->batchDeletePhoneNumber
([/* ... */]); $promise = $client->batchDeletePhoneNumberAsync
([/* ... */]);
Moves phone numbers into the Deletion queue. Phone numbers must be disassociated from any users or Amazon Chime Voice Connectors before they can be deleted.
Phone numbers remain in the Deletion queue for 7 days before they are deleted permanently.
Parameter Syntax
$result = $client->batchDeletePhoneNumber([ 'PhoneNumberIds' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- PhoneNumberIds
-
- Required: Yes
- Type: Array of strings
List of phone number IDs.
Result Syntax
[ 'PhoneNumberErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'PhoneNumberId' => '<string>', ], // ... ], ]
Result Details
Members
- PhoneNumberErrors
-
- Type: Array of PhoneNumberError structures
If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
BatchSuspendUser
$result = $client->batchSuspendUser
([/* ... */]); $promise = $client->batchSuspendUserAsync
([/* ... */]);
Suspends up to 50 users from a Team
or EnterpriseLWA
Amazon Chime account. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide.
Users suspended from a Team
account are disassociated from the account,but they can continue to use Amazon Chime as free users. To remove the suspension from suspended Team
account users, invite them to the Team
account again. You can use the InviteUsers action to do so.
Users suspended from an EnterpriseLWA
account are immediately signed out of Amazon Chime and can no longer sign in. To remove the suspension from suspended EnterpriseLWA
account users, use the BatchUnsuspendUser action.
To sign out users without suspending them, use the LogoutUser action.
Parameter Syntax
$result = $client->batchSuspendUser([ 'AccountId' => '<string>', // REQUIRED 'UserIdList' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserIdList
-
- Required: Yes
- Type: Array of strings
The request containing the user IDs to suspend.
Result Syntax
[ 'UserErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'UserId' => '<string>', ], // ... ], ]
Result Details
Members
- UserErrors
-
- Type: Array of UserError structures
If the BatchSuspendUser action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
BatchUnsuspendUser
$result = $client->batchUnsuspendUser
([/* ... */]); $promise = $client->batchUnsuspendUserAsync
([/* ... */]);
Removes the suspension from up to 50 previously suspended users for the specified Amazon Chime EnterpriseLWA
account. Only users on EnterpriseLWA
accounts can be unsuspended using this action. For more information about different account types, see Managing Your Amazon Chime Accounts in the account types, in the Amazon Chime Administration Guide.
Previously suspended users who are unsuspended using this action are returned to Registered
status. Users who are not previously suspended are ignored.
Parameter Syntax
$result = $client->batchUnsuspendUser([ 'AccountId' => '<string>', // REQUIRED 'UserIdList' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserIdList
-
- Required: Yes
- Type: Array of strings
The request containing the user IDs to unsuspend.
Result Syntax
[ 'UserErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'UserId' => '<string>', ], // ... ], ]
Result Details
Members
- UserErrors
-
- Type: Array of UserError structures
If the BatchUnsuspendUser action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
BatchUpdatePhoneNumber
$result = $client->batchUpdatePhoneNumber
([/* ... */]); $promise = $client->batchUpdatePhoneNumberAsync
([/* ... */]);
Updates phone number product types or calling names. You can update one attribute at a time for each UpdatePhoneNumberRequestItem
. For example, you can update the product type or the calling name.
For toll-free numbers, you cannot use the Amazon Chime Business Calling product type. For numbers outside the U.S., you must use the Amazon Chime SIP Media Application Dial-In product type.
Updates to outbound calling names can take up to 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.
Parameter Syntax
$result = $client->batchUpdatePhoneNumber([ 'UpdatePhoneNumberRequestItems' => [ // REQUIRED [ 'CallingName' => '<string>', 'PhoneNumberId' => '<string>', // REQUIRED 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', ], // ... ], ]);
Parameter Details
Members
- UpdatePhoneNumberRequestItems
-
- Required: Yes
- Type: Array of UpdatePhoneNumberRequestItem structures
The request containing the phone number IDs and product types or calling names to update.
Result Syntax
[ 'PhoneNumberErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'PhoneNumberId' => '<string>', ], // ... ], ]
Result Details
Members
- PhoneNumberErrors
-
- Type: Array of PhoneNumberError structures
If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
BatchUpdateUser
$result = $client->batchUpdateUser
([/* ... */]); $promise = $client->batchUpdateUserAsync
([/* ... */]);
Updates user details within the UpdateUserRequestItem object for up to 20 users for the specified Amazon Chime account. Currently, only LicenseType
updates are supported for this action.
Parameter Syntax
$result = $client->batchUpdateUser([ 'AccountId' => '<string>', // REQUIRED 'UpdateUserRequestItems' => [ // REQUIRED [ 'AlexaForBusinessMetadata' => [ 'AlexaForBusinessRoomArn' => '<string>', 'IsAlexaForBusinessEnabled' => true || false, ], 'LicenseType' => 'Basic|Plus|Pro|ProTrial', 'UserId' => '<string>', // REQUIRED 'UserType' => 'PrivateUser|SharedDevice', ], // ... ], ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UpdateUserRequestItems
-
- Required: Yes
- Type: Array of UpdateUserRequestItem structures
The request containing the user IDs and details to update.
Result Syntax
[ 'UserErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'UserId' => '<string>', ], // ... ], ]
Result Details
Members
- UserErrors
-
- Type: Array of UserError structures
If the BatchUpdateUser action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateAccount
$result = $client->createAccount
([/* ... */]); $promise = $client->createAccountAsync
([/* ... */]);
Creates an Amazon Chime account under the administrator's AWS account. Only Team
account types are currently supported for this action. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide.
Parameter Syntax
$result = $client->createAccount([ 'Name' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Name
-
- Required: Yes
- Type: string
The name of the Amazon Chime account.
Result Syntax
[ 'Account' => [ 'AccountId' => '<string>', 'AccountStatus' => 'Suspended|Active', 'AccountType' => 'Team|EnterpriseDirectory|EnterpriseLWA|EnterpriseOIDC', 'AwsAccountId' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DefaultLicense' => 'Basic|Plus|Pro|ProTrial', 'Name' => '<string>', 'SigninDelegateGroups' => [ [ 'GroupName' => '<string>', ], // ... ], 'SupportedLicenses' => ['<string>', ...], ], ]
Result Details
Members
- Account
-
- Type: Account structure
The Amazon Chime account details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateAppInstance
$result = $client->createAppInstance
([/* ... */]); $promise = $client->createAppInstanceAsync
([/* ... */]);
Creates an Amazon Chime SDK messaging AppInstance
under an AWS account. Only SDK messaging customers use this API. CreateAppInstance
supports idempotency behavior as described in the AWS API Standard.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateAppInstance, 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.
Parameter Syntax
$result = $client->createAppInstance([ 'ClientRequestToken' => '<string>', // REQUIRED 'Metadata' => '<string>', 'Name' => '<string>', // REQUIRED 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- ClientRequestToken
-
- Required: Yes
- Type: string
The
ClientRequestToken
of theAppInstance
. - Metadata
-
- Type: string
The metadata of the
AppInstance
. Limited to a 1KB string in UTF-8. - Name
-
- Required: Yes
- Type: string
The name of the
AppInstance
. - Tags
-
- Type: Array of Tag structures
Tags assigned to the
AppInstance
.
Result Syntax
[ 'AppInstanceArn' => '<string>', ]
Result Details
Members
- AppInstanceArn
-
- Type: string
The Amazon Resource Number (ARN) of the
AppInstance
.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateAppInstanceAdmin
$result = $client->createAppInstanceAdmin
([/* ... */]); $promise = $client->createAppInstanceAdminAsync
([/* ... */]);
Promotes an AppInstanceUser
to an AppInstanceAdmin
. The promoted user can perform the following actions.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateAppInstanceAdmin, 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.
-
ChannelModerator
actions across all channels in theAppInstance
. -
DeleteChannelMessage
actions.
Only an AppInstanceUser
can be promoted to an AppInstanceAdmin
role.
Parameter Syntax
$result = $client->createAppInstanceAdmin([ 'AppInstanceAdminArn' => '<string>', // REQUIRED 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceAdminArn
-
- Required: Yes
- Type: string
The ARN of the administrator of the current
AppInstance
. - AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
.
Result Syntax
[ 'AppInstanceAdmin' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'AppInstanceArn' => '<string>', ]
Result Details
Members
- AppInstanceAdmin
-
- Type: Identity structure
The name and ARN of the admin for the
AppInstance
. - AppInstanceArn
-
- Type: string
The ARN of the of the admin for the
AppInstance
.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateAppInstanceUser
$result = $client->createAppInstanceUser
([/* ... */]); $promise = $client->createAppInstanceUserAsync
([/* ... */]);
Creates a user under an Amazon Chime AppInstance
. The request consists of a unique appInstanceUserId
and Name
for that user.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateAppInstanceUser, 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.
Parameter Syntax
$result = $client->createAppInstanceUser([ 'AppInstanceArn' => '<string>', // REQUIRED 'AppInstanceUserId' => '<string>', // REQUIRED 'ClientRequestToken' => '<string>', // REQUIRED 'Metadata' => '<string>', 'Name' => '<string>', // REQUIRED 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
request. - AppInstanceUserId
-
- Required: Yes
- Type: string
The user ID of the
AppInstance
. - ClientRequestToken
-
- Required: Yes
- Type: string
The token assigned to the user requesting an
AppInstance
. - Metadata
-
- Type: string
The request's metadata. Limited to a 1KB string in UTF-8.
- Name
-
- Required: Yes
- Type: string
The user's name.
- Tags
-
- Type: Array of Tag structures
Tags assigned to the
AppInstanceUser
.
Result Syntax
[ 'AppInstanceUserArn' => '<string>', ]
Result Details
Members
- AppInstanceUserArn
-
- Type: string
The user's ARN.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateAttendee
$result = $client->createAttendee
([/* ... */]); $promise = $client->createAttendeeAsync
([/* ... */]);
Creates a new attendee for an active Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateAttendee, 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.
Parameter Syntax
$result = $client->createAttendee([ 'ExternalUserId' => '<string>', // REQUIRED 'MeetingId' => '<string>', // REQUIRED 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- ExternalUserId
-
- Required: Yes
- Type: string
The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
- Tags
-
- Type: Array of Tag structures
The tag key-value pairs.
Result Syntax
[ 'Attendee' => [ 'AttendeeId' => '<string>', 'ExternalUserId' => '<string>', 'JoinToken' => '<string>', ], ]
Result Details
Members
- Attendee
-
- Type: Attendee structure
The attendee information, including attendee ID and join token.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateBot
$result = $client->createBot
([/* ... */]); $promise = $client->createBotAsync
([/* ... */]);
Creates a bot for an Amazon Chime Enterprise account.
Parameter Syntax
$result = $client->createBot([ 'AccountId' => '<string>', // REQUIRED 'DisplayName' => '<string>', // REQUIRED 'Domain' => '<string>', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- DisplayName
-
- Required: Yes
- Type: string
The bot display name.
- Domain
-
- Type: string
The domain of the Amazon Chime Enterprise account.
Result Syntax
[ 'Bot' => [ 'BotEmail' => '<string>', 'BotId' => '<string>', 'BotType' => 'ChatBot', 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'DisplayName' => '<string>', 'SecurityToken' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'UserId' => '<string>', ], ]
Result Details
Members
- Bot
-
- Type: Bot structure
The bot details.
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
CreateChannel
$result = $client->createChannel
([/* ... */]); $promise = $client->createChannelAsync
([/* ... */]);
Creates a channel to which you can add users and send messages.
Restriction: You can't change a channel's privacy.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateChannel, 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.
Parameter Syntax
$result = $client->createChannel([ 'AppInstanceArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'ClientRequestToken' => '<string>', // REQUIRED 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', 'Name' => '<string>', // REQUIRED 'Privacy' => 'PUBLIC|PRIVATE', 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the channel request.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - ClientRequestToken
-
- Required: Yes
- Type: string
The client token for the request. An
Idempotency
token. - Metadata
-
- Type: string
The metadata of the creation request. Limited to 1KB and UTF-8.
- Mode
-
- Type: string
The channel mode:
UNRESTRICTED
orRESTRICTED
. Administrators, moderators, and channel members can add themselves and other members to unrestricted channels. Only administrators and moderators can add members to restricted channels. - Name
-
- Required: Yes
- Type: string
The name of the channel.
- Privacy
-
- Type: string
The channel's privacy level:
PUBLIC
orPRIVATE
. Private channels aren't discoverable by users outside the channel. Public channels are discoverable by anyone in theAppInstance
. - Tags
-
- Type: Array of Tag structures
The tags for the creation request.
Result Syntax
[ 'ChannelArn' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateChannelBan
$result = $client->createChannelBan
([/* ... */]); $promise = $client->createChannelBanAsync
([/* ... */]);
Permanently bans a member from a channel. Moderators can't add banned members to a channel. To undo a ban, you first have to DeleteChannelBan
, and then CreateChannelMembership
. Bans are cleaned up when you delete users or channels.
If you ban a user who is already part of a channel, that user is automatically kicked from the channel.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateChannelBan, 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.
Parameter Syntax
$result = $client->createChannelBan([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MemberArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the ban request.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MemberArn
-
- Required: Yes
- Type: string
The ARN of the member being banned.
Result Syntax
[ 'ChannelArn' => '<string>', 'Member' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the response to the ban request.
- Member
-
- Type: Identity structure
The
ChannelArn
andBannedIdentity
of the member in the ban response.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateChannelMembership
$result = $client->createChannelMembership
([/* ... */]); $promise = $client->createChannelMembershipAsync
([/* ... */]);
Adds a user to a channel. The InvitedBy
response field is derived from the request header. A channel member can:
-
List messages
-
Send messages
-
Receive messages
-
Edit their own messages
-
Leave the channel
Privacy settings impact this action as follows:
-
Public Channels: You do not need to be a member to list messages, but you must be a member to send messages.
-
Private Channels: You must be a member to list or send messages.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateChannelMembership, 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.
Parameter Syntax
$result = $client->createChannelMembership([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MemberArn' => '<string>', // REQUIRED 'Type' => 'DEFAULT|HIDDEN', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel to which you're adding users.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MemberArn
-
- Required: Yes
- Type: string
The ARN of the member you want to add to the channel.
- Type
-
- Required: Yes
- Type: string
The membership type of a user,
DEFAULT
orHIDDEN
. Default members are always returned as part ofListChannelMemberships
. Hidden members are only returned if the type filter inListChannelMemberships
equalsHIDDEN
. Otherwise hidden members are not returned. This is only supported by moderators.
Result Syntax
[ 'ChannelArn' => '<string>', 'Member' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- Member
-
- Type: Identity structure
The ARN and metadata of the member being added.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateChannelModerator
$result = $client->createChannelModerator
([/* ... */]); $promise = $client->createChannelModeratorAsync
([/* ... */]);
Creates a new ChannelModerator
. A channel moderator can:
-
Add and remove other members of the channel.
-
Add and remove other moderators of the channel.
-
Add and remove user bans for the channel.
-
Redact messages in the channel.
-
List messages in the channel.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateChannelModerator, 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.
Parameter Syntax
$result = $client->createChannelModerator([ 'ChannelArn' => '<string>', // REQUIRED 'ChannelModeratorArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChannelModeratorArn
-
- Required: Yes
- Type: string
The ARN of the moderator.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[ 'ChannelArn' => '<string>', 'ChannelModerator' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- ChannelModerator
-
- Type: Identity structure
The ARNs of the channel and the moderator.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateMediaCapturePipeline
$result = $client->createMediaCapturePipeline
([/* ... */]); $promise = $client->createMediaCapturePipelineAsync
([/* ... */]);
Creates a media capture pipeline.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateMediaCapturePipeline, 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.
Parameter Syntax
$result = $client->createMediaCapturePipeline([ 'ChimeSdkMeetingConfiguration' => [ 'ArtifactsConfiguration' => [ 'Audio' => [ // REQUIRED 'MuxType' => 'AudioOnly|AudioWithActiveSpeakerVideo', // REQUIRED ], 'Content' => [ // REQUIRED 'MuxType' => 'ContentOnly', 'State' => 'Enabled|Disabled', // REQUIRED ], 'Video' => [ // REQUIRED 'MuxType' => 'VideoOnly', 'State' => 'Enabled|Disabled', // REQUIRED ], ], 'SourceConfiguration' => [ 'SelectedVideoStreams' => [ 'AttendeeIds' => ['<string>', ...], 'ExternalUserIds' => ['<string>', ...], ], ], ], 'ClientRequestToken' => '<string>', 'SinkArn' => '<string>', // REQUIRED 'SinkType' => 'S3Bucket', // REQUIRED 'SourceArn' => '<string>', // REQUIRED 'SourceType' => 'ChimeSdkMeeting', // REQUIRED ]);
Parameter Details
Members
- ChimeSdkMeetingConfiguration
-
- Type: ChimeSdkMeetingConfiguration structure
The configuration for a specified media capture pipeline.
SourceType
must beChimeSdkMeeting
. - ClientRequestToken
-
- Type: string
The unique identifier for the client request. The token makes the API request idempotent. Use a different token for different media pipeline requests.
- SinkArn
-
- Required: Yes
- Type: string
The ARN of the sink type.
- SinkType
-
- Required: Yes
- Type: string
Destination type to which the media artifacts are saved. You must use an S3 bucket.
- SourceArn
-
- Required: Yes
- Type: string
ARN of the source from which the media artifacts are captured.
- SourceType
-
- Required: Yes
- Type: string
Source type from which the media artifacts will be captured. A Chime SDK Meeting is the only supported source.
Result Syntax
[ 'MediaCapturePipeline' => [ 'ChimeSdkMeetingConfiguration' => [ 'ArtifactsConfiguration' => [ 'Audio' => [ 'MuxType' => 'AudioOnly|AudioWithActiveSpeakerVideo', ], 'Content' => [ 'MuxType' => 'ContentOnly', 'State' => 'Enabled|Disabled', ], 'Video' => [ 'MuxType' => 'VideoOnly', 'State' => 'Enabled|Disabled', ], ], 'SourceConfiguration' => [ 'SelectedVideoStreams' => [ 'AttendeeIds' => ['<string>', ...], 'ExternalUserIds' => ['<string>', ...], ], ], ], 'CreatedTimestamp' => <DateTime>, 'MediaPipelineId' => '<string>', 'SinkArn' => '<string>', 'SinkType' => 'S3Bucket', 'SourceArn' => '<string>', 'SourceType' => 'ChimeSdkMeeting', 'Status' => 'Initializing|InProgress|Failed|Stopping|Stopped', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- MediaCapturePipeline
-
- Type: MediaCapturePipeline structure
A media capture pipeline object, the ID, source type, source ARN, sink type, and sink ARN of a media capture pipeline object.
Errors
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateMeeting
$result = $client->createMeeting
([/* ... */]); $promise = $client->createMeetingAsync
([/* ... */]);
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.
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.
Parameter Syntax
$result = $client->createMeeting([ 'ClientRequestToken' => '<string>', // REQUIRED 'ExternalMeetingId' => '<string>', 'MediaRegion' => '<string>', 'MeetingHostId' => '<string>', 'NotificationsConfiguration' => [ 'SnsTopicArn' => '<string>', 'SqsQueueArn' => '<string>', ], 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- ClientRequestToken
-
- Required: Yes
- Type: string
The unique identifier for the client request. Use a different token for different meetings.
- ExternalMeetingId
-
- Type: string
The external meeting ID.
- MediaRegion
-
- Type: 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
. - MeetingHostId
-
- Type: string
Reserved.
- NotificationsConfiguration
-
- Type: MeetingNotificationConfiguration structure
The configuration for resource targets to receive notifications when meeting and attendee events occur.
- Tags
-
- Type: Array of Tag structures
The tag key-value pairs.
Result Syntax
[ 'Meeting' => [ 'ExternalMeetingId' => '<string>', 'MediaPlacement' => [ 'AudioFallbackUrl' => '<string>', 'AudioHostUrl' => '<string>', 'EventIngestionUrl' => '<string>', 'ScreenDataUrl' => '<string>', 'ScreenSharingUrl' => '<string>', 'ScreenViewingUrl' => '<string>', 'SignalingUrl' => '<string>', 'TurnControlUrl' => '<string>', ], 'MediaRegion' => '<string>', 'MeetingId' => '<string>', ], ]
Result Details
Members
- Meeting
-
- Type: Meeting structure
The meeting information, including the meeting ID and
MediaPlacement
.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateMeetingDialOut
$result = $client->createMeetingDialOut
([/* ... */]); $promise = $client->createMeetingDialOutAsync
([/* ... */]);
Uses the join token and call metadata in a meeting request (From number, To number, and so forth) to initiate an outbound call to a public switched telephone network (PSTN) and join them into a Chime meeting. Also ensures that the From number belongs to the customer.
To play welcome audio or implement an interactive voice response (IVR), use the CreateSipMediaApplicationCall
action with the corresponding SIP media application ID.
This API is is not available in a dedicated namespace.
Parameter Syntax
$result = $client->createMeetingDialOut([ 'FromPhoneNumber' => '<string>', // REQUIRED 'JoinToken' => '<string>', // REQUIRED 'MeetingId' => '<string>', // REQUIRED 'ToPhoneNumber' => '<string>', // REQUIRED ]);
Parameter Details
Members
- FromPhoneNumber
-
- Required: Yes
- Type: string
Phone number used as the caller ID when the remote party receives a call.
- JoinToken
-
- Required: Yes
- Type: string
Token used by the Amazon Chime SDK attendee. Call the CreateAttendee action to get a join token.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
- ToPhoneNumber
-
- Required: Yes
- Type: string
Phone number called when inviting someone to a meeting.
Result Syntax
[ 'TransactionId' => '<string>', ]
Result Details
Members
- TransactionId
-
- Type: string
Unique ID that tracks API calls.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateMeetingWithAttendees
$result = $client->createMeetingWithAttendees
([/* ... */]); $promise = $client->createMeetingWithAttendeesAsync
([/* ... */]);
Creates a new Amazon Chime SDK meeting in the specified media Region, with 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 .
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateMeetingWithAttendees, 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.
Parameter Syntax
$result = $client->createMeetingWithAttendees([ 'Attendees' => [ [ 'ExternalUserId' => '<string>', // REQUIRED 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ], // ... ], 'ClientRequestToken' => '<string>', // REQUIRED 'ExternalMeetingId' => '<string>', 'MediaRegion' => '<string>', 'MeetingHostId' => '<string>', 'NotificationsConfiguration' => [ 'SnsTopicArn' => '<string>', 'SqsQueueArn' => '<string>', ], 'Tags' => [ [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- Attendees
-
- Type: Array of CreateAttendeeRequestItem structures
The request containing the attendees to create.
- ClientRequestToken
-
- Required: Yes
- Type: string
The unique identifier for the client request. Use a different token for different meetings.
- ExternalMeetingId
-
- Type: string
The external meeting ID.
- MediaRegion
-
- Type: 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
. - MeetingHostId
-
- Type: string
Reserved.
- NotificationsConfiguration
-
- Type: MeetingNotificationConfiguration structure
The resource target configurations for receiving Amazon Chime SDK meeting and attendee event notifications. The Amazon Chime SDK supports resource targets located in the US East (N. Virginia) AWS Region (us-east-1).
- Tags
-
- Type: Array of Tag structures
The tag key-value pairs.
Result Syntax
[ 'Attendees' => [ [ 'AttendeeId' => '<string>', 'ExternalUserId' => '<string>', 'JoinToken' => '<string>', ], // ... ], 'Errors' => [ [ 'ErrorCode' => '<string>', 'ErrorMessage' => '<string>', 'ExternalUserId' => '<string>', ], // ... ], 'Meeting' => [ 'ExternalMeetingId' => '<string>', 'MediaPlacement' => [ 'AudioFallbackUrl' => '<string>', 'AudioHostUrl' => '<string>', 'EventIngestionUrl' => '<string>', 'ScreenDataUrl' => '<string>', 'ScreenSharingUrl' => '<string>', 'ScreenViewingUrl' => '<string>', 'SignalingUrl' => '<string>', 'TurnControlUrl' => '<string>', ], 'MediaRegion' => '<string>', 'MeetingId' => '<string>', ], ]
Result Details
Members
- Attendees
-
- Type: Array of Attendee structures
The attendee information, including attendees IDs and join tokens.
- Errors
-
- Type: Array of CreateAttendeeError structures
If the action fails for one or more of the attendees in the request, a list of the attendees is returned, along with error codes and error messages.
- Meeting
-
- Type: Meeting structure
A meeting created using the Amazon Chime SDK.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreatePhoneNumberOrder
$result = $client->createPhoneNumberOrder
([/* ... */]); $promise = $client->createPhoneNumberOrderAsync
([/* ... */]);
Creates an order for phone numbers to be provisioned. For toll-free numbers, you cannot use the Amazon Chime Business Calling product type. For numbers outside the U.S., you must use the Amazon Chime SIP Media Application Dial-In product type.
Parameter Syntax
$result = $client->createPhoneNumberOrder([ 'E164PhoneNumbers' => ['<string>', ...], // REQUIRED 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', // REQUIRED ]);
Parameter Details
Members
- E164PhoneNumbers
-
- Required: Yes
- Type: Array of strings
List of phone numbers, in E.164 format.
- ProductType
-
- Required: Yes
- Type: string
The phone number product type.
Result Syntax
[ 'PhoneNumberOrder' => [ 'CreatedTimestamp' => <DateTime>, 'OrderedPhoneNumbers' => [ [ 'E164PhoneNumber' => '<string>', 'Status' => 'Processing|Acquired|Failed', ], // ... ], 'PhoneNumberOrderId' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'Processing|Successful|Failed|Partial', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- PhoneNumberOrder
-
- Type: PhoneNumberOrder structure
The phone number order details.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateProxySession
$result = $client->createProxySession
([/* ... */]); $promise = $client->createProxySessionAsync
([/* ... */]);
Creates a proxy session on the specified Amazon Chime Voice Connector for the specified participant phone numbers.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateProxySession, 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.
Parameter Syntax
$result = $client->createProxySession([ 'Capabilities' => ['<string>', ...], // REQUIRED 'ExpiryMinutes' => <integer>, 'GeoMatchLevel' => 'Country|AreaCode', 'GeoMatchParams' => [ 'AreaCode' => '<string>', // REQUIRED 'Country' => '<string>', // REQUIRED ], 'Name' => '<string>', 'NumberSelectionBehavior' => 'PreferSticky|AvoidSticky', 'ParticipantPhoneNumbers' => ['<string>', ...], // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Capabilities
-
- Required: Yes
- Type: Array of strings
The proxy session capabilities.
- ExpiryMinutes
-
- Type: int
The number of minutes allowed for the proxy session.
- GeoMatchLevel
-
- Type: string
The preference for matching the country or area code of the proxy phone number with that of the first participant.
- GeoMatchParams
-
- Type: GeoMatchParams structure
The country and area code for the proxy phone number.
- Name
-
- Type: string
The name of the proxy session.
- NumberSelectionBehavior
-
- Type: string
The preference for proxy phone number reuse, or stickiness, between the same participants across sessions.
- ParticipantPhoneNumbers
-
- Required: Yes
- Type: Array of strings
The participant phone numbers.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime voice connector ID.
Result Syntax
[ 'ProxySession' => [ 'Capabilities' => ['<string>', ...], 'CreatedTimestamp' => <DateTime>, 'EndedTimestamp' => <DateTime>, 'ExpiryMinutes' => <integer>, 'GeoMatchLevel' => 'Country|AreaCode', 'GeoMatchParams' => [ 'AreaCode' => '<string>', 'Country' => '<string>', ], 'Name' => '<string>', 'NumberSelectionBehavior' => 'PreferSticky|AvoidSticky', 'Participants' => [ [ 'PhoneNumber' => '<string>', 'ProxyPhoneNumber' => '<string>', ], // ... ], 'ProxySessionId' => '<string>', 'Status' => 'Open|InProgress|Closed', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorId' => '<string>', ], ]
Result Details
Members
- ProxySession
-
- Type: ProxySession structure
The proxy session details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateRoom
$result = $client->createRoom
([/* ... */]); $promise = $client->createRoomAsync
([/* ... */]);
Creates a chat room for the specified Amazon Chime Enterprise account.
Parameter Syntax
$result = $client->createRoom([ 'AccountId' => '<string>', // REQUIRED 'ClientRequestToken' => '<string>', 'Name' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- ClientRequestToken
-
- Type: string
The idempotency token for the request.
- Name
-
- Required: Yes
- Type: string
The room name.
Result Syntax
[ 'Room' => [ 'AccountId' => '<string>', 'CreatedBy' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'RoomId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- Room
-
- Type: Room structure
The room details.
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateRoomMembership
$result = $client->createRoomMembership
([/* ... */]); $promise = $client->createRoomMembershipAsync
([/* ... */]);
Adds a member to a chat room in an Amazon Chime Enterprise account. A member can be either a user or a bot. The member role designates whether the member is a chat room administrator or a general chat room member.
Parameter Syntax
$result = $client->createRoomMembership([ 'AccountId' => '<string>', // REQUIRED 'MemberId' => '<string>', // REQUIRED 'Role' => 'Administrator|Member', 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MemberId
-
- Required: Yes
- Type: string
The Amazon Chime member ID (user ID or bot ID).
- Role
-
- Type: string
The role of the member.
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[ 'RoomMembership' => [ 'InvitedBy' => '<string>', 'Member' => [ 'AccountId' => '<string>', 'Email' => '<string>', 'FullName' => '<string>', 'MemberId' => '<string>', 'MemberType' => 'User|Bot|Webhook', ], 'Role' => 'Administrator|Member', 'RoomId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- RoomMembership
-
- Type: RoomMembership structure
The room membership details.
Errors
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateSipMediaApplication
$result = $client->createSipMediaApplication
([/* ... */]); $promise = $client->createSipMediaApplicationAsync
([/* ... */]);
Creates a SIP media application.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateSipMediaApplication, 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.
Parameter Syntax
$result = $client->createSipMediaApplication([ 'AwsRegion' => '<string>', // REQUIRED 'Endpoints' => [ // REQUIRED [ 'LambdaArn' => '<string>', ], // ... ], 'Name' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AwsRegion
-
- Required: Yes
- Type: string
The AWS Region assigned to the SIP media application.
- Endpoints
-
- Required: Yes
- Type: Array of SipMediaApplicationEndpoint structures
List of endpoints (Lambda Amazon Resource Names) specified for the SIP media application. Currently, only one endpoint is supported.
- Name
-
- Required: Yes
- Type: string
The SIP media application name.
Result Syntax
[ 'SipMediaApplication' => [ 'AwsRegion' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Endpoints' => [ [ 'LambdaArn' => '<string>', ], // ... ], 'Name' => '<string>', 'SipMediaApplicationId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- SipMediaApplication
-
- Type: SipMediaApplication structure
The SIP media application details.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateSipMediaApplicationCall
$result = $client->createSipMediaApplicationCall
([/* ... */]); $promise = $client->createSipMediaApplicationCallAsync
([/* ... */]);
Creates an outbound call to a phone number from the phone number specified in the request, and it invokes the endpoint of the specified sipMediaApplicationId
.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateSipMediaApplicationCall, 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.
Parameter Syntax
$result = $client->createSipMediaApplicationCall([ 'FromPhoneNumber' => '<string>', // REQUIRED 'SipHeaders' => ['<string>', ...], 'SipMediaApplicationId' => '<string>', // REQUIRED 'ToPhoneNumber' => '<string>', // REQUIRED ]);
Parameter Details
Members
- FromPhoneNumber
-
- Required: Yes
- Type: string
The phone number that a user calls from. This is a phone number in your Amazon Chime phone number inventory.
- SipHeaders
-
- Type: Associative array of custom strings keys (SensitiveString) to strings
The SIP headers added to an outbound call leg.
- SipMediaApplicationId
-
- Required: Yes
- Type: string
The ID of the SIP media application.
- ToPhoneNumber
-
- Required: Yes
- Type: string
The phone number that the service should call.
Result Syntax
[ 'SipMediaApplicationCall' => [ 'TransactionId' => '<string>', ], ]
Result Details
Members
- SipMediaApplicationCall
-
- Type: SipMediaApplicationCall structure
The actual call.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateSipRule
$result = $client->createSipRule
([/* ... */]); $promise = $client->createSipRuleAsync
([/* ... */]);
Creates a SIP rule which can be used to run a SIP media application as a target for a specific trigger type.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateSipRule, 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.
Parameter Syntax
$result = $client->createSipRule([ 'Disabled' => true || false, 'Name' => '<string>', // REQUIRED 'TargetApplications' => [ // REQUIRED [ 'AwsRegion' => '<string>', 'Priority' => <integer>, 'SipMediaApplicationId' => '<string>', ], // ... ], 'TriggerType' => 'ToPhoneNumber|RequestUriHostname', // REQUIRED 'TriggerValue' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Disabled
-
- Type: boolean
Enables or disables a rule. You must disable rules before you can delete them.
- Name
-
- Required: Yes
- Type: string
The name of the SIP rule.
- TargetApplications
-
- Required: Yes
- Type: Array of SipRuleTargetApplication structures
List of SIP media applications with priority and AWS Region. Only one SIP application per AWS Region can be used.
- TriggerType
-
- Required: Yes
- Type: string
The type of trigger assigned to the SIP rule in
TriggerValue
, currentlyRequestUriHostname
orToPhoneNumber
. - TriggerValue
-
- Required: Yes
- Type: string
If
TriggerType
isRequestUriHostname
, the value can be the outbound host name of an Amazon Chime Voice Connector. IfTriggerType
isToPhoneNumber
, the value can be a customer-owned phone number in the E164 format. TheSipMediaApplication
specified in theSipRule
is triggered if the request URI in an incoming SIP request matches theRequestUriHostname
, or if theTo
header in the incoming SIP request matches theToPhoneNumber
value.
Result Syntax
[ 'SipRule' => [ 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'Name' => '<string>', 'SipRuleId' => '<string>', 'TargetApplications' => [ [ 'AwsRegion' => '<string>', 'Priority' => <integer>, 'SipMediaApplicationId' => '<string>', ], // ... ], 'TriggerType' => 'ToPhoneNumber|RequestUriHostname', 'TriggerValue' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- SipRule
-
- Type: SipRule structure
Returns the SIP rule information, including the rule ID, triggers, and target applications.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateUser
$result = $client->createUser
([/* ... */]); $promise = $client->createUserAsync
([/* ... */]);
Creates a user under the specified Amazon Chime account.
Parameter Syntax
$result = $client->createUser([ 'AccountId' => '<string>', // REQUIRED 'Email' => '<string>', 'UserType' => 'PrivateUser|SharedDevice', 'Username' => '<string>', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
-
- Type: string
The user's email address.
- UserType
-
- Type: string
The user type.
- Username
-
- Type: string
The user name.
Result Syntax
[ 'User' => [ 'AccountId' => '<string>', 'AlexaForBusinessMetadata' => [ 'AlexaForBusinessRoomArn' => '<string>', 'IsAlexaForBusinessEnabled' => true || false, ], 'DisplayName' => '<string>', 'InvitedOn' => <DateTime>, 'LicenseType' => 'Basic|Plus|Pro|ProTrial', 'PersonalPIN' => '<string>', 'PrimaryEmail' => '<string>', 'PrimaryProvisionedNumber' => '<string>', 'RegisteredOn' => <DateTime>, 'UserId' => '<string>', 'UserInvitationStatus' => 'Pending|Accepted|Failed', 'UserRegistrationStatus' => 'Unregistered|Registered|Suspended', 'UserType' => 'PrivateUser|SharedDevice', ], ]
Result Details
Members
- User
-
- Type: User structure
The user on the Amazon Chime account.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateVoiceConnector
$result = $client->createVoiceConnector
([/* ... */]); $promise = $client->createVoiceConnectorAsync
([/* ... */]);
Creates an Amazon Chime Voice Connector under the administrator's AWS account. You can choose to create an Amazon Chime Voice Connector in a specific AWS Region.
Enabling CreateVoiceConnectorRequest$RequireEncryption configures your Amazon Chime Voice Connector to use TLS transport for SIP signaling and Secure RTP (SRTP) for media. Inbound calls use TLS transport, and unencrypted outbound calls are blocked.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateVoiceConnector, 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.
Parameter Syntax
$result = $client->createVoiceConnector([ 'AwsRegion' => 'us-east-1|us-west-2', 'Name' => '<string>', // REQUIRED 'RequireEncryption' => true || false, // REQUIRED ]);
Parameter Details
Members
- AwsRegion
-
- Type: string
The AWS Region in which the Amazon Chime Voice Connector is created. Default value:
us-east-1
. - Name
-
- Required: Yes
- Type: string
The name of the Amazon Chime Voice Connector.
- RequireEncryption
-
- Required: Yes
- Type: boolean
When enabled, requires encryption for the Amazon Chime Voice Connector.
Result Syntax
[ 'VoiceConnector' => [ 'AwsRegion' => 'us-east-1|us-west-2', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'OutboundHostName' => '<string>', 'RequireEncryption' => true || false, 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorArn' => '<string>', 'VoiceConnectorId' => '<string>', ], ]
Result Details
Members
- VoiceConnector
-
- Type: VoiceConnector structure
The Amazon Chime Voice Connector details.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
CreateVoiceConnectorGroup
$result = $client->createVoiceConnectorGroup
([/* ... */]); $promise = $client->createVoiceConnectorGroupAsync
([/* ... */]);
Creates an Amazon Chime Voice Connector group under the administrator's AWS account. You can associate Amazon Chime Voice Connectors with the Amazon Chime Voice Connector group by including VoiceConnectorItems
in the request.
You can include Amazon Chime Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.
This API is is no longer supported and will not be updated. We recommend using the latest version, CreateVoiceConnectorGroup, 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.
Parameter Syntax
$result = $client->createVoiceConnectorGroup([ 'Name' => '<string>', // REQUIRED 'VoiceConnectorItems' => [ [ 'Priority' => <integer>, // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- Name
-
- Required: Yes
- Type: string
The name of the Amazon Chime Voice Connector group.
- VoiceConnectorItems
-
- Type: Array of VoiceConnectorItem structures
The Amazon Chime Voice Connectors to route inbound calls to.
Result Syntax
[ 'VoiceConnectorGroup' => [ 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorGroupArn' => '<string>', 'VoiceConnectorGroupId' => '<string>', 'VoiceConnectorItems' => [ [ 'Priority' => <integer>, 'VoiceConnectorId' => '<string>', ], // ... ], ], ]
Result Details
Members
- VoiceConnectorGroup
-
- Type: VoiceConnectorGroup structure
The Amazon Chime Voice Connector group details.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteAccount
$result = $client->deleteAccount
([/* ... */]); $promise = $client->deleteAccountAsync
([/* ... */]);
Deletes the specified Amazon Chime account. You must suspend all users before deleting Team
account. You can use the BatchSuspendUser action to dodo.
For EnterpriseLWA
and EnterpriseAD
accounts, you must release the claimed domains for your Amazon Chime account before deletion. As soon as you release the domain, all users under that account are suspended.
Deleted accounts appear in your Disabled
accounts list for 90 days. To restore deleted account from your Disabled
accounts list, you must contact AWS Support.
After 90 days, deleted accounts are permanently removed from your Disabled
accounts list.
Parameter Syntax
$result = $client->deleteAccount([ 'AccountId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnprocessableEntityException:
The request was well-formed but was unable to be followed due to semantic errors.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteAppInstance
$result = $client->deleteAppInstance
([/* ... */]); $promise = $client->deleteAppInstanceAsync
([/* ... */]);
Deletes an AppInstance
and all associated data asynchronously.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteAppInstance, 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.
Parameter Syntax
$result = $client->deleteAppInstance([ 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteAppInstanceAdmin
$result = $client->deleteAppInstanceAdmin
([/* ... */]); $promise = $client->deleteAppInstanceAdminAsync
([/* ... */]);
Demotes an AppInstanceAdmin
to an AppInstanceUser
. This action does not delete the user.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteAppInstanceAdmin, 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.
Parameter Syntax
$result = $client->deleteAppInstanceAdmin([ 'AppInstanceAdminArn' => '<string>', // REQUIRED 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceAdminArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
's administrator. - AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteAppInstanceStreamingConfigurations
$result = $client->deleteAppInstanceStreamingConfigurations
([/* ... */]); $promise = $client->deleteAppInstanceStreamingConfigurationsAsync
([/* ... */]);
Deletes the streaming configurations of an AppInstance
.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteAppInstanceStreamingConfigurations, 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.
Parameter Syntax
$result = $client->deleteAppInstanceStreamingConfigurations([ 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the streaming configurations being deleted.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteAppInstanceUser
$result = $client->deleteAppInstanceUser
([/* ... */]); $promise = $client->deleteAppInstanceUserAsync
([/* ... */]);
Deletes an AppInstanceUser
.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteAppInstanceUser, 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.
Parameter Syntax
$result = $client->deleteAppInstanceUser([ 'AppInstanceUserArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceUserArn
-
- Required: Yes
- Type: string
The ARN of the user request being deleted.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteAttendee
$result = $client->deleteAttendee
([/* ... */]); $promise = $client->deleteAttendeeAsync
([/* ... */]);
Deletes an attendee from the specified Amazon Chime SDK meeting and deletes their JoinToken
. Attendees are automatically deleted when a Amazon Chime SDK meeting is deleted. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteAttendee, 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.
Parameter Syntax
$result = $client->deleteAttendee([ 'AttendeeId' => '<string>', // REQUIRED 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AttendeeId
-
- Required: Yes
- Type: string
The Amazon Chime SDK attendee ID.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteChannel
$result = $client->deleteChannel
([/* ... */]); $promise = $client->deleteChannelAsync
([/* ... */]);
Immediately makes a channel and its memberships inaccessible and marks them for deletion. This is an irreversible process.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteChannel, 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.
Parameter Syntax
$result = $client->deleteChannel([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel being deleted.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteChannelBan
$result = $client->deleteChannelBan
([/* ... */]); $promise = $client->deleteChannelBanAsync
([/* ... */]);
Removes a user from a channel's ban list.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteChannelBan, 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.
Parameter Syntax
$result = $client->deleteChannelBan([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MemberArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel from which the
AppInstanceUser
was banned. - ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MemberArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstanceUser
that you want to reinstate.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteChannelMembership
$result = $client->deleteChannelMembership
([/* ... */]); $promise = $client->deleteChannelMembershipAsync
([/* ... */]);
Removes a member from a channel.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteChannelMembership, 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.
Parameter Syntax
$result = $client->deleteChannelMembership([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MemberArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel from which you want to remove the user.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MemberArn
-
- Required: Yes
- Type: string
The ARN of the member that you're removing from the channel.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteChannelMessage
$result = $client->deleteChannelMessage
([/* ... */]); $promise = $client->deleteChannelMessageAsync
([/* ... */]);
Deletes a channel message. Only admins can perform this action. Deletion makes messages inaccessible immediately. A background process deletes any revisions created by UpdateChannelMessage
.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteChannelMessage, 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.
Parameter Syntax
$result = $client->deleteChannelMessage([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MessageId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MessageId
-
- Required: Yes
- Type: string
The ID of the message being deleted.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteChannelModerator
$result = $client->deleteChannelModerator
([/* ... */]); $promise = $client->deleteChannelModeratorAsync
([/* ... */]);
Deletes a channel moderator.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteChannelModerator, 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.
Parameter Syntax
$result = $client->deleteChannelModerator([ 'ChannelArn' => '<string>', // REQUIRED 'ChannelModeratorArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChannelModeratorArn
-
- Required: Yes
- Type: string
The ARN of the moderator being deleted.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteEventsConfiguration
$result = $client->deleteEventsConfiguration
([/* ... */]); $promise = $client->deleteEventsConfigurationAsync
([/* ... */]);
Deletes the events configuration that allows a bot to receive outgoing events.
Parameter Syntax
$result = $client->deleteEventsConfiguration([ 'AccountId' => '<string>', // REQUIRED 'BotId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- BotId
-
- Required: Yes
- Type: string
The bot ID.
Result Syntax
[]
Result Details
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
DeleteMediaCapturePipeline
$result = $client->deleteMediaCapturePipeline
([/* ... */]); $promise = $client->deleteMediaCapturePipelineAsync
([/* ... */]);
Deletes the media capture pipeline.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteMediaCapturePipeline, 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.
Parameter Syntax
$result = $client->deleteMediaCapturePipeline([ 'MediaPipelineId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MediaPipelineId
-
- Required: Yes
- Type: string
The ID of the media capture pipeline being deleted.
Result Syntax
[]
Result Details
Errors
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteMeeting
$result = $client->deleteMeeting
([/* ... */]); $promise = $client->deleteMeetingAsync
([/* ... */]);
Deletes the specified Amazon Chime SDK meeting. The operation deletes all attendees, disconnects all clients, and prevents new clients from joining the meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteMeeting, 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.
Parameter Syntax
$result = $client->deleteMeeting([ 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeletePhoneNumber
$result = $client->deletePhoneNumber
([/* ... */]); $promise = $client->deletePhoneNumberAsync
([/* ... */]);
Moves the specified phone number into the Deletion queue. A phone number must be disassociated from any users or Amazon Chime Voice Connectors before it can be deleted.
Deleted phone numbers remain in the Deletion queue for 7 days before they are deleted permanently.
Parameter Syntax
$result = $client->deletePhoneNumber([ 'PhoneNumberId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- PhoneNumberId
-
- Required: Yes
- Type: string
The phone number ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteProxySession
$result = $client->deleteProxySession
([/* ... */]); $promise = $client->deleteProxySessionAsync
([/* ... */]);
Deletes the specified proxy session from the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteProxySession, 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.
Parameter Syntax
$result = $client->deleteProxySession([ 'ProxySessionId' => '<string>', // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ProxySessionId
-
- Required: Yes
- Type: string
The proxy session ID.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime voice connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteRoom
$result = $client->deleteRoom
([/* ... */]); $promise = $client->deleteRoomAsync
([/* ... */]);
Deletes a chat room in an Amazon Chime Enterprise account.
Parameter Syntax
$result = $client->deleteRoom([ 'AccountId' => '<string>', // REQUIRED 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- RoomId
-
- Required: Yes
- Type: string
The chat room ID.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteRoomMembership
$result = $client->deleteRoomMembership
([/* ... */]); $promise = $client->deleteRoomMembershipAsync
([/* ... */]);
Removes a member from a chat room in an Amazon Chime Enterprise account.
Parameter Syntax
$result = $client->deleteRoomMembership([ 'AccountId' => '<string>', // REQUIRED 'MemberId' => '<string>', // REQUIRED 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MemberId
-
- Required: Yes
- Type: string
The member ID (user ID or bot ID).
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteSipMediaApplication
$result = $client->deleteSipMediaApplication
([/* ... */]); $promise = $client->deleteSipMediaApplicationAsync
([/* ... */]);
Deletes a SIP media application.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteSipMediaApplication, 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.
Parameter Syntax
$result = $client->deleteSipMediaApplication([ 'SipMediaApplicationId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- SipMediaApplicationId
-
- Required: Yes
- Type: string
The SIP media application ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteSipRule
$result = $client->deleteSipRule
([/* ... */]); $promise = $client->deleteSipRuleAsync
([/* ... */]);
Deletes a SIP rule. You must disable a SIP rule before you can delete it.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteSipRule, 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.
Parameter Syntax
$result = $client->deleteSipRule([ 'SipRuleId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- SipRuleId
-
- Required: Yes
- Type: string
The SIP rule ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnector
$result = $client->deleteVoiceConnector
([/* ... */]); $promise = $client->deleteVoiceConnectorAsync
([/* ... */]);
Deletes the specified Amazon Chime Voice Connector. Any phone numbers associated with the Amazon Chime Voice Connector must be disassociated from it before it can be deleted.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceConnector, 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.
Parameter Syntax
$result = $client->deleteVoiceConnector([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnectorEmergencyCallingConfiguration
$result = $client->deleteVoiceConnectorEmergencyCallingConfiguration
([/* ... */]); $promise = $client->deleteVoiceConnectorEmergencyCallingConfigurationAsync
([/* ... */]);
Deletes the emergency calling configuration details from the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceConnectorEmergencyCallingConfiguration, 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.
Parameter Syntax
$result = $client->deleteVoiceConnectorEmergencyCallingConfiguration([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnectorGroup
$result = $client->deleteVoiceConnectorGroup
([/* ... */]); $promise = $client->deleteVoiceConnectorGroupAsync
([/* ... */]);
Deletes the specified Amazon Chime Voice Connector group. Any VoiceConnectorItems
and phone numbers associated with the group must be removed before it can be deleted.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceConnectorGroup, 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.
Parameter Syntax
$result = $client->deleteVoiceConnectorGroup([ 'VoiceConnectorGroupId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorGroupId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector group ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnectorOrigination
$result = $client->deleteVoiceConnectorOrigination
([/* ... */]); $promise = $client->deleteVoiceConnectorOriginationAsync
([/* ... */]);
Deletes the origination settings for the specified Amazon Chime Voice Connector.
If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to deleting the origination settings.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceConnectorOrigination, 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.
Parameter Syntax
$result = $client->deleteVoiceConnectorOrigination([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnectorProxy
$result = $client->deleteVoiceConnectorProxy
([/* ... */]); $promise = $client->deleteVoiceConnectorProxyAsync
([/* ... */]);
Deletes the proxy configuration from the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceProxy, 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.
Parameter Syntax
$result = $client->deleteVoiceConnectorProxy([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnectorStreamingConfiguration
$result = $client->deleteVoiceConnectorStreamingConfiguration
([/* ... */]); $promise = $client->deleteVoiceConnectorStreamingConfigurationAsync
([/* ... */]);
Deletes the streaming configuration for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceConnectorStreamingConfiguration, 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.
Parameter Syntax
$result = $client->deleteVoiceConnectorStreamingConfiguration([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnectorTermination
$result = $client->deleteVoiceConnectorTermination
([/* ... */]); $promise = $client->deleteVoiceConnectorTerminationAsync
([/* ... */]);
Deletes the termination settings for the specified Amazon Chime Voice Connector.
If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to deleting the termination settings.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceConnectorTermination, 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.
Parameter Syntax
$result = $client->deleteVoiceConnectorTermination([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DeleteVoiceConnectorTerminationCredentials
$result = $client->deleteVoiceConnectorTerminationCredentials
([/* ... */]); $promise = $client->deleteVoiceConnectorTerminationCredentialsAsync
([/* ... */]);
Deletes the specified SIP credentials used by your equipment to authenticate during call termination.
This API is is no longer supported and will not be updated. We recommend using the latest version, DeleteVoiceConnectorTerminationCredentials, 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.
Parameter Syntax
$result = $client->deleteVoiceConnectorTerminationCredentials([ 'Usernames' => ['<string>', ...], // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Usernames
-
- Required: Yes
- Type: Array of strings
The RFC2617 compliant username associated with the SIP credentials, in US-ASCII format.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeAppInstance
$result = $client->describeAppInstance
([/* ... */]); $promise = $client->describeAppInstanceAsync
([/* ... */]);
Returns the full details of an AppInstance
.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeAppInstance, 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.
Parameter Syntax
$result = $client->describeAppInstance([ 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
.
Result Syntax
[ 'AppInstance' => [ 'AppInstanceArn' => '<string>', 'CreatedTimestamp' => <DateTime>, 'LastUpdatedTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Name' => '<string>', ], ]
Result Details
Members
- AppInstance
-
- Type: AppInstance structure
The ARN, metadata, created and last-updated timestamps, and the name of the
AppInstance
. All timestamps use epoch milliseconds.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeAppInstanceAdmin
$result = $client->describeAppInstanceAdmin
([/* ... */]); $promise = $client->describeAppInstanceAdminAsync
([/* ... */]);
Returns the full details of an AppInstanceAdmin
.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeAppInstanceAdmin, 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.
Parameter Syntax
$result = $client->describeAppInstanceAdmin([ 'AppInstanceAdminArn' => '<string>', // REQUIRED 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceAdminArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstanceAdmin
. - AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
.
Result Syntax
[ 'AppInstanceAdmin' => [ 'Admin' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'AppInstanceArn' => '<string>', 'CreatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- AppInstanceAdmin
-
- Type: AppInstanceAdmin structure
The ARN and name of the
AppInstanceUser
, the ARN of theAppInstance
, and the created and last-updated timestamps. All timestamps use epoch milliseconds.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeAppInstanceUser
$result = $client->describeAppInstanceUser
([/* ... */]); $promise = $client->describeAppInstanceUserAsync
([/* ... */]);
Returns the full details of an AppInstanceUser
.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeAppInstanceUser, 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.
Parameter Syntax
$result = $client->describeAppInstanceUser([ 'AppInstanceUserArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceUserArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstanceUser
.
Result Syntax
[ 'AppInstanceUser' => [ 'AppInstanceUserArn' => '<string>', 'CreatedTimestamp' => <DateTime>, 'LastUpdatedTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Name' => '<string>', ], ]
Result Details
Members
- AppInstanceUser
-
- Type: AppInstanceUser structure
The name of the
AppInstanceUser
.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeChannel
$result = $client->describeChannel
([/* ... */]); $promise = $client->describeChannelAsync
([/* ... */]);
Returns the full details of a channel in an Amazon Chime AppInstance
.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeChannel, 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.
Parameter Syntax
$result = $client->describeChannel([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[ 'Channel' => [ 'ChannelArn' => '<string>', 'CreatedBy' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'CreatedTimestamp' => <DateTime>, 'LastMessageTimestamp' => <DateTime>, 'LastUpdatedTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', 'Name' => '<string>', 'Privacy' => 'PUBLIC|PRIVATE', ], ]
Result Details
Members
- Channel
-
- Type: Channel structure
The channel details.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeChannelBan
$result = $client->describeChannelBan
([/* ... */]); $promise = $client->describeChannelBanAsync
([/* ... */]);
Returns the full details of a channel ban.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeChannelBan, 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.
Parameter Syntax
$result = $client->describeChannelBan([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MemberArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel from which the user is banned.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MemberArn
-
- Required: Yes
- Type: string
The ARN of the member being banned.
Result Syntax
[ 'ChannelBan' => [ 'ChannelArn' => '<string>', 'CreatedBy' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'CreatedTimestamp' => <DateTime>, 'Member' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ], ]
Result Details
Members
- ChannelBan
-
- Type: ChannelBan structure
The details of the ban.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeChannelMembership
$result = $client->describeChannelMembership
([/* ... */]); $promise = $client->describeChannelMembershipAsync
([/* ... */]);
Returns the full details of a user's channel membership.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeChannelMembership, 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.
Parameter Syntax
$result = $client->describeChannelMembership([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MemberArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MemberArn
-
- Required: Yes
- Type: string
The ARN of the member.
Result Syntax
[ 'ChannelMembership' => [ 'ChannelArn' => '<string>', 'CreatedTimestamp' => <DateTime>, 'InvitedBy' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'LastUpdatedTimestamp' => <DateTime>, 'Member' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'Type' => 'DEFAULT|HIDDEN', ], ]
Result Details
Members
- ChannelMembership
-
- Type: ChannelMembership structure
The details of the membership.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeChannelMembershipForAppInstanceUser
$result = $client->describeChannelMembershipForAppInstanceUser
([/* ... */]); $promise = $client->describeChannelMembershipForAppInstanceUserAsync
([/* ... */]);
Returns the details of a channel based on the membership of the specified AppInstanceUser
.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeChannelMembershipForAppInstanceUser, 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.
Parameter Syntax
$result = $client->describeChannelMembershipForAppInstanceUser([ 'AppInstanceUserArn' => '<string>', // REQUIRED 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- AppInstanceUserArn
-
- Required: Yes
- Type: string
The ARN of the user in a channel.
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel to which the user belongs.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[ 'ChannelMembership' => [ 'AppInstanceUserMembershipSummary' => [ 'ReadMarkerTimestamp' => <DateTime>, 'Type' => 'DEFAULT|HIDDEN', ], 'ChannelSummary' => [ 'ChannelArn' => '<string>', 'LastMessageTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', 'Name' => '<string>', 'Privacy' => 'PUBLIC|PRIVATE', ], ], ]
Result Details
Members
- ChannelMembership
-
- Type: ChannelMembershipForAppInstanceUserSummary structure
The channel to which a user belongs.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeChannelModeratedByAppInstanceUser
$result = $client->describeChannelModeratedByAppInstanceUser
([/* ... */]); $promise = $client->describeChannelModeratedByAppInstanceUserAsync
([/* ... */]);
Returns the full details of a channel moderated by the specified AppInstanceUser
.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeChannelModeratedByAppInstanceUser, 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.
Parameter Syntax
$result = $client->describeChannelModeratedByAppInstanceUser([ 'AppInstanceUserArn' => '<string>', // REQUIRED 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- AppInstanceUserArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstanceUser
in the moderated channel. - ChannelArn
-
- Required: Yes
- Type: string
The ARN of the moderated channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[ 'Channel' => [ 'ChannelSummary' => [ 'ChannelArn' => '<string>', 'LastMessageTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', 'Name' => '<string>', 'Privacy' => 'PUBLIC|PRIVATE', ], ], ]
Result Details
Members
- Channel
-
- Type: ChannelModeratedByAppInstanceUserSummary structure
The moderated channel.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DescribeChannelModerator
$result = $client->describeChannelModerator
([/* ... */]); $promise = $client->describeChannelModeratorAsync
([/* ... */]);
Returns the full details of a single ChannelModerator.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, DescribeChannelModerator, 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.
Parameter Syntax
$result = $client->describeChannelModerator([ 'ChannelArn' => '<string>', // REQUIRED 'ChannelModeratorArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChannelModeratorArn
-
- Required: Yes
- Type: string
The ARN of the channel moderator.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[ 'ChannelModerator' => [ 'ChannelArn' => '<string>', 'CreatedBy' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'CreatedTimestamp' => <DateTime>, 'Moderator' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ], ]
Result Details
Members
- ChannelModerator
-
- Type: ChannelModerator structure
The details of the channel moderator.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DisassociatePhoneNumberFromUser
$result = $client->disassociatePhoneNumberFromUser
([/* ... */]); $promise = $client->disassociatePhoneNumberFromUserAsync
([/* ... */]);
Disassociates the primary provisioned phone number from the specified Amazon Chime user.
Parameter Syntax
$result = $client->disassociatePhoneNumberFromUser([ 'AccountId' => '<string>', // REQUIRED 'UserId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserId
-
- Required: Yes
- Type: string
The user ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DisassociatePhoneNumbersFromVoiceConnector
$result = $client->disassociatePhoneNumbersFromVoiceConnector
([/* ... */]); $promise = $client->disassociatePhoneNumbersFromVoiceConnectorAsync
([/* ... */]);
Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, DisassociatePhoneNumbersFromVoiceConnector, 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.
Parameter Syntax
$result = $client->disassociatePhoneNumbersFromVoiceConnector([ 'E164PhoneNumbers' => ['<string>', ...], // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- E164PhoneNumbers
-
- Required: Yes
- Type: Array of strings
List of phone numbers, in E.164 format.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'PhoneNumberErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'PhoneNumberId' => '<string>', ], // ... ], ]
Result Details
Members
- PhoneNumberErrors
-
- Type: Array of PhoneNumberError structures
If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DisassociatePhoneNumbersFromVoiceConnectorGroup
$result = $client->disassociatePhoneNumbersFromVoiceConnectorGroup
([/* ... */]); $promise = $client->disassociatePhoneNumbersFromVoiceConnectorGroupAsync
([/* ... */]);
Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector group.
This API is is no longer supported and will not be updated. We recommend using the latest version, DisassociatePhoneNumbersFromVoiceConnectorGroup, 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.
Parameter Syntax
$result = $client->disassociatePhoneNumbersFromVoiceConnectorGroup([ 'E164PhoneNumbers' => ['<string>', ...], // REQUIRED 'VoiceConnectorGroupId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- E164PhoneNumbers
-
- Required: Yes
- Type: Array of strings
List of phone numbers, in E.164 format.
- VoiceConnectorGroupId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector group ID.
Result Syntax
[ 'PhoneNumberErrors' => [ [ 'ErrorCode' => 'BadRequest|Conflict|Forbidden|NotFound|PreconditionFailed|ResourceLimitExceeded|ServiceFailure|AccessDenied|ServiceUnavailable|Throttled|Throttling|Unauthorized|Unprocessable|VoiceConnectorGroupAssociationsExist|PhoneNumberAssociationsExist', 'ErrorMessage' => '<string>', 'PhoneNumberId' => '<string>', ], // ... ], ]
Result Details
Members
- PhoneNumberErrors
-
- Type: Array of PhoneNumberError structures
If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
DisassociateSigninDelegateGroupsFromAccount
$result = $client->disassociateSigninDelegateGroupsFromAccount
([/* ... */]); $promise = $client->disassociateSigninDelegateGroupsFromAccountAsync
([/* ... */]);
Disassociates the specified sign-in delegate groups from the specified Amazon Chime account.
Parameter Syntax
$result = $client->disassociateSigninDelegateGroupsFromAccount([ 'AccountId' => '<string>', // REQUIRED 'GroupNames' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- GroupNames
-
- Required: Yes
- Type: Array of strings
The sign-in delegate group names.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetAccount
$result = $client->getAccount
([/* ... */]); $promise = $client->getAccountAsync
([/* ... */]);
Retrieves details for the specified Amazon Chime account, such as account type and supported licenses.
Parameter Syntax
$result = $client->getAccount([ 'AccountId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
Result Syntax
[ 'Account' => [ 'AccountId' => '<string>', 'AccountStatus' => 'Suspended|Active', 'AccountType' => 'Team|EnterpriseDirectory|EnterpriseLWA|EnterpriseOIDC', 'AwsAccountId' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DefaultLicense' => 'Basic|Plus|Pro|ProTrial', 'Name' => '<string>', 'SigninDelegateGroups' => [ [ 'GroupName' => '<string>', ], // ... ], 'SupportedLicenses' => ['<string>', ...], ], ]
Result Details
Members
- Account
-
- Type: Account structure
The Amazon Chime account details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetAccountSettings
$result = $client->getAccountSettings
([/* ... */]); $promise = $client->getAccountSettingsAsync
([/* ... */]);
Retrieves account settings for the specified Amazon Chime account ID, such as remote control and dialout settings. For more information about these settings, see Use the Policies Page in the Amazon Chime Administration Guide.
Parameter Syntax
$result = $client->getAccountSettings([ 'AccountId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
Result Syntax
[ 'AccountSettings' => [ 'DisableRemoteControl' => true || false, 'EnableDialOut' => true || false, ], ]
Result Details
Members
- AccountSettings
-
- Type: AccountSettings structure
The Amazon Chime account settings.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetAppInstanceRetentionSettings
$result = $client->getAppInstanceRetentionSettings
([/* ... */]); $promise = $client->getAppInstanceRetentionSettingsAsync
([/* ... */]);
Gets the retention settings for an AppInstance
.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetMessagingRetentionSettings, 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.
Parameter Syntax
$result = $client->getAppInstanceRetentionSettings([ 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
.
Result Syntax
[ 'AppInstanceRetentionSettings' => [ 'ChannelRetentionSettings' => [ 'RetentionDays' => <integer>, ], ], 'InitiateDeletionTimestamp' => <DateTime>, ]
Result Details
Members
- AppInstanceRetentionSettings
-
- Type: AppInstanceRetentionSettings structure
The retention settings for the
AppInstance
. - InitiateDeletionTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp representing the time at which the specified items are retained, in Epoch Seconds.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetAppInstanceStreamingConfigurations
$result = $client->getAppInstanceStreamingConfigurations
([/* ... */]); $promise = $client->getAppInstanceStreamingConfigurationsAsync
([/* ... */]);
Gets the streaming settings for an AppInstance
.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetMessagingStreamingConfigurations, 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.
Parameter Syntax
$result = $client->getAppInstanceStreamingConfigurations([ 'AppInstanceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
.
Result Syntax
[ 'AppInstanceStreamingConfigurations' => [ [ 'AppInstanceDataType' => 'Channel|ChannelMessage', 'ResourceArn' => '<string>', ], // ... ], ]
Result Details
Members
- AppInstanceStreamingConfigurations
-
- Type: Array of AppInstanceStreamingConfiguration structures
The streaming settings.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetAttendee
$result = $client->getAttendee
([/* ... */]); $promise = $client->getAttendeeAsync
([/* ... */]);
Gets the Amazon Chime SDK attendee details for a specified meeting ID and attendee ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetAttendee, 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.
Parameter Syntax
$result = $client->getAttendee([ 'AttendeeId' => '<string>', // REQUIRED 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AttendeeId
-
- Required: Yes
- Type: string
The Amazon Chime SDK attendee ID.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
Result Syntax
[ 'Attendee' => [ 'AttendeeId' => '<string>', 'ExternalUserId' => '<string>', 'JoinToken' => '<string>', ], ]
Result Details
Members
- Attendee
-
- Type: Attendee structure
The Amazon Chime SDK attendee information.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetBot
$result = $client->getBot
([/* ... */]); $promise = $client->getBotAsync
([/* ... */]);
Retrieves details for the specified bot, such as bot email address, bot type, status, and display name.
Parameter Syntax
$result = $client->getBot([ 'AccountId' => '<string>', // REQUIRED 'BotId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- BotId
-
- Required: Yes
- Type: string
The bot ID.
Result Syntax
[ 'Bot' => [ 'BotEmail' => '<string>', 'BotId' => '<string>', 'BotType' => 'ChatBot', 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'DisplayName' => '<string>', 'SecurityToken' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'UserId' => '<string>', ], ]
Result Details
Members
- Bot
-
- Type: Bot structure
The chat bot details.
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
GetChannelMessage
$result = $client->getChannelMessage
([/* ... */]); $promise = $client->getChannelMessageAsync
([/* ... */]);
Gets the full details of a channel message.
The x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetChannelMessage, 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.
Parameter Syntax
$result = $client->getChannelMessage([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MessageId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MessageId
-
- Required: Yes
- Type: string
The ID of the message.
Result Syntax
[ 'ChannelMessage' => [ 'ChannelArn' => '<string>', 'Content' => '<string>', 'CreatedTimestamp' => <DateTime>, 'LastEditedTimestamp' => <DateTime>, 'LastUpdatedTimestamp' => <DateTime>, 'MessageId' => '<string>', 'Metadata' => '<string>', 'Persistence' => 'PERSISTENT|NON_PERSISTENT', 'Redacted' => true || false, 'Sender' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'Type' => 'STANDARD|CONTROL', ], ]
Result Details
Members
- ChannelMessage
-
- Type: ChannelMessage structure
The details of and content in the message.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetEventsConfiguration
$result = $client->getEventsConfiguration
([/* ... */]); $promise = $client->getEventsConfigurationAsync
([/* ... */]);
Gets details for an events configuration that allows a bot to receive outgoing events, such as an HTTPS endpoint or Lambda function ARN.
Parameter Syntax
$result = $client->getEventsConfiguration([ 'AccountId' => '<string>', // REQUIRED 'BotId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- BotId
-
- Required: Yes
- Type: string
The bot ID.
Result Syntax
[ 'EventsConfiguration' => [ 'BotId' => '<string>', 'LambdaFunctionArn' => '<string>', 'OutboundEventsHTTPSEndpoint' => '<string>', ], ]
Result Details
Members
- EventsConfiguration
-
- Type: EventsConfiguration structure
The events configuration details.
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
GetGlobalSettings
$result = $client->getGlobalSettings
([/* ... */]); $promise = $client->getGlobalSettingsAsync
([/* ... */]);
Retrieves global settings for the administrator's AWS account, such as Amazon Chime Business Calling and Amazon Chime Voice Connector settings.
Parameter Syntax
$result = $client->getGlobalSettings([ ]);
Parameter Details
Members
Result Syntax
[ 'BusinessCalling' => [ 'CdrBucket' => '<string>', ], 'VoiceConnector' => [ 'CdrBucket' => '<string>', ], ]
Result Details
Members
- BusinessCalling
-
- Type: BusinessCallingSettings structure
The Amazon Chime Business Calling settings.
- VoiceConnector
-
- Type: VoiceConnectorSettings structure
The Amazon Chime Voice Connector settings.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetMediaCapturePipeline
$result = $client->getMediaCapturePipeline
([/* ... */]); $promise = $client->getMediaCapturePipelineAsync
([/* ... */]);
Gets an existing media capture pipeline.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetMediaCapturePipeline, 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.
Parameter Syntax
$result = $client->getMediaCapturePipeline([ 'MediaPipelineId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MediaPipelineId
-
- Required: Yes
- Type: string
The ID of the pipeline that you want to get.
Result Syntax
[ 'MediaCapturePipeline' => [ 'ChimeSdkMeetingConfiguration' => [ 'ArtifactsConfiguration' => [ 'Audio' => [ 'MuxType' => 'AudioOnly|AudioWithActiveSpeakerVideo', ], 'Content' => [ 'MuxType' => 'ContentOnly', 'State' => 'Enabled|Disabled', ], 'Video' => [ 'MuxType' => 'VideoOnly', 'State' => 'Enabled|Disabled', ], ], 'SourceConfiguration' => [ 'SelectedVideoStreams' => [ 'AttendeeIds' => ['<string>', ...], 'ExternalUserIds' => ['<string>', ...], ], ], ], 'CreatedTimestamp' => <DateTime>, 'MediaPipelineId' => '<string>', 'SinkArn' => '<string>', 'SinkType' => 'S3Bucket', 'SourceArn' => '<string>', 'SourceType' => 'ChimeSdkMeeting', 'Status' => 'Initializing|InProgress|Failed|Stopping|Stopped', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- MediaCapturePipeline
-
- Type: MediaCapturePipeline structure
The media capture pipeline object.
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetMeeting
$result = $client->getMeeting
([/* ... */]); $promise = $client->getMeetingAsync
([/* ... */]);
This API is is no longer supported and will not be updated. We recommend using the latest version, GetMeeting, 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.
Gets the Amazon Chime SDK meeting details for the specified meeting ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide .
Parameter Syntax
$result = $client->getMeeting([ 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
Result Syntax
[ 'Meeting' => [ 'ExternalMeetingId' => '<string>', 'MediaPlacement' => [ 'AudioFallbackUrl' => '<string>', 'AudioHostUrl' => '<string>', 'EventIngestionUrl' => '<string>', 'ScreenDataUrl' => '<string>', 'ScreenSharingUrl' => '<string>', 'ScreenViewingUrl' => '<string>', 'SignalingUrl' => '<string>', 'TurnControlUrl' => '<string>', ], 'MediaRegion' => '<string>', 'MeetingId' => '<string>', ], ]
Result Details
Members
- Meeting
-
- Type: Meeting structure
The Amazon Chime SDK meeting information.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetMessagingSessionEndpoint
$result = $client->getMessagingSessionEndpoint
([/* ... */]); $promise = $client->getMessagingSessionEndpointAsync
([/* ... */]);
The details of the endpoint for the messaging session.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetMessagingSessionEndpoint, 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.
Parameter Syntax
$result = $client->getMessagingSessionEndpoint([ ]);
Parameter Details
Members
Result Syntax
[ 'Endpoint' => [ 'Url' => '<string>', ], ]
Result Details
Members
- Endpoint
-
- Type: MessagingSessionEndpoint structure
The endpoint returned in the response.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetPhoneNumber
$result = $client->getPhoneNumber
([/* ... */]); $promise = $client->getPhoneNumberAsync
([/* ... */]);
Retrieves details for the specified phone number ID, such as associations, capabilities, and product type.
Parameter Syntax
$result = $client->getPhoneNumber([ 'PhoneNumberId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- PhoneNumberId
-
- Required: Yes
- Type: string
The phone number ID.
Result Syntax
[ 'PhoneNumber' => [ 'Associations' => [ [ 'AssociatedTimestamp' => <DateTime>, 'Name' => 'AccountId|UserId|VoiceConnectorId|VoiceConnectorGroupId|SipRuleId', 'Value' => '<string>', ], // ... ], 'CallingName' => '<string>', 'CallingNameStatus' => 'Unassigned|UpdateInProgress|UpdateSucceeded|UpdateFailed', 'Capabilities' => [ 'InboundCall' => true || false, 'InboundMMS' => true || false, 'InboundSMS' => true || false, 'OutboundCall' => true || false, 'OutboundMMS' => true || false, 'OutboundSMS' => true || false, ], 'Country' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DeletionTimestamp' => <DateTime>, 'E164PhoneNumber' => '<string>', 'PhoneNumberId' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'AcquireInProgress|AcquireFailed|Unassigned|Assigned|ReleaseInProgress|DeleteInProgress|ReleaseFailed|DeleteFailed', 'Type' => 'Local|TollFree', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- PhoneNumber
-
- Type: PhoneNumber structure
The phone number details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetPhoneNumberOrder
$result = $client->getPhoneNumberOrder
([/* ... */]); $promise = $client->getPhoneNumberOrderAsync
([/* ... */]);
Retrieves details for the specified phone number order, such as the order creation timestamp, phone numbers in E.164 format, product type, and order status.
Parameter Syntax
$result = $client->getPhoneNumberOrder([ 'PhoneNumberOrderId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- PhoneNumberOrderId
-
- Required: Yes
- Type: string
The ID for the phone number order.
Result Syntax
[ 'PhoneNumberOrder' => [ 'CreatedTimestamp' => <DateTime>, 'OrderedPhoneNumbers' => [ [ 'E164PhoneNumber' => '<string>', 'Status' => 'Processing|Acquired|Failed', ], // ... ], 'PhoneNumberOrderId' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'Processing|Successful|Failed|Partial', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- PhoneNumberOrder
-
- Type: PhoneNumberOrder structure
The phone number order details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetPhoneNumberSettings
$result = $client->getPhoneNumberSettings
([/* ... */]); $promise = $client->getPhoneNumberSettingsAsync
([/* ... */]);
Retrieves the phone number settings for the administrator's AWS account, such as the default outbound calling name.
Parameter Syntax
$result = $client->getPhoneNumberSettings([ ]);
Parameter Details
Members
Result Syntax
[ 'CallingName' => '<string>', 'CallingNameUpdatedTimestamp' => <DateTime>, ]
Result Details
Members
- CallingName
-
- Type: string
The default outbound calling name for the account.
- CallingNameUpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The updated outbound calling name timestamp, in ISO 8601 format.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetProxySession
$result = $client->getProxySession
([/* ... */]); $promise = $client->getProxySessionAsync
([/* ... */]);
Gets the specified proxy session details for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetProxySession, 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.
Parameter Syntax
$result = $client->getProxySession([ 'ProxySessionId' => '<string>', // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ProxySessionId
-
- Required: Yes
- Type: string
The proxy session ID.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime voice connector ID.
Result Syntax
[ 'ProxySession' => [ 'Capabilities' => ['<string>', ...], 'CreatedTimestamp' => <DateTime>, 'EndedTimestamp' => <DateTime>, 'ExpiryMinutes' => <integer>, 'GeoMatchLevel' => 'Country|AreaCode', 'GeoMatchParams' => [ 'AreaCode' => '<string>', 'Country' => '<string>', ], 'Name' => '<string>', 'NumberSelectionBehavior' => 'PreferSticky|AvoidSticky', 'Participants' => [ [ 'PhoneNumber' => '<string>', 'ProxyPhoneNumber' => '<string>', ], // ... ], 'ProxySessionId' => '<string>', 'Status' => 'Open|InProgress|Closed', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorId' => '<string>', ], ]
Result Details
Members
- ProxySession
-
- Type: ProxySession structure
The proxy session details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetRetentionSettings
$result = $client->getRetentionSettings
([/* ... */]); $promise = $client->getRetentionSettingsAsync
([/* ... */]);
Gets the retention settings for the specified Amazon Chime Enterprise account. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide.
Parameter Syntax
$result = $client->getRetentionSettings([ 'AccountId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
Result Syntax
[ 'InitiateDeletionTimestamp' => <DateTime>, 'RetentionSettings' => [ 'ConversationRetentionSettings' => [ 'RetentionDays' => <integer>, ], 'RoomRetentionSettings' => [ 'RetentionDays' => <integer>, ], ], ]
Result Details
Members
- InitiateDeletionTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp representing the time at which the specified items are permanently deleted, in ISO 8601 format.
- RetentionSettings
-
- Type: RetentionSettings structure
The retention settings.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetRoom
$result = $client->getRoom
([/* ... */]); $promise = $client->getRoomAsync
([/* ... */]);
Retrieves room details, such as the room name, for a room in an Amazon Chime Enterprise account.
Parameter Syntax
$result = $client->getRoom([ 'AccountId' => '<string>', // REQUIRED 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[ 'Room' => [ 'AccountId' => '<string>', 'CreatedBy' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'RoomId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- Room
-
- Type: Room structure
The room details.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetSipMediaApplication
$result = $client->getSipMediaApplication
([/* ... */]); $promise = $client->getSipMediaApplicationAsync
([/* ... */]);
Retrieves the information for a SIP media application, including name, AWS Region, and endpoints.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetSipMediaApplication, 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.
Parameter Syntax
$result = $client->getSipMediaApplication([ 'SipMediaApplicationId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- SipMediaApplicationId
-
- Required: Yes
- Type: string
The SIP media application ID.
Result Syntax
[ 'SipMediaApplication' => [ 'AwsRegion' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Endpoints' => [ [ 'LambdaArn' => '<string>', ], // ... ], 'Name' => '<string>', 'SipMediaApplicationId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- SipMediaApplication
-
- Type: SipMediaApplication structure
The SIP media application details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetSipMediaApplicationLoggingConfiguration
$result = $client->getSipMediaApplicationLoggingConfiguration
([/* ... */]); $promise = $client->getSipMediaApplicationLoggingConfigurationAsync
([/* ... */]);
Returns the logging configuration for the specified SIP media application.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetSipMediaApplicationLoggingConfiguration, 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.
Parameter Syntax
$result = $client->getSipMediaApplicationLoggingConfiguration([ 'SipMediaApplicationId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- SipMediaApplicationId
-
- Required: Yes
- Type: string
The SIP media application ID.
Result Syntax
[ 'SipMediaApplicationLoggingConfiguration' => [ 'EnableSipMediaApplicationMessageLogs' => true || false, ], ]
Result Details
Members
- SipMediaApplicationLoggingConfiguration
-
- Type: SipMediaApplicationLoggingConfiguration structure
The actual logging configuration.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetSipRule
$result = $client->getSipRule
([/* ... */]); $promise = $client->getSipRuleAsync
([/* ... */]);
Retrieves the details of a SIP rule, such as the rule ID, name, triggers, and target endpoints.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetSipRule, 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.
Parameter Syntax
$result = $client->getSipRule([ 'SipRuleId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- SipRuleId
-
- Required: Yes
- Type: string
The SIP rule ID.
Result Syntax
[ 'SipRule' => [ 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'Name' => '<string>', 'SipRuleId' => '<string>', 'TargetApplications' => [ [ 'AwsRegion' => '<string>', 'Priority' => <integer>, 'SipMediaApplicationId' => '<string>', ], // ... ], 'TriggerType' => 'ToPhoneNumber|RequestUriHostname', 'TriggerValue' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- SipRule
-
- Type: SipRule structure
The SIP rule details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetUser
$result = $client->getUser
([/* ... */]); $promise = $client->getUserAsync
([/* ... */]);
Retrieves details for the specified user ID, such as primary email address, license type,and personal meeting PIN.
To retrieve user details with an email address instead of a user ID, use the ListUsers action, and then filter by email address.
Parameter Syntax
$result = $client->getUser([ 'AccountId' => '<string>', // REQUIRED 'UserId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserId
-
- Required: Yes
- Type: string
The user ID.
Result Syntax
[ 'User' => [ 'AccountId' => '<string>', 'AlexaForBusinessMetadata' => [ 'AlexaForBusinessRoomArn' => '<string>', 'IsAlexaForBusinessEnabled' => true || false, ], 'DisplayName' => '<string>', 'InvitedOn' => <DateTime>, 'LicenseType' => 'Basic|Plus|Pro|ProTrial', 'PersonalPIN' => '<string>', 'PrimaryEmail' => '<string>', 'PrimaryProvisionedNumber' => '<string>', 'RegisteredOn' => <DateTime>, 'UserId' => '<string>', 'UserInvitationStatus' => 'Pending|Accepted|Failed', 'UserRegistrationStatus' => 'Unregistered|Registered|Suspended', 'UserType' => 'PrivateUser|SharedDevice', ], ]
Result Details
Members
- User
-
- Type: User structure
The user details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetUserSettings
$result = $client->getUserSettings
([/* ... */]); $promise = $client->getUserSettingsAsync
([/* ... */]);
Retrieves settings for the specified user ID, such as any associated phone number settings.
Parameter Syntax
$result = $client->getUserSettings([ 'AccountId' => '<string>', // REQUIRED 'UserId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserId
-
- Required: Yes
- Type: string
The user ID.
Result Syntax
[ 'UserSettings' => [ 'Telephony' => [ 'InboundCalling' => true || false, 'OutboundCalling' => true || false, 'SMS' => true || false, ], ], ]
Result Details
Members
- UserSettings
-
- Type: UserSettings structure
The user settings.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnector
$result = $client->getVoiceConnector
([/* ... */]); $promise = $client->getVoiceConnectorAsync
([/* ... */]);
Retrieves details for the specified Amazon Chime Voice Connector, such as timestamps,name, outbound host, and encryption requirements.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnector, 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.
Parameter Syntax
$result = $client->getVoiceConnector([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'VoiceConnector' => [ 'AwsRegion' => 'us-east-1|us-west-2', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'OutboundHostName' => '<string>', 'RequireEncryption' => true || false, 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorArn' => '<string>', 'VoiceConnectorId' => '<string>', ], ]
Result Details
Members
- VoiceConnector
-
- Type: VoiceConnector structure
The Amazon Chime Voice Connector details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorEmergencyCallingConfiguration
$result = $client->getVoiceConnectorEmergencyCallingConfiguration
([/* ... */]); $promise = $client->getVoiceConnectorEmergencyCallingConfigurationAsync
([/* ... */]);
Gets the emergency calling configuration details for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorEmergencyCallingConfiguration, 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.
Parameter Syntax
$result = $client->getVoiceConnectorEmergencyCallingConfiguration([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'EmergencyCallingConfiguration' => [ 'DNIS' => [ [ 'CallingCountry' => '<string>', 'EmergencyPhoneNumber' => '<string>', 'TestPhoneNumber' => '<string>', ], // ... ], ], ]
Result Details
Members
- EmergencyCallingConfiguration
-
- Type: EmergencyCallingConfiguration structure
The emergency calling configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorGroup
$result = $client->getVoiceConnectorGroup
([/* ... */]); $promise = $client->getVoiceConnectorGroupAsync
([/* ... */]);
Retrieves details for the specified Amazon Chime Voice Connector group, such as timestamps,name, and associated VoiceConnectorItems
.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorGroup, 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.
Parameter Syntax
$result = $client->getVoiceConnectorGroup([ 'VoiceConnectorGroupId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorGroupId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector group ID.
Result Syntax
[ 'VoiceConnectorGroup' => [ 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorGroupArn' => '<string>', 'VoiceConnectorGroupId' => '<string>', 'VoiceConnectorItems' => [ [ 'Priority' => <integer>, 'VoiceConnectorId' => '<string>', ], // ... ], ], ]
Result Details
Members
- VoiceConnectorGroup
-
- Type: VoiceConnectorGroup structure
The Amazon Chime Voice Connector group details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorLoggingConfiguration
$result = $client->getVoiceConnectorLoggingConfiguration
([/* ... */]); $promise = $client->getVoiceConnectorLoggingConfigurationAsync
([/* ... */]);
Retrieves the logging configuration details for the specified Amazon Chime Voice Connector. Shows whether SIP message logs are enabled for sending to Amazon CloudWatch Logs.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorLoggingConfiguration, 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.
Parameter Syntax
$result = $client->getVoiceConnectorLoggingConfiguration([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'LoggingConfiguration' => [ 'EnableMediaMetricLogs' => true || false, 'EnableSIPLogs' => true || false, ], ]
Result Details
Members
- LoggingConfiguration
-
- Type: LoggingConfiguration structure
The logging configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorOrigination
$result = $client->getVoiceConnectorOrigination
([/* ... */]); $promise = $client->getVoiceConnectorOriginationAsync
([/* ... */]);
Retrieves origination setting details for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorOrigination, 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.
Parameter Syntax
$result = $client->getVoiceConnectorOrigination([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'Origination' => [ 'Disabled' => true || false, 'Routes' => [ [ 'Host' => '<string>', 'Port' => <integer>, 'Priority' => <integer>, 'Protocol' => 'TCP|UDP', 'Weight' => <integer>, ], // ... ], ], ]
Result Details
Members
- Origination
-
- Type: Origination structure
The origination setting details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorProxy
$result = $client->getVoiceConnectorProxy
([/* ... */]); $promise = $client->getVoiceConnectorProxyAsync
([/* ... */]);
Gets the proxy configuration details for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorProxy, 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.
Parameter Syntax
$result = $client->getVoiceConnectorProxy([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime voice connector ID.
Result Syntax
[ 'Proxy' => [ 'DefaultSessionExpiryMinutes' => <integer>, 'Disabled' => true || false, 'FallBackPhoneNumber' => '<string>', 'PhoneNumberCountries' => ['<string>', ...], ], ]
Result Details
Members
- Proxy
-
- Type: Proxy structure
The proxy configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorStreamingConfiguration
$result = $client->getVoiceConnectorStreamingConfiguration
([/* ... */]); $promise = $client->getVoiceConnectorStreamingConfigurationAsync
([/* ... */]);
Retrieves the streaming configuration details for the specified Amazon Chime Voice Connector. Shows whether media streaming is enabled for sending to Amazon Kinesis. It also shows the retention period, in hours, for the Amazon Kinesis data.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorStreamingConfiguration, 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.
Parameter Syntax
$result = $client->getVoiceConnectorStreamingConfiguration([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'StreamingConfiguration' => [ 'DataRetentionInHours' => <integer>, 'Disabled' => true || false, 'StreamingNotificationTargets' => [ [ 'NotificationTarget' => 'EventBridge|SNS|SQS', ], // ... ], ], ]
Result Details
Members
- StreamingConfiguration
-
- Type: StreamingConfiguration structure
The streaming configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorTermination
$result = $client->getVoiceConnectorTermination
([/* ... */]); $promise = $client->getVoiceConnectorTerminationAsync
([/* ... */]);
Retrieves termination setting details for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorTermination, 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.
Parameter Syntax
$result = $client->getVoiceConnectorTermination([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'Termination' => [ 'CallingRegions' => ['<string>', ...], 'CidrAllowedList' => ['<string>', ...], 'CpsLimit' => <integer>, 'DefaultPhoneNumber' => '<string>', 'Disabled' => true || false, ], ]
Result Details
Members
- Termination
-
- Type: Termination structure
The termination setting details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
GetVoiceConnectorTerminationHealth
$result = $client->getVoiceConnectorTerminationHealth
([/* ... */]); $promise = $client->getVoiceConnectorTerminationHealthAsync
([/* ... */]);
This API is is no longer supported and will not be updated. We recommend using the latest version, GetVoiceConnectorTerminationHealth, 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.
Retrieves information about the last time a SIP OPTIONS
ping was received from your SIP infrastructure for the specified Amazon Chime Voice Connector.
Parameter Syntax
$result = $client->getVoiceConnectorTerminationHealth([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'TerminationHealth' => [ 'Source' => '<string>', 'Timestamp' => <DateTime>, ], ]
Result Details
Members
- TerminationHealth
-
- Type: TerminationHealth structure
The termination health details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
InviteUsers
$result = $client->inviteUsers
([/* ... */]); $promise = $client->inviteUsersAsync
([/* ... */]);
Sends email to a maximum of 50 users, inviting them to the specified Amazon Chime Team
account. Only Team
account types are currently supported for this action.
Parameter Syntax
$result = $client->inviteUsers([ 'AccountId' => '<string>', // REQUIRED 'UserEmailList' => ['<string>', ...], // REQUIRED 'UserType' => 'PrivateUser|SharedDevice', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserEmailList
-
- Required: Yes
- Type: Array of strings
The user email addresses to which to send the email invitation.
- UserType
-
- Type: string
The user type.
Result Syntax
[ 'Invites' => [ [ 'EmailAddress' => '<string>', 'EmailStatus' => 'NotSent|Sent|Failed', 'InviteId' => '<string>', 'Status' => 'Pending|Accepted|Failed', ], // ... ], ]
Result Details
Members
- Invites
-
- Type: Array of Invite structures
The email invitation details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListAccounts
$result = $client->listAccounts
([/* ... */]); $promise = $client->listAccountsAsync
([/* ... */]);
Lists the Amazon Chime accounts under the administrator's AWS account. You can filter accounts by account name prefix. To find out which Amazon Chime account a user belongs to, you can filter by the user's email address, which returns one account result.
Parameter Syntax
$result = $client->listAccounts([ 'MaxResults' => <integer>, 'Name' => '<string>', 'NextToken' => '<string>', 'UserEmail' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call. Defaults to 100.
- Name
-
- Type: string
Amazon Chime account name prefix with which to filter results.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- UserEmail
-
- Type: string
User email address with which to filter results.
Result Syntax
[ 'Accounts' => [ [ 'AccountId' => '<string>', 'AccountStatus' => 'Suspended|Active', 'AccountType' => 'Team|EnterpriseDirectory|EnterpriseLWA|EnterpriseOIDC', 'AwsAccountId' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DefaultLicense' => 'Basic|Plus|Pro|ProTrial', 'Name' => '<string>', 'SigninDelegateGroups' => [ [ 'GroupName' => '<string>', ], // ... ], 'SupportedLicenses' => ['<string>', ...], ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Accounts
-
- Type: Array of Account structures
List of Amazon Chime accounts and account details.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListAppInstanceAdmins
$result = $client->listAppInstanceAdmins
([/* ... */]); $promise = $client->listAppInstanceAdminsAsync
([/* ... */]);
Returns a list of the administrators in the AppInstance
.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListAppInstanceAdmins, 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.
Parameter Syntax
$result = $client->listAppInstanceAdmins([ 'AppInstanceArn' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
. - MaxResults
-
- Type: int
The maximum number of administrators that you want to return.
- NextToken
-
- Type: string
The token returned from previous API requests until the number of administrators is reached.
Result Syntax
[ 'AppInstanceAdmins' => [ [ 'Admin' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ], // ... ], 'AppInstanceArn' => '<string>', 'NextToken' => '<string>', ]
Result Details
Members
- AppInstanceAdmins
-
- Type: Array of AppInstanceAdminSummary structures
The information for each administrator.
- AppInstanceArn
-
- Type: string
The ARN of the
AppInstance
. - NextToken
-
- Type: string
The token returned from previous API requests until the number of administrators is reached.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListAppInstanceUsers
$result = $client->listAppInstanceUsers
([/* ... */]); $promise = $client->listAppInstanceUsersAsync
([/* ... */]);
List all AppInstanceUsers
created under a single AppInstance
.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListAppInstanceUsers, 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.
Parameter Syntax
$result = $client->listAppInstanceUsers([ 'AppInstanceArn' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
. - MaxResults
-
- Type: int
The maximum number of requests that you want returned.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested users are returned.
Result Syntax
[ 'AppInstanceArn' => '<string>', 'AppInstanceUsers' => [ [ 'AppInstanceUserArn' => '<string>', 'Metadata' => '<string>', 'Name' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- AppInstanceArn
-
- Type: string
The ARN of the
AppInstance
. - AppInstanceUsers
-
- Type: Array of AppInstanceUserSummary structures
The information for each requested
AppInstanceUser
. - NextToken
-
- Type: string
The token passed by previous API calls until all requested users are returned.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListAppInstances
$result = $client->listAppInstances
([/* ... */]); $promise = $client->listAppInstancesAsync
([/* ... */]);
Lists all Amazon Chime AppInstance
s created under a single AWS account.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListAppInstances, 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.
Parameter Syntax
$result = $client->listAppInstances([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of
AppInstance
s that you want to return. - NextToken
-
- Type: string
The token passed by previous API requests until you reach the maximum number of
AppInstance
s.
Result Syntax
[ 'AppInstances' => [ [ 'AppInstanceArn' => '<string>', 'Metadata' => '<string>', 'Name' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- AppInstances
-
- Type: Array of AppInstanceSummary structures
The information for each
AppInstance
. - NextToken
-
- Type: string
The token passed by previous API requests until the maximum number of
AppInstance
s is reached.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListAttendeeTags
$result = $client->listAttendeeTags
([/* ... */]); $promise = $client->listAttendeeTagsAsync
([/* ... */]);
Lists the tags applied to an Amazon Chime SDK attendee resource.
ListAttendeeTags is not supported in the Amazon Chime SDK Meetings Namespace. Update your application to remove calls to this API.
Parameter Syntax
$result = $client->listAttendeeTags([ 'AttendeeId' => '<string>', // REQUIRED 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AttendeeId
-
- Required: Yes
- Type: string
The Amazon Chime SDK attendee ID.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
Result Syntax
[ 'Tags' => [ [ 'Key' => '<string>', 'Value' => '<string>', ], // ... ], ]
Result Details
Members
- Tags
-
- Type: Array of Tag structures
A list of tag key-value pairs.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListAttendees
$result = $client->listAttendees
([/* ... */]); $promise = $client->listAttendeesAsync
([/* ... */]);
Lists the attendees for the specified Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListAttendees, 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.
Parameter Syntax
$result = $client->listAttendees([ 'MaxResults' => <integer>, 'MeetingId' => '<string>', // REQUIRED 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'Attendees' => [ [ 'AttendeeId' => '<string>', 'ExternalUserId' => '<string>', 'JoinToken' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Attendees
-
- Type: Array of Attendee structures
The Amazon Chime SDK attendee information.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListBots
$result = $client->listBots
([/* ... */]); $promise = $client->listBotsAsync
([/* ... */]);
Lists the bots associated with the administrator's Amazon Chime Enterprise account ID.
Parameter Syntax
$result = $client->listBots([ 'AccountId' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MaxResults
-
- Type: int
The maximum number of results to return in a single call. The default is 10.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'Bots' => [ [ 'BotEmail' => '<string>', 'BotId' => '<string>', 'BotType' => 'ChatBot', 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'DisplayName' => '<string>', 'SecurityToken' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'UserId' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Bots
-
- Type: Array of Bot structures
List of bots and bot details.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
ListChannelBans
$result = $client->listChannelBans
([/* ... */]); $promise = $client->listChannelBansAsync
([/* ... */]);
Lists all the users banned from a particular channel.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListChannelBans, 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.
Parameter Syntax
$result = $client->listChannelBans([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MaxResults
-
- Type: int
The maximum number of bans that you want returned.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested bans are returned.
Result Syntax
[ 'ChannelArn' => '<string>', 'ChannelBans' => [ [ 'Member' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- ChannelBans
-
- Type: Array of ChannelBanSummary structures
The information for each requested ban.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested bans are returned.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListChannelMemberships
$result = $client->listChannelMemberships
([/* ... */]); $promise = $client->listChannelMembershipsAsync
([/* ... */]);
Lists all channel memberships in a channel.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListChannelMemberships, 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.
Parameter Syntax
$result = $client->listChannelMemberships([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', 'Type' => 'DEFAULT|HIDDEN', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The maximum number of channel memberships that you want returned.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MaxResults
-
- Type: int
The maximum number of channel memberships that you want returned.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested channel memberships are returned.
- Type
-
- Type: string
The membership type of a user,
DEFAULT
orHIDDEN
. Default members are always returned as part ofListChannelMemberships
. Hidden members are only returned if the type filter inListChannelMemberships
equalsHIDDEN
. Otherwise hidden members are not returned.
Result Syntax
[ 'ChannelArn' => '<string>', 'ChannelMemberships' => [ [ 'Member' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- ChannelMemberships
-
- Type: Array of ChannelMembershipSummary structures
The information for the requested channel memberships.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested channel memberships are returned.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListChannelMembershipsForAppInstanceUser
$result = $client->listChannelMembershipsForAppInstanceUser
([/* ... */]); $promise = $client->listChannelMembershipsForAppInstanceUserAsync
([/* ... */]);
Lists all channels that a particular AppInstanceUser
is a part of. Only an AppInstanceAdmin
can call the API with a user ARN that is not their own.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListChannelMembershipsForAppInstanceUser, 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.
Parameter Syntax
$result = $client->listChannelMembershipsForAppInstanceUser([ 'AppInstanceUserArn' => '<string>', 'ChimeBearer' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- AppInstanceUserArn
-
- Type: string
The ARN of the
AppInstanceUser
s - ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MaxResults
-
- Type: int
The maximum number of users that you want returned.
- NextToken
-
- Type: string
The token returned from previous API requests until the number of channel memberships is reached.
Result Syntax
[ 'ChannelMemberships' => [ [ 'AppInstanceUserMembershipSummary' => [ 'ReadMarkerTimestamp' => <DateTime>, 'Type' => 'DEFAULT|HIDDEN', ], 'ChannelSummary' => [ 'ChannelArn' => '<string>', 'LastMessageTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', 'Name' => '<string>', 'Privacy' => 'PUBLIC|PRIVATE', ], ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- ChannelMemberships
-
- Type: Array of ChannelMembershipForAppInstanceUserSummary structures
The information for the requested channel memberships.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested users are returned.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListChannelMessages
$result = $client->listChannelMessages
([/* ... */]); $promise = $client->listChannelMessagesAsync
([/* ... */]);
List all the messages in a channel. Returns a paginated list of ChannelMessages
. By default, sorted by creation timestamp in descending order.
Redacted messages appear in the results as empty, since they are only redacted, not deleted. Deleted messages do not appear in the results. This action always returns the latest version of an edited message.
Also, the x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListChannelMessages, 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.
Parameter Syntax
$result = $client->listChannelMessages([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', 'NotAfter' => <integer || string || DateTime>, 'NotBefore' => <integer || string || DateTime>, 'SortOrder' => 'ASCENDING|DESCENDING', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MaxResults
-
- Type: int
The maximum number of messages that you want returned.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested messages are returned.
- NotAfter
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The final or ending time stamp for your requested messages.
- NotBefore
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The initial or starting time stamp for your requested messages.
- SortOrder
-
- Type: string
The order in which you want messages sorted. Default is Descending, based on time created.
Result Syntax
[ 'ChannelArn' => '<string>', 'ChannelMessages' => [ [ 'Content' => '<string>', 'CreatedTimestamp' => <DateTime>, 'LastEditedTimestamp' => <DateTime>, 'LastUpdatedTimestamp' => <DateTime>, 'MessageId' => '<string>', 'Metadata' => '<string>', 'Redacted' => true || false, 'Sender' => [ 'Arn' => '<string>', 'Name' => '<string>', ], 'Type' => 'STANDARD|CONTROL', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel containing the requested messages.
- ChannelMessages
-
- Type: Array of ChannelMessageSummary structures
The information about, and content of, each requested message.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested messages are returned.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListChannelModerators
$result = $client->listChannelModerators
([/* ... */]); $promise = $client->listChannelModeratorsAsync
([/* ... */]);
Lists all the moderators for a channel.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListChannelModerators, 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.
Parameter Syntax
$result = $client->listChannelModerators([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MaxResults
-
- Type: int
The maximum number of moderators that you want returned.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested moderators are returned.
Result Syntax
[ 'ChannelArn' => '<string>', 'ChannelModerators' => [ [ 'Moderator' => [ 'Arn' => '<string>', 'Name' => '<string>', ], ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- ChannelModerators
-
- Type: Array of ChannelModeratorSummary structures
The information about and names of each moderator.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested moderators are returned.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListChannels
$result = $client->listChannels
([/* ... */]); $promise = $client->listChannelsAsync
([/* ... */]);
Lists all Channels created under a single Chime App as a paginated list. You can specify filters to narrow results.
Functionality & restrictions
-
Use privacy =
PUBLIC
to retrieve all public channels in the account. -
Only an
AppInstanceAdmin
can set privacy =PRIVATE
to list the private channels in an account.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListChannels, 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.
Parameter Syntax
$result = $client->listChannels([ 'AppInstanceArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', 'Privacy' => 'PUBLIC|PRIVATE', ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
. - ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MaxResults
-
- Type: int
The maximum number of channels that you want to return.
- NextToken
-
- Type: string
The token passed by previous API calls until all requested channels are returned.
- Privacy
-
- Type: string
The privacy setting.
PUBLIC
retrieves all the public channels.PRIVATE
retrieves private channels. Only anAppInstanceAdmin
can retrieve private channels.
Result Syntax
[ 'Channels' => [ [ 'ChannelArn' => '<string>', 'LastMessageTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', 'Name' => '<string>', 'Privacy' => 'PUBLIC|PRIVATE', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Channels
-
- Type: Array of ChannelSummary structures
The information about each channel.
- NextToken
-
- Type: string
The token returned from previous API requests until the number of channels is reached.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListChannelsModeratedByAppInstanceUser
$result = $client->listChannelsModeratedByAppInstanceUser
([/* ... */]); $promise = $client->listChannelsModeratedByAppInstanceUserAsync
([/* ... */]);
A list of the channels moderated by an AppInstanceUser
.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListChannelsModeratedByAppInstanceUser, 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.
Parameter Syntax
$result = $client->listChannelsModeratedByAppInstanceUser([ 'AppInstanceUserArn' => '<string>', 'ChimeBearer' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- AppInstanceUserArn
-
- Type: string
The ARN of the user in the moderated channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MaxResults
-
- Type: int
The maximum number of channels in the request.
- NextToken
-
- Type: string
The token returned from previous API requests until the number of channels moderated by the user is reached.
Result Syntax
[ 'Channels' => [ [ 'ChannelSummary' => [ 'ChannelArn' => '<string>', 'LastMessageTimestamp' => <DateTime>, 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', 'Name' => '<string>', 'Privacy' => 'PUBLIC|PRIVATE', ], ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Channels
-
- Type: Array of ChannelModeratedByAppInstanceUserSummary structures
The moderated channels in the request.
- NextToken
-
- Type: string
The token returned from previous API requests until the number of channels moderated by the user is reached.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListMediaCapturePipelines
$result = $client->listMediaCapturePipelines
([/* ... */]); $promise = $client->listMediaCapturePipelinesAsync
([/* ... */]);
Returns a list of media capture pipelines.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListMediaCapturePipelines, 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.
Parameter Syntax
$result = $client->listMediaCapturePipelines([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call. Valid Range: 1 - 99.
- NextToken
-
- Type: string
The token used to retrieve the next page of results.
Result Syntax
[ 'MediaCapturePipelines' => [ [ 'ChimeSdkMeetingConfiguration' => [ 'ArtifactsConfiguration' => [ 'Audio' => [ 'MuxType' => 'AudioOnly|AudioWithActiveSpeakerVideo', ], 'Content' => [ 'MuxType' => 'ContentOnly', 'State' => 'Enabled|Disabled', ], 'Video' => [ 'MuxType' => 'VideoOnly', 'State' => 'Enabled|Disabled', ], ], 'SourceConfiguration' => [ 'SelectedVideoStreams' => [ 'AttendeeIds' => ['<string>', ...], 'ExternalUserIds' => ['<string>', ...], ], ], ], 'CreatedTimestamp' => <DateTime>, 'MediaPipelineId' => '<string>', 'SinkArn' => '<string>', 'SinkType' => 'S3Bucket', 'SourceArn' => '<string>', 'SourceType' => 'ChimeSdkMeeting', 'Status' => 'Initializing|InProgress|Failed|Stopping|Stopped', 'UpdatedTimestamp' => <DateTime>, ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- MediaCapturePipelines
-
- Type: Array of MediaCapturePipeline structures
The media capture pipeline objects in the list.
- NextToken
-
- Type: string
The token used to retrieve the next page of results.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListMeetingTags
$result = $client->listMeetingTags
([/* ... */]); $promise = $client->listMeetingTagsAsync
([/* ... */]);
Lists the tags applied to an Amazon Chime SDK meeting resource.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListTagsForResource, 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.
Parameter Syntax
$result = $client->listMeetingTags([ 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
Result Syntax
[ 'Tags' => [ [ 'Key' => '<string>', 'Value' => '<string>', ], // ... ], ]
Result Details
Members
- Tags
-
- Type: Array of Tag structures
A list of tag key-value pairs.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListMeetings
$result = $client->listMeetings
([/* ... */]); $promise = $client->listMeetingsAsync
([/* ... */]);
Lists up to 100 active Amazon Chime SDK meetings.
ListMeetings is not supported in the Amazon Chime SDK Meetings Namespace. Update your application to remove calls to this API.
For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime SDK Developer Guide.
Parameter Syntax
$result = $client->listMeetings([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'Meetings' => [ [ 'ExternalMeetingId' => '<string>', 'MediaPlacement' => [ 'AudioFallbackUrl' => '<string>', 'AudioHostUrl' => '<string>', 'EventIngestionUrl' => '<string>', 'ScreenDataUrl' => '<string>', 'ScreenSharingUrl' => '<string>', 'ScreenViewingUrl' => '<string>', 'SignalingUrl' => '<string>', 'TurnControlUrl' => '<string>', ], 'MediaRegion' => '<string>', 'MeetingId' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Meetings
-
- Type: Array of Meeting structures
The Amazon Chime SDK meeting information.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListPhoneNumberOrders
$result = $client->listPhoneNumberOrders
([/* ... */]); $promise = $client->listPhoneNumberOrdersAsync
([/* ... */]);
Lists the phone number orders for the administrator's Amazon Chime account.
Parameter Syntax
$result = $client->listPhoneNumberOrders([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'NextToken' => '<string>', 'PhoneNumberOrders' => [ [ 'CreatedTimestamp' => <DateTime>, 'OrderedPhoneNumbers' => [ [ 'E164PhoneNumber' => '<string>', 'Status' => 'Processing|Acquired|Failed', ], // ... ], 'PhoneNumberOrderId' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'Processing|Successful|Failed|Partial', 'UpdatedTimestamp' => <DateTime>, ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- PhoneNumberOrders
-
- Type: Array of PhoneNumberOrder structures
The phone number order details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListPhoneNumbers
$result = $client->listPhoneNumbers
([/* ... */]); $promise = $client->listPhoneNumbersAsync
([/* ... */]);
Lists the phone numbers for the specified Amazon Chime account, Amazon Chime user, Amazon Chime Voice Connector, or Amazon Chime Voice Connector group.
Parameter Syntax
$result = $client->listPhoneNumbers([ 'FilterName' => 'AccountId|UserId|VoiceConnectorId|VoiceConnectorGroupId|SipRuleId', 'FilterValue' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'AcquireInProgress|AcquireFailed|Unassigned|Assigned|ReleaseInProgress|DeleteInProgress|ReleaseFailed|DeleteFailed', ]);
Parameter Details
Members
- FilterName
-
- Type: string
The filter to use to limit the number of results.
- FilterValue
-
- Type: string
The value to use for the filter.
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- ProductType
-
- Type: string
The phone number product type.
- Status
-
- Type: string
The phone number status.
Result Syntax
[ 'NextToken' => '<string>', 'PhoneNumbers' => [ [ 'Associations' => [ [ 'AssociatedTimestamp' => <DateTime>, 'Name' => 'AccountId|UserId|VoiceConnectorId|VoiceConnectorGroupId|SipRuleId', 'Value' => '<string>', ], // ... ], 'CallingName' => '<string>', 'CallingNameStatus' => 'Unassigned|UpdateInProgress|UpdateSucceeded|UpdateFailed', 'Capabilities' => [ 'InboundCall' => true || false, 'InboundMMS' => true || false, 'InboundSMS' => true || false, 'OutboundCall' => true || false, 'OutboundMMS' => true || false, 'OutboundSMS' => true || false, ], 'Country' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DeletionTimestamp' => <DateTime>, 'E164PhoneNumber' => '<string>', 'PhoneNumberId' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'AcquireInProgress|AcquireFailed|Unassigned|Assigned|ReleaseInProgress|DeleteInProgress|ReleaseFailed|DeleteFailed', 'Type' => 'Local|TollFree', 'UpdatedTimestamp' => <DateTime>, ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- PhoneNumbers
-
- Type: Array of PhoneNumber structures
The phone number details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListProxySessions
$result = $client->listProxySessions
([/* ... */]); $promise = $client->listProxySessionsAsync
([/* ... */]);
Lists the proxy sessions for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListProxySessions, 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.
Parameter Syntax
$result = $client->listProxySessions([ 'MaxResults' => <integer>, 'NextToken' => '<string>', 'Status' => 'Open|InProgress|Closed', 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- Status
-
- Type: string
The proxy session status.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime voice connector ID.
Result Syntax
[ 'NextToken' => '<string>', 'ProxySessions' => [ [ 'Capabilities' => ['<string>', ...], 'CreatedTimestamp' => <DateTime>, 'EndedTimestamp' => <DateTime>, 'ExpiryMinutes' => <integer>, 'GeoMatchLevel' => 'Country|AreaCode', 'GeoMatchParams' => [ 'AreaCode' => '<string>', 'Country' => '<string>', ], 'Name' => '<string>', 'NumberSelectionBehavior' => 'PreferSticky|AvoidSticky', 'Participants' => [ [ 'PhoneNumber' => '<string>', 'ProxyPhoneNumber' => '<string>', ], // ... ], 'ProxySessionId' => '<string>', 'Status' => 'Open|InProgress|Closed', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorId' => '<string>', ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- ProxySessions
-
- Type: Array of ProxySession structures
The proxy session details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListRoomMemberships
$result = $client->listRoomMemberships
([/* ... */]); $promise = $client->listRoomMembershipsAsync
([/* ... */]);
Lists the membership details for the specified room in an Amazon Chime Enterprise account, such as the members' IDs, email addresses, and names.
Parameter Syntax
$result = $client->listRoomMemberships([ 'AccountId' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'NextToken' => '<string>', 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[ 'NextToken' => '<string>', 'RoomMemberships' => [ [ 'InvitedBy' => '<string>', 'Member' => [ 'AccountId' => '<string>', 'Email' => '<string>', 'FullName' => '<string>', 'MemberId' => '<string>', 'MemberType' => 'User|Bot|Webhook', ], 'Role' => 'Administrator|Member', 'RoomId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- RoomMemberships
-
- Type: Array of RoomMembership structures
The room membership details.
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListRooms
$result = $client->listRooms
([/* ... */]); $promise = $client->listRoomsAsync
([/* ... */]);
Lists the room details for the specified Amazon Chime Enterprise account. Optionally, filter the results by a member ID (user ID or bot ID) to see a list of rooms that the member belongs to.
Parameter Syntax
$result = $client->listRooms([ 'AccountId' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'MemberId' => '<string>', 'NextToken' => '<string>', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- MemberId
-
- Type: string
The member ID (user ID or bot ID).
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'NextToken' => '<string>', 'Rooms' => [ [ 'AccountId' => '<string>', 'CreatedBy' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'RoomId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- Rooms
-
- Type: Array of Room structures
The room details.
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListSipMediaApplications
$result = $client->listSipMediaApplications
([/* ... */]); $promise = $client->listSipMediaApplicationsAsync
([/* ... */]);
Lists the SIP media applications under the administrator's AWS account.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListSipMediaApplications, 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.
Parameter Syntax
$result = $client->listSipMediaApplications([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call. Defaults to 100.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'NextToken' => '<string>', 'SipMediaApplications' => [ [ 'AwsRegion' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Endpoints' => [ [ 'LambdaArn' => '<string>', ], // ... ], 'Name' => '<string>', 'SipMediaApplicationId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- SipMediaApplications
-
- Type: Array of SipMediaApplication structures
List of SIP media applications and application details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListSipRules
$result = $client->listSipRules
([/* ... */]); $promise = $client->listSipRulesAsync
([/* ... */]);
Lists the SIP rules under the administrator's AWS account.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListSipRules, 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.
Parameter Syntax
$result = $client->listSipRules([ 'MaxResults' => <integer>, 'NextToken' => '<string>', 'SipMediaApplicationId' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call. Defaults to 100.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- SipMediaApplicationId
-
- Type: string
The SIP media application ID.
Result Syntax
[ 'NextToken' => '<string>', 'SipRules' => [ [ 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'Name' => '<string>', 'SipRuleId' => '<string>', 'TargetApplications' => [ [ 'AwsRegion' => '<string>', 'Priority' => <integer>, 'SipMediaApplicationId' => '<string>', ], // ... ], 'TriggerType' => 'ToPhoneNumber|RequestUriHostname', 'TriggerValue' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- SipRules
-
- Type: Array of SipRule structures
List of SIP rules and rule details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListSupportedPhoneNumberCountries
$result = $client->listSupportedPhoneNumberCountries
([/* ... */]); $promise = $client->listSupportedPhoneNumberCountriesAsync
([/* ... */]);
Lists supported phone number countries.
Parameter Syntax
$result = $client->listSupportedPhoneNumberCountries([ 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', // REQUIRED ]);
Parameter Details
Members
- ProductType
-
- Required: Yes
- Type: string
The phone number product type.
Result Syntax
[ 'PhoneNumberCountries' => [ [ 'CountryCode' => '<string>', 'SupportedPhoneNumberTypes' => ['<string>', ...], ], // ... ], ]
Result Details
Members
- PhoneNumberCountries
-
- Type: Array of PhoneNumberCountry structures
The supported phone number countries.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
Lists the tags applied to an Amazon Chime SDK meeting and messaging resources.
This API is is no longer supported and will not be updated. We recommend using the applicable latest version in the Amazon Chime SDK.
-
For meetings: ListTagsForResource.
-
For messaging: ListTagsForResource.
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.
Parameter Syntax
$result = $client->listTagsForResource([ 'ResourceARN' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ResourceARN
-
- Required: Yes
- Type: string
The resource ARN.
Result Syntax
[ 'Tags' => [ [ 'Key' => '<string>', 'Value' => '<string>', ], // ... ], ]
Result Details
Members
- Tags
-
- Type: Array of Tag structures
A list of tag-key value pairs.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListUsers
$result = $client->listUsers
([/* ... */]); $promise = $client->listUsersAsync
([/* ... */]);
Lists the users that belong to the specified Amazon Chime account. You can specify an email address to list only the user that the email address belongs to.
Parameter Syntax
$result = $client->listUsers([ 'AccountId' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'NextToken' => '<string>', 'UserEmail' => '<string>', 'UserType' => 'PrivateUser|SharedDevice', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MaxResults
-
- Type: int
The maximum number of results to return in a single call. Defaults to 100.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- UserEmail
-
- Type: string
Optional. The user email address used to filter results. Maximum 1.
- UserType
-
- Type: string
The user type.
Result Syntax
[ 'NextToken' => '<string>', 'Users' => [ [ 'AccountId' => '<string>', 'AlexaForBusinessMetadata' => [ 'AlexaForBusinessRoomArn' => '<string>', 'IsAlexaForBusinessEnabled' => true || false, ], 'DisplayName' => '<string>', 'InvitedOn' => <DateTime>, 'LicenseType' => 'Basic|Plus|Pro|ProTrial', 'PersonalPIN' => '<string>', 'PrimaryEmail' => '<string>', 'PrimaryProvisionedNumber' => '<string>', 'RegisteredOn' => <DateTime>, 'UserId' => '<string>', 'UserInvitationStatus' => 'Pending|Accepted|Failed', 'UserRegistrationStatus' => 'Unregistered|Registered|Suspended', 'UserType' => 'PrivateUser|SharedDevice', ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- Users
-
- Type: Array of User structures
List of users and user details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListVoiceConnectorGroups
$result = $client->listVoiceConnectorGroups
([/* ... */]); $promise = $client->listVoiceConnectorGroupsAsync
([/* ... */]);
Lists the Amazon Chime Voice Connector groups for the administrator's AWS account.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListVoiceConnectorGroups, 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.
Parameter Syntax
$result = $client->listVoiceConnectorGroups([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'NextToken' => '<string>', 'VoiceConnectorGroups' => [ [ 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorGroupArn' => '<string>', 'VoiceConnectorGroupId' => '<string>', 'VoiceConnectorItems' => [ [ 'Priority' => <integer>, 'VoiceConnectorId' => '<string>', ], // ... ], ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- VoiceConnectorGroups
-
- Type: Array of VoiceConnectorGroup structures
The details of the Amazon Chime Voice Connector groups.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListVoiceConnectorTerminationCredentials
$result = $client->listVoiceConnectorTerminationCredentials
([/* ... */]); $promise = $client->listVoiceConnectorTerminationCredentialsAsync
([/* ... */]);
Lists the SIP credentials for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListVoiceConnectorTerminationCredentials, 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.
Parameter Syntax
$result = $client->listVoiceConnectorTerminationCredentials([ 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'Usernames' => ['<string>', ...], ]
Result Details
Members
- Usernames
-
- Type: Array of strings
A list of user names.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ListVoiceConnectors
$result = $client->listVoiceConnectors
([/* ... */]); $promise = $client->listVoiceConnectorsAsync
([/* ... */]);
Lists the Amazon Chime Voice Connectors for the administrator's AWS account.
This API is is no longer supported and will not be updated. We recommend using the latest version, ListVoiceConnectors, 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.
Parameter Syntax
$result = $client->listVoiceConnectors([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
Result Syntax
[ 'NextToken' => '<string>', 'VoiceConnectors' => [ [ 'AwsRegion' => 'us-east-1|us-west-2', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'OutboundHostName' => '<string>', 'RequireEncryption' => true || false, 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorArn' => '<string>', 'VoiceConnectorId' => '<string>', ], // ... ], ]
Result Details
Members
- NextToken
-
- Type: string
The token to use to retrieve the next page of results.
- VoiceConnectors
-
- Type: Array of VoiceConnector structures
The details of the Amazon Chime Voice Connectors.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
LogoutUser
$result = $client->logoutUser
([/* ... */]); $promise = $client->logoutUserAsync
([/* ... */]);
Logs out the specified user from all of the devices they are currently logged into.
Parameter Syntax
$result = $client->logoutUser([ 'AccountId' => '<string>', // REQUIRED 'UserId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserId
-
- Required: Yes
- Type: string
The user ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutAppInstanceRetentionSettings
$result = $client->putAppInstanceRetentionSettings
([/* ... */]); $promise = $client->putAppInstanceRetentionSettingsAsync
([/* ... */]);
Sets the amount of time in days that a given AppInstance
retains data.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutAppInstanceRetentionSettings, 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.
Parameter Syntax
$result = $client->putAppInstanceRetentionSettings([ 'AppInstanceArn' => '<string>', // REQUIRED 'AppInstanceRetentionSettings' => [ // REQUIRED 'ChannelRetentionSettings' => [ 'RetentionDays' => <integer>, ], ], ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
. - AppInstanceRetentionSettings
-
- Required: Yes
- Type: AppInstanceRetentionSettings structure
The time in days to retain data. Data type: number.
Result Syntax
[ 'AppInstanceRetentionSettings' => [ 'ChannelRetentionSettings' => [ 'RetentionDays' => <integer>, ], ], 'InitiateDeletionTimestamp' => <DateTime>, ]
Result Details
Members
- AppInstanceRetentionSettings
-
- Type: AppInstanceRetentionSettings structure
The time in days to retain data. Data type: number.
- InitiateDeletionTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the API deletes data.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutAppInstanceStreamingConfigurations
$result = $client->putAppInstanceStreamingConfigurations
([/* ... */]); $promise = $client->putAppInstanceStreamingConfigurationsAsync
([/* ... */]);
The data streaming configurations of an AppInstance
.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutMessagingStreamingConfigurations, 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.
Parameter Syntax
$result = $client->putAppInstanceStreamingConfigurations([ 'AppInstanceArn' => '<string>', // REQUIRED 'AppInstanceStreamingConfigurations' => [ // REQUIRED [ 'AppInstanceDataType' => 'Channel|ChannelMessage', // REQUIRED 'ResourceArn' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
. - AppInstanceStreamingConfigurations
-
- Required: Yes
- Type: Array of AppInstanceStreamingConfiguration structures
The streaming configurations set for an
AppInstance
.
Result Syntax
[ 'AppInstanceStreamingConfigurations' => [ [ 'AppInstanceDataType' => 'Channel|ChannelMessage', 'ResourceArn' => '<string>', ], // ... ], ]
Result Details
Members
- AppInstanceStreamingConfigurations
-
- Type: Array of AppInstanceStreamingConfiguration structures
The streaming configurations of an
AppInstance
.
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutEventsConfiguration
$result = $client->putEventsConfiguration
([/* ... */]); $promise = $client->putEventsConfigurationAsync
([/* ... */]);
Creates an events configuration that allows a bot to receive outgoing events sent by Amazon Chime. Choose either an HTTPS endpoint or a Lambda function ARN. For more information, see Bot.
Parameter Syntax
$result = $client->putEventsConfiguration([ 'AccountId' => '<string>', // REQUIRED 'BotId' => '<string>', // REQUIRED 'LambdaFunctionArn' => '<string>', 'OutboundEventsHTTPSEndpoint' => '<string>', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- BotId
-
- Required: Yes
- Type: string
The bot ID.
- LambdaFunctionArn
-
- Type: string
Lambda function ARN that allows the bot to receive outgoing events.
- OutboundEventsHTTPSEndpoint
-
- Type: string
HTTPS endpoint that allows the bot to receive outgoing events.
Result Syntax
[ 'EventsConfiguration' => [ 'BotId' => '<string>', 'LambdaFunctionArn' => '<string>', 'OutboundEventsHTTPSEndpoint' => '<string>', ], ]
Result Details
Members
- EventsConfiguration
-
- Type: EventsConfiguration structure
The configuration that allows a bot to receive outgoing events. Can be an HTTPS endpoint or an AWS Lambda function ARN.
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
PutRetentionSettings
$result = $client->putRetentionSettings
([/* ... */]); $promise = $client->putRetentionSettingsAsync
([/* ... */]);
Puts retention settings for the specified Amazon Chime Enterprise account. We recommend using AWS CloudTrail to monitor usage of this API for your account. For more information, see Logging Amazon Chime API Calls with AWS CloudTrail in the Amazon Chime Administration Guide.
To turn off existing retention settings, remove the number of days from the corresponding RetentionDays field in the RetentionSettings object. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide.
Parameter Syntax
$result = $client->putRetentionSettings([ 'AccountId' => '<string>', // REQUIRED 'RetentionSettings' => [ // REQUIRED 'ConversationRetentionSettings' => [ 'RetentionDays' => <integer>, ], 'RoomRetentionSettings' => [ 'RetentionDays' => <integer>, ], ], ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- RetentionSettings
-
- Required: Yes
- Type: RetentionSettings structure
The retention settings.
Result Syntax
[ 'InitiateDeletionTimestamp' => <DateTime>, 'RetentionSettings' => [ 'ConversationRetentionSettings' => [ 'RetentionDays' => <integer>, ], 'RoomRetentionSettings' => [ 'RetentionDays' => <integer>, ], ], ]
Result Details
Members
- InitiateDeletionTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp representing the time at which the specified items are permanently deleted, in ISO 8601 format.
- RetentionSettings
-
- Type: RetentionSettings structure
The retention settings.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutSipMediaApplicationLoggingConfiguration
$result = $client->putSipMediaApplicationLoggingConfiguration
([/* ... */]); $promise = $client->putSipMediaApplicationLoggingConfigurationAsync
([/* ... */]);
Updates the logging configuration for the specified SIP media application.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutSipMediaApplicationLoggingConfiguration, 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.
Parameter Syntax
$result = $client->putSipMediaApplicationLoggingConfiguration([ 'SipMediaApplicationId' => '<string>', // REQUIRED 'SipMediaApplicationLoggingConfiguration' => [ 'EnableSipMediaApplicationMessageLogs' => true || false, ], ]);
Parameter Details
Members
- SipMediaApplicationId
-
- Required: Yes
- Type: string
The SIP media application ID.
- SipMediaApplicationLoggingConfiguration
-
- Type: SipMediaApplicationLoggingConfiguration structure
The actual logging configuration.
Result Syntax
[ 'SipMediaApplicationLoggingConfiguration' => [ 'EnableSipMediaApplicationMessageLogs' => true || false, ], ]
Result Details
Members
- SipMediaApplicationLoggingConfiguration
-
- Type: SipMediaApplicationLoggingConfiguration structure
The logging configuration of the SIP media application.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutVoiceConnectorEmergencyCallingConfiguration
$result = $client->putVoiceConnectorEmergencyCallingConfiguration
([/* ... */]); $promise = $client->putVoiceConnectorEmergencyCallingConfigurationAsync
([/* ... */]);
Puts emergency calling configuration details to the specified Amazon Chime Voice Connector, such as emergency phone numbers and calling countries. Origination and termination settings must be enabled for the Amazon Chime Voice Connector before emergency calling can be configured.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutVoiceConnectorEmergencyCallingConfiguration, 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.
Parameter Syntax
$result = $client->putVoiceConnectorEmergencyCallingConfiguration([ 'EmergencyCallingConfiguration' => [ // REQUIRED 'DNIS' => [ [ 'CallingCountry' => '<string>', // REQUIRED 'EmergencyPhoneNumber' => '<string>', // REQUIRED 'TestPhoneNumber' => '<string>', ], // ... ], ], 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- EmergencyCallingConfiguration
-
- Required: Yes
- Type: EmergencyCallingConfiguration structure
The emergency calling configuration details.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'EmergencyCallingConfiguration' => [ 'DNIS' => [ [ 'CallingCountry' => '<string>', 'EmergencyPhoneNumber' => '<string>', 'TestPhoneNumber' => '<string>', ], // ... ], ], ]
Result Details
Members
- EmergencyCallingConfiguration
-
- Type: EmergencyCallingConfiguration structure
The emergency calling configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutVoiceConnectorLoggingConfiguration
$result = $client->putVoiceConnectorLoggingConfiguration
([/* ... */]); $promise = $client->putVoiceConnectorLoggingConfigurationAsync
([/* ... */]);
Adds a logging configuration for the specified Amazon Chime Voice Connector. The logging configuration specifies whether SIP message logs are enabled for sending to Amazon CloudWatch Logs.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutVoiceConnectorLoggingConfiguration, 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.
Parameter Syntax
$result = $client->putVoiceConnectorLoggingConfiguration([ 'LoggingConfiguration' => [ // REQUIRED 'EnableMediaMetricLogs' => true || false, 'EnableSIPLogs' => true || false, ], 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- LoggingConfiguration
-
- Required: Yes
- Type: LoggingConfiguration structure
The logging configuration details to add.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'LoggingConfiguration' => [ 'EnableMediaMetricLogs' => true || false, 'EnableSIPLogs' => true || false, ], ]
Result Details
Members
- LoggingConfiguration
-
- Type: LoggingConfiguration structure
The updated logging configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutVoiceConnectorOrigination
$result = $client->putVoiceConnectorOrigination
([/* ... */]); $promise = $client->putVoiceConnectorOriginationAsync
([/* ... */]);
Adds origination settings for the specified Amazon Chime Voice Connector.
If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to turning off origination settings.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutVoiceConnectorOrigination, 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.
Parameter Syntax
$result = $client->putVoiceConnectorOrigination([ 'Origination' => [ // REQUIRED 'Disabled' => true || false, 'Routes' => [ [ 'Host' => '<string>', 'Port' => <integer>, 'Priority' => <integer>, 'Protocol' => 'TCP|UDP', 'Weight' => <integer>, ], // ... ], ], 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Origination
-
- Required: Yes
- Type: Origination structure
The origination setting details to add.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'Origination' => [ 'Disabled' => true || false, 'Routes' => [ [ 'Host' => '<string>', 'Port' => <integer>, 'Priority' => <integer>, 'Protocol' => 'TCP|UDP', 'Weight' => <integer>, ], // ... ], ], ]
Result Details
Members
- Origination
-
- Type: Origination structure
The updated origination setting details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutVoiceConnectorProxy
$result = $client->putVoiceConnectorProxy
([/* ... */]); $promise = $client->putVoiceConnectorProxyAsync
([/* ... */]);
Puts the specified proxy configuration to the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutVoiceConnectorProxy, 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.
Parameter Syntax
$result = $client->putVoiceConnectorProxy([ 'DefaultSessionExpiryMinutes' => <integer>, // REQUIRED 'Disabled' => true || false, 'FallBackPhoneNumber' => '<string>', 'PhoneNumberPoolCountries' => ['<string>', ...], // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- DefaultSessionExpiryMinutes
-
- Required: Yes
- Type: int
The default number of minutes allowed for proxy sessions.
- Disabled
-
- Type: boolean
When true, stops proxy sessions from being created on the specified Amazon Chime Voice Connector.
- FallBackPhoneNumber
-
- Type: string
The phone number to route calls to after a proxy session expires.
- PhoneNumberPoolCountries
-
- Required: Yes
- Type: Array of strings
The countries for proxy phone numbers to be selected from.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime voice connector ID.
Result Syntax
[ 'Proxy' => [ 'DefaultSessionExpiryMinutes' => <integer>, 'Disabled' => true || false, 'FallBackPhoneNumber' => '<string>', 'PhoneNumberCountries' => ['<string>', ...], ], ]
Result Details
Members
- Proxy
-
- Type: Proxy structure
The proxy configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutVoiceConnectorStreamingConfiguration
$result = $client->putVoiceConnectorStreamingConfiguration
([/* ... */]); $promise = $client->putVoiceConnectorStreamingConfigurationAsync
([/* ... */]);
Adds a streaming configuration for the specified Amazon Chime Voice Connector. The streaming configuration specifies whether media streaming is enabled for sending to Kinesis. It also sets the retention period, in hours, for the Amazon Kinesis data.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutVoiceConnectorStreamingConfiguration, 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.
Parameter Syntax
$result = $client->putVoiceConnectorStreamingConfiguration([ 'StreamingConfiguration' => [ // REQUIRED 'DataRetentionInHours' => <integer>, // REQUIRED 'Disabled' => true || false, 'StreamingNotificationTargets' => [ [ 'NotificationTarget' => 'EventBridge|SNS|SQS', // REQUIRED ], // ... ], ], 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- StreamingConfiguration
-
- Required: Yes
- Type: StreamingConfiguration structure
The streaming configuration details to add.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'StreamingConfiguration' => [ 'DataRetentionInHours' => <integer>, 'Disabled' => true || false, 'StreamingNotificationTargets' => [ [ 'NotificationTarget' => 'EventBridge|SNS|SQS', ], // ... ], ], ]
Result Details
Members
- StreamingConfiguration
-
- Type: StreamingConfiguration structure
The updated streaming configuration details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutVoiceConnectorTermination
$result = $client->putVoiceConnectorTermination
([/* ... */]); $promise = $client->putVoiceConnectorTerminationAsync
([/* ... */]);
Adds termination settings for the specified Amazon Chime Voice Connector.
If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to turning off termination settings.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutVoiceConnectorTermination, 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.
Parameter Syntax
$result = $client->putVoiceConnectorTermination([ 'Termination' => [ // REQUIRED 'CallingRegions' => ['<string>', ...], 'CidrAllowedList' => ['<string>', ...], 'CpsLimit' => <integer>, 'DefaultPhoneNumber' => '<string>', 'Disabled' => true || false, ], 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Termination
-
- Required: Yes
- Type: Termination structure
The termination setting details to add.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'Termination' => [ 'CallingRegions' => ['<string>', ...], 'CidrAllowedList' => ['<string>', ...], 'CpsLimit' => <integer>, 'DefaultPhoneNumber' => '<string>', 'Disabled' => true || false, ], ]
Result Details
Members
- Termination
-
- Type: Termination structure
The updated termination setting details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
PutVoiceConnectorTerminationCredentials
$result = $client->putVoiceConnectorTerminationCredentials
([/* ... */]); $promise = $client->putVoiceConnectorTerminationCredentialsAsync
([/* ... */]);
Adds termination SIP credentials for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, PutVoiceConnectorTerminationCredentials, 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.
Parameter Syntax
$result = $client->putVoiceConnectorTerminationCredentials([ 'Credentials' => [ [ 'Password' => '<string>', 'Username' => '<string>', ], // ... ], 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Credentials
-
- Type: Array of Credential structures
The termination SIP credentials.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
RedactChannelMessage
$result = $client->redactChannelMessage
([/* ... */]); $promise = $client->redactChannelMessageAsync
([/* ... */]);
Redacts message content, but not metadata. The message exists in the back end, but the action returns null content, and the state shows as redacted.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, RedactChannelMessage, 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.
Parameter Syntax
$result = $client->redactChannelMessage([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'MessageId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel containing the messages that you want to redact.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - MessageId
-
- Required: Yes
- Type: string
The ID of the message being redacted.
Result Syntax
[ 'ChannelArn' => '<string>', 'MessageId' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel containing the messages that you want to redact.
- MessageId
-
- Type: string
The ID of the message being redacted.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
RedactConversationMessage
$result = $client->redactConversationMessage
([/* ... */]); $promise = $client->redactConversationMessageAsync
([/* ... */]);
Redacts the specified message from the specified Amazon Chime conversation.
Parameter Syntax
$result = $client->redactConversationMessage([ 'AccountId' => '<string>', // REQUIRED 'ConversationId' => '<string>', // REQUIRED 'MessageId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- ConversationId
-
- Required: Yes
- Type: string
The conversation ID.
- MessageId
-
- Required: Yes
- Type: string
The message ID.
Result Syntax
[]
Result Details
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
RedactRoomMessage
$result = $client->redactRoomMessage
([/* ... */]); $promise = $client->redactRoomMessageAsync
([/* ... */]);
Redacts the specified message from the specified Amazon Chime channel.
Parameter Syntax
$result = $client->redactRoomMessage([ 'AccountId' => '<string>', // REQUIRED 'MessageId' => '<string>', // REQUIRED 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MessageId
-
- Required: Yes
- Type: string
The message ID.
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[]
Result Details
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
RegenerateSecurityToken
$result = $client->regenerateSecurityToken
([/* ... */]); $promise = $client->regenerateSecurityTokenAsync
([/* ... */]);
Regenerates the security token for a bot.
Parameter Syntax
$result = $client->regenerateSecurityToken([ 'AccountId' => '<string>', // REQUIRED 'BotId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- BotId
-
- Required: Yes
- Type: string
The bot ID.
Result Syntax
[ 'Bot' => [ 'BotEmail' => '<string>', 'BotId' => '<string>', 'BotType' => 'ChatBot', 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'DisplayName' => '<string>', 'SecurityToken' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'UserId' => '<string>', ], ]
Result Details
Members
- Bot
-
- Type: Bot structure
A resource that allows Enterprise account administrators to configure an interface that receives events from Amazon Chime.
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
ResetPersonalPIN
$result = $client->resetPersonalPIN
([/* ... */]); $promise = $client->resetPersonalPINAsync
([/* ... */]);
Resets the personal meeting PIN for the specified user on an Amazon Chime account. Returns the User object with the updated personal meeting PIN.
Parameter Syntax
$result = $client->resetPersonalPIN([ 'AccountId' => '<string>', // REQUIRED 'UserId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserId
-
- Required: Yes
- Type: string
The user ID.
Result Syntax
[ 'User' => [ 'AccountId' => '<string>', 'AlexaForBusinessMetadata' => [ 'AlexaForBusinessRoomArn' => '<string>', 'IsAlexaForBusinessEnabled' => true || false, ], 'DisplayName' => '<string>', 'InvitedOn' => <DateTime>, 'LicenseType' => 'Basic|Plus|Pro|ProTrial', 'PersonalPIN' => '<string>', 'PrimaryEmail' => '<string>', 'PrimaryProvisionedNumber' => '<string>', 'RegisteredOn' => <DateTime>, 'UserId' => '<string>', 'UserInvitationStatus' => 'Pending|Accepted|Failed', 'UserRegistrationStatus' => 'Unregistered|Registered|Suspended', 'UserType' => 'PrivateUser|SharedDevice', ], ]
Result Details
Members
- User
-
- Type: User structure
The user details and new personal meeting PIN.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
RestorePhoneNumber
$result = $client->restorePhoneNumber
([/* ... */]); $promise = $client->restorePhoneNumberAsync
([/* ... */]);
Moves a phone number from the Deletion queue back into the phone number Inventory.
Parameter Syntax
$result = $client->restorePhoneNumber([ 'PhoneNumberId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- PhoneNumberId
-
- Required: Yes
- Type: string
The phone number.
Result Syntax
[ 'PhoneNumber' => [ 'Associations' => [ [ 'AssociatedTimestamp' => <DateTime>, 'Name' => 'AccountId|UserId|VoiceConnectorId|VoiceConnectorGroupId|SipRuleId', 'Value' => '<string>', ], // ... ], 'CallingName' => '<string>', 'CallingNameStatus' => 'Unassigned|UpdateInProgress|UpdateSucceeded|UpdateFailed', 'Capabilities' => [ 'InboundCall' => true || false, 'InboundMMS' => true || false, 'InboundSMS' => true || false, 'OutboundCall' => true || false, 'OutboundMMS' => true || false, 'OutboundSMS' => true || false, ], 'Country' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DeletionTimestamp' => <DateTime>, 'E164PhoneNumber' => '<string>', 'PhoneNumberId' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'AcquireInProgress|AcquireFailed|Unassigned|Assigned|ReleaseInProgress|DeleteInProgress|ReleaseFailed|DeleteFailed', 'Type' => 'Local|TollFree', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- PhoneNumber
-
- Type: PhoneNumber structure
The phone number details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
SearchAvailablePhoneNumbers
$result = $client->searchAvailablePhoneNumbers
([/* ... */]); $promise = $client->searchAvailablePhoneNumbersAsync
([/* ... */]);
Searches for phone numbers that can be ordered. For US numbers, provide at least one of the following search filters: AreaCode
, City
, State
, or TollFreePrefix
. If you provide City
, you must also provide State
. Numbers outside the US only support the PhoneNumberType
filter, which you must use.
Parameter Syntax
$result = $client->searchAvailablePhoneNumbers([ 'AreaCode' => '<string>', 'City' => '<string>', 'Country' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', 'PhoneNumberType' => 'Local|TollFree', 'State' => '<string>', 'TollFreePrefix' => '<string>', ]);
Parameter Details
Members
- AreaCode
-
- Type: string
The area code used to filter results. Only applies to the US.
- City
-
- Type: string
The city used to filter results. Only applies to the US.
- Country
-
- Type: string
The country used to filter results. Defaults to the US Format: ISO 3166-1 alpha-2.
- MaxResults
-
- Type: int
The maximum number of results to return in a single call.
- NextToken
-
- Type: string
The token used to retrieve the next page of results.
- PhoneNumberType
-
- Type: string
The phone number type used to filter results. Required for non-US numbers.
- State
-
- Type: string
The state used to filter results. Required only if you provide
City
. Only applies to the US. - TollFreePrefix
-
- Type: string
The toll-free prefix that you use to filter results. Only applies to the US.
Result Syntax
[ 'E164PhoneNumbers' => ['<string>', ...], 'NextToken' => '<string>', ]
Result Details
Members
- E164PhoneNumbers
-
- Type: Array of strings
List of phone numbers, in E.164 format.
- NextToken
-
- Type: string
The token used to retrieve the next page of search results.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- AccessDeniedException:
You don't have permissions to perform the requested operation.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
SendChannelMessage
$result = $client->sendChannelMessage
([/* ... */]); $promise = $client->sendChannelMessageAsync
([/* ... */]);
Sends a message to a particular channel that the member is a part of.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
Also, STANDARD
messages can contain 4KB of data and the 1KB of metadata. CONTROL
messages can contain 30 bytes of data and no metadata.
This API is is no longer supported and will not be updated. We recommend using the latest version, SendChannelMessage, 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.
Parameter Syntax
$result = $client->sendChannelMessage([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'ClientRequestToken' => '<string>', // REQUIRED 'Content' => '<string>', // REQUIRED 'Metadata' => '<string>', 'Persistence' => 'PERSISTENT|NON_PERSISTENT', // REQUIRED 'Type' => 'STANDARD|CONTROL', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - ClientRequestToken
-
- Required: Yes
- Type: string
The
Idempotency
token for each client request. - Content
-
- Required: Yes
- Type: string
The content of the message.
- Metadata
-
- Type: string
The optional metadata for each message.
- Persistence
-
- Required: Yes
- Type: string
Boolean that controls whether the message is persisted on the back end. Required.
- Type
-
- Required: Yes
- Type: string
The type of message,
STANDARD
orCONTROL
.
Result Syntax
[ 'ChannelArn' => '<string>', 'MessageId' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- MessageId
-
- Type: string
The ID string assigned to each message.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
StartMeetingTranscription
$result = $client->startMeetingTranscription
([/* ... */]); $promise = $client->startMeetingTranscriptionAsync
([/* ... */]);
Starts transcription for the specified meetingId
. For more information, refer to Using Amazon Chime SDK live transcription in the Amazon Chime SDK Developer Guide.
If you specify an invalid configuration, a TranscriptFailed
event will be sent with the contents of the BadRequestException
generated by Amazon Transcribe. For more information on each parameter and which combinations are valid, refer to the StartStreamTranscription API in the Amazon Transcribe Developer Guide.
Amazon Chime SDK live transcription is powered by Amazon Transcribe. Use of Amazon Transcribe is subject to the AWS Service Terms, including the terms specific to the AWS Machine Learning and Artificial Intelligence Services.
This API is is no longer supported and will not be updated. We recommend using the latest version, StartMeetingTranscription, 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.
Parameter Syntax
$result = $client->startMeetingTranscription([ 'MeetingId' => '<string>', // REQUIRED 'TranscriptionConfiguration' => [ // REQUIRED 'EngineTranscribeMedicalSettings' => [ 'ContentIdentificationType' => 'PHI', 'LanguageCode' => 'en-US', // REQUIRED 'Region' => 'us-east-1|us-east-2|us-west-2|ap-southeast-2|ca-central-1|eu-west-1|auto', 'Specialty' => 'PRIMARYCARE|CARDIOLOGY|NEUROLOGY|ONCOLOGY|RADIOLOGY|UROLOGY', // REQUIRED 'Type' => 'CONVERSATION|DICTATION', // REQUIRED 'VocabularyName' => '<string>', ], 'EngineTranscribeSettings' => [ 'ContentIdentificationType' => 'PII', 'ContentRedactionType' => 'PII', 'EnablePartialResultsStabilization' => true || false, 'IdentifyLanguage' => true || false, 'LanguageCode' => 'en-US|en-GB|es-US|fr-CA|fr-FR|en-AU|it-IT|de-DE|pt-BR|ja-JP|ko-KR|zh-CN|th-TH|hi-IN', 'LanguageModelName' => '<string>', 'LanguageOptions' => '<string>', 'PartialResultsStability' => 'low|medium|high', 'PiiEntityTypes' => '<string>', 'PreferredLanguage' => 'en-US|en-GB|es-US|fr-CA|fr-FR|en-AU|it-IT|de-DE|pt-BR|ja-JP|ko-KR|zh-CN|th-TH|hi-IN', 'Region' => 'us-east-2|us-east-1|us-west-2|ap-northeast-2|ap-southeast-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|sa-east-1|auto', 'VocabularyFilterMethod' => 'remove|mask|tag', 'VocabularyFilterName' => '<string>', 'VocabularyFilterNames' => '<string>', 'VocabularyName' => '<string>', 'VocabularyNames' => '<string>', ], ], ]);
Parameter Details
Members
- MeetingId
-
- Required: Yes
- Type: string
The unique ID of the meeting being transcribed.
- TranscriptionConfiguration
-
- Required: Yes
- Type: TranscriptionConfiguration structure
The configuration for the current transcription operation. Must contain
EngineTranscribeSettings
orEngineTranscribeMedicalSettings
.
Result Syntax
[]
Result Details
Errors
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- UnprocessableEntityException:
The request was well-formed but was unable to be followed due to semantic errors.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
StopMeetingTranscription
$result = $client->stopMeetingTranscription
([/* ... */]); $promise = $client->stopMeetingTranscriptionAsync
([/* ... */]);
Stops transcription for the specified meetingId
.
This API is is no longer supported and will not be updated. We recommend using the latest version, StopMeetingTranscription, 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.
Parameter Syntax
$result = $client->stopMeetingTranscription([ 'MeetingId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MeetingId
-
- Required: Yes
- Type: string
The unique ID of the meeting for which you stop transcription.
Result Syntax
[]
Result Details
Errors
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- UnprocessableEntityException:
The request was well-formed but was unable to be followed due to semantic errors.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
TagAttendee
$result = $client->tagAttendee
([/* ... */]); $promise = $client->tagAttendeeAsync
([/* ... */]);
Applies the specified tags to the specified Amazon Chime attendee.
TagAttendee is not supported in the Amazon Chime SDK Meetings Namespace. Update your application to remove calls to this API.
Parameter Syntax
$result = $client->tagAttendee([ 'AttendeeId' => '<string>', // REQUIRED 'MeetingId' => '<string>', // REQUIRED 'Tags' => [ // REQUIRED [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- AttendeeId
-
- Required: Yes
- Type: string
The Amazon Chime SDK attendee ID.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
- Tags
-
- Required: Yes
- Type: Array of Tag structures
The tag key-value pairs.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
TagMeeting
$result = $client->tagMeeting
([/* ... */]); $promise = $client->tagMeetingAsync
([/* ... */]);
Applies the specified tags to the specified Amazon Chime SDK meeting.
This API is is no longer supported and will not be updated. We recommend using the latest version, TagResource, 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.
Parameter Syntax
$result = $client->tagMeeting([ 'MeetingId' => '<string>', // REQUIRED 'Tags' => [ // REQUIRED [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
- Tags
-
- Required: Yes
- Type: Array of Tag structures
The tag key-value pairs.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
Applies the specified tags to the specified Amazon Chime SDK meeting resource.
This API is is no longer supported and will not be updated. We recommend using the latest version, TagResource, 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.
Parameter Syntax
$result = $client->tagResource([ 'ResourceARN' => '<string>', // REQUIRED 'Tags' => [ // REQUIRED [ 'Key' => '<string>', // REQUIRED 'Value' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- ResourceARN
-
- Required: Yes
- Type: string
The resource ARN.
- Tags
-
- Required: Yes
- Type: Array of Tag structures
The tag key-value pairs.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UntagAttendee
$result = $client->untagAttendee
([/* ... */]); $promise = $client->untagAttendeeAsync
([/* ... */]);
Untags the specified tags from the specified Amazon Chime SDK attendee.
UntagAttendee is not supported in the Amazon Chime SDK Meetings Namespace. Update your application to remove calls to this API.
Parameter Syntax
$result = $client->untagAttendee([ 'AttendeeId' => '<string>', // REQUIRED 'MeetingId' => '<string>', // REQUIRED 'TagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- AttendeeId
-
- Required: Yes
- Type: string
The Amazon Chime SDK attendee ID.
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
- TagKeys
-
- Required: Yes
- Type: Array of strings
The tag keys.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UntagMeeting
$result = $client->untagMeeting
([/* ... */]); $promise = $client->untagMeetingAsync
([/* ... */]);
Untags the specified tags from the specified Amazon Chime SDK meeting.
This API is is no longer supported and will not be updated. We recommend using the latest version, UntagResource, 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.
Parameter Syntax
$result = $client->untagMeeting([ 'MeetingId' => '<string>', // REQUIRED 'TagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- MeetingId
-
- Required: Yes
- Type: string
The Amazon Chime SDK meeting ID.
- TagKeys
-
- Required: Yes
- Type: Array of strings
The tag keys.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
Untags the specified tags from the specified Amazon Chime SDK meeting resource.
Applies the specified tags to the specified Amazon Chime SDK meeting resource.
This API is is no longer supported and will not be updated. We recommend using the latest version, UntagResource, 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.
Parameter Syntax
$result = $client->untagResource([ 'ResourceARN' => '<string>', // REQUIRED 'TagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- ResourceARN
-
- Required: Yes
- Type: string
The resource ARN.
- TagKeys
-
- Required: Yes
- Type: Array of strings
The tag keys.
Result Syntax
[]
Result Details
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateAccount
$result = $client->updateAccount
([/* ... */]); $promise = $client->updateAccountAsync
([/* ... */]);
Updates account details for the specified Amazon Chime account. Currently, only account name and default license updates are supported for this action.
Parameter Syntax
$result = $client->updateAccount([ 'AccountId' => '<string>', // REQUIRED 'DefaultLicense' => 'Basic|Plus|Pro|ProTrial', 'Name' => '<string>', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- DefaultLicense
-
- Type: string
The default license applied when you add users to an Amazon Chime account.
- Name
-
- Type: string
The new name for the specified Amazon Chime account.
Result Syntax
[ 'Account' => [ 'AccountId' => '<string>', 'AccountStatus' => 'Suspended|Active', 'AccountType' => 'Team|EnterpriseDirectory|EnterpriseLWA|EnterpriseOIDC', 'AwsAccountId' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DefaultLicense' => 'Basic|Plus|Pro|ProTrial', 'Name' => '<string>', 'SigninDelegateGroups' => [ [ 'GroupName' => '<string>', ], // ... ], 'SupportedLicenses' => ['<string>', ...], ], ]
Result Details
Members
- Account
-
- Type: Account structure
The updated Amazon Chime account details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateAccountSettings
$result = $client->updateAccountSettings
([/* ... */]); $promise = $client->updateAccountSettingsAsync
([/* ... */]);
Updates the settings for the specified Amazon Chime account. You can update settings for remote control of shared screens, or for the dial-out option. For more information about these settings, see Use the Policies Page in the Amazon Chime Administration Guide.
Parameter Syntax
$result = $client->updateAccountSettings([ 'AccountId' => '<string>', // REQUIRED 'AccountSettings' => [ // REQUIRED 'DisableRemoteControl' => true || false, 'EnableDialOut' => true || false, ], ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- AccountSettings
-
- Required: Yes
- Type: AccountSettings structure
The Amazon Chime account settings to update.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateAppInstance
$result = $client->updateAppInstance
([/* ... */]); $promise = $client->updateAppInstanceAsync
([/* ... */]);
Updates AppInstance
metadata.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateAppInstance, 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.
Parameter Syntax
$result = $client->updateAppInstance([ 'AppInstanceArn' => '<string>', // REQUIRED 'Metadata' => '<string>', 'Name' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstance
. - Metadata
-
- Type: string
The metadata that you want to change.
- Name
-
- Required: Yes
- Type: string
The name that you want to change.
Result Syntax
[ 'AppInstanceArn' => '<string>', ]
Result Details
Members
- AppInstanceArn
-
- Type: string
The ARN of the
AppInstance
.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateAppInstanceUser
$result = $client->updateAppInstanceUser
([/* ... */]); $promise = $client->updateAppInstanceUserAsync
([/* ... */]);
Updates the details of an AppInstanceUser
. You can update names and metadata.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateAppInstanceUser, 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.
Parameter Syntax
$result = $client->updateAppInstanceUser([ 'AppInstanceUserArn' => '<string>', // REQUIRED 'Metadata' => '<string>', 'Name' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AppInstanceUserArn
-
- Required: Yes
- Type: string
The ARN of the
AppInstanceUser
. - Metadata
-
- Type: string
The metadata of the
AppInstanceUser
. - Name
-
- Required: Yes
- Type: string
The name of the
AppInstanceUser
.
Result Syntax
[ 'AppInstanceUserArn' => '<string>', ]
Result Details
Members
- AppInstanceUserArn
-
- Type: string
The ARN of the
AppInstanceUser
.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateBot
$result = $client->updateBot
([/* ... */]); $promise = $client->updateBotAsync
([/* ... */]);
Updates the status of the specified bot, such as starting or stopping the bot from running in your Amazon Chime Enterprise account.
Parameter Syntax
$result = $client->updateBot([ 'AccountId' => '<string>', // REQUIRED 'BotId' => '<string>', // REQUIRED 'Disabled' => true || false, ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- BotId
-
- Required: Yes
- Type: string
The bot ID.
- Disabled
-
- Type: boolean
When true, stops the specified bot from running in your account.
Result Syntax
[ 'Bot' => [ 'BotEmail' => '<string>', 'BotId' => '<string>', 'BotType' => 'ChatBot', 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'DisplayName' => '<string>', 'SecurityToken' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'UserId' => '<string>', ], ]
Result Details
Members
- Bot
-
- Type: Bot structure
The updated bot details.
Errors
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ThrottledClientException:
The client exceeded its request rate limit.
UpdateChannel
$result = $client->updateChannel
([/* ... */]); $promise = $client->updateChannelAsync
([/* ... */]);
Update a channel's attributes.
Restriction: You can't change a channel's privacy.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateChannel, 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.
Parameter Syntax
$result = $client->updateChannel([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'Metadata' => '<string>', 'Mode' => 'UNRESTRICTED|RESTRICTED', // REQUIRED 'Name' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - Metadata
-
- Type: string
The metadata for the update request.
- Mode
-
- Required: Yes
- Type: string
The mode of the update request.
- Name
-
- Required: Yes
- Type: string
The name of the channel.
Result Syntax
[ 'ChannelArn' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateChannelMessage
$result = $client->updateChannelMessage
([/* ... */]); $promise = $client->updateChannelMessageAsync
([/* ... */]);
Updates the content of a message.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateChannelMessage, 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.
Parameter Syntax
$result = $client->updateChannelMessage([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', 'Content' => '<string>', 'MessageId' => '<string>', // REQUIRED 'Metadata' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call. - Content
-
- Type: string
The content of the message being updated.
- MessageId
-
- Required: Yes
- Type: string
The ID string of the message being updated.
- Metadata
-
- Type: string
The metadata of the message being updated.
Result Syntax
[ 'ChannelArn' => '<string>', 'MessageId' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- MessageId
-
- Type: string
The ID string of the message being updated.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ForbiddenException:
The client is permanently forbidden from making the request.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateChannelReadMarker
$result = $client->updateChannelReadMarker
([/* ... */]); $promise = $client->updateChannelReadMarkerAsync
([/* ... */]);
The details of the time when a user last read messages in a channel.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateChannelReadMarker, 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.
Parameter Syntax
$result = $client->updateChannelReadMarker([ 'ChannelArn' => '<string>', // REQUIRED 'ChimeBearer' => '<string>', ]);
Parameter Details
Members
- ChannelArn
-
- Required: Yes
- Type: string
The ARN of the channel.
- ChimeBearer
-
- Type: string
The
AppInstanceUserArn
of the user that makes the API call.
Result Syntax
[ 'ChannelArn' => '<string>', ]
Result Details
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateGlobalSettings
$result = $client->updateGlobalSettings
([/* ... */]); $promise = $client->updateGlobalSettingsAsync
([/* ... */]);
Updates global settings for the administrator's AWS account, such as Amazon Chime Business Calling and Amazon Chime Voice Connector settings.
Parameter Syntax
$result = $client->updateGlobalSettings([ 'BusinessCalling' => [ 'CdrBucket' => '<string>', ], 'VoiceConnector' => [ 'CdrBucket' => '<string>', ], ]);
Parameter Details
Members
- BusinessCalling
-
- Type: BusinessCallingSettings structure
The Amazon Chime Business Calling settings.
- VoiceConnector
-
- Type: VoiceConnectorSettings structure
The Amazon Chime Voice Connector settings.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdatePhoneNumber
$result = $client->updatePhoneNumber
([/* ... */]); $promise = $client->updatePhoneNumberAsync
([/* ... */]);
Updates phone number details, such as product type or calling name, for the specified phone number ID. You can update one phone number detail at a time. For example, you can update either the product type or the calling name in one action.
For toll-free numbers, you cannot use the Amazon Chime Business Calling product type. For numbers outside the U.S., you must use the Amazon Chime SIP Media Application Dial-In product type.
Updates to outbound calling names can take 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.
Parameter Syntax
$result = $client->updatePhoneNumber([ 'CallingName' => '<string>', 'PhoneNumberId' => '<string>', // REQUIRED 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', ]);
Parameter Details
Members
- CallingName
-
- Type: string
The outbound calling name associated with the phone number.
- PhoneNumberId
-
- Required: Yes
- Type: string
The phone number ID.
- ProductType
-
- Type: string
The product type.
Result Syntax
[ 'PhoneNumber' => [ 'Associations' => [ [ 'AssociatedTimestamp' => <DateTime>, 'Name' => 'AccountId|UserId|VoiceConnectorId|VoiceConnectorGroupId|SipRuleId', 'Value' => '<string>', ], // ... ], 'CallingName' => '<string>', 'CallingNameStatus' => 'Unassigned|UpdateInProgress|UpdateSucceeded|UpdateFailed', 'Capabilities' => [ 'InboundCall' => true || false, 'InboundMMS' => true || false, 'InboundSMS' => true || false, 'OutboundCall' => true || false, 'OutboundMMS' => true || false, 'OutboundSMS' => true || false, ], 'Country' => '<string>', 'CreatedTimestamp' => <DateTime>, 'DeletionTimestamp' => <DateTime>, 'E164PhoneNumber' => '<string>', 'PhoneNumberId' => '<string>', 'ProductType' => 'BusinessCalling|VoiceConnector|SipMediaApplicationDialIn', 'Status' => 'AcquireInProgress|AcquireFailed|Unassigned|Assigned|ReleaseInProgress|DeleteInProgress|ReleaseFailed|DeleteFailed', 'Type' => 'Local|TollFree', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- PhoneNumber
-
- Type: PhoneNumber structure
The updated phone number details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdatePhoneNumberSettings
$result = $client->updatePhoneNumberSettings
([/* ... */]); $promise = $client->updatePhoneNumberSettingsAsync
([/* ... */]);
Updates the phone number settings for the administrator's AWS account, such as the default outbound calling name. You can update the default outbound calling name once every seven days. Outbound calling names can take up to 72 hours to update.
Parameter Syntax
$result = $client->updatePhoneNumberSettings([ 'CallingName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- CallingName
-
- Required: Yes
- Type: string
The default outbound calling name for the account.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateProxySession
$result = $client->updateProxySession
([/* ... */]); $promise = $client->updateProxySessionAsync
([/* ... */]);
Updates the specified proxy session details, such as voice or SMS capabilities.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateProxySession, 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.
Parameter Syntax
$result = $client->updateProxySession([ 'Capabilities' => ['<string>', ...], // REQUIRED 'ExpiryMinutes' => <integer>, 'ProxySessionId' => '<string>', // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Capabilities
-
- Required: Yes
- Type: Array of strings
The proxy session capabilities.
- ExpiryMinutes
-
- Type: int
The number of minutes allowed for the proxy session.
- ProxySessionId
-
- Required: Yes
- Type: string
The proxy session ID.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime voice connector ID.
Result Syntax
[ 'ProxySession' => [ 'Capabilities' => ['<string>', ...], 'CreatedTimestamp' => <DateTime>, 'EndedTimestamp' => <DateTime>, 'ExpiryMinutes' => <integer>, 'GeoMatchLevel' => 'Country|AreaCode', 'GeoMatchParams' => [ 'AreaCode' => '<string>', 'Country' => '<string>', ], 'Name' => '<string>', 'NumberSelectionBehavior' => 'PreferSticky|AvoidSticky', 'Participants' => [ [ 'PhoneNumber' => '<string>', 'ProxyPhoneNumber' => '<string>', ], // ... ], 'ProxySessionId' => '<string>', 'Status' => 'Open|InProgress|Closed', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorId' => '<string>', ], ]
Result Details
Members
- ProxySession
-
- Type: ProxySession structure
The proxy session details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateRoom
$result = $client->updateRoom
([/* ... */]); $promise = $client->updateRoomAsync
([/* ... */]);
Updates room details, such as the room name, for a room in an Amazon Chime Enterprise account.
Parameter Syntax
$result = $client->updateRoom([ 'AccountId' => '<string>', // REQUIRED 'Name' => '<string>', 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- Name
-
- Type: string
The room name.
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[ 'Room' => [ 'AccountId' => '<string>', 'CreatedBy' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'RoomId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- Room
-
- Type: Room structure
The room details.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateRoomMembership
$result = $client->updateRoomMembership
([/* ... */]); $promise = $client->updateRoomMembershipAsync
([/* ... */]);
Updates room membership details, such as the member role, for a room in an Amazon Chime Enterprise account. The member role designates whether the member is a chat room administrator or a general chat room member. The member role can be updated only for user IDs.
Parameter Syntax
$result = $client->updateRoomMembership([ 'AccountId' => '<string>', // REQUIRED 'MemberId' => '<string>', // REQUIRED 'Role' => 'Administrator|Member', 'RoomId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- MemberId
-
- Required: Yes
- Type: string
The member ID.
- Role
-
- Type: string
The role of the member.
- RoomId
-
- Required: Yes
- Type: string
The room ID.
Result Syntax
[ 'RoomMembership' => [ 'InvitedBy' => '<string>', 'Member' => [ 'AccountId' => '<string>', 'Email' => '<string>', 'FullName' => '<string>', 'MemberId' => '<string>', 'MemberType' => 'User|Bot|Webhook', ], 'Role' => 'Administrator|Member', 'RoomId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- RoomMembership
-
- Type: RoomMembership structure
The room membership details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateSipMediaApplication
$result = $client->updateSipMediaApplication
([/* ... */]); $promise = $client->updateSipMediaApplicationAsync
([/* ... */]);
Updates the details of the specified SIP media application.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateSipMediaApplication, 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.
Parameter Syntax
$result = $client->updateSipMediaApplication([ 'Endpoints' => [ [ 'LambdaArn' => '<string>', ], // ... ], 'Name' => '<string>', 'SipMediaApplicationId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Endpoints
-
- Type: Array of SipMediaApplicationEndpoint structures
The new set of endpoints for the specified SIP media application.
- Name
-
- Type: string
The new name for the specified SIP media application.
- SipMediaApplicationId
-
- Required: Yes
- Type: string
The SIP media application ID.
Result Syntax
[ 'SipMediaApplication' => [ 'AwsRegion' => '<string>', 'CreatedTimestamp' => <DateTime>, 'Endpoints' => [ [ 'LambdaArn' => '<string>', ], // ... ], 'Name' => '<string>', 'SipMediaApplicationId' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- SipMediaApplication
-
- Type: SipMediaApplication structure
The updated SIP media application details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateSipMediaApplicationCall
$result = $client->updateSipMediaApplicationCall
([/* ... */]); $promise = $client->updateSipMediaApplicationCallAsync
([/* ... */]);
Invokes the AWS Lambda function associated with the SIP media application and transaction ID in an update request. The Lambda function can then return a new set of actions.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateSipMediaApplicationCall, 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.
Parameter Syntax
$result = $client->updateSipMediaApplicationCall([ 'Arguments' => ['<string>', ...], // REQUIRED 'SipMediaApplicationId' => '<string>', // REQUIRED 'TransactionId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Arguments
-
- Required: Yes
- Type: Associative array of custom strings keys (SensitiveString) to strings
Arguments made available to the Lambda function as part of the
CALL_UPDATE_REQUESTED
event. Can contain 0-20 key-value pairs. - SipMediaApplicationId
-
- Required: Yes
- Type: string
The ID of the SIP media application handling the call.
- TransactionId
-
- Required: Yes
- Type: string
The ID of the call transaction.
Result Syntax
[ 'SipMediaApplicationCall' => [ 'TransactionId' => '<string>', ], ]
Result Details
Members
- SipMediaApplicationCall
-
- Type: SipMediaApplicationCall structure
A
Call
instance for a SIP media application.
Errors
- BadRequestException:
The input parameters don't match the service's restrictions.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ThrottledClientException:
The client exceeded its request rate limit.
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateSipRule
$result = $client->updateSipRule
([/* ... */]); $promise = $client->updateSipRuleAsync
([/* ... */]);
Updates the details of the specified SIP rule.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateSipRule, 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.
Parameter Syntax
$result = $client->updateSipRule([ 'Disabled' => true || false, 'Name' => '<string>', // REQUIRED 'SipRuleId' => '<string>', // REQUIRED 'TargetApplications' => [ [ 'AwsRegion' => '<string>', 'Priority' => <integer>, 'SipMediaApplicationId' => '<string>', ], // ... ], ]);
Parameter Details
Members
- Disabled
-
- Type: boolean
The new value specified to indicate whether the rule is disabled.
- Name
-
- Required: Yes
- Type: string
The new name for the specified SIP rule.
- SipRuleId
-
- Required: Yes
- Type: string
The SIP rule ID.
- TargetApplications
-
- Type: Array of SipRuleTargetApplication structures
The new value of the list of target applications.
Result Syntax
[ 'SipRule' => [ 'CreatedTimestamp' => <DateTime>, 'Disabled' => true || false, 'Name' => '<string>', 'SipRuleId' => '<string>', 'TargetApplications' => [ [ 'AwsRegion' => '<string>', 'Priority' => <integer>, 'SipMediaApplicationId' => '<string>', ], // ... ], 'TriggerType' => 'ToPhoneNumber|RequestUriHostname', 'TriggerValue' => '<string>', 'UpdatedTimestamp' => <DateTime>, ], ]
Result Details
Members
- SipRule
-
- Type: SipRule structure
Updated SIP rule details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ResourceLimitExceededException:
The request exceeds the resource limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateUser
$result = $client->updateUser
([/* ... */]); $promise = $client->updateUserAsync
([/* ... */]);
Updates user details for a specified user ID. Currently, only LicenseType
updates are supported for this action.
Parameter Syntax
$result = $client->updateUser([ 'AccountId' => '<string>', // REQUIRED 'AlexaForBusinessMetadata' => [ 'AlexaForBusinessRoomArn' => '<string>', 'IsAlexaForBusinessEnabled' => true || false, ], 'LicenseType' => 'Basic|Plus|Pro|ProTrial', 'UserId' => '<string>', // REQUIRED 'UserType' => 'PrivateUser|SharedDevice', ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- AlexaForBusinessMetadata
-
- Type: AlexaForBusinessMetadata structure
The Alexa for Business metadata.
- LicenseType
-
- Type: string
The user license type to update. This must be a supported license type for the Amazon Chime account that the user belongs to.
- UserId
-
- Required: Yes
- Type: string
The user ID.
- UserType
-
- Type: string
The user type.
Result Syntax
[ 'User' => [ 'AccountId' => '<string>', 'AlexaForBusinessMetadata' => [ 'AlexaForBusinessRoomArn' => '<string>', 'IsAlexaForBusinessEnabled' => true || false, ], 'DisplayName' => '<string>', 'InvitedOn' => <DateTime>, 'LicenseType' => 'Basic|Plus|Pro|ProTrial', 'PersonalPIN' => '<string>', 'PrimaryEmail' => '<string>', 'PrimaryProvisionedNumber' => '<string>', 'RegisteredOn' => <DateTime>, 'UserId' => '<string>', 'UserInvitationStatus' => 'Pending|Accepted|Failed', 'UserRegistrationStatus' => 'Unregistered|Registered|Suspended', 'UserType' => 'PrivateUser|SharedDevice', ], ]
Result Details
Members
- User
-
- Type: User structure
The updated user details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateUserSettings
$result = $client->updateUserSettings
([/* ... */]); $promise = $client->updateUserSettingsAsync
([/* ... */]);
Updates the settings for the specified user, such as phone number settings.
Parameter Syntax
$result = $client->updateUserSettings([ 'AccountId' => '<string>', // REQUIRED 'UserId' => '<string>', // REQUIRED 'UserSettings' => [ // REQUIRED 'Telephony' => [ // REQUIRED 'InboundCalling' => true || false, // REQUIRED 'OutboundCalling' => true || false, // REQUIRED 'SMS' => true || false, // REQUIRED ], ], ]);
Parameter Details
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- UserId
-
- Required: Yes
- Type: string
The user ID.
- UserSettings
-
- Required: Yes
- Type: UserSettings structure
The user settings to update.
Result Syntax
[]
Result Details
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateVoiceConnector
$result = $client->updateVoiceConnector
([/* ... */]); $promise = $client->updateVoiceConnectorAsync
([/* ... */]);
Updates details for the specified Amazon Chime Voice Connector.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateVoiceConnector, 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.
Parameter Syntax
$result = $client->updateVoiceConnector([ 'Name' => '<string>', // REQUIRED 'RequireEncryption' => true || false, // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- Name
-
- Required: Yes
- Type: string
The name of the Amazon Chime Voice Connector.
- RequireEncryption
-
- Required: Yes
- Type: boolean
When enabled, requires encryption for the Amazon Chime Voice Connector.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
Result Syntax
[ 'VoiceConnector' => [ 'AwsRegion' => 'us-east-1|us-west-2', 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'OutboundHostName' => '<string>', 'RequireEncryption' => true || false, 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorArn' => '<string>', 'VoiceConnectorId' => '<string>', ], ]
Result Details
Members
- VoiceConnector
-
- Type: VoiceConnector structure
The updated Amazon Chime Voice Connector details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
UpdateVoiceConnectorGroup
$result = $client->updateVoiceConnectorGroup
([/* ... */]); $promise = $client->updateVoiceConnectorGroupAsync
([/* ... */]);
Updates details of the specified Amazon Chime Voice Connector group, such as the name and Amazon Chime Voice Connector priority ranking.
This API is is no longer supported and will not be updated. We recommend using the latest version, UpdateVoiceConnectorGroup, 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.
Parameter Syntax
$result = $client->updateVoiceConnectorGroup([ 'Name' => '<string>', // REQUIRED 'VoiceConnectorGroupId' => '<string>', // REQUIRED 'VoiceConnectorItems' => [ // REQUIRED [ 'Priority' => <integer>, // REQUIRED 'VoiceConnectorId' => '<string>', // REQUIRED ], // ... ], ]);
Parameter Details
Members
- Name
-
- Required: Yes
- Type: string
The name of the Amazon Chime Voice Connector group.
- VoiceConnectorGroupId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector group ID.
- VoiceConnectorItems
-
- Required: Yes
- Type: Array of VoiceConnectorItem structures
The
VoiceConnectorItems
to associate with the group.
Result Syntax
[ 'VoiceConnectorGroup' => [ 'CreatedTimestamp' => <DateTime>, 'Name' => '<string>', 'UpdatedTimestamp' => <DateTime>, 'VoiceConnectorGroupArn' => '<string>', 'VoiceConnectorGroupId' => '<string>', 'VoiceConnectorItems' => [ [ 'Priority' => <integer>, 'VoiceConnectorId' => '<string>', ], // ... ], ], ]
Result Details
Members
- VoiceConnectorGroup
-
- Type: VoiceConnectorGroup structure
The updated Amazon Chime Voice Connector group details.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ConflictException:
The request could not be processed because of conflict in the current state of the resource.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
ValidateE911Address
$result = $client->validateE911Address
([/* ... */]); $promise = $client->validateE911AddressAsync
([/* ... */]);
Validates an address to be used for 911 calls made with Amazon Chime Voice Connectors. You can use validated addresses in a Presence Information Data Format Location Object file that you include in SIP requests. That helps ensure that addresses are routed to the appropriate Public Safety Answering Point.
This API is is no longer supported and will not be updated. We recommend using the latest version, ValidateE911Address, 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.
Parameter Syntax
$result = $client->validateE911Address([ 'AwsAccountId' => '<string>', // REQUIRED 'City' => '<string>', // REQUIRED 'Country' => '<string>', // REQUIRED 'PostalCode' => '<string>', // REQUIRED 'State' => '<string>', // REQUIRED 'StreetInfo' => '<string>', // REQUIRED 'StreetNumber' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AwsAccountId
-
- Required: Yes
- Type: string
The AWS account ID.
- City
-
- Required: Yes
- Type: string
The address city, such as
Portland
. - Country
-
- Required: Yes
- Type: string
The address country, such as
US
. - PostalCode
-
- Required: Yes
- Type: string
The address postal code, such as
04352
. - State
-
- Required: Yes
- Type: string
The address state, such as
ME
. - StreetInfo
-
- Required: Yes
- Type: string
The address street information, such as
8th Avenue
. - StreetNumber
-
- Required: Yes
- Type: string
The address street number, such as
200
or2121
.
Result Syntax
[ 'Address' => [ 'city' => '<string>', 'country' => '<string>', 'postDirectional' => '<string>', 'postalCode' => '<string>', 'postalCodePlus4' => '<string>', 'preDirectional' => '<string>', 'state' => '<string>', 'streetName' => '<string>', 'streetNumber' => '<string>', 'streetSuffix' => '<string>', ], 'AddressExternalId' => '<string>', 'CandidateAddressList' => [ [ 'city' => '<string>', 'country' => '<string>', 'postalCode' => '<string>', 'postalCodePlus4' => '<string>', 'state' => '<string>', 'streetInfo' => '<string>', 'streetNumber' => '<string>', ], // ... ], 'ValidationResult' => <integer>, ]
Result Details
Members
- Address
-
- Type: Address structure
The validated address.
- AddressExternalId
-
- Type: string
The ID that represents the address.
- CandidateAddressList
-
- Type: Array of CandidateAddress structures
The list of address suggestions.
- ValidationResult
-
- Type: int
Number indicating the result of address validation.
0
means the address was perfect as is and successfully validated.1
means the address was corrected.2
means the address sent was not close enough and was not validated.
Errors
- UnauthorizedClientException:
The client is not currently authorized to make the request.
- NotFoundException:
One or more of the resources in the request does not exist in the system.
- ForbiddenException:
The client is permanently forbidden from making the request.
- BadRequestException:
The input parameters don't match the service's restrictions.
- ThrottledClientException:
The client exceeded its request rate limit.
- ServiceUnavailableException:
The service is currently unavailable.
- ServiceFailureException:
The service encountered an unexpected error.
Shapes
AccessDeniedException
Description
You don't have permissions to perform the requested operation.
Members
- Code
-
- Type: string
- Message
-
- Type: string
Account
Description
The Amazon Chime account details. An AWS account can have multiple Amazon Chime accounts.
Members
- AccountId
-
- Required: Yes
- Type: string
The Amazon Chime account ID.
- AccountStatus
-
- Type: string
The status of the account.
- AccountType
-
- Type: string
The Amazon Chime account type. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide.
- AwsAccountId
-
- Required: Yes
- Type: string
The AWS account ID.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The Amazon Chime account creation timestamp, in ISO 8601 format.
- DefaultLicense
-
- Type: string
The default license for the Amazon Chime account.
- Name
-
- Required: Yes
- Type: string
The Amazon Chime account name.
- SigninDelegateGroups
-
- Type: Array of SigninDelegateGroup structures
The sign-in delegate groups associated with the account.
- SupportedLicenses
-
- Type: Array of strings
Supported licenses for the Amazon Chime account.
AccountSettings
Description
Settings related to the Amazon Chime account. This includes settings that start or stop remote control of shared screens, or start or stop the dial-out option in the Amazon Chime web application. For more information about these settings, see Use the Policies Page in the Amazon Chime Administration Guide.
Members
- DisableRemoteControl
-
- Type: boolean
Setting that stops or starts remote control of shared screens during meetings.
- EnableDialOut
-
- Type: boolean
Setting that allows meeting participants to choose the Call me at a phone number option. For more information, see Join a Meeting without the Amazon Chime App.
Address
Description
A validated address.
Members
- city
-
- Type: string
The city of an address.
- country
-
- Type: string
The country of an address.
- postDirectional
-
- Type: string
An address suffix location, such as the
S. Unit A
inCentral Park S. Unit A
. - postalCode
-
- Type: string
The postal code of an address.
- postalCodePlus4
-
- Type: string
The Zip + 4 or postal code + 4 of an address.
- preDirectional
-
- Type: string
An address prefix location, such as the
N
inN. Third St.
. - state
-
- Type: string
The state of an address.
- streetName
-
- Type: string
The address street, such as
8th Avenue
. - streetNumber
-
- Type: string
The numeric portion of an address.
- streetSuffix
-
- Type: string
The address suffix, such as the
N
in8th Avenue N
.
AlexaForBusinessMetadata
Description
The Alexa for Business metadata associated with an Amazon Chime user, used to integrate Alexa for Business with a device.
Members
- AlexaForBusinessRoomArn
-
- Type: string
The ARN of the room resource.
- IsAlexaForBusinessEnabled
-
- Type: boolean
Starts or stops Alexa for Business.
AppInstance
Description
The details of an AppInstance
, an instance of an Amazon Chime SDK messaging application.
Members
- AppInstanceArn
-
- Type: string
The ARN of the messaging instance.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which an
AppInstance
was created. In epoch milliseconds. - LastUpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time an
AppInstance
was last updated. In epoch milliseconds. - Metadata
-
- Type: string
The metadata of an
AppInstance
. - Name
-
- Type: string
The name of an
AppInstance
.
AppInstanceAdmin
Description
The details of an AppInstanceAdmin
.
Members
- Admin
-
- Type: Identity structure
The
AppInstanceAdmin
data. - AppInstanceArn
-
- Type: string
The ARN of the
AppInstance
for which the user is an administrator. - CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which an administrator was created.
AppInstanceAdminSummary
Description
Summary of the details of an AppInstanceAdmin
.
Members
- Admin
-
- Type: Identity structure
The details of the
AppInstanceAdmin
.
AppInstanceRetentionSettings
Description
The details of the data-retention settings for an AppInstance
.
Members
- ChannelRetentionSettings
-
- Type: ChannelRetentionSettings structure
The length of time in days to retain the messages in a channel.
AppInstanceStreamingConfiguration
Description
The details of the streaming configuration of an AppInstance
.
Members
- AppInstanceDataType
-
- Required: Yes
- Type: string
The type of data to be streamed.
- ResourceArn
-
- Required: Yes
- Type: string
The resource ARN.
AppInstanceSummary
Description
Summary of the data for an AppInstance
.
Members
- AppInstanceArn
-
- Type: string
The
AppInstance
ARN. - Metadata
-
- Type: string
The metadata of the
AppInstance
. - Name
-
- Type: string
The name of the
AppInstance
.
AppInstanceUser
Description
The details of an AppInstanceUser
.
Members
- AppInstanceUserArn
-
- Type: string
The ARN of the
AppInstanceUser
. - CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the
AppInstanceUser
was created. - LastUpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the
AppInstanceUser
was last updated. - Metadata
-
- Type: string
The metadata of the
AppInstanceUser
. - Name
-
- Type: string
The name of the
AppInstanceUser
.
AppInstanceUserMembershipSummary
Description
Summary of the membership details of an AppInstanceUser
.
Members
- ReadMarkerTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a message was last read.
- Type
-
- Type: string
The type of
ChannelMembership
.
AppInstanceUserSummary
Description
Summary of the details of an AppInstanceUser
.
Members
- AppInstanceUserArn
-
- Type: string
The ARN of the
AppInstanceUser
. - Metadata
-
- Type: string
The metadata of the
AppInstanceUser
. - Name
-
- Type: string
The name of an
AppInstanceUser
.
ArtifactsConfiguration
Description
The configuration for the artifacts.
Members
- Audio
-
- Required: Yes
- Type: AudioArtifactsConfiguration structure
The configuration for the audio artifacts.
- Content
-
- Required: Yes
- Type: ContentArtifactsConfiguration structure
The configuration for the content artifacts.
- Video
-
- Required: Yes
- Type: VideoArtifactsConfiguration structure
The configuration for the video artifacts.
Attendee
Description
An Amazon Chime SDK meeting attendee. Includes a unique AttendeeId
and JoinToken
. The JoinToken
allows a client to authenticate and join as the specified attendee. The JoinToken
expires when the meeting ends or when DeleteAttendee is called. After that, the attendee is unable to join the meeting.
We recommend securely transferring each JoinToken
from your server application to the client so that no other client has access to the token except for the one authorized to represent the attendee.
Members
- AttendeeId
-
- Type: string
The Amazon Chime SDK attendee ID.
- ExternalUserId
-
- Type: string
The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
- JoinToken
-
- Type: string
The join token used by the Amazon Chime SDK attendee.
AudioArtifactsConfiguration
Description
The audio artifact configuration object.
Members
- MuxType
-
- Required: Yes
- Type: string
The MUX type of the audio artifact configuration object.
BadRequestException
Description
The input parameters don't match the service's restrictions.
Members
- Code
-
- Type: string
- Message
-
- Type: string
BatchChannelMemberships
Description
The membership information, including member ARNs, the channel ARN, and membership types.
Members
- ChannelArn
-
- Type: string
The ARN of the channel to which you're adding users.
- InvitedBy
-
- Type: Identity structure
The identifier of the member who invited another member.
- Members
-
- Type: Array of Identity structures
The users successfully added to the request.
- Type
-
- Type: string
The membership types set for the channel users.
BatchCreateChannelMembershipError
Description
A list of failed member ARNs, error codes, and error messages.
Members
- ErrorCode
-
- Type: string
The error code.
- ErrorMessage
-
- Type: string
The error message.
- MemberArn
-
- Type: string
The ARN of the member that the service couldn't add.
Bot
Description
A resource that allows Enterprise account administrators to configure an interface to receive events from Amazon Chime.
Members
- BotEmail
-
- Type: string
The bot email address.
- BotId
-
- Type: string
The bot ID.
- BotType
-
- Type: string
The bot type.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The bot creation timestamp, in ISO 8601 format.
- Disabled
-
- Type: boolean
When true, the bot is stopped from running in your account.
- DisplayName
-
- Type: string
The bot display name.
- SecurityToken
-
- Type: string
The security token used to authenticate Amazon Chime with the outgoing event endpoint.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The updated bot timestamp, in ISO 8601 format.
- UserId
-
- Type: string
The unique ID for the bot user.
BusinessCallingSettings
Description
The Amazon Chime Business Calling settings for the administrator's AWS account. Includes any Amazon S3 buckets designated for storing call detail records.
Members
- CdrBucket
-
- Type: string
The Amazon S3 bucket designated for call detail record storage.
CandidateAddress
Description
A suggested address.
Members
- city
-
- Type: string
The city of a candidate address.
- country
-
- Type: string
The country of a candidate address.
- postalCode
-
- Type: string
The postal code of a candidate address.
- postalCodePlus4
-
- Type: string
The Zip + 4 or postal code + 4 of a candidate address.
- state
-
- Type: string
The state of a candidate address.
- streetInfo
-
- Type: string
The street information of a candidate address
- streetNumber
-
- Type: string
The numeric portion of a candidate address.
Channel
Description
The details of a channel.
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- CreatedBy
-
- Type: Identity structure
The
AppInstanceUser
who created the channel. - CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the
AppInstanceUser
created the channel. - LastMessageTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a member sent the last message in the channel.
- LastUpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a channel was last updated.
- Metadata
-
- Type: string
The channel's metadata.
- Mode
-
- Type: string
The mode of the channel.
- Name
-
- Type: string
The name of the channel.
- Privacy
-
- Type: string
The channel's privacy setting.
ChannelBan
Description
The details of a channel ban.
Members
- ChannelArn
-
- Type: string
The ARN of the channel from which a member is being banned.
- CreatedBy
-
- Type: Identity structure
The
AppInstanceUser
who created the ban. - CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the ban was created.
- Member
-
- Type: Identity structure
The member being banned from the channel.
ChannelBanSummary
Description
Summary of the details of a ChannelBan
.
Members
- Member
-
- Type: Identity structure
The member being banned from a channel.
ChannelMembership
Description
The details of a channel member.
Members
- ChannelArn
-
- Type: string
The ARN of the member's channel.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the channel membership was created.
- InvitedBy
-
- Type: Identity structure
The identifier of the member who invited another member.
- LastUpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a channel membership was last updated.
- Member
-
- Type: Identity structure
The data of the channel member.
- Type
-
- Type: string
The membership type set for the channel member.
ChannelMembershipForAppInstanceUserSummary
Description
Summary of the channel membership details of an AppInstanceUser
.
Members
- AppInstanceUserMembershipSummary
-
- Type: AppInstanceUserMembershipSummary structure
Summary of the membership details of an
AppInstanceUser
. - ChannelSummary
-
- Type: ChannelSummary structure
Summary of the details of a
Channel
.
ChannelMembershipSummary
Description
Summary of the details of a ChannelMembership
.
Members
- Member
-
- Type: Identity structure
A member's summary data.
ChannelMessage
Description
The details of a message in a channel.
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- Content
-
- Type: string
The message content.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the message was created.
- LastEditedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a message was edited.
- LastUpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a message was updated.
- MessageId
-
- Type: string
The ID of a message.
- Metadata
-
- Type: string
The message metadata.
- Persistence
-
- Type: string
The persistence setting for a channel message.
- Redacted
-
- Type: boolean
Hides the content of a message.
- Sender
-
- Type: Identity structure
The message sender.
- Type
-
- Type: string
The message type.
ChannelMessageSummary
Description
Summary of the messages in a Channel
.
Members
- Content
-
- Type: string
The content of the message.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the message summary was created.
- LastEditedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a message was last edited.
- LastUpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which a message was last updated.
- MessageId
-
- Type: string
The ID of the message.
- Metadata
-
- Type: string
The metadata of the message.
- Redacted
-
- Type: boolean
Indicates whether a message was redacted.
- Sender
-
- Type: Identity structure
The message sender.
- Type
-
- Type: string
The type of message.
ChannelModeratedByAppInstanceUserSummary
Description
Summary of the details of a moderated channel.
Members
- ChannelSummary
-
- Type: ChannelSummary structure
Summary of the details of a
Channel
.
ChannelModerator
Description
The details of a channel moderator.
Members
- ChannelArn
-
- Type: string
The ARN of the moderator's channel.
- CreatedBy
-
- Type: Identity structure
The
AppInstanceUser
who created the moderator. - CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the moderator was created.
- Moderator
-
- Type: Identity structure
The moderator's data.
ChannelModeratorSummary
Description
Summary of the details of a ChannelModerator
.
Members
- Moderator
-
- Type: Identity structure
The data for a moderator.
ChannelRetentionSettings
Description
The details of the retention settings for a channel.
Members
- RetentionDays
-
- Type: int
The time in days to retain the messages in a channel.
ChannelSummary
Description
Summary of the details of a Channel
.
Members
- ChannelArn
-
- Type: string
The ARN of the channel.
- LastMessageTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the last message in a channel was sent.
- Metadata
-
- Type: string
The metadata of the channel.
- Mode
-
- Type: string
The mode of the channel.
- Name
-
- Type: string
The name of the channel.
- Privacy
-
- Type: string
The privacy setting of the channel.
ChimeSdkMeetingConfiguration
Description
The configuration object of the Amazon Chime SDK meeting for a specified media capture pipeline. SourceType
must be ChimeSdkMeeting
.
Members
- ArtifactsConfiguration
-
- Type: ArtifactsConfiguration structure
The configuration for the artifacts in an Amazon Chime SDK meeting.
- SourceConfiguration
-
- Type: SourceConfiguration structure
The source configuration for a specified media capture pipeline.
ConflictException
Description
The request could not be processed because of conflict in the current state of the resource.
Members
- Code
-
- Type: string
- Message
-
- Type: string
ContentArtifactsConfiguration
Description
The content artifact object.
Members
- MuxType
-
- Type: string
The MUX type of the artifact configuration.
- State
-
- Required: Yes
- Type: string
Indicates whether the content artifact is enabled or disabled.
ConversationRetentionSettings
Description
The retention settings that determine how long to retain conversation messages for an Amazon Chime Enterprise account.
Members
- RetentionDays
-
- Type: int
The number of days for which to retain conversation messages.
CreateAttendeeError
Description
The list of errors returned when errors are encountered during the BatchCreateAttendee and CreateAttendee actions. This includes external user IDs, error codes, and error messages.
Members
- ErrorCode
-
- Type: string
The error code.
- ErrorMessage
-
- Type: string
The error message.
- ExternalUserId
-
- Type: string
The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
CreateAttendeeRequestItem
Description
The Amazon Chime SDK attendee fields to create, used with the BatchCreateAttendee action.
Members
- ExternalUserId
-
- Required: Yes
- Type: string
The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
- Tags
-
- Type: Array of Tag structures
The tag key-value pairs.
Credential
Description
The SIP credentials used to authenticate requests to your Amazon Chime Voice Connector.
Members
- Password
-
- Type: string
The RFC2617 compliant password associated with the SIP credentials, in US-ASCII format.
- Username
-
- Type: string
The RFC2617 compliant user name associated with the SIP credentials, in US-ASCII format.
DNISEmergencyCallingConfiguration
Description
The Dialed Number Identification Service (DNIS) emergency calling configuration details associated with an Amazon Chime Voice Connector's emergency calling configuration.
Members
- CallingCountry
-
- Required: Yes
- Type: string
The country from which emergency calls are allowed, in ISO 3166-1 alpha-2 format.
- EmergencyPhoneNumber
-
- Required: Yes
- Type: string
The DNIS phone number to route emergency calls to, in E.164 format.
- TestPhoneNumber
-
- Type: string
The DNIS phone number to route test emergency calls to, in E.164 format.
EmergencyCallingConfiguration
Description
The emergency calling configuration details associated with an Amazon Chime Voice Connector.
Members
- DNIS
-
- Type: Array of DNISEmergencyCallingConfiguration structures
The Dialed Number Identification Service (DNIS) emergency calling configuration details.
EngineTranscribeMedicalSettings
Description
Settings specific to the Amazon Transcribe Medical engine.
Members
- ContentIdentificationType
-
- Type: string
Labels all personally identifiable information (PII) identified in your transcript. If you don't include
PiiEntityTypes
, all PII is identified.You can’t set
ContentIdentificationType
andContentRedactionType
. - LanguageCode
-
- Required: Yes
- Type: string
The language code specified for the Amazon Transcribe Medical engine.
- Region
-
- Type: string
The AWS Region passed to Amazon Transcribe Medical. If you don't specify a Region, Amazon Chime uses the meeting's Region.
- Specialty
-
- Required: Yes
- Type: string
The specialty specified for the Amazon Transcribe Medical engine.
- Type
-
- Required: Yes
- Type: string
The type of transcription.
- VocabularyName
-
- Type: string
The name of the vocabulary passed to Amazon Transcribe Medical.
EngineTranscribeSettings
Description
Settings specific for Amazon Transcribe as the live transcription engine.
If you specify an invalid combination of parameters, a TranscriptFailed
event will be sent with the contents of the BadRequestException
generated by Amazon Transcribe. For more information on each parameter and which combinations are valid, refer to the StartStreamTranscription API in the Amazon Transcribe Developer Guide.
Members
- ContentIdentificationType
-
- Type: string
Labels all personally identifiable information (PII) identified in your transcript. If you don't include
PiiEntityTypes
, all PII is identified.You can’t set
ContentIdentificationType
andContentRedactionType
. - ContentRedactionType
-
- Type: string
Content redaction is performed at the segment level. If you don't include
PiiEntityTypes
, all PII is redacted.You can’t set
ContentIdentificationType
andContentRedactionType
. - EnablePartialResultsStabilization
-
- Type: boolean
Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy.
- IdentifyLanguage
-
- Type: boolean
Enables automatic language identification for your transcription.
If you include
IdentifyLanguage
, you can optionally useLanguageOptions
to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy.You can also use
PreferredLanguage
to include a preferred language. Doing so can help Amazon Transcribe identify the language faster.You must include either
LanguageCode
orIdentifyLanguage
.Language identification can't be combined with custom language models or redaction.
- LanguageCode
-
- Type: string
Specify the language code that represents the language spoken.
If you're unsure of the language spoken in your audio, consider using
IdentifyLanguage
to enable automatic language identification. - LanguageModelName
-
- Type: string
Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive.
The language of the specified language model must match the language code. If the languages don't match, the custom language model isn't applied. There are no errors or warnings associated with a language mismatch.
If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region.
- LanguageOptions
-
- Type: string
Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you're unsure what languages are present, do not include this parameter.
Including language options can improve the accuracy of language identification.
If you include
LanguageOptions
, you must also includeIdentifyLanguage
.You can only include one language dialect per language. For example, you cannot include
en-US
anden-AU
. - PartialResultsStability
-
- Type: string
Specify the level of stability to use when you enable partial results stabilization (
EnablePartialResultsStabilization
).Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy.
- PiiEntityTypes
-
- Type: string
Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you'd like, or you can select
ALL
.Values must be comma-separated and can include:
ADDRESS
,BANK_ACCOUNT_NUMBER
,BANK_ROUTING
,CREDIT_DEBIT_CVV
,CREDIT_DEBIT_EXPIRY
CREDIT_DEBIT_NUMBER
,EMAIL
,NAME
,PHONE
,PIN
,SSN
, orALL
.Note that if you include
PiiEntityTypes
, you must also includeContentIdentificationType
orContentRedactionType
.If you include
ContentRedactionType
orContentIdentificationType
, but do not includePiiEntityTypes
, all PII is redacted or identified. - PreferredLanguage
-
- Type: string
Specify a preferred language from the subset of languages codes you specified in
LanguageOptions
.You can only use this parameter if you include
IdentifyLanguage
andLanguageOptions
. - Region
-
- Type: string
The AWS Region in which to use Amazon Transcribe.
If you don't specify a Region, then the
MediaRegion
parameter of the CreateMeeting.html API will be used. However, if Amazon Transcribe is not available in theMediaRegion
, then a TranscriptFailed event is sent.Use
auto
to use Amazon Transcribe in a Region near the meeting’sMediaRegion
. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide. - VocabularyFilterMethod
-
- Type: string
Specify how you want your vocabulary filter applied to your transcript.
To replace words with
***
, choosemask
.To delete words, choose
remove
.To flag words without changing them, choose
tag
. - VocabularyFilterName
-
- Type: string
Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.
If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.
If you include
IdentifyLanguage
and want to use one or more vocabulary filters with your transcription, use theVocabularyFilterNames
parameter instead. - VocabularyFilterNames
-
- Type: string
Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.
If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.
If you're not including
IdentifyLanguage
and want to use a custom vocabulary filter with your transcription, use theVocabularyFilterName
parameter instead. - VocabularyName
-
- Type: string
Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive.
If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.
If you include
IdentifyLanguage
and want to use one or more custom vocabularies with your transcription, use theVocabularyNames
parameter instead. - VocabularyNames
-
- Type: string
Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive.
If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.
If you don't include
IdentifyLanguage
and want to use a custom vocabulary with your transcription, use theVocabularyName
parameter instead.
EventsConfiguration
Description
The configuration that allows a bot to receive outgoing events. Can be either an HTTPS endpoint or a Lambda function ARN.
Members
- BotId
-
- Type: string
The bot ID.
- LambdaFunctionArn
-
- Type: string
Lambda function ARN that allows a bot to receive outgoing events.
- OutboundEventsHTTPSEndpoint
-
- Type: string
HTTPS endpoint that allows a bot to receive outgoing events.
ForbiddenException
Description
The client is permanently forbidden from making the request.
Members
- Code
-
- Type: string
- Message
-
- Type: string
GeoMatchParams
Description
The country and area code for a proxy phone number in a proxy phone session.
Members
- AreaCode
-
- Required: Yes
- Type: string
The area code.
- Country
-
- Required: Yes
- Type: string
The country.
Identity
Description
The details of a user.
Members
- Arn
-
- Type: string
The ARN in an Identity.
- Name
-
- Type: string
The name in an Identity.
Invite
Description
Invitation object returned after emailing users to invite them to join the Amazon Chime Team
account.
Members
- EmailAddress
-
- Type: string
The email address to which the invite is sent.
- EmailStatus
-
- Type: string
The status of the invite email.
- InviteId
-
- Type: string
The invite ID.
- Status
-
- Type: string
The status of the invite.
LoggingConfiguration
Description
The logging configuration associated with an Amazon Chime Voice Connector. Specifies whether SIP message logs are enabled for sending to Amazon CloudWatch Logs.
Members
- EnableMediaMetricLogs
-
- Type: boolean
Boolean that enables logging of detailed media metrics for Voice Connectors to Amazon CloudWatch logs.
- EnableSIPLogs
-
- Type: boolean
Boolean that enables SIP message logs to Amazon CloudWatch logs.
MediaCapturePipeline
Description
A media capture pipeline object consisting of an ID, source type, source ARN, a sink type, a sink ARN, and a configuration object.
Members
- ChimeSdkMeetingConfiguration
-
- Type: ChimeSdkMeetingConfiguration structure
The configuration for a specified media capture pipeline.
SourceType
must beChimeSdkMeeting
. - CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the capture pipeline was created, in ISO 8601 format.
- MediaPipelineId
-
- Type: string
The ID of a media capture pipeline.
- SinkArn
-
- Type: string
ARN of the destination to which the media artifacts are saved.
- SinkType
-
- Type: string
Destination type to which the media artifacts are saved. You must use an S3 Bucket.
- SourceArn
-
- Type: string
ARN of the source from which the media artifacts will be saved.
- SourceType
-
- Type: string
Source type from which media artifacts are saved. You must use
ChimeMeeting
. - Status
-
- Type: string
The status of the media capture pipeline.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the capture pipeline was updated, in ISO 8601 format.
MediaPlacement
Description
A set of endpoints used by clients to connect to the media service group for an Amazon Chime SDK meeting.
Members
- AudioFallbackUrl
-
- Type: string
The audio fallback URL.
- AudioHostUrl
-
- Type: string
The audio host URL.
- EventIngestionUrl
-
- Type: string
The event ingestion URL to which you send client meeting events.
- ScreenDataUrl
-
- Type: string
The screen data URL.
This parameter is is no longer supported and no longer used by the Amazon Chime SDK.
- ScreenSharingUrl
-
- Type: string
The screen sharing URL.
This parameter is is no longer supported and no longer used by the Amazon Chime SDK..
- ScreenViewingUrl
-
- Type: string
The screen viewing URL.
This parameter is is no longer supported and no longer used by the Amazon Chime SDK.
- SignalingUrl
-
- Type: string
The signaling URL.
- TurnControlUrl
-
- Type: string
The turn control URL.
This parameter is is no longer supported and no longer used by the Amazon Chime SDK.
Meeting
Description
A meeting created using the Amazon Chime SDK.
Members
- ExternalMeetingId
-
- Type: string
The external meeting ID.
- MediaPlacement
-
- Type: MediaPlacement structure
The media placement for the meeting.
- MediaRegion
-
- Type: 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
. - MeetingId
-
- Type: string
The Amazon Chime SDK meeting ID.
MeetingNotificationConfiguration
Description
The resource target configurations for receiving Amazon Chime SDK meeting and attendee event notifications. The Amazon Chime SDK supports resource targets located in the US East (N. Virginia) AWS Region (us-east-1
).
Members
- SnsTopicArn
-
- Type: string
The SNS topic ARN.
- SqsQueueArn
-
- Type: string
The SQS queue ARN.
Member
Description
The member details, such as email address, name, member ID, and member type.
Members
- AccountId
-
- Type: string
The Amazon Chime account ID.
-
- Type: string
The member email address.
- FullName
-
- Type: string
The member name.
- MemberId
-
- Type: string
The member ID (user ID or bot ID).
- MemberType
-
- Type: string
The member type.
MemberError
Description
The list of errors returned when a member action results in an error.
Members
- ErrorCode
-
- Type: string
The error code.
- ErrorMessage
-
- Type: string
The error message.
- MemberId
-
- Type: string
The member ID.
MembershipItem
Description
Membership details, such as member ID and member role.
Members
- MemberId
-
- Type: string
The member ID.
- Role
-
- Type: string
The member role.
MessagingSessionEndpoint
Description
The websocket endpoint used to connect to Amazon Chime SDK messaging.
Members
- Url
-
- Type: string
The endpoint to which you establish a websocket connection.
NotFoundException
Description
One or more of the resources in the request does not exist in the system.
Members
- Code
-
- Type: string
- Message
-
- Type: string
OrderedPhoneNumber
Description
A phone number for which an order has been placed.
Members
- E164PhoneNumber
-
- Type: string
The phone number, in E.164 format.
- Status
-
- Type: string
The phone number status.
Origination
Description
Origination settings enable your SIP hosts to receive inbound calls using your Amazon Chime Voice Connector.
The parameters listed below are not required, but you must use at least one.
Members
- Disabled
-
- Type: 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
. - Routes
-
- Type: Array of OriginationRoute structures
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
.
OriginationRoute
Description
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.
The parameters listed below are not required, but you must use at least one.
Members
- Host
-
- Type: string
The FQDN or IP address to contact for origination traffic.
- Port
-
- Type: int
The designated origination route port. Defaults to 5060.
- Priority
-
- Type: int
The priority associated with the host, with 1 being the highest priority. Higher priority hosts are attempted first.
- Protocol
-
- Type: string
The protocol to use for the origination route. Encryption-enabled Amazon Chime Voice Connectors use TCP protocol by default.
- Weight
-
- Type: int
The weight associated with the host. If hosts are equal in priority, calls are redistributed among them based on their relative weight.
Participant
Description
The phone number and proxy phone number for a participant in an Amazon Chime Voice Connector proxy session.
Members
- PhoneNumber
-
- Type: string
The participant's phone number.
- ProxyPhoneNumber
-
- Type: string
The participant's proxy phone number.
PhoneNumber
Description
A phone number used for Amazon Chime Business Calling or an Amazon Chime Voice Connector.
Members
- Associations
-
- Type: Array of PhoneNumberAssociation structures
The phone number associations.
- CallingName
-
- Type: string
The outbound calling name associated with the phone number.
- CallingNameStatus
-
- Type: string
The outbound calling name status.
- Capabilities
-
- Type: PhoneNumberCapabilities structure
The phone number capabilities.
- Country
-
- Type: string
The phone number country. Format: ISO 3166-1 alpha-2.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The phone number creation timestamp, in ISO 8601 format.
- DeletionTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The deleted phone number timestamp, in ISO 8601 format.
- E164PhoneNumber
-
- Type: string
The phone number, in E.164 format.
- PhoneNumberId
-
- Type: string
The phone number ID.
- ProductType
-
- Type: string
The phone number product type.
- Status
-
- Type: string
The phone number status.
- Type
-
- Type: string
The phone number type.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The updated phone number timestamp, in ISO 8601 format.
PhoneNumberAssociation
Description
The phone number associations, such as Amazon Chime account ID, Amazon Chime user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.
Members
- AssociatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp of the phone number association, in ISO 8601 format.
- Name
-
- Type: string
Defines the association with an Amazon Chime account ID, user ID, Amazon Chime Voice Connector ID, or Amazon Chime Voice Connector group ID.
- Value
-
- Type: string
Contains the ID for the entity specified in Name.
PhoneNumberCapabilities
Description
The phone number capabilities for Amazon Chime Business Calling phone numbers, such as enabled inbound and outbound calling and text messaging.
Members
- InboundCall
-
- Type: boolean
Allows or denies inbound calling for the specified phone number.
- InboundMMS
-
- Type: boolean
Allows or denies inbound MMS messaging for the specified phone number.
- InboundSMS
-
- Type: boolean
Allows or denies inbound SMS messaging for the specified phone number.
- OutboundCall
-
- Type: boolean
Allows or denies outbound calling for the specified phone number.
- OutboundMMS
-
- Type: boolean
Allows or denies outbound MMS messaging for the specified phone number.
- OutboundSMS
-
- Type: boolean
Allows or denies outbound SMS messaging for the specified phone number.
PhoneNumberCountry
Description
The phone number country.
Members
- CountryCode
-
- Type: string
The phone number country code. Format: ISO 3166-1 alpha-2.
- SupportedPhoneNumberTypes
-
- Type: Array of strings
The supported phone number types.
PhoneNumberError
Description
If the phone number action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
Members
- ErrorCode
-
- Type: string
The error code.
- ErrorMessage
-
- Type: string
The error message.
- PhoneNumberId
-
- Type: string
The phone number ID for which the action failed.
PhoneNumberOrder
Description
The details of a phone number order created for Amazon Chime.
Members
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The phone number order creation time stamp, in ISO 8601 format.
- OrderedPhoneNumbers
-
- Type: Array of OrderedPhoneNumber structures
The ordered phone number details, such as the phone number in E.164 format and the phone number status.
- PhoneNumberOrderId
-
- Type: string
The phone number order ID.
- ProductType
-
- Type: string
The phone number order product type.
- Status
-
- Type: string
The status of the phone number order.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The updated phone number order time stamp, in ISO 8601 format.
Proxy
Description
The proxy configuration for an Amazon Chime Voice Connector.
Members
- DefaultSessionExpiryMinutes
-
- Type: int
The default number of minutes allowed for proxy sessions.
- Disabled
-
- Type: boolean
When true, stops proxy sessions from being created on the specified Amazon Chime Voice Connector.
- FallBackPhoneNumber
-
- Type: string
The phone number to route calls to after a proxy session expires.
- PhoneNumberCountries
-
- Type: Array of strings
The countries for proxy phone numbers to be selected from.
ProxySession
Description
The proxy session for an Amazon Chime Voice Connector.
Members
- Capabilities
-
- Type: Array of strings
The proxy session capabilities.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The created time stamp, in ISO 8601 format.
- EndedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The ended time stamp, in ISO 8601 format.
- ExpiryMinutes
-
- Type: int
The number of minutes allowed for the proxy session.
- GeoMatchLevel
-
- Type: string
The preference for matching the country or area code of the proxy phone number with that of the first participant.
- GeoMatchParams
-
- Type: GeoMatchParams structure
The country and area code for the proxy phone number.
- Name
-
- Type: string
The name of the proxy session.
- NumberSelectionBehavior
-
- Type: string
The preference for proxy phone number reuse, or stickiness, between the same participants across sessions.
- Participants
-
- Type: Array of Participant structures
The proxy session participants.
- ProxySessionId
-
- Type: string
The proxy session ID.
- Status
-
- Type: string
The status of the proxy session.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The updated time stamp, in ISO 8601 format.
- VoiceConnectorId
-
- Type: string
The Amazon Chime voice connector ID.
ResourceLimitExceededException
Description
The request exceeds the resource limit.
Members
- Code
-
- Type: string
- Message
-
- Type: string
RetentionSettings
Description
The retention settings for an Amazon Chime Enterprise account that determine how long to retain items such as chat-room messages and chat-conversation messages.
Members
- ConversationRetentionSettings
-
- Type: ConversationRetentionSettings structure
The chat conversation retention settings.
- RoomRetentionSettings
-
- Type: RoomRetentionSettings structure
The chat room retention settings.
Room
Description
The Amazon Chime chat room details.
Members
- AccountId
-
- Type: string
The Amazon Chime account ID.
- CreatedBy
-
- Type: string
The identifier of the room creator.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The room creation timestamp, in ISO 8601 format.
- Name
-
- Type: string
The room name.
- RoomId
-
- Type: string
The room ID.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The room update timestamp, in ISO 8601 format.
RoomMembership
Description
The room membership details.
Members
- InvitedBy
-
- Type: string
The identifier of the user that invited the room member.
- Member
-
- Type: Member structure
The member details, such as email address, name, member ID, and member type.
- Role
-
- Type: string
The membership role.
- RoomId
-
- Type: string
The room ID.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The room membership update timestamp, in ISO 8601 format.
RoomRetentionSettings
Description
The retention settings that determine how long to retain chat-room messages for an Amazon Chime Enterprise account.
Members
- RetentionDays
-
- Type: int
The number of days for which to retain chat-room messages.
SelectedVideoStreams
Description
The video streams to capture for a specified media capture pipeline. The total number of video streams can't exceed 25.
Members
- AttendeeIds
-
- Type: Array of strings
The attendee IDs of the streams selected for a media capture pipeline.
- ExternalUserIds
-
- Type: Array of strings
The external user IDs of the streams selected for a media capture pipeline.
ServiceFailureException
Description
The service encountered an unexpected error.
Members
- Code
-
- Type: string
- Message
-
- Type: string
ServiceUnavailableException
Description
The service is currently unavailable.
Members
- Code
-
- Type: string
- Message
-
- Type: string
SigninDelegateGroup
Description
An Active Directory (AD) group whose members are granted permission to act as delegates.
Members
- GroupName
-
- Type: string
The group name.
SipMediaApplication
Description
The details of the SIP media application, including name and endpoints. An AWS account can have multiple SIP media applications.
Members
- AwsRegion
-
- Type: string
The AWS Region in which the SIP media application is created.
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The SIP media application creation timestamp, in ISO 8601 format.
- Endpoints
-
- Type: Array of SipMediaApplicationEndpoint structures
List of endpoints for SIP media application. Currently, only one endpoint per SIP media application is permitted.
- Name
-
- Type: string
The name of the SIP media application.
- SipMediaApplicationId
-
- Type: string
The SIP media application ID.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The SIP media application updated timestamp, in ISO 8601 format.
SipMediaApplicationCall
Description
A Call
instance for a SIP media application.
Members
- TransactionId
-
- Type: string
The transaction ID of a call.
SipMediaApplicationEndpoint
Description
The endpoint assigned to the SIP media application.
Members
- LambdaArn
-
- Type: string
Valid Amazon Resource Name (ARN) of the Lambda function, version, or alias. The function must be created in the same AWS Region as the SIP media application.
SipMediaApplicationLoggingConfiguration
Description
Logging configuration of the SIP media application.
Members
- EnableSipMediaApplicationMessageLogs
-
- Type: boolean
Enables application message logs for the SIP media application.
SipRule
Description
The SIP rule details, including name, triggers, and target applications. An AWS account can have multiple SIP rules.
Members
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the SIP rule was created, in ISO 8601 format.
- Disabled
-
- Type: boolean
Indicates whether the SIP rule is enabled or disabled. You must disable a rule before you can delete it.
- Name
-
- Type: string
The name of the SIP rule.
- SipRuleId
-
- Type: string
The SIP rule ID.
- TargetApplications
-
- Type: Array of SipRuleTargetApplication structures
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.
- TriggerType
-
- Type: string
The type of trigger assigned to the SIP rule in
TriggerValue
, currentlyRequestUriHostname
orToPhoneNumber
. - TriggerValue
-
- Type: string
If
TriggerType
isRequestUriHostname
, then the value can be the outbound host name of the Amazon Chime Voice Connector. IfTriggerType
isToPhoneNumber
, then the value can be a customer-owned phone number in E164 format.SipRule
is triggered when a SIP rule requests host name orToPhoneNumber
matches in the incoming SIP request. - UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time at which the SIP rule was last updated, in ISO 8601 format.
SipRuleTargetApplication
Description
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.
Members
- AwsRegion
-
- Type: string
The AWS Region of the target application.
- Priority
-
- Type: int
Priority of the SIP media application in the target list.
- SipMediaApplicationId
-
- Type: string
The SIP media application ID.
SourceConfiguration
Description
Source configuration for a specified media capture pipeline.
Members
- SelectedVideoStreams
-
- Type: SelectedVideoStreams structure
The selected video streams to capture for a specified media capture pipeline. The number of video streams can't exceed 25.
StreamingConfiguration
Description
The streaming configuration associated with an Amazon Chime Voice Connector. Specifies whether media streaming is enabled for sending to Amazon Kinesis, and shows the retention period for the Amazon Kinesis data, in hours.
Members
- DataRetentionInHours
-
- Required: Yes
- Type: int
The retention period, in hours, for the Amazon Kinesis data.
- Disabled
-
- Type: boolean
When true, media streaming to Amazon Kinesis is turned off.
- StreamingNotificationTargets
-
- Type: Array of StreamingNotificationTarget structures
The streaming notification targets.
StreamingNotificationTarget
Description
The targeted recipient for a streaming configuration notification.
Members
- NotificationTarget
-
- Required: Yes
- Type: string
The streaming notification target.
Tag
Description
Describes a tag applied to a resource.
Members
- Key
-
- Required: Yes
- Type: string
The key of the tag.
- Value
-
- Required: Yes
- Type: string
The value of the tag.
TelephonySettings
Description
Settings that allow management of telephony permissions for an Amazon Chime user, such as inbound and outbound calling and text messaging.
Members
- InboundCalling
-
- Required: Yes
- Type: boolean
Allows or denies inbound calling.
- OutboundCalling
-
- Required: Yes
- Type: boolean
Allows or denies outbound calling.
- SMS
-
- Required: Yes
- Type: boolean
Allows or denies SMS messaging.
Termination
Description
Termination settings enable your SIP hosts to make outbound calls using your Amazon Chime Voice Connector.
Members
- CallingRegions
-
- Type: Array of strings
The countries to which calls are allowed, in ISO 3166-1 alpha-2 format. Required.
- CidrAllowedList
-
- Type: Array of strings
The IP addresses allowed to make calls, in CIDR format. Required.
- CpsLimit
-
- Type: int
The limit on calls per second. Max value based on account service quota. Default value of 1.
- DefaultPhoneNumber
-
- Type: string
The default caller ID phone number.
- Disabled
-
- Type: boolean
When termination settings are disabled, outbound calls can not be made.
TerminationHealth
Description
The termination health details, including the source IP address and timestamp of the last successful SIP OPTIONS
message from your SIP infrastructure.
Members
- Source
-
- Type: string
The source IP address.
- Timestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The timestamp, in ISO 8601 format.
ThrottledClientException
Description
The client exceeded its request rate limit.
Members
- Code
-
- Type: string
- Message
-
- Type: string
TranscriptionConfiguration
Description
The configuration for the current transcription operation. Must contain EngineTranscribeSettings
or EngineTranscribeMedicalSettings
.
Members
- EngineTranscribeMedicalSettings
-
- Type: EngineTranscribeMedicalSettings structure
The transcription configuration settings passed to Amazon Transcribe Medical.
- EngineTranscribeSettings
-
- Type: EngineTranscribeSettings structure
The transcription configuration settings passed to Amazon Transcribe.
UnauthorizedClientException
Description
The client is not currently authorized to make the request.
Members
- Code
-
- Type: string
- Message
-
- Type: string
UnprocessableEntityException
Description
The request was well-formed but was unable to be followed due to semantic errors.
Members
- Code
-
- Type: string
- Message
-
- Type: string
UpdatePhoneNumberRequestItem
Description
The phone number ID, product type, or calling name fields to update, used with the BatchUpdatePhoneNumber and UpdatePhoneNumber actions.
Members
- CallingName
-
- Type: string
The outbound calling name to update.
- PhoneNumberId
-
- Required: Yes
- Type: string
The phone number ID to update.
- ProductType
-
- Type: string
The product type to update.
UpdateUserRequestItem
Description
The user ID and user fields to update, used with the BatchUpdateUser action.
Members
- AlexaForBusinessMetadata
-
- Type: AlexaForBusinessMetadata structure
The Alexa for Business metadata.
- LicenseType
-
- Type: string
The user license type.
- UserId
-
- Required: Yes
- Type: string
The user ID.
- UserType
-
- Type: string
The user type.
User
Description
The user on the Amazon Chime account.
Members
- AccountId
-
- Type: string
The Amazon Chime account ID.
- AlexaForBusinessMetadata
-
- Type: AlexaForBusinessMetadata structure
The Alexa for Business metadata.
- DisplayName
-
- Type: string
The display name of the user.
- InvitedOn
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.
- LicenseType
-
- Type: string
The license type for the user.
- PersonalPIN
-
- Type: string
The user's personal meeting PIN.
- PrimaryEmail
-
- Type: string
The primary email address of the user.
- PrimaryProvisionedNumber
-
- Type: string
The primary phone number associated with the user.
- RegisteredOn
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Date and time when the user is registered, in ISO 8601 format.
- UserId
-
- Required: Yes
- Type: string
The user ID.
- UserInvitationStatus
-
- Type: string
The user invite status.
- UserRegistrationStatus
-
- Type: string
The user registration status.
- UserType
-
- Type: string
The user type.
UserError
Description
The list of errors returned when errors are encountered during the BatchSuspendUser, BatchUnsuspendUser, or BatchUpdateUser actions. This includes user IDs, error codes, and error messages.
Members
- ErrorCode
-
- Type: string
The error code.
- ErrorMessage
-
- Type: string
The error message.
- UserId
-
- Type: string
The user ID for which the action failed.
UserSettings
Description
Settings associated with an Amazon Chime user, including inbound and outbound calling and text messaging.
Members
- Telephony
-
- Required: Yes
- Type: TelephonySettings structure
The telephony settings associated with the user.
VideoArtifactsConfiguration
Description
The video artifact configuration object.
Members
- MuxType
-
- Type: string
The MUX type of the video artifact configuration object.
- State
-
- Required: Yes
- Type: string
Indicates whether the video artifact is enabled or disabled.
VoiceConnector
Description
The Amazon Chime Voice Connector configuration, including outbound host name and encryption settings.
Members
- AwsRegion
-
- Type: string
The AWS Region in which the Amazon Chime Voice Connector is created. Default:
us-east-1
. - CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The Amazon Chime Voice Connector creation timestamp, in ISO 8601 format.
- Name
-
- Type: string
The name of the Amazon Chime Voice Connector.
- OutboundHostName
-
- Type: string
The outbound host name for the Amazon Chime Voice Connector.
- RequireEncryption
-
- Type: boolean
Designates whether encryption is required for the Amazon Chime Voice Connector.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The updated Amazon Chime Voice Connector timestamp, in ISO 8601 format.
- VoiceConnectorArn
-
- Type: string
The ARN of the specified Amazon Chime Voice Connector.
- VoiceConnectorId
-
- Type: string
The Amazon Chime Voice Connector ID.
VoiceConnectorGroup
Description
The Amazon Chime Voice Connector group configuration, including associated Amazon Chime Voice Connectors. You can include Amazon Chime Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.
Members
- CreatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The Amazon Chime Voice Connector group creation time stamp, in ISO 8601 format.
- Name
-
- Type: string
The name of the Amazon Chime Voice Connector group.
- UpdatedTimestamp
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The updated Amazon Chime Voice Connector group time stamp, in ISO 8601 format.
- VoiceConnectorGroupArn
-
- Type: string
The ARN of the specified Amazon Chime Voice Connector group.
- VoiceConnectorGroupId
-
- Type: string
The Amazon Chime Voice Connector group ID.
- VoiceConnectorItems
-
- Type: Array of VoiceConnectorItem structures
The Amazon Chime Voice Connectors to which to route inbound calls.
VoiceConnectorItem
Description
For Amazon Chime Voice Connector groups, the Amazon Chime Voice Connectors to which to route inbound calls. Includes priority configuration settings. Limit: 3 VoiceConnectorItems
per Amazon Chime Voice Connector group.
Members
- Priority
-
- Required: Yes
- Type: int
The priority associated with the Amazon Chime Voice Connector, with 1 being the highest priority. Higher priority Amazon Chime Voice Connectors are attempted first.
- VoiceConnectorId
-
- Required: Yes
- Type: string
The Amazon Chime Voice Connector ID.
VoiceConnectorSettings
Description
The Amazon Chime Voice Connector settings. Includes any Amazon S3 buckets designated for storing call detail records.
Members
- CdrBucket
-
- Type: string
The Amazon S3 bucket designated for call detail record storage.