本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS Directory Service Data 的動作、資源和條件索引鍵
AWS Directory Service Data （服務字首：ds-data) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視此服務可用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
主題
AWS Directory Service Data 定義的動作
您可以在 IAM 政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource元素限制資源存取，則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| AddGroupMember | 准許將成員新增至目錄上的群組 | 寫入 |
ds:AccessDSData |
||
| CreateGroup | 准許在目錄上建立群組 | 寫入 |
ds:AccessDSData |
||
| CreateUser | 准許在目錄上建立使用者 | 寫入 |
ds:AccessDSData |
||
| DeleteGroup | 准許刪除目錄上的群組 | 寫入 |
ds:AccessDSData |
||
| DeleteUser | 准許刪除目錄上的使用者 | 寫入 |
ds:AccessDSData |
||
| DescribeGroup | 准許描述目錄上的群組 | 讀取 |
ds:AccessDSData |
||
| DescribeUser | 准許在目錄中描述使用者 | 讀取 |
ds:AccessDSData |
||
| DisableUser | 准許停用目錄上的使用者 | 寫入 |
ds:AccessDSData |
||
| ListGroupMembers | 准許列出目錄上群組中的成員 | 清單 |
ds:AccessDSData |
||
| ListGroups | 准許列出目錄上的群組 | 清單 |
ds:AccessDSData |
||
| ListGroupsForMember | 准許列出成員在目錄中所在的群組 | 清單 |
ds:AccessDSData |
||
| ListUsers | 准許列出目錄上的使用者 | 清單 |
ds:AccessDSData |
||
| RemoveGroupMember | 准許從目錄上的群組中移除成員 | 寫入 |
ds:AccessDSData |
||
| SearchGroups | 准許搜尋目錄上的群組 | 讀取 |
ds-data:DescribeGroup ds:AccessDSData |
||
| SearchUsers | 准許搜尋目錄上的使用者 | 讀取 |
ds-data:DescribeUser ds:AccessDSData |
||
| UpdateGroup | 准許更新目錄上的群組 | 寫入 |
ds:AccessDSData |
||
| UpdateUser | 准許更新目錄上的使用者 | 寫入 |
ds:AccessDSData |
||
AWS Directory Service Data 定義的資源類型
下列資源類型由此服務定義，可用於 IAM 許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| directory |
arn:${Partition}:ds:${Region}:${Account}:directory/${DirectoryId}
|
AWS Directory Service Data 的條件索引鍵
AWS Directory Service Data 定義下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵，請參閱可用全域條件鍵。
| 條件索引鍵 | 描述 | Type |
|---|---|---|
| aws:ResourceTag/${TagKey} | 依要執行動作的 AWS DS 資源篩選存取權 | 字串 |
| ds-data:Identifier | 根據請求中提供的識別符類型 （即 SAM 帳戶名稱） 篩選存取權 | 字串 |
| ds-data:MemberName | 依請求的 SAM 輸入中包含的目錄 MemberName 帳戶名稱篩選存取權 | 字串 |
| ds-data:MemberRealm | 依請求的 MemberRealm 輸入中包含的目錄領域名稱篩選存取權 | 字串 |
| ds-data:Realm | 依請求的目錄領域名稱篩選存取權 | 字串 |
| ds-data:SAMAccountName | 依包含在請求的 SAM 輸入中的目錄 SAMAccountName 帳戶名稱篩選存取權 | 字串 |
