Request Syntax URI 요청 파라미터 요청 본문 응답 구문 응답 요소 Errors 참고

PutBotAlias

지정된 버전의 봇에 대한 별칭을 만들거나 지정된 버전의 봇에 대한 별칭을 대체합니다. 별칭이 가리키는 봇 버전을 변경하려면 별칭을 바꾸십시오. 별칭에 대한 자세한 내용은 버전 관리 및 별칭을 참조하십시오.

이 작업에는 lex:PutBotAlias 액션에 대한 권한이 필요합니다.

Request Syntax


PUT /bots/botName/aliases/name HTTP/1.1
Content-type: application/json

{
   "botVersion": "string",
   "checksum": "string",
   "conversationLogs": { 
      "iamRoleArn": "string",
      "logSettings": [ 
         { 
            "destination": "string",
            "kmsKeyArn": "string",
            "logType": "string",
            "resourceArn": "string"
         }
      ]
   },
   "description": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}

URI 요청 파라미터

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

botName

봇의 이름.

길이 제약: 최소 길이 2. 최대 길이는 50.

패턴: ^([A-Za-z]_?)+$

필수 여부: 예

name

별칭의 이름. 이름은 대/소문자를 구분하지 않습니다.

길이 제약: 최소 길이 1. 최대 길이는 100.

패턴: ^([A-Za-z]_?)+$

필수: 예

요청 본문

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

botVersion

봇의 버전.

유형: 문자열

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

패턴: \$LATEST|[0-9]+

필수 여부: 예

checksum

$LATEST 버전의 특정 개정 버전을 식별합니다.

새 봇을 만들 때는 checksum 필드를 비워 두십시오. 체크섬을 지정하면 BadRequestException 예외가 발생합니다.

봇을 업데이트하려면 checksum 필드를 해당 버전의 최신 수정 $LATEST 버전의 체크섬으로 설정하십시오. checksum 필드를 지정하지 않거나 체크섬이 $LATEST 버전과 일치하지 않으면 PreconditionFailedException 예외가 발생합니다.

타입: 문자열

필수 항목 여부: 아니요

conversationLogs

별칭의 대화 로그 설정.

타입: ConversationLogsRequest 객체

필수 여부: 아니요

description

별칭에 대한 설명.

유형: 문자열

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

필수 여부: 아니요

tags

봇에 추가할 태그의 목록입니다. 봇을 생성할 때만 태그를 추가할 수 있으며, 봇 별칭에서 태그를 업데이트하기 위해 PutBotAlias 작업을 사용할 수 없습니다. 태그를 업데이트하려면 TagResource 작업을 사용합니다.

유형: Tag 객체의 배열

어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

필수 여부: 아니요

응답 구문


HTTP/1.1 200
Content-type: application/json

{
   "botName": "string",
   "botVersion": "string",
   "checksum": "string",
   "conversationLogs": { 
      "iamRoleArn": "string",
      "logSettings": [ 
         { 
            "destination": "string",
            "kmsKeyArn": "string",
            "logType": "string",
            "resourceArn": "string",
            "resourcePrefix": "string"
         }
      ]
   },
   "createdDate": number,
   "description": "string",
   "lastUpdatedDate": number,
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}