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	准許建立新身分集區	寫入		aws:RequestTag/${TagKey} aws:TagKeys
DeleteIdentities	准許從身分集區刪除身分。您可以指定要刪除 1-60 個身分的清單	寫入
DeleteIdentityPool	准許刪除使用者集區 一旦刪除集區，使用者將無法用集區進行驗證	寫入	identitypool*
DescribeIdentity	准許傳回與指定身分相關的中繼資料，包括建立身分的時間和任何相關聯的連結登入	讀取
DescribeIdentityPool	准許取得關於特定身分集區的詳細資訊，包括集區名稱、ID 描述、建立日期和目前使用者的數量	讀取	identitypool*
GetCredentialsForIdentity	准許傳回所提供身分 ID 的登入資料	讀取
GetId	准許產生 (或擷取) Cognito ID。提供多個登入將會建立隱含連結的帳戶	寫入
GetIdentityPoolAnalytics	授予取得所有身分集區身分識別提供者目前總身分計數之分析資料的權限 (IdPs)	讀取	identitypool*
GetIdentityPoolDailyAnalytics	授與取得所有身分集區身分識別提供者之新身分和身分識別總數之分析資料的權限 (IdPs)	讀取	identitypool*
GetIdentityPoolRoles	准許取得身分集區的角色	讀取	identitypool*
GetIdentityProviderDailyAnalytics	授與取得一個身分集區身分識別提供者之新身分和身分總數之分析資料的權限 (IdPs)	讀取	identitypool*
GetOpenIdToken	准許使用已知 Cognito ID 取得 OpenID 字符	讀取
GetOpenIdTokenForDeveloperIdentity	授予註冊（或檢索）Cognito IdentityId 和 OpenID Connect 令牌的權限，用於通過後端身份驗證過程驗證的用戶	讀取	identitypool*
GetPrincipalTagAttributeMap	准許取得身分集區和提供者的委託人標籤	讀取	identitypool*
ListIdentities	准許在身分集區中列出身分	列出	identitypool*
ListIdentityPools	准許列出針對您帳戶註冊的所有 Cognito 身分集區。	列出
ListTagsForResource	准許列出指派給 Amazon Cognito 身分集區的標籤。	讀取	identitypool
LookupDeveloperIdentity	授與與現有身份 IdentityId 相關聯的 DeveloperUserIdentifier 或與之 DeveloperUserIdentifiers 相關聯的清單的權限 IdentityId	讀取	identitypool*
MergeDeveloperIdentities	授予合併具有不同 IdentityIds、存在於相同身分集區中且由相同開發人員提供者識別的兩個使用者的權限	寫入	identitypool*
SetIdentityPoolRoles	准許設定身分集區的角色。這些角色呼籲 GetCredentialsForIdentity 採取行動時使用	寫入
SetPrincipalTagAttributeMap	准許設定身分集區和提供者的委託人標籤。呼籲 GetOpenIdToken 採取行動時，這些標籤使用	寫入
TagResource	准許將一組標籤指派給 Amazon Cognito 身分集區	標記	identitypool
				aws:RequestTag/${TagKey} aws:TagKeys
UnlinkDeveloperIdentity	授予取消與現有身份的 DeveloperUserIdentifier 鏈接的權限	寫入	identitypool*
UnlinkIdentity	准許取消現有帳戶的聯合身分連結	寫入
UntagResource	准許從 Amazon Cognito 身分集區移除指定標籤	標記	identitypool
				aws:TagKeys
UpdateIdentityPool	准許更新身分集區	寫入	identitypool*

Amazon Cognito Identity 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作資料表中的每個動作都會指明可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。

資源類型	ARN	條件索引鍵
identitypool	arn:${Partition}:cognito-identity:${Region}:${Account}:identitypool/${IdentityPoolId}	aws:ResourceTag/${TagKey}

Amazon Cognito Identity 條件索引鍵

Amazon Cognito Identity 定義了下列條件索引鍵，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵資料表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用全域條件索引鍵。

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	根據請求中的標籤鍵值組是否存在來篩選動作	字串
aws:ResourceTag/${TagKey}	根據連接到資源的標籤鍵值組來篩選動作	字串
aws:TagKeys	依請求中的金鑰是否存在來篩選存取	ArrayOfString