本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Cognito Identity 的動作、資源與條件索引鍵
Amazon Cognito Identity (服務字首:cognito-identity
) 提供下列服務特有的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視此服務可用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon Cognito Identity 定義的動作
您可以在 IAM 政策陳述式的 Action
元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時,通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource
元素限制資源存取,則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
CreateIdentityPool | 准許建立新身分集區 | 寫入 | |||
DeleteIdentities | 准許從身分集區刪除身分。您可以指定要刪除 1-60 個身分的清單 | 寫入 | |||
DeleteIdentityPool | 准許刪除使用者集區 一旦刪除集區,使用者將無法用集區進行驗證 | 寫入 | |||
DescribeIdentity | 准許傳回與指定身分相關的中繼資料,包括建立身分的時間和任何相關聯的連結登入 | 讀取 | |||
DescribeIdentityPool | 准許取得關於特定身分集區的詳細資訊,包括集區名稱、ID 描述、建立日期和目前使用者的數量 | 讀取 | |||
GetCredentialsForIdentity | 准許傳回所提供身分 ID 的登入資料 | 讀取 | |||
GetId | 准許產生 (或擷取) Cognito ID。提供多個登入將會建立隱含連結的帳戶 | 寫入 | |||
GetIdentityPoolAnalytics | 准許取得所有身分集區身分提供者 (IdPs) 目前身分計數總數的分析資料 | 讀取 | |||
GetIdentityPoolDailyAnalytics | 准許取得所有身分集區身分提供者 (IdPs) 的新身分數量和身分總數的分析資料 | 讀取 | |||
GetIdentityPoolRoles | 准許取得身分集區的角色 | 讀取 | |||
GetIdentityProviderDailyAnalytics | 准許取得有關一個身分集區身分提供者 (IdPs) 新身分數量和身分總數的分析資料 | 讀取 | |||
GetOpenIdToken | 准許使用已知 Cognito ID 取得 OpenID 字符 | 讀取 | |||
GetOpenIdTokenForDeveloperIdentity | 准許註冊 (或擷取) Cognito IdentityId 和 OpenID Connect 權杖給由後端身分驗證程序驗證的使用者 | 讀取 | |||
GetPrincipalTagAttributeMap | 准許取得身分集區和提供者的委託人標籤 | 讀取 | |||
ListIdentities | 准許在身分集區中列出身分 | 列出 | |||
ListIdentityPools | 准許列出針對您帳戶註冊的所有 Cognito 身分集區。 | 列出 | |||
ListTagsForResource | 准許列出指派給 Amazon Cognito 身分集區的標籤。 | 讀取 | |||
LookupDeveloperIdentity | 准許針對現有身分擷取與 a DeveloperUserIdentifier 相關聯的 IdentityId DeveloperUserIdentifiers 或與 aWord 相關聯的 IdentityId 清單 | 讀取 | |||
MergeDeveloperIdentities | 准許合併兩個具有不同 IdentityIds 的使用者、存在於相同的身分集區中,並由相同的開發人員供應商識別 | 寫入 | |||
SetIdentityPoolRoles | 准許設定身分集區的角色。呼叫 GetCredentialsForIdentity 動作時,會使用這些角色 | 寫入 | |||
SetPrincipalTagAttributeMap | 准許設定身分集區和提供者的委託人標籤。呼叫 GetOpenIdToken 動作時,會使用這些標籤 | 寫入 | |||
TagResource | 准許將一組標籤指派給 Amazon Cognito 身分集區 | 標記 | |||
UnlinkDeveloperIdentity | 准許取消 a DeveloperUserIdentifier 與現有身分的連結 | 寫入 | |||
UnlinkIdentity | 准許取消現有帳戶的聯合身分連結 | 寫入 | |||
UntagResource | 准許從 Amazon Cognito 身分集區移除指定標籤 | 標記 | |||
UpdateIdentityPool | 准許更新身分集區 | 寫入 |
Amazon Cognito Identity 定義的資源類型
下列資源類型由此服務定義,可用於 IAM 許可政策陳述式的 Resource
元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
資源類型 | ARN | 條件索引鍵 |
---|---|---|
identitypool |
arn:${Partition}:cognito-identity:${Region}:${Account}:identitypool/${IdentityPoolId}
|
Amazon Cognito Identity 條件索引鍵
Amazon Cognito Identity 定義下列條件索引鍵,可用於 IAM 政策的 Condition
元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵。
條件索引鍵 | 描述 | 類型 |
---|---|---|
aws:RequestTag/${TagKey} | 根據請求中的標籤鍵值組是否存在來篩選動作 | 字串 |
aws:ResourceTag/${TagKey} | 根據連接到資源的標籤鍵值組來篩選動作 | 字串 |
aws:TagKeys | 依請求中的金鑰是否存在來篩選存取 | ArrayOfString |