UpdateBot - Amazon Lex

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

UpdateBot

기존 봇의 구성을 업데이트합니다.

요청 구문

PUT /bots/botId/ HTTP/1.1 Content-type: application/json { "botName": "string", "dataPrivacy": { "childDirected": boolean }, "description": "string", "idleSessionTTLInSeconds": number, "roleArn": "string" }

URI 요청 파라미터

요청은 다음의 URI 파라미터를 사용합니다.

botId

업데이트할 봇의 고유한 식별자입니다. 이 식별자는 다음에 의해 반환됩니다.크리에이트봇작업.

길이 제약 조건: 고정 길이 10입니다.

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

: 필수 예

요청 본문

요청은 JSON 형식의 다음 데이터를 받습니다.

botName

봇의 새 이름 봇을 생성하는 계정에서 이름이 고유해야 합니다.

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 100입니다.

Pattern: ^([0-9a-zA-Z][_-]?)+$

: 필수 예

dataPrivacy

Amazon Lex가 봇의 데이터와 함께 사용해야 하는 추가 개인 정보 보호에 대한 정보를 제공합니다.

유형: DataPrivacy 객체

: 필수 예

description

봇에 대한 설명입니다.

Type: 문자열

길이 제약 조건: 최소 길이 0. 최대 길이는 200입니다.

: 필수 아니요

idleSessionTTLInSeconds

Amazon Lex가 봇과의 대화에 대한 정보를 보관해야 하는 시간 (초) 입니다.

사용자 상호 작용은 지정된 시간 동안 활성 상태로 유지됩니다. 이 시간 동안 대화가 발생하지 않으면 세션이 만료되고 Amazon Lex는 시간 초과 전에 제공된 모든 데이터를 삭제합니다.

60초 (1분) 에서 86,400초 (24시간) 초 사이에서 지정할 수 있습니다.

Type: 정수

유효한 범위: 최소값은 60입니다. 최대값은 86400입니다.

: 필수 예

roleArn

봇에 액세스할 수 있는 권한이 있는 IAM 역할의 Amazon 리소스 이름 (ARN) 입니다.

Type: 문자열

길이 제약 조건: 최소 길이는 32이고, 최대 길이 2048.

Pattern: ^arn:aws:iam::[0-9]{12}:role/.*$

: 필수 예

응답 구문

HTTP/1.1 202 Content-type: application/json { "botId": "string", "botName": "string", "botStatus": "string", "creationDateTime": number, "dataPrivacy": { "childDirected": boolean }, "description": "string", "idleSessionTTLInSeconds": number, "lastUpdatedDateTime": number, "roleArn": "string" }

응답 요소

작업이 성공하면 서비스가 HTTP 202 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

botId

업데이트된 봇의 고유한 식별자입니다.

Type: 문자열

길이 제약 조건: 고정 길이 10입니다.

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

botName

업데이트 후의 봇의 이름

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 100입니다.

Pattern: ^([0-9a-zA-Z][_-]?)+$

botStatus

봇의 현재 상태를 표시합니다. 봇이 첫 번째입니다.Creating상태. 사용하기 위해 봇을 읽으면Available상태. 봇이 생성된 후에DRAFT봇의 버전

Type: 문자열

유효한 값: Creating | Available | Inactive | Deleting | Failed | Versioning | Importing

creationDateTime

봇이 생성된 날짜와 시간의 타임스탬프입니다.

Type: 타임스탬프

dataPrivacy

업데이트 후 봇에 대한 데이터 개인 정보 보호 설정입니다.

유형: DataPrivacy 객체

description

업데이트 후의 봇에 대한 설명입니다.

Type: 문자열

길이 제약 조건: 최소 길이 0. 최대 길이는 200입니다.

idleSessionTTLInSeconds

업데이트 후 봇에 대한 세션 시간 초과 (초) 입니다.

Type: 정수

유효한 범위: 최소값은 60입니다. 최대값은 86400입니다.

lastUpdatedDateTime

봇이 마지막으로 업데이트된 날짜와 시간의 타임스탬프입니다.

Type: 타임스탬프

roleArn

업데이트 후 봇이 사용하는 IAM 역할의 Amazon 리소스 이름 (ARN) 입니다.

Type: 문자열

길이 제약 조건: 최소 길이는 32이고, 최대 길이 2048.

Pattern: ^arn:aws:iam::[0-9]{12}:role/.*$

오류

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.

ConflictException

리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 409

InternalServerException

서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 500

PreconditionFailedException

하나 이상의 요청 필드가 유효하지 않기 때문에 요청을 완료할 수 없습니다. 요청의 필드를 확인하고 다시 시도하십시오.

HTTP 상태 코드: 412

ServiceQuotaExceededException

봇에 대한 할당량에 도달했습니다.

HTTP 상태 코드: 402

ThrottlingException

요청량이 너무 높습니다. 요청 횟수를 줄입니다.

HTTP 상태 코드: 429

ValidationException

요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.