기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon WorkDocs에 사용되는 작업, 리소스 및 조건 키
Amazon WorkDocs(서비스 접두사: workdocs)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
Amazon WorkDocs에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| AbortDocumentVersionUpload | InitiateDocumentVersionUpload에 의해 이전에 시작된 지정된 문서 버전의 업로드를 중단할 수 있는 권한을 부여합니다. | 쓰기 | |||
| ActivateUser | 지정된 사용자를 활성화할 수 있는 권한을 부여합니다. 활성 사용자만 Amazon WorkDocs에 액세스할 수 있습니다. | 쓰기 | |||
| AddNotificationPermissions [권한만 해당] | 지정된 WorkDocs 사이트의 알림 구독 API를 호출할 수 있는 보안 주체를 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| AddResourcePermissions | 지정된 폴더 또는 문서에 대한 권한 세트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| AddUserToGroup [권한만 해당] | 그룹에 사용자를 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CheckAlias [권한만 해당] | 별칭을 확인할 수 있는 권한을 부여합니다. | Read | |||
| CreateComment | 지정된 문서 버전에 새 의견을 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateCustomMetadata | 지정된 리소스에 하나 이상의 사용자 지정 속성을 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateFolder | 지정된 이름 및 상위 폴더로 폴더를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateInstance [권한만 해당] | 인스턴스를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateLabels | 지정된 리소스에 레이블을 추가할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateNotificationSubscription | Amazon SNS 알림을 사용하기 위해 WorkDocs를 구성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateUser | Simple AD 또는 Microsoft AD 디렉터리에서 사용자를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeactivateUser | 지정된 사용자를 비활성화하여 Amazon WorkDocs에 대한 사용자의 액세스 권한을 취소할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteComment | 문서 버전에서 지정된 의견을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteCustomMetadata | 지정된 리소스에서 사용자 지정 메타데이터를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDocument | 지정된 문서 및 연결된 메타데이터를 영구적으로 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteDocumentVersion | 지정된 문서의 버전을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteFolder | 지정된 폴더 및 그 내용을 영구적으로 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteFolderContents | 지정된 폴더의 내용을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteInstance [권한만 해당] | 인스턴스를 삭제할 권한을 부여합니다. | 쓰기 | |||
| DeleteLabels | 리소스에서 하나 이상의 레이블을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteNotificationPermissions [권한만 해당] | 지정된 WorkDocs 사이트의 알림 구독 API를 호출할 수 있는 보안 주체를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteNotificationSubscription | 지정된 조직에서 지정된 구독을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteUser | Simple AD 또는 Microsoft AD 디렉터리에서 지정된 사용자를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeregisterDirectory [권한만 해당] | 디렉터리를 등록 취소할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DescribeActivities | 지정된 기간의 사용자 활동을 가져올 수 있는 권한을 부여합니다. | List | |||
| DescribeAvailableDirectories [권한만 해당] | 사용 가능한 디렉터리를 설명할 수 있는 권한을 부여합니다. | List | |||
| DescribeComments | 지정된 문서 버전에 대한 모든 의견을 나열할 수 있는 권한을 부여합니다. | List | |||
| DescribeDocumentVersions | 지정된 문서의 문서 버전을 검색할 수 있는 권한을 부여합니다. | List | |||
| DescribeFolderContents | 문서 및 하위 폴더를 포함한 지정된 폴더의 내용을 설명할 수 있는 권한을 부여합니다. | List | |||
| DescribeGroups | 사용자 그룹을 설명할 수 있는 권한을 부여합니다. | List | |||
| DescribeInstanceExports [권한만 해당] | 인스턴스에 대한 내보내기 기록을 설명할 수 있는 권한을 부여합니다. | List | |||
| DescribeInstances [권한만 해당] | 인스턴스를 설명할 수 있는 권한을 부여합니다. | List | |||
| DescribeNotificationPermissions [권한만 해당] | 지정된 WorkDocs 사이트의 알림 구독 API를 호출할 수 있는 보안 주체를 설명할 수 있는 권한을 부여합니다. | List | |||
| DescribeNotificationSubscriptions | 지정된 알림 구독을 나열할 수 있는 권한을 부여합니다. | List | |||
| DescribeResourcePermissions | 지정된 리소스의 권한에 대한 설명을 볼 수 있는 권한을 부여합니다. | List | |||
| DescribeRootFolders | 루트 폴더를 설명할 수 있는 권한을 부여합니다. | List | |||
| DescribeUsers | 지정된 사용자에 대한 설명을 볼 수 있는 권한을 부여합니다. 모든 사용자를 설명하거나 결과를 필터링할 수 있습니다(예: 상태별 또는 조직별 필터링). | List | |||
| DownloadDocumentVersion [권한만 해당] | 지정된 문서 버전을 다운로드할 수 있는 권한을 부여합니다. | Read | |||
| GetCurrentUser | 현재 사용자의 세부 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetDocument | 지정된 문서 객체를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetDocumentPath | 요청된 문서에 대한 경로 정보(루트 폴더의 계층 구조)를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetDocumentVersion | 지정된 문서의 버전 메타데이터를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetFolder | 지정된 폴더의 메타데이터를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetFolderPath | 지정된 문서에 대한 경로 정보(루트 폴더의 계층 구조)를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetGroup [권한만 해당] | 지정된 그룹의 세부 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetResources | 리소스 모음을 가져올 수 있는 권한을 부여합니다. | Read | |||
| InitiateDocumentVersionUpload | 새 문서 객체 및 버전 객체를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RegisterDirectory [권한만 해당] | 디렉터리를 등록할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RemoveAllResourcePermissions | 지정된 리소스에서 모든 권한을 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RemoveResourcePermission | 지정된 리소스에서 지정된 보안 주체의 권한을 제거할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RestoreDocumentVersions | 지정된 문서의 버전을 복원할 수 있는 권한을 부여합니다. | 쓰기 | |||
| SearchResources | 리소스의 메타데이터 및 콘텐츠를 검색할 수 있는 권한을 부여합니다. | List | |||
| StartInstanceExport [권한만 해당] | 인스턴스 내보내기를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateDocument | 지정된 문서의 지정된 속성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateDocumentVersion | 문서 버전의 상태를 ACTIVE로 변경할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateFolder | 지정된 폴더의 지정된 속성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateInstanceAlias [권한만 해당] | 인스턴스 별칭을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateUser | 지정된 사용자의 지정된 속성을 업데이트하고, Amazon WorkDocs 사이트에 대한 관리 권한을 부여하거나 취소할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateUserAdministrativeSettings [권한만 해당] | 사용자에 대한 관리자 설정을 업데이트할 수 있는 권한 부여 | 쓰기 |
Amazon WorkDocs에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| organization |
arn:${Partition}:workdocs:${Region}:${Account}:organization/${ResourceId}
|
Amazon WorkDocs에 사용되는 조건 키
WorkDocs에는 정책 설명의 Condition 요소에 사용할 수 있는 서비스별 컨텍스트 키가 없습니다. 모든 서비스에서 사용할 수 있는 전역 컨텍스트 키 목록은 AWS 전역 조건 컨텍스트 키를 참조하세요.