기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Lex에 사용되는 작업, 리소스 및 조건 키
Amazon Lex(서비스 접두사: lex)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
Amazon Lex에서 정의한 작업
IAM 정책 설명의 Action 요소에서 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| CreateBotVersion | 지정된 봇의 $LATEST 버전을 기반으로 새 버전을 생성합니다. | 쓰기 | |||
| CreateIntentVersion | 지정된 의도의 $LATEST 버전을 기반으로 새 버전을 생성합니다. | 쓰기 | |||
| CreateSlotTypeVersion | 지정된 슬롯 유형의 $LATEST 버전을 기반으로 새 버전을 생성합니다. | 쓰기 | |||
| DeleteBot | 봇의 모든 버전을 삭제합니다. | 쓰기 | |||
| DeleteBotAlias | 지정된 봇의 별칭을 삭제합니다. | 쓰기 | |||
| DeleteBotChannelAssociation | Amazon Lex 봇 별칭과 메시징 플랫폼 간의 연결을 삭제합니다. | 쓰기 | |||
| DeleteBotVersion | 봇의 특정 버전을 삭제합니다. | 쓰기 | |||
| DeleteIntent | 의도의 모든 버전을 삭제합니다. | 쓰기 | |||
| DeleteIntentVersion | 의도의 특정 버전을 삭제합니다. | 쓰기 | |||
| DeleteSession | 지정된 봇, 별칭 및 사용자 ID에 대한 세션 정보를 제거합니다. | 쓰기 | |||
| DeleteSlotType | 슬롯 유형의 모든 버전을 삭제합니다. | 쓰기 | |||
| DeleteSlotTypeVersion | 슬롯 유형의 특정 버전을 삭제합니다. | 쓰기 | |||
| DeleteUtterances | Amazon Lex가 특정 봇 및 userId에서 utterances를 위해 유지하는 정보를 삭제합니다. | 쓰기 | |||
| GetBot | 특정 봇에 대한 정보를 반환합니다. 봇 이름뿐만 아니라 봇 버전 또는 별칭도 필요합니다. | 읽기 | |||
| GetBotAlias | Amazon Lex 봇 별칭에 대한 정보를 반환합니다. | 읽기 | |||
| GetBotAliases | 지정된 Amazon Lex 봇에 대한 별칭 목록을 반환합니다. | 목록 | |||
| GetBotChannelAssociation | Amazon Lex 봇과 메시징 플랫폼 간의 연결에 대한 정보를 반환합니다. | 읽기 | |||
| GetBotChannelAssociations | 단일 봇과 연결된 모든 채널의 목록을 반환합니다. | 목록 | |||
| GetBotVersions | 특정 봇의 모든 버전에 대한 정보를 반환합니다. | 목록 | |||
| GetBots | 클라이언트에서 제공하는 필터에 따라 모든 봇의 $LATEST 버전에 대한 정보를 반환합니다. | 목록 | |||
| GetBuiltinIntent | 기본 제공 의도에 관한 정보를 반환합니다. | 읽기 | |||
| GetBuiltinIntents | 지정된 기준에 맞는 기본 제공 의도의 목록을 가져옵니다. | 읽기 | |||
| GetBuiltinSlotTypes | 지정된 기준에 맞는 기본 제공 슬롯 유형을 가져옵니다. | 읽기 | |||
| GetExport | Amazon Lex 리소스를 요청된 형식으로 내보냅니다. | 읽기 | |||
| GetImport | StartImport로 시작한 가져오기 작업에 대한 정보를 가져옵니다. | 읽기 | |||
| GetIntent | 특정 의도에 대한 정보를 반환합니다. 의도 이름뿐만 아니라 의도 버전 또한 지정해야 합니다. | 읽기 | |||
| GetIntentVersions | 특정 의도의 모든 버전에 대한 정보를 반환합니다. | 목록 | |||
| GetIntents | 클라이언트에서 제공하는 필터에 따라 모든 의도의 $LATEST 버전에 대한 정보를 반환합니다. | 목록 | |||
| GetMigration | 진행 중이거나 완료된 마이그레이션을 볼 수 있는 권한을 부여합니다. | 읽기 | |||
| GetMigrations | Amazon Lex v1에서 Amazon Lex v2로의 마이그레이션 목록을 볼 수 있는 권한을 부여합니다. | 목록 | |||
| GetSession | 지정된 봇, 별칭 및 사용자 ID에 대한 세션 정보를 반환합니다. | 읽기 | |||
| GetSlotType | 슬롯 유형의 특정 버전에 대한 정보를 반환합니다. 슬롯 유형 이름을 지정할 뿐만 아니라 슬롯 유형 버전 또한 지정해야 합니다. | 읽기 | |||
| GetSlotTypeVersions | 특정 슬롯 유형의 모든 버전에 대한 정보를 반환합니다. | 목록 | |||
| GetSlotTypes | 클라이언트에서 제공하는 필터에 따라 모든 슬롯 유형의 $LATEST 버전에 대한 정보를 반환합니다. | 목록 | |||
| GetUtterancesView | 최근 기간 동안 봇의 버전에 대한 집계 utterance 데이터의 보기를 반환합니다. | 목록 | |||
| ListTagsForResource | Lex 리소스에 대한 태그를 나열합니다. | 읽기 | |||
| PostContent | Amazon Lex에 사용자 입력(텍스트 또는 스피치)을 전송합니다. | 쓰기 | |||
| PostText | Amazon Lex에 사용자 입력(텍스트만)을 전송합니다. | 쓰기 | |||
| PutBot | Amazon Lex 대화형 봇의 $LATEST 버전을 생성하거나 업데이트합니다. | 쓰기 | |||
| PutBotAlias | 특정 봇의 별칭을 생성하거나 업데이트합니다. | 쓰기 | |||
| PutIntent | 의도의 $LATEST 버전을 생성하거나 업데이트합니다. | 쓰기 | |||
| PutSession | Amazon Lex 봇을 사용하여 새 세션을 생성하거나 기존 세션을 수정합니다. | 쓰기 | |||
| PutSlotType | 슬롯 유형의 $LATEST 버전을 생성하거나 업데이트합니다. | 쓰기 | |||
| StartImport | Amazon Lex로 리소스를 가져오는 작업을 시작합니다. | 쓰기 | |||
| StartMigration | Amazon Lex v1에서 Amazon Lex v2로 봇을 마이그레이션할 수 있는 권한을 부여합니다. | 쓰기 | |||
| TagResource | Lex 리소스에 태그를 추가하거나 덮어씁니다. | 태그 지정 | |||
| UntagResource | Lex 리소스에서 태그를 제거합니다. | 태그 지정 | |||
Amazon Lex에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| bot |
arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}
|
|
| bot version |
arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotVersion}
|
|
| bot alias |
arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotAlias}
|
|
| channel |
arn:${Partition}:lex:${Region}:${Account}:bot-channel:${BotName}:${BotAlias}:${ChannelName}
|
|
| intent version |
arn:${Partition}:lex:${Region}:${Account}:intent:${IntentName}:${IntentVersion}
|
|
| slottype version |
arn:${Partition}:lex:${Region}:${Account}:slottype:${SlotName}:${SlotVersion}
|
Amazon Lex에 사용되는 조건 키
Amazon Lex는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.
| 조건 키 | 설명 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청의 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:ResourceTag/${TagKey} | Lex 리소스에 연결된 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:TagKeys | 요청의 태그 키 집합을 기준으로 액세스를 필터링합니다. | ArrayOfString |
| lex:associatedIntents | 요청에 포함된 의도를 기반으로 액세스를 제어할 수 있습니다. | ArrayOfString |
| lex:associatedSlotTypes | 요청에 포함된 슬롯 유형을 기반으로 액세스를 제어할 수 있습니다. | ArrayOfString |
| lex:channelType | 요청에 포함된 채널 유형을 기반으로 액세스를 제어할 수 있습니다. | 문자열 |
