本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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 [僅限許可] | 准許檢查別名 | 讀取 | |||
| CreateComment | 准許將新的註解新增到指定的文件版本 | 寫入 | |||
| CreateCustomMetadata | 准許將一或多個自訂屬性新增到指定的資源 | 寫入 | |||
| CreateFolder | 准許以指定的名稱和父資料夾來建立資料夾 | 寫入 | |||
| CreateInstance [僅限許可] | 准許建立執行個體 | 寫入 | |||
| CreateLabels | 准許將標籤新增到指定的資源 | 寫入 | |||
| CreateNotificationSubscription | 准許將 WorkDocs 設定為使用 Amazon SNS 通知 | 寫入 | |||
| 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 | 准許擷取指定期間內的使用者活動 | 清單 | |||
| DescribeAvailableDirectories [僅限許可] | 准許描述可用的目錄 | 清單 | |||
| DescribeComments | 准許列出特定文件版本的所有註解 | 清單 | |||
| DescribeDocumentVersions | 准許擷取特定文件的文件版本 | 清單 | |||
| DescribeFolderContents | 准許描述特定資料夾的內容，包括其文件和子資料夾 | 清單 | |||
| DescribeGroups | 准許描述使用者群組 | 清單 | |||
| DescribeInstanceExports [僅限許可] | 准許描述執行個體的匯出歷史記錄 | 清單 | |||
| DescribeInstances [僅限許可] | 准許描述執行個體 | 清單 | |||
| DescribeNotificationPermissions [僅限許可] | 准許描述允許其呼叫特定 WorkDocs 網站的通知訂閱 API 的主體 | 清單 | |||
| DescribeNotificationSubscriptions | 准許列出指定的通知訂閱 | 清單 | |||
| DescribeResourcePermissions | 准許檢視特定資源的許可描述 | 清單 | |||
| DescribeRootFolders | 准許描述根資料夾 | 清單 | |||
| DescribeUsers | 准許檢視特定使用者的描述。您可以描述所有使用者或篩選結果 (例如，依狀態或組織) | 清單 | |||
| DownloadDocumentVersion [僅限許可] | 准許下載指定的文件版本 | 讀取 | |||
| GetCurrentUser | 准許擷取目前使用者的詳細資料 | 讀取 | |||
| GetDocument | 准許擷取指定的文件物件 | 讀取 | |||
| GetDocumentPath | 准許擷取所請求文件的路徑資訊 (始於根資料夾的階層) | 讀取 | |||
| GetDocumentVersion | 准許擷取特定文件的版本中繼資料 | 讀取 | |||
| GetFolder | 准許擷取特定資料夾的中繼資料 | 讀取 | |||
| GetFolderPath | 准許擷取特定資料夾的路徑資訊 (始於根資料夾的階層) | 讀取 | |||
| GetGroup [僅限許可] | 准許擷取指定群組的詳細資訊 | 讀取 | |||
| GetResources | 准許取得資源集合 | 讀取 | |||
| InitiateDocumentVersionUpload | 准許建立新的文件物件和版本物件 | 寫入 | |||
| RegisterDirectory [僅限許可] | 准許註冊目錄 | 寫入 | |||
| RemoveAllResourcePermissions | 准許從指定的資源移除所有許可 | 寫入 | |||
| RemoveResourcePermission | 准許從指定的資源移除特定主體的許可 | 寫入 | |||
| RestoreDocumentVersions | 准許還原指定文件的版本 | 寫入 | |||
| SearchResources | 准許搜尋中繼資料和資源內容 | 清單 | |||
| 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 元素中使用的服務特定內容金鑰。如需可供所有服務使用之全域內容索引鍵的清單，請參閱可用的條件索引鍵。
