UpdateBotAlias - Amazon Lex API Reference

UpdateBotAlias

Updates the configuration of an existing bot alias.

Request Syntax

PUT /bots/botId/botaliases/botAliasId/ HTTP/1.1 Content-type: application/json { "botAliasLocaleSettings": { "string" : { "codeHookSpecification": { "lambdaCodeHook": { "codeHookInterfaceVersion": "string", "lambdaARN": "string" } }, "enabled": boolean } }, "botAliasName": "string", "botVersion": "string", "conversationLogSettings": { "audioLogSettings": [ { "destination": { "s3Bucket": { "kmsKeyArn": "string", "logPrefix": "string", "s3BucketArn": "string" } }, "enabled": boolean, "selectiveLoggingEnabled": boolean } ], "textLogSettings": [ { "destination": { "cloudWatch": { "cloudWatchLogGroupArn": "string", "logPrefix": "string" } }, "enabled": boolean, "selectiveLoggingEnabled": boolean } ] }, "description": "string", "sentimentAnalysisSettings": { "detectSentiment": boolean } }

URI Request Parameters

The request uses the following URI parameters.

botAliasId

The unique identifier of the bot alias.

Length Constraints: Fixed length of 10.

Pattern: ^(\bTSTALIASID\b|[0-9a-zA-Z]+)$

Required: Yes

botId

The identifier of the bot with the updated alias.

Length Constraints: Fixed length of 10.

Pattern: ^[0-9a-zA-Z]+$

Required: Yes

Request Body

The request accepts the following data in JSON format.

botAliasLocaleSettings

The new Lambda functions to use in each locale for the bot alias.

Type: String to BotAliasLocaleSettings object map

Map Entries: Maximum number of items.

Required: No

botAliasName

The new name to assign to the bot alias.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^([0-9a-zA-Z][_-]?){1,100}$

Required: Yes

botVersion

The new bot version to assign to the bot alias.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 5.

Pattern: ^(DRAFT|[0-9]+)$

Required: No

conversationLogSettings

The new settings for storing conversation logs in Amazon CloudWatch Logs and Amazon S3 buckets.

Type: ConversationLogSettings object

Required: No

description

The new description to assign to the bot alias.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 200.

Required: No

sentimentAnalysisSettings

Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

Type: SentimentAnalysisSettings object

Required: No

Response Syntax

HTTP/1.1 202 Content-type: application/json { "botAliasId": "string", "botAliasLocaleSettings": { "string" : { "codeHookSpecification": { "lambdaCodeHook": { "codeHookInterfaceVersion": "string", "lambdaARN": "string" } }, "enabled": boolean } }, "botAliasName": "string", "botAliasStatus": "string", "botId": "string", "botVersion": "string", "conversationLogSettings": { "audioLogSettings": [ { "destination": { "s3Bucket": { "kmsKeyArn": "string", "logPrefix": "string", "s3BucketArn": "string" } }, "enabled": boolean, "selectiveLoggingEnabled": boolean } ], "textLogSettings": [ { "destination": { "cloudWatch": { "cloudWatchLogGroupArn": "string", "logPrefix": "string" } }, "enabled": boolean, "selectiveLoggingEnabled": boolean } ] }, "creationDateTime": number, "description": "string", "lastUpdatedDateTime": number, "sentimentAnalysisSettings": { "detectSentiment": boolean } }

Response Elements

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

botAliasId

The identifier of the updated bot alias.

Type: String

Length Constraints: Fixed length of 10.

Pattern: ^(\bTSTALIASID\b|[0-9a-zA-Z]+)$

botAliasLocaleSettings

The updated Lambda functions to use in each locale for the bot alias.

Type: String to BotAliasLocaleSettings object map

Map Entries: Maximum number of items.

botAliasName

The updated name of the bot alias.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: ^([0-9a-zA-Z][_-]?){1,100}$

botAliasStatus

The current status of the bot alias. When the status is Available the alias is ready for use.

Type: String

Valid Values: Creating | Available | Deleting | Failed

botId

The identifier of the bot with the updated alias.

Type: String

Length Constraints: Fixed length of 10.

Pattern: ^[0-9a-zA-Z]+$

botVersion

The updated version of the bot that the alias points to.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 5.

Pattern: ^(DRAFT|[0-9]+)$

conversationLogSettings

The updated settings for storing conversation logs in Amazon CloudWatch Logs and Amazon S3 buckets.

Type: ConversationLogSettings object

creationDateTime

A timestamp of the date and time that the bot was created.

Type: Timestamp

description

The updated description of the bot alias.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 200.

lastUpdatedDateTime

A timestamp of the date and time that the bot was last updated.

Type: Timestamp

sentimentAnalysisSettings

Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

Type: SentimentAnalysisSettings object

Errors

For information about the errors that are common to all actions, see Common Errors.

ConflictException

The action that you tried to perform couldn't be completed because the resource is in a conflicting state. For example, deleting a bot that is in the CREATING state. Try your request again.

HTTP Status Code: 409

InternalServerException

The service encountered an unexpected condition. Try your request again.

HTTP Status Code: 500

PreconditionFailedException

Your request couldn't be completed because one or more request fields aren't valid. Check the fields in your request and try again.

HTTP Status Code: 412

ServiceQuotaExceededException

You have reached a quota for your bot.

HTTP Status Code: 402

ThrottlingException

Your request rate is too high. Reduce the frequency of requests.

HTTP Status Code: 429

ValidationException

One of the input parameters in your request isn't valid. Check the parameters and try your request again.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: