Amazon Lex V2에 사용되는 작업, 리소스 및 조건 키

Amazon Lex V2(서비스 접두사: lex)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.

참조:

• 이 서비스의 구성 방법을 알아봅니다.

• 이 서비스에 사용 가능한 API 작업 목록을 봅니다.

• IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

Amazon Lex V2에서 정의한 작업

IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.

작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.

작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.

참고

리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키	종속 작업
BatchCreateCustomVocabularyItem	기존 사용자 지정 어휘에서 새 항목을 생성할 수 있는 권한을 부여합니다.	쓰기	bot*
BatchDeleteCustomVocabularyItem	기존 사용자 지정 어휘에서 기존 항목을 삭제할 수 있는 권한을 부여합니다.	쓰기	bot*
BatchUpdateCustomVocabularyItem	기존 사용자 지정 어휘에서 기존 항목을 업데이트할 수 있는 권한을 부여합니다.	쓰기	bot*
BuildBotLocale	봇에 기존 봇 로캘을 빌드할 수 있는 권한을 부여합니다.	Write	bot*
CreateBot	새 봇을 생성하고 DRAFT 봇 버전을 가리키는 테스트 봇 별칭을 생성할 권한을 부여합니다.	Write	bot*
			bot alias*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateBotAlias	봇에 새 봇 별칭을 생성할 권한을 부여합니다.	Write	bot alias*
				aws:TagKeys aws:RequestTag/${TagKey}
CreateBotChannel [권한만 해당]	기존 봇에 봇 채널을 생성할 권한을 부여합니다.	Write	bot*
CreateBotLocale	기존 봇에 새 봇 로캘을 생성할 권한을 부여합니다.	쓰기	bot*
CreateBotReplica	봇에 대한 봇 복제본을 만들 수 있는 권한을 부여합니다.	쓰기	bot*
CreateBotVersion	기존 봇의 새 버전을 생성할 권한을 부여합니다.	쓰기	bot*
CreateCustomVocabulary [권한만 해당]	기존 봇 로캘에 새 사용자 정의 어휘를 생성할 수 있는 권한을 부여합니다.	쓰기	bot*
CreateExport	기존 리소스에 대한 내보내기를 만들 수 있는 권한을 부여합니다.	Write	bot
			test set
CreateIntent	기존 봇 로캘에 새 의도를 생성할 권한을 부여합니다.	Write	bot*
CreateResourcePolicy	Lex 리소스에 대한 새 리소스 정책을 만들 수 있는 권한을 부여합니다.	Write	bot
			bot alias
CreateSlot	의도에 새 슬롯을 생성할 권한을 부여합니다.	Write	bot*
CreateSlotType	기존 봇 로캘에 새 슬롯 유형을 생성할 권한을 부여합니다.	쓰기	bot*
CreateTestSet [권한만 해당]	새 테스트 세트를 가져오는 권한을 부여합니다.	쓰기
CreateTestSetDiscrepancyReport	테스트 세트 불일치 보고서를 생성하는 권한을 부여합니다.	쓰기	test set*
CreateUploadUrl	가져오기 파일에 대한 업로드 URL을 만들 수 있는 권한을 부여합니다.	Write
DeleteBot	기존 봇을 삭제할 권한을 부여합니다.	Write	bot*		lex:DeleteBotAlias lex:DeleteBotChannel lex:DeleteBotLocale lex:DeleteBotVersion lex:DeleteIntent lex:DeleteSlot lex:DeleteSlotType
			bot alias*
DeleteBotAlias	봇에서 기존 봇 별칭을 삭제할 권한을 부여합니다.	Write	bot alias*
DeleteBotChannel [권한만 해당]	기존 봇 채널을 삭제할 권한을 부여합니다.	Write	bot*
DeleteBotLocale	봇에서 기존 봇 로캘을 삭제할 수 있는 권한을 부여합니다.	쓰기	bot*		lex:DeleteIntent lex:DeleteSlot lex:DeleteSlotType
DeleteBotReplica	기존 봇 복제본을 삭제할 권한을 부여합니다.	쓰기	bot*
DeleteBotVersion	기존 봇 버전을 삭제할 권한을 부여합니다.	쓰기	bot*
DeleteCustomVocabulary	봇 로캘에서 기존 사용자 정의 의도를 삭제할 수 있는 권한을 부여합니다.	쓰기	bot*
DeleteExport	기존 내보내기를 삭제할 수 있는 권한을 부여합니다.	Write	bot
			test set
DeleteImport	기존 가져오기를 삭제할 수 있는 권한을 부여합니다.	Write	bot
			test set
DeleteIntent	봇 로캘에서 기존 의도를 삭제할 권한을 부여합니다.	Write	bot*
DeleteResourcePolicy	Lex 리소스에 대한 기존 리소스 정책을 삭제할 수 있는 권한을 부여합니다.	Write	bot
			bot alias
DeleteSession	봇 별칭 및 사용자 ID에 대한 세션 정보를 삭제할 권한을 부여합니다.	Write	bot alias*
DeleteSlot	의도에서 기존 슬롯을 삭제할 권한을 부여합니다.	Write	bot*
DeleteSlotType	봇 로캘에서 기존 슬롯 유형을 삭제할 권한을 부여합니다.	쓰기	bot*
DeleteTestSet	기존 테스트 세트를 삭제하는 권한을 부여합니다.	쓰기	test set*
DeleteUtterances	봇에 대한 발언 데이터를 삭제할 수 있는 권한을 부여합니다.	쓰기	bot*
DescribeBot	기존 봇을 검색할 권한을 부여합니다.	Read	bot*
DescribeBotAlias	기존 봇 별칭을 검색할 권한을 부여합니다.	Read	bot alias*
DescribeBotChannel [권한만 해당]	기존 봇 채널을 검색할 권한을 부여합니다.	Read	bot*
DescribeBotLocale	기존 봇 로캘을 검색할 권한을 부여합니다.	읽기	bot*
DescribeBotRecommendation	봇 권장 사항에 메타데이터를 검색할 수 있는 권한을 부여합니다.	읽기	bot*
DescribeBotReplica	기존 봇 복제본을 검색할 권한을 부여합니다.	읽기	bot*
DescribeBotResourceGeneration	봇 리소스 생성을 위한 메타데이터를 검색할 수 있는 권한 부여	읽기	bot*
DescribeBotVersion	기존 봇 버전을 검색할 수 있는 권한을 부여합니다.	읽기	bot*
DescribeCustomVocabulary [권한만 해당]	기존 사용자 정의 어휘를 검색할 수 있는 권한을 부여합니다.	읽기	bot*
DescribeCustomVocabularyMetadata	기존 사용자 정의 어휘의 메타데이터를 검색할 수 있는 권한을 부여합니다.	읽기	bot*
DescribeExport	기존 내보내기를 검색할 수 있는 권한을 부여합니다.	Read	bot		lex:DescribeBot lex:DescribeBotLocale lex:DescribeIntent lex:DescribeSlot lex:DescribeSlotType lex:ListBotLocales lex:ListIntents lex:ListSlotTypes lex:ListSlots
			test set
DescribeImport	기존 가져오기를 검색할 수 있는 권한을 부여합니다.	Read	bot
			test set
DescribeIntent	기존 의도를 검색할 권한을 부여합니다.	Read	bot*
DescribeResourcePolicy	Lex 리소스에 대한 기존 리소스 정책을 검색할 수 있는 권한을 부여합니다.	Read	bot
			bot alias
