本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS Resource Access Manager (RAM) 的動作、資源和條件索引鍵
AWS Resource Access Manager (RAM) （服務字首：ram) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視此服務可用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
主題
AWS Resource Access Manager (RAM) 定義的動作
您可以在 IAM 政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource元素限制資源存取，則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| AcceptResourceShareInvitation | 准許接受指定的資源共用邀請 | 寫入 | |||
| AssociateResourceShare | 准許將資源和/或委託人關聯至資源共用 | 寫入 | |||
| AssociateResourceSharePermission | 准許將許可與資源共用相關聯 | 寫入 | |||
| CreatePermission | 准許建立與資源共用相關聯的許可 | 寫入 |
ram:TagResource |
||
| CreatePermissionVersion | 准許建立與資源共用相關聯的新版許可 | 寫入 | |||
| CreateResourceShare | 准許使用提供的資源和/或委託人建立資源共用 | 寫入 | |||
| DeletePermission | 准許刪除指定許可 | 寫入 | |||
| DeletePermissionVersion | 准許刪除指定版本的許可 | 寫入 | |||
| DeleteResourceShare | 准許刪除資源共用 | 寫入 | |||
| DisassociateResourceShare | 准許取消資源和/或委託人與資源共用的關聯 | 寫入 | |||
| DisassociateResourceSharePermission | 准許取消許可與資源共用的關聯 | 寫入 | |||
| EnableSharingWithAwsOrganization | 准許存取客戶的組織，並在客戶帳戶中建立 SLR | 許可管理 |
iam:CreateServiceLinkedRole organizations:DescribeOrganization organizations:EnableAWSServiceAccess |
||
| GetPermission | 准許取得 a AWS RAM 許可的內容 | 讀取 | |||
| GetResourcePolicies | 准許取得您所擁有和已共用的指定資源政策 | 讀取 | |||
| GetResourceShareAssociations | 准許從提供的清單中，或依據特定類型的特定狀態，取得一組資源共享關聯 | 讀取 | |||
| GetResourceShareInvitations | 准許依指定的邀請 ARN 或資源共用的 ARN，取得資源共用的邀請 | 讀取 | |||
| GetResourceShares | 准許從提供的清單中，或依據指定的狀態，取得一組資源共用 | 讀取 | |||
| ListPendingInvitationResources | 准許列出與您共用但邀請仍待定的資源共用中的資源 | 讀取 | |||
| ListPermissionAssociations | 准許列出許可和任何相關聯的資訊 | 清單 | |||
| ListPermissionVersions | 准許列出 a AWS RAM 許可的版本 | 清單 | |||
| ListPermissions | 准許列出 AWS RAM 許可 | 清單 | |||
| ListPrincipals | 准許列出您與其共用資源或其與您共用資源的委託人 | 清單 | |||
| ListReplacePermissionAssociationsWork | 准許擷取非同步許可替換的狀態 | 清單 | |||
| ListResourceSharePermissions | 准許列出與資源共用相關聯的許可 | 清單 | |||
| ListResourceTypes | 准許列出 AWS RAM 支援的可共用資源類型 | 清單 | |||
| ListResources | 准許列出您新增至資源共用或與您共用資源的資源 | 清單 | |||
| PromotePermissionCreatedFromPolicy | 准許建立獨立、可全面管理的客戶受管許可 | 寫入 | |||
| PromoteResourceShareCreatedFromPolicy | 准許升級指定的資源共用 | 寫入 | |||
| RejectResourceShareInvitation | 准許拒絕指定的資源共用邀請 | 寫入 | |||
| ReplacePermissionAssociations | 准許將所有資源共用更新為新的許可 | 寫入 | |||
| SetDefaultPermissionVersion | 准許將版本編號指定為個別客戶受管許可的預設版本 | 寫入 | |||
| TagResource | 准許標記指定的資源共用或許可 | 標記 | |||
| UntagResource | 准許取消標記指定的資源共用或許可 | 標記 | |||
| UpdateResourceShare | 准許更新資源共用的屬性 | 寫入 | |||
AWS Resource Access Manager (RAM) 定義的資源類型
下列資源類型由此服務定義，可用於 IAM 許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| resource-share |
arn:${Partition}:ram:${Region}:${Account}:resource-share/${ResourcePath}
|
|
| resource-share-invitation |
arn:${Partition}:ram:${Region}:${Account}:resource-share-invitation/${ResourcePath}
|
|
| permission |
arn:${Partition}:ram::${Account}:permission/${ResourcePath}
|
|
| customer-managed-permission |
arn:${Partition}:ram:${Region}:${Account}:permission/${ResourcePath}
|
AWS Resource Access Manager (RAM) 的條件索引鍵
AWS Resource Access Manager (RAM) 定義下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵，請參閱可用全域條件鍵。
| 條件索引鍵 | 描述 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 依據建立或標記資源共用時請求中傳遞的標籤來篩選存取權。如果使用者未傳遞這些特定標籤，或完全未指定標籤，則請求會失敗 | 字串 |
| aws:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
| aws:TagKeys | 依據建立或標記資源共用時傳遞的標籤鍵篩選存取權 | ArrayOfString |
| ram:AllowsExternalPrincipals | 依據允許或拒絕與外部委託人共用的資源共用來篩選存取權。例如，如果只在允許與外部委託人共享的資源共享上才能執行此動作，則指定 true。外部主體是 AWS 組織外部 AWS 的帳戶 | Bool |
| ram:PermissionArn | 依指定的許可ARN篩選存取權 | ARN |
| ram:PermissionResourceType | 依據指定資源類型的許可來篩選存取權 | 字串 |
| ram:Principal | 依據指定委託人的格式篩選存取權 | 字串 |
| ram:RequestedAllowsExternalPrincipals | 依 'allowExternalPrincipals' 的指定值篩選存取權。外部主體是其 AWS 組織以外的 AWS 帳戶 | Bool |
| ram:RequestedResourceType | 依據指定的資源類型篩選存取權 | 字串 |
| ram:ResourceArn | 依指定的 ARN 篩選存取權 | ARN |
| ram:ResourceShareName | 依據具有指定名稱的資源共用來篩選存取權 | 字串 |
| ram:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
| ram:ShareOwnerAccountId | 依據特定帳戶擁有的資源共用來篩選存取權 例如，您可以使用此條件索引鍵，以指定根據資源共享擁有者的帳戶 ID，而可接受或拒絕哪些資源共享邀請 | 字串 |
