기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Q in Connect에 사용되는 작업, 리소스 및 조건 키
Amazon Q in Connect (서비스 접두사:wisdom
) 는 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다. IAM
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용할 수 있는 API 작업 목록을 확인하십시오.
-
IAM권한 정책을 사용하여 이 서비스와 해당 리소스를 보호하는 방법을 알아보십시오.
Amazon Q in Connect에서 정의한 작업
IAM정책 설명의 Action
요소에 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용할 때는 일반적으로 이름이 같은 API 작업이나 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource
요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 열에 리소스 유형이 포함된 경우 해당 작업이 포함된 명령문에 해당 ARN 유형의 리소스를 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM정책의 Resource
요소로 리소스 액세스를 제한하는 경우 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition
요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
---|---|---|---|---|---|
ActivateMessageTemplate | 메시지 템플릿을 활성화할 권한을 부여합니다. | 쓰기 | |||
CreateAssistant | 어시스턴트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
CreateAssistantAssociation | 어시스턴트와 다른 리소스 간의 연결을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
CreateContent | 콘텐츠를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
CreateContentAssociation | 콘텐츠 연결을 만들 권한을 부여합니다. | 쓰기 | |||
CreateKnowledgeBase | 지식 기반을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
CreateMessageTemplate | 메시지 템플릿을 만들 권한을 부여합니다. | 쓰기 | |||
CreateMessageTemplateAttachment | 메시지 템플릿에 첨부 파일을 만들 수 있는 권한을 부여합니다. | 쓰기 | |||
CreateMessageTemplateVersion | 메시지 템플릿의 버전을 만들 수 있는 권한을 부여합니다. | 쓰기 | |||
CreateQuickResponse | 빠른 응답을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
CreateSession | 세션을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
DeactivateMessageTemplate | 메시지 템플릿을 비활성화할 수 있는 권한을 부여합니다. | 쓰기 | |||
DeleteAssistant | 어시스턴트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
DeleteAssistantAssociation | 어시스턴트 연결을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
DeleteContent | 콘텐츠를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
DeleteContentAssociation | 콘텐츠 연결을 삭제할 권한을 부여합니다. | 쓰기 | |||
DeleteImportJob | 지식 베이스의 가져오기 작업을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
DeleteKnowledgeBase | 지식 기반을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
DeleteMessageTemplate | 메시지 템플릿을 삭제할 권한을 부여합니다. | 쓰기 | |||
DeleteMessageTemplateAttachment | 메시지 템플릿에서 첨부 파일을 삭제할 권한을 부여합니다. | 쓰기 | |||
DeleteQuickResponse | 빠른 응답을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
GetAssistant | 어시스턴트에 대한 정보를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetAssistantAssociation | 어시스턴트 연결에 대한 정보를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetContent | 콘텐츠를 다운로드할 수 있도록 미리 서명된 권한을 포함하여 콘텐츠를 검색할 URL 수 있는 권한을 부여합니다. | 읽기 | |||
GetContentAssociation | 콘텐츠 연결에 대한 정보를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetContentSummary | 콘텐츠에 대한 요약 정보를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetImportJob | 가져오기 작업에 대한 정보를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetKnowledgeBase | 지식 기반에 대한 정보를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetMessageTemplate | 메시지 템플릿을 검색할 권한을 부여합니다. | 읽기 | |||
GetQuickResponse | 콘텐츠를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetRecommendations | 지정된 세션에 대한 권장 사항을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
GetSession | 지정된 세션에 대한 정보를 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
ListAssistantAssociations | 어시스턴트 연결에 대한 정보를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListAssistants | 어시스턴트에 대한 정보를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListContentAssociations | 콘텐츠 연결에 대한 정보를 나열할 권한을 부여합니다. | 나열 | |||
ListContents | 지식 기반 콘텐츠를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListImportJobs | 지식 기반에 대한 정보를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListKnowledgeBases | 지식 기반에 대한 정보를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListMessageTemplateVersions | 지정된 메시지 템플릿의 메시지 템플릿 버전을 나열할 권한을 부여합니다. | 나열 | |||
ListMessageTemplates | 지식창고의 메시지 템플릿을 나열할 권한을 부여합니다. | 나열 | |||
ListQuickResponses | 지식 베이스와 함께 빠른 응답을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListTagsForResource | 지정된 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다. | 읽기 | |||
NotifyRecommendationsReceived | 새로 사용할 수 있는 권장 사항의 지정된 어시스턴트 대기열에서 지정된 권장 사항을 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
PutFeedback | 피드백을 제출할 수 있는 권한을 부여합니다 | 쓰기 | |||
QueryAssistant | 지정된 어시스턴트에 대해 수동 검색을 수행할 수 있는 권한을 부여합니다. | 읽기 | |||
RemoveKnowledgeBaseTemplateUri | 지식창고에서 URI 템플릿을 제거할 권한을 부여합니다. | 쓰기 | |||
RenderMessageTemplate | 메시지 템플릿을 렌더링할 권한을 부여합니다. | 읽기 |
wisdom:GetMessageTemplate |
||
SearchContent | 지정된 지식 기반을 참조하는 컨텐츠를 검색할 수 있는 권한을 부여합니다. 이름을 기준으로 특정 콘텐츠 리소스를 가져오는 데 사용할 수 있습니다. | 읽기 | |||
SearchMessageTemplates | 지정된 지식 베이스를 참조하는 메시지 템플릿을 검색할 수 있는 권한을 부여합니다. | 읽기 | |||
SearchQuickResponses | 지정된 지식 베이스를 참조하는 빠른 응답을 검색할 수 있는 권한을 부여합니다. | 읽기 |
wisdom:GetQuickResponse |
||
SearchSessions | 지정된 어시스턴트를 참조하는 세션을 검색할 수 있는 권한을 부여합니다. 이름으로 특정 세션 리소스를 가져오는 데 사용할 수 있습니다. | 읽기 | |||
StartContentUpload | 지식창고에 콘텐츠를 URL 업로드할 수 있는 권한을 부여합니다. | 쓰기 | |||
StartImportJob | 여러 개의 빠른 응답을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
TagResource | 지정된 리소스에 지정된 태그를 추가할 수 있는 권한을 부여합니다. | 태그 지정 | |||
UntagResource | 지정된 리소스에서 지정된 태그를 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
UpdateContent | 콘텐츠에 대한 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
UpdateKnowledgeBaseTemplateUri | 지식창고 템플릿을 URI 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
UpdateMessageTemplate | 메시지 템플릿의 콘텐츠를 업데이트할 권한을 부여합니다. | 쓰기 | |||
UpdateMessageTemplateMetadata | 메시지 템플릿의 메타데이터를 업데이트할 권한을 부여합니다. | 쓰기 | |||
UpdateQuickResponse | 빠른 응답의 정보 또는 콘텐츠를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
UpdateSession | 세션을 업데이트할 권한을 부여합니다. | 쓰기 | |||
Amazon Q in Connect에서 정의한 리소스 유형
다음 리소스 유형은 이 서비스에 의해 정의되며 IAM 권한 정책 설명의 Resource
요소에 사용될 수 있습니다. 작업 테이블의 각 작업에서 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
리소스 유형 | ARN | 조건 키 |
---|---|---|
Assistant |
arn:${Partition}:wisdom:${Region}:${Account}:assistant/${AssistantId}
|
|
AssistantAssociation |
arn:${Partition}:wisdom:${Region}:${Account}:association/${AssistantId}/${AssistantAssociationId}
|
|
Content |
arn:${Partition}:wisdom:${Region}:${Account}:content/${KnowledgeBaseId}/${ContentId}
|
|
ContentAssociation |
arn:${Partition}:wisdom:${Region}:${Account}:content-association/${KnowledgeBaseId}/${ContentId}/${ContentAssociationId}
|
|
KnowledgeBase |
arn:${Partition}:wisdom:${Region}:${Account}:knowledge-base/${KnowledgeBaseId}
|
|
MessageTemplate |
arn:${Partition}:wisdom:${Region}:${Account}:message-template/${KnowledgeBaseId}/${MessageTemplateId}
|
|
Session |
arn:${Partition}:wisdom:${Region}:${Account}:session/${AssistantId}/${SessionId}
|
|
QuickResponse |
arn:${Partition}:wisdom:${Region}:${Account}:quick-response/${KnowledgeBaseId}/${QuickResponseId}
|
Amazon Q in Connect에 사용되는 조건 키
Connect의 Amazon Q는 IAM 정책 Condition
요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.
조건 키 | 설명 | Type |
---|---|---|
aws:RequestTag/${TagKey} | 요청에서 전달되는 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
aws:ResourceTag/${TagKey} | 리소스와 연결된 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
aws:TagKeys | 요청에서 전달되는 태그 키를 기준으로 액세스를 필터링합니다. | ArrayOfString |
wisdom:MessageTemplate/RoutingProfileArn | 리소스와 연결된 연결 라우팅 프로필 ARN을 기준으로 액세스를 필터링합니다. | ArrayOfARN |
wisdom:SearchFilter/Qualifier | 요청에 전달된 한정자별로 액세스를 필터링합니다. | ArrayOfString |
wisdom:SearchFilter/RoutingProfileArn | 요청에서 전달되는 연결 라우팅 프로파일 arn을 기준으로 액세스를 필터링합니다. | ARN |