DescribeSlot	기존 슬롯을 검색할 권한을 부여합니다.	Read	bot*
DescribeSlotType	기존 슬롯 유형을 검색할 권한을 부여합니다.	읽기	bot*
DescribeTestExecution	테스트 실행 메타데이터를 검색하는 권한을 부여합니다.	읽기	test set*
DescribeTestSet	기존 테스트 세트를 검색하는 권한을 부여합니다.	읽기	test set*
DescribeTestSetDiscrepancyReport	테스트 세트 불일치 보고서 메타데이터를 검색하는 권한을 부여합니다.	읽기	test set*
DescribeTestSetGeneration	테스트 세트 생성 메타데이터를 검색하는 권한을 부여합니다.	읽기	test set
GenerateBotElement	봇에 지원되는 필드 또는 요소를 생성할 수 있는 권한 부여	읽기	bot*
GetSession	봇 별칭 및 사용자 ID에 대한 세션 정보를 검색할 권한을 부여합니다.	읽기	bot alias*
GetTestExecutionArtifactsUrl	테스트 실행을 위한 아티팩트 URL을 검색하는 권한을 부여합니다.	읽기	test set*
ListAggregatedUtterances	봇에 대한 발언 및 통계를 나열할 수 있는 권한을 부여합니다.	나열	bot*
ListBotAliasReplicas	봇 복제본의 별칭 복제본을 나열할 권한을 부여합니다.	나열	bot*
ListBotAliases	봇의 봇 별칭을 나열할 권한을 부여합니다.	나열	bot*
ListBotChannels [권한만 해당]	봇 채널을 나열할 권한을 부여합니다.	나열	bot*
ListBotLocales	봇의 봇 로캘을 나열할 권한을 부여합니다.	나열	bot*
ListBotRecommendations	지정된 조건을 충족하는 봇 권장 사항 목록을 가져올 수 있는 권한을 부여합니다.	나열	bot*
ListBotReplicas	봇의 복제본을 나열할 권한을 부여합니다.	나열	bot*
ListBotResourceGenerations	봇에 대한 리소스 생성을 나열할 수 있는 권한 부여	나열	bot*
ListBotVersionReplicas	봇 복제본의 버전 복제본을 나열할 권한을 부여합니다.	나열	bot*
ListBotVersions	기존 봇 버전을 나열할 권한을 부여합니다.	나열	bot*
ListBots	기존 봇을 나열할 권한을 부여합니다.	나열
ListBuiltInIntents	내장 의도를 나열할 권한을 부여합니다.	나열
ListBuiltInSlotTypes	내장 슬롯 유형을 나열할 권한을 부여합니다.	나열
ListCustomVocabularyItems	기존 사용자 정의 어휘의 항목을 나열할 수 있는 권한을 부여합니다.	나열	bot*
ListExports	기존 내보내기를 나열할 권한을 부여합니다.	나열
ListImports	기존 가져오기를 나열할 권한을 부여합니다.	나열
ListIntentMetrics	봇에 대한 의도 분석 지표를 나열할 수 있는 권한을 부여합니다.	나열	bot*
ListIntentPaths	봇에 대한 의도 경로 분석을 나열할 수 있는 권한을 부여합니다.	나열	bot*
ListIntentStageMetrics	봇에 대한 intentStage 분석 지표를 나열할 수 있는 권한을 부여합니다.	나열	bot*
ListIntents	봇의 의도를 나열할 권한을 부여합니다.	나열	bot*
ListRecommendedIntents	봇 권장 사항에서 제공하는 권장 의도의 목록을 가져올 수 있는 권한을 부여합니다.	나열	bot*
ListSessionAnalyticsData	봇에 대한 세션 분석 데이터를 나열할 수 있는 권한을 부여합니다.	나열	bot*
ListSessionMetrics	봇에 대한 세션 분석 지표를 나열할 수 있는 권한을 부여합니다.	나열	bot*
ListSlotTypes	봇의 슬롯 유형을 나열할 권한을 부여합니다.	나열	bot*
ListSlots	의도의 슬롯을 나열할 권한을 부여합니다.	나열	bot*
ListTagsForResource	Lex 리소스의 태그를 나열할 권한을 부여합니다.	읽기	bot
			bot alias
			test set
