쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

PutBotAlias

포커스 모드
PutBotAlias - Amazon Lex V1

지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단합니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 Amazon Lex V2 가이드를 참조하세요.

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

지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단합니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 Amazon Lex V2 가이드를 참조하세요.

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

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

이 작업에는 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.

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

필수 여부: 예

name

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

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

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

필수 여부: 예

요청 본문

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

botVersion

봇의 버전.

유형: 문자열

길이 제한: 최소 길이는 1. 최대 길이는 64.

Pattern: \$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" } ] }

응답 요소

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

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

botName

별칭이 가리키는 봇의 이름.

유형: 문자열

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

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

botVersion

별칭이 가리키는 봇의 버전.

유형: 문자열

길이 제한: 최소 길이는 1. 최대 길이는 64.

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

checksum

별칭의 현재 버전에 대한 체크섬.

유형: 문자열

conversationLogs

Amazon Lex가 별칭에 대한 대화 로그를 사용하는 방법을 결정하는 설정입니다.

유형: ConversationLogsResponse 객체

createdDate

봇이 별칭이 생성된 날짜.

유형: 타임스탬프

description

별칭에 대한 설명.

유형: 문자열

길이 제한: 최소 길이는 0. 최대 길이는 200.

lastUpdatedDate

봇 별칭이 업데이트된 날짜. 리소스를 생성할 때 생성 날짜 및 최종 업데이트 날짜가 동일합니다.

유형: 타임스탬프

name

별칭의 이름.

유형: 문자열

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

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

tags

봇과 연결된 태그 목록.

유형: Tag객체 어레이

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

Errors

BadRequestException

요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.

HTTP 상태 코드: 400

ConflictException

요청을 처리하는 동안 충돌이 발생했습니다. 다시 요청해 보세요.

HTTP 상태 코드: 409

InternalFailureException

내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청이 한도를 초과했습니다. 다시 요청해 보세요.

HTTP 상태 코드: 429

PreconditionFailedException

변경하려는 리소스의 체크섬이 요청의 체크섬과 일치하지 않습니다. 리소스의 체크섬을 확인한 후 다시 시도하세요.

HTTP 상태 코드: 412

참고

언어별 AWS SDKs

이 페이지에서

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.