기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateBotRecommendation
기존 봇 권장 요청을 업데이트합니다.
요청 구문
PUT /bots/botId/botversions/botVersion/botlocales/localeId/botrecommendations/botRecommendationId/ HTTP/1.1
Content-type: application/json
{
"encryptionSetting": {
"associatedTranscriptsPassword": "string",
"botLocaleExportPassword": "string",
"kmsKeyArn": "string"
}
}URI 요청 파라미터
요청은 다음의 URI 파라미터를 사용합니다.
- botId
-
업데이트할 봇 추천을 포함하는 봇의 고유 식별자입니다.
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$: 필수 예
- botRecommendationId
-
업데이트할 봇의 고유한 식별자입니다.
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$: 필수 예
- botVersion
-
업데이트할 봇의 권장 사항이 포함된 봇의 버전입니다.
길이 제약 조건: 고정 길이 5입니다.
Pattern:
^DRAFT$: 필수 예
- localeId
-
업데이트할 봇 권장 사항의 언어 및 로케일의 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어
: 필수 예
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- encryptionSetting
-
봇 추천 결과와 관련된 데이터를 암호화하는 데 사용되는 암호를 나타내는 객체와 연관된 메타데이터를 암호화하는 데 사용되는 KMS 키 ARN도 있습니다.
유형: EncryptionSetting 객체
: 필수 예
응답 구문
HTTP/1.1 202
Content-type: application/json
{
"botId": "string",
"botRecommendationId": "string",
"botRecommendationStatus": "string",
"botVersion": "string",
"creationDateTime": number,
"encryptionSetting": {
"associatedTranscriptsPassword": "string",
"botLocaleExportPassword": "string",
"kmsKeyArn": "string"
},
"lastUpdatedDateTime": number,
"localeId": "string",
"transcriptSourceSetting": {
"s3BucketTranscriptSource": {
"kmsKeyArn": "string",
"pathFormat": {
"objectPrefixes": [ "string" ]
},
"s3BucketName": "string",
"transcriptFilter": {
"lexTranscriptFilter": {
"dateRangeFilter": {
"endDateTime": number,
"startDateTime": number
}
}
},
"transcriptFormat": "string"
}
}
}응답 요소
작업이 성공하면 서비스가 HTTP 202 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- botId
-
업데이트된 봇 추천을 포함하는 봇의 고유 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$ - botRecommendationId
-
업데이트할 봇의 고유한 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$ - botRecommendationStatus
-
봇 권장 사항의 상태입니다.
상태가 실패인 경우 실패 이유가 실패이유 필드에 나열됩니다.
Type: 문자열
유효한 값:
Processing | Deleting | Deleted | Downloading | Updating | Available | Failed - botVersion
-
업데이트된 봇 권장 사항이 포함된 봇 버전입니다.
Type: 문자열
길이 제약 조건: 고정 길이 5입니다.
Pattern:
^DRAFT$ - creationDateTime
-
봇 권장 사항이 생성된 날짜와 시간의 타임스탬프입니다.
Type: 타임스탬프
- encryptionSetting
-
봇 추천 결과와 관련된 데이터를 암호화하는 데 사용된 암호를 나타내는 객체와 연관된 메타데이터를 암호화하는 데 사용된 KMS 키 ARN을 나타냅니다.
유형: EncryptionSetting 객체
- lastUpdatedDateTime
-
봇 권장 사항이 마지막으로 업데이트된 날짜 및 시간의 타임스탬프입니다.
Type: 타임스탬프
- localeId
-
업데이트할 봇 권장 사항의 언어 및 로케일의 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어
Type: 문자열
- transcriptSourceSetting
-
관련 메타데이터뿐만 아니라 해당 기록을 포함하는 Amazon S3 버킷을 나타내는 객체입니다.
유형: TranscriptSourceSetting 객체
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- ConflictException
-
리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 409
- ConflictException
-
리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 409
- InternalServerException
-
서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 500
- PreconditionFailedException
-
하나 이상의 요청 필드가 유효하지 않기 때문에 요청을 완료할 수 없습니다. 요청의 필드를 확인하고 다시 시도하십시오.
HTTP 상태 코드: 412
- ResourceNotFoundException
-
사용자가 존재하지 않는 리소스를 설명하도록 요청했습니다. 요청하는 리소스를 확인하고 다시 시도하십시오.
HTTP 상태 코드: 404
- ServiceQuotaExceededException
-
봇에 대한 할당량에 도달했습니다.
HTTP 상태 코드: 402
- ThrottlingException
-
요청량이 너무 높습니다. 요청 횟수를 줄입니다.
HTTP 상태 코드: 429
- ValidationException
-
요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