ListTestExecutionResultItems	테스트 실행을 위한 테스트 결과 데이터를 검색하는 권한을 부여합니다.	읽기	test set*		lex:ListTestSetRecords
ListTestExecutions	테스트 실행을 나열하는 권한을 부여합니다.	나열
ListTestSetRecords	기존 테스트 세트 내부 레코드를 검색하는 권한을 부여합니다.	읽기	test set*
ListTestSets	데이터 세트를 나열하는 권한을 부여합니다.	나열
PutSession	봇 별칭 및 사용자 ID에 대해 새 세션을 생성하거나 기존 세션을 수정할 권한을 부여합니다.	쓰기	bot alias*
RecognizeText	봇 별칭에 사용자 입력(텍스트만)을 전송할 권한을 부여합니다.	쓰기	bot alias*
RecognizeUtterance	봇 별칭에 사용자 입력(텍스트 또는 음성)을 전송할 권한을 부여합니다.	쓰기	bot alias*
SearchAssociatedTranscripts	지정된 기준을 충족하는 연결된 기록을 검색할 수 있는 권한을 부여합니다.	나열	bot*
StartBotRecommendation	기존 봇 로캘에 대한 봇 권장 사항을 시작할 수 있는 권한을 부여합니다.	쓰기	bot*
StartBotResourceGeneration	기존 봇 로캘에 대한 리소스 생성을 시작할 수 있는 권한 부여	쓰기	bot*
StartConversation	봇 별칭에 사용자 입력(음성, 텍스트, DTMF)을 스트리밍할 권한을 부여합니다.	Write	bot alias*
StartImport	업로드된 가져오기 파일로 새 가져오기를 시작할 수 있는 권한을 부여합니다.	쓰기	bot		lex:CreateBot lex:CreateBotLocale lex:CreateCustomVocabulary lex:CreateIntent lex:CreateSlot lex:CreateSlotType lex:CreateTestSet lex:DeleteBotLocale lex:DeleteCustomVocabulary lex:DeleteIntent lex:DeleteSlot lex:DeleteSlotType lex:UpdateBot lex:UpdateBotLocale lex:UpdateCustomVocabulary lex:UpdateIntent lex:UpdateSlot lex:UpdateSlotType lex:UpdateTestSet
			bot alias
			test set
				aws:TagKeys aws:RequestTag/${TagKey}
StartTestExecution	테스트 세트를 사용하여 테스트 실행을 시작하는 권한을 부여합니다.	쓰기	test set*
StartTestSetGeneration	테스트 세트를 생성하는 권한을 부여합니다.	쓰기	test set
StopBotRecommendation	기존 봇 로캘에 대한 봇 권장 사항을 정지할 수 있는 권한을 부여합니다.	쓰기	bot*
TagResource	Lex 리소스의 태그를 추가하거나 덮어쓸 권한을 부여합니다.	태그 지정	bot
			bot alias
			test set
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Lex 리소스에서 태그를 제거할 권한을 부여합니다.	태그 지정	bot
			bot alias
			test set
				aws:TagKeys
UpdateBot	기존 봇을 업데이트할 권한을 부여합니다.	Write	bot*
UpdateBotAlias	기존 봇 별칭을 업데이트할 권한을 부여합니다.	Write	bot alias*
UpdateBotLocale	기존 봇 로캘을 업데이트할 권한을 부여합니다.	쓰기	bot*
UpdateBotRecommendation	기존 봇 권장 요청을 업데이트할 수 있는 권한을 부여합니다.	쓰기	bot*
UpdateCustomVocabulary [권한만 해당]	기존 사용자 정의 어휘를 업데이트할 수 있는 권한을 부여합니다.	쓰기	bot*
UpdateExport	기존 내보내기를 업데이트할 권한을 부여합니다.	Write	bot*
UpdateIntent	기존 의도를 업데이트할 권한을 부여합니다.	Write	bot*
UpdateResourcePolicy	Lex 리소스에 대한 기존 리소스 정책을 업데이트할 수 있는 권한을 부여합니다.	Write	bot
			bot alias
UpdateSlot	기존 슬롯을 업데이트할 권한을 부여합니다.	Write	bot*
UpdateSlotType	기존 슬롯 유형을 업데이트할 권한을 부여합니다.	쓰기	bot*
UpdateTestSet	기존 테스트 세트를 업데이트하는 권한을 부여합니다.	쓰기	test set*

Amazon Lex V2에서 정의한 리소스 유형

이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업에서 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.

리소스 유형	ARN	조건 키
bot	arn:${Partition}:lex:${Region}:${Account}:bot/${BotId}	aws:ResourceTag/${TagKey}
bot alias	arn:${Partition}:lex:${Region}:${Account}:bot-alias/${BotId}/${BotAliasId}	aws:ResourceTag/${TagKey}
test set	arn:${Partition}:lex:${Region}:${Account}:test-set/${TestSetId}	aws:ResourceTag/${TagKey}

Amazon Lex V2에 사용되는 조건 키

Amazon Lex V2는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.

조건 키	설명	유형
aws:RequestTag/${TagKey}	요청의 태그별로 액세스를 필터링합니다.	String
aws:ResourceTag/${TagKey}	Lex 리소스에 연결된 태그를 기준으로 액세스를 필터링합니다.	String
aws:TagKeys	요청의 태그 키 세트를 기준으로 액세스를 필터링합니다.	ArrayOfString