기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Q Business에 사용되는 작업, 리소스 및 조건 키
Amazon Q Business(서비스 접두사: qbusiness)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
Amazon Q Business에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| AllowVendedLogDeliveryForResource [권한만 해당] | Amazon Q Business 애플리케이션 리소스에 대한 판매된 로그 전송을 구성할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| AssociatePermission | 리소스 기반 정책 설명을 애플리케이션에 연결할 수 있는 권한을 부여합니다. | 쓰기 |
qbusiness:PutResourcePolicy |
||
| BatchDeleteDocument | 문서를 일괄 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| BatchPutDocument | 문서를 일괄 넣기할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CancelSubscription | 구독을 취소할 수 있는 권한을 부여합니다. | 쓰기 | |||
| Chat | 애플리케이션을 사용하여 채팅을 할 수 있는 권한을 부여합니다. | Read | |||
| ChatSync | 애플리케이션을 사용하여 동기적으로 채팅을 할 수 있는 권한을 부여합니다. | Read | |||
| CheckDocumentAccess | 사용자에게 문서에 대한 액세스 권한이 있는지 확인할 수 있는 권한을 부여합니다. | Read | |||
| CreateAnonymousWebExperienceUrl | 익명 Amazon Q Business 웹 경험을 위한 고유한 URL을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateApplication | 애플리케이션을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateChatResponseConfiguration | 애플리케이션에 대한 채팅 응답 구성을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateDataAccessor | 애플리케이션에 DataAccessor를 생성할 수 있는 권한을 부여합니다. | 쓰기 |
qbusiness:CreateDataAccessorWithTti |
||
| CreateDataAccessorWithTti [권한만 해당] | 애플리케이션에 AWS IAM Identity Center 신뢰할 수 있는 토큰 발급자 기반 DataAccessor를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateDataSource | 주어진 애플리케이션 및 인덱스에 대한 데이터 소스를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateIndex | 주어진 애플리케이션에 대한 인덱스를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateIntegration | Q Business 애플리케이션에 대한 새 통합을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreatePlugin | 주어진 애플리케이션에 대한 플러그인을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateRetriever | 주어진 애플리케이션에 대한 검색기를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateSubscription | 구독을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateUser | 사용자를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateWebExperience | 주어진 애플리케이션에 대한 웹 경험을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteApplication | 애플리케이션을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAttachment | 현재 채팅 컨텍스트에서 첨부 파일을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteChatControlsConfiguration | 애플리케이션에 대한 채팅 제어 구성을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteChatResponseConfiguration | 채팅 응답 구성을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteConversation | 대화를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDataAccessor | DataAccessor를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDataSource | DataSource를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteGroup | 그룹을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteIndex | 인덱스를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteIntegration | Q Business 애플리케이션에 대한 통합을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeletePlugin | 플러그인을 삭제할 권한을 부여합니다. | 쓰기 | |||
| DeleteRetriever | 검색기를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteUser | 사용자를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteWebExperience | 웹 경험을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DisableAclOnDataSource [권한만 해당] | Amazon Q Business 데이터 소스 리소스를 생성하는 동안 ACL 크롤링을 비활성화할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DisassociatePermission | 리소스 기반 정책 설명을 애플리케이션에 연결 해제할 수 있는 권한을 부여합니다. | 쓰기 |
qbusiness:PutResourcePolicy |
||
| GetApplication | 애플리케이션을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetChatControlsConfiguration | 애플리케이션에 대한 채팅 제어 구성을 가져올 수 있는 권한을 부여합니다. | List | |||
| GetChatResponseConfiguration | 채팅 응답 구성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetDataAccessor | DataAccessor를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetDataSource | 데이터 소스를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetDocumentContent | 문서 콘텐츠를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetGroup | 그룹을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetIndex | 인덱스를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetIntegration | Q Business 애플리케이션에 대한 통합을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetMedia | 시스템 메시지에 연결된 미디어를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetPlugin | 플러그인을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetPolicy | 애플리케이션의 리소스 기반 정책을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetRetriever | 검색기를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetUser | 사용자를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetWebExperience | 웹 경험을 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListApplications | 애플리케이션을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAttachments | 현재 채팅 컨텍스트에서 첨부 파일을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListChatResponseConfigurations | 애플리케이션에 대한 채팅 응답 구성을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListConversations | 애플리케이션에 대한 모든 대화를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListDataAccessors | 애플리케이션의 DataAccessors 나열할 수 있는 권한을 부여합니다. | List | |||
| ListDataSourceSyncJobs | 데이터 원본 동기화 작업 기록을 가져올 수 있는 권한을 부여합니다. | List | |||
| ListDataSources | 애플리케이션 및 인덱스의 데이터 소스를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListDocuments | 모든 문서를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListGroups | 그룹을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListIndices | 애플리케이션의 인덱스를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListIntegrations | Q Business 애플리케이션의 모든 통합을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListMessages | 모든 메시지를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListPluginActions | 애플리케이션 내에서 플러그인의 플러그인 작업을 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListPluginTypeActions | 플러그인 유형에 대한 모든 작업을 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListPluginTypeMetadata | 모든 플러그인 유형 메타데이터를 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListPlugins | 애플리케이션의 플러그인을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListRetrievers | 애플리케이션의 검색기를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListSubscriptions | 구독을 나열할 수 있는 권한 부여 | List | |||
| ListTagsForResource | 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListWebExperiences | 애플리케이션의 웹 경험을 나열할 수 있는 권한을 부여합니다. | List | |||
| PutFeedback | 대화 메시지에 대한 피드백을 넣을 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutGroup | 사용자 그룹을 넣을 수 있는 권한을 부여합니다. | 쓰기 | |||
| PutResourcePolicy [권한만 해당] | 리소스 기반 정책 설명을 애플리케이션에 넣을 수 있는 권한을 부여합니다. | 쓰기 | |||
| SearchRelevantContent | Amazon Q Business 애플리케이션에서 관련 콘텐츠를 검색할 수 있는 권한을 부여합니다. | Read | |||
| StartDataSourceSyncJob | 데이터 원본 동기화 작업을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartDeployment | 통합에 대한 배포를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopDataSourceSyncJob | 데이터 원본 동기화 작업을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| TagResource | 지정된 키 값 페어로 리소스에 태그를 지정할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | 리소스에서 주어진 키가 있는 태그를 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateApplication | 애플리케이션을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateChatControlsConfiguration | 애플리케이션에 대한 채팅 제어 구성을 어데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateChatResponseConfiguration | 채팅 응답 구성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateDataAccessor | DataAccessor를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateDataSource | DataSource를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateIndex | 인덱스를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateIntegration | Q Business 애플리케이션의 통합을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdatePlugin | 플러그인을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateRetriever | 검색기를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateSubscription | 구독을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateUser | 사용자를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateWebExperience | 웹 경험을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
Amazon Q Business에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| application |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}
|
|
| integration |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/integration/${IntegrationId}
|
|
| retriever |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/retriever/${RetrieverId}
|
|
| index |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}
|
|
| data-source |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}/data-source/${DataSourceId}
|
|
| plugin |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/plugin/${PluginId}
|
|
| web-experience |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/web-experience/${WebExperienceId}
|
|
| subscription |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/subscription/${SubscriptionId}
|
|
| data-accessor |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/data-accessor/${DataAccessorId}
|
|
| chat-response-configuration |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/chat-response-configuration/${ChatResponseConfigurationId}
|
Amazon Q Business에 사용되는 조건 키
Amazon Q Business는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청에서 전달되는 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:ResourceTag/${TagKey} | 리소스와 연결된 태그를 기준으로 액세스를 필터링합니다. | 문자열 |
| aws:TagKeys | 요청에서 전달되는 태그 키를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| identitystore:GroupId | IAM Identity Center 그룹 ID를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| identitystore:UserId | IAM Identity Center 사용자 ID를 기준으로 액세스를 필터링합니다. | ArrayOfString |
