기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 | 메시지 템플릿을 활성화할 수 있는 권한을 부여합니다. | 쓰기 | |||
| AllowVendedLogDeliveryForResource [권한만 해당] | 어시스턴트를 위해 판매된 로그 전송을 구성할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| CreateAIAgent | AI 에이전트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateAIAgentVersion | AI 에이전트 버전을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateAIGuardrail | AI 가드레일을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateAIGuardrailVersion | AI 가드레일 버전을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateAIPrompt | AI 프롬프트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateAIPromptVersion | AI 프롬프트 버전을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateAssistant | 어시스턴트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateAssistantAssociation | 어시스턴트와 다른 리소스 간의 연결을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateContent | 콘텐츠를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateContentAssociation | 콘텐츠 연결을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateKnowledgeBase | 지식 기반을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateMessageTemplate | 메시지 템플릿을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateMessageTemplateAttachment | 메시지 템플릿의 첨부 파일을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateMessageTemplateVersion | 메시지 템플릿의 버전을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateQuickResponse | 빠른 응답을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateSession | 세션을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeactivateMessageTemplate | 메시지 템플릿을 비활성화할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAIAgent | AI 에이전트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAIAgentVersion | AI 에이전트 버전을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAIGuardrail | AI 가드레일을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAIGuardrailVersion | AI 가드레일 버전을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAIPrompt | AI 프롬프트 흐름을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAIPromptVersion | AI 프롬프트 버전을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAssistant | 어시스턴트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAssistantAssociation | 어시스턴트 연결을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteContent | 콘텐츠를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteContentAssociation | 콘텐츠 연결을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteImportJob | 지식 베이스의 가져오기 작업을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteKnowledgeBase | 지식 기반을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteMessageTemplate | 메시지 템플릿을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteMessageTemplateAttachment | 메시지 템플릿에서 첨부 파일을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteQuickResponse | 빠른 응답을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| GetAIAgent | AI 에이전트에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetAIGuardrail | AI 가드레일에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetAIPrompt | AI 프롬프트에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetAssistant | 어시스턴트에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetAssistantAssociation | 어시스턴트 연결에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetContent | 콘텐츠를 다운로드할 수 있는 미리 서명된 URL을 포함하여 콘텐츠를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetContentAssociation | 콘텐츠 연결에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetContentSummary | 콘텐츠에 대한 요약 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetImportJob | 가져오기 작업에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetKnowledgeBase | 지식 기반에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetMessageTemplate | 메시지 템플릿을 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetNextMessage | 세션에서 다음 메시지를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetQuickResponse | 콘텐츠를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetRecommendations | 지정된 세션에 대한 권장 사항을 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetSession | 지정된 세션에 대한 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| ListAIAgentVersions | AI 에이전트 버전에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAIAgents | AI 에이전트에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAIGuardrailVersions | AI 가드레일 버전에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAIGuardrails | AI 가드레일에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAIPromptVersions | AI 프롬프트 버전에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAIPrompts | AI 프롬프트에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAssistantAssociations | 어시스턴트 연결에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAssistants | 어시스턴트에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListContentAssociations | 콘텐츠 연결에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListContents | 지식 기반 콘텐츠를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListImportJobs | 지식 기반에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListKnowledgeBases | 지식 기반에 대한 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListMessageTemplateVersions | 지정된 메시지 템플릿에 대한 메시지 템플릿 버전을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListMessageTemplates | 지식 기반에 대한 메시지 템플릿을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListMessages | 세션의 메시지를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListQuickResponses | 지식 베이스와 함께 빠른 응답을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListTagsForResource | 지정된 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다. | Read | |||
| NotifyRecommendationsReceived | 새로 사용할 수 있는 권장 사항의 지정된 어시스턴트 대기열에서 지정된 권장 사항을 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutFeedback | 피드백을 제출할 수 있는 권한을 부여합니다 | 쓰기 | |||
| QueryAssistant | 지정된 어시스턴트에 대해 수동 검색을 수행할 수 있는 권한을 부여합니다. | Read | |||
| RemoveAssistantAIAgent | 어시스턴트에서 AI 에이전트를 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RemoveKnowledgeBaseTemplateUri | 지식 기반에서 URI 템플릿을 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RenderMessageTemplate | 메시지 템플릿을 렌더링할 수 있는 권한을 부여합니다. | Read |
wisdom:GetMessageTemplate |
||
| Retrieve | 지정된 어시스턴트 연결에서 지식 콘텐츠를 검색할 수 있는 권한을 부여합니다. | Read | |||
| SearchContent | 지정된 지식 기반을 참조하는 컨텐츠를 검색할 수 있는 권한을 부여합니다. 이름을 기준으로 특정 콘텐츠 리소스를 가져오는 데 사용할 수 있습니다. | Read | |||
| SearchMessageTemplates | 지정된 지식 기반을 참조하는 메시지 템플릿을 검색할 수 있는 권한을 부여합니다. | Read | |||
| SearchQuickResponses | 지정된 지식 베이스를 참조하는 빠른 응답을 검색할 수 있는 권한을 부여합니다. | Read |
wisdom:GetQuickResponse |
||
| SearchSessions | 지정된 어시스턴트를 참조하는 세션을 검색할 수 있는 권한을 부여합니다. 이름으로 특정 세션 리소스를 가져오는 데 사용할 수 있습니다. | Read | |||
| SendMessage | 메시지를 보낼 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartContentUpload | 지식 기반에 콘텐츠를 업로드할 URL을 가져올 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartImportJob | 여러 개의 빠른 응답을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| TagResource | 지정된 리소스에 지정된 태그를 추가할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | 지정된 리소스에서 지정된 태그를 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateAIAgent | AI 에이전트에 대한 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateAIGuardrail | AI 가드레일에 대한 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateAIPrompt | AI 프롬프트에 대한 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateAssistantAIAgent | AI 에이전트에 대한 어시스턴트 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateContent | 콘텐츠에 대한 정보를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateKnowledgeBaseTemplateUri | 지식 기반에서 URI 템플릿을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateMessageTemplate | 메시지 템플릿의 콘텐츠를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateMessageTemplateMetadata | 메시지 템플릿의 메타데이터를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateQuickResponse | 빠른 응답의 정보 또는 콘텐츠를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateSession | 세션을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateSessionData | 세션에 저장된 데이터를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
Amazon Q in Connect에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| AIAgent |
arn:${Partition}:wisdom:${Region}:${Account}:ai-agent/${AssistantId}/${AIAgentId}
|
|
| AIPrompt |
arn:${Partition}:wisdom:${Region}:${Account}:ai-prompt/${AssistantId}/${AIPromptId}
|
|
| AIGuardrail |
arn:${Partition}:wisdom:${Region}:${Account}:ai-guardrail/${AssistantId}/${AIGuardrailId}
|
|
| 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에 사용되는 조건 키
Amazon Q in Connect는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청에서 전달되는 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:ResourceTag/${TagKey} | 리소스와 연결된 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:TagKeys | 요청에서 전달되는 태그 키를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| wisdom:MessageTemplate/RoutingProfileArn | 리소스와 연결된 연결 라우팅 프로필 ARN을 기준으로 액세스를 필터링합니다. | ArrayOfARN |
| wisdom:SearchFilter/Qualifier | 요청에서 전달되는 한정자를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| wisdom:SearchFilter/RoutingProfileArn | 요청에서 전달되는 연결 라우팅 프로파일 arn을 기준으로 액세스를 필터링합니다. | ARN |
