Amazon Cognito Sync 的動作、資源與條件索引鍵

Amazon Cognito Sync (服務字首：cognito-sync) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

Amazon Cognito Sync 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS 中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果此欄包含資源類型，則您可以在包含該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，發起人必須具有將動作與這些資源搭配使用的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
BulkPublish	准許啟動將身分集區所有現有資料集大量發佈到所設定串流的動作	寫入	identitypool*
DeleteDataset	准許刪除特定資料集	寫入	dataset*
DescribeDataset	准許依身分和資料集名稱取得與資料集相關的中繼資料	讀取	dataset*
DescribeIdentityPoolUsage	准許取得關於特定身分集區的用量詳細資訊 (如資料儲存體)	讀取	identitypool*
DescribeIdentityUsage	准許取得身分用量資訊，包含資料集數量和資料用量	讀取	identity*
GetBulkPublishDetails	准許取得上次針對身分集區執行 BulkPublish 操作的狀態	讀取	identitypool*
GetCognitoEvents	准許取得與身分集區相關聯的事件和對應 Lambda 函數	讀取	identitypool*
GetIdentityPoolConfiguration	准許取得身分集區的配置設定	讀取	identitypool*
ListDatasets	准許列出身分資料集	列出	dataset*
ListIdentityPoolUsage	准許取得已向 Cognito 註冊的身分集區清單	讀取	identitypool*
ListRecords	准許取得分頁記錄，選擇在資料集和身分特定同步計數後進行變更。	讀取	dataset*
QueryRecords [僅限許可]	准許查詢記錄	讀取
RegisterDevice	准許註冊裝置以接收推播同步通知。	寫入	identity*
SetCognitoEvents	准許為身分集區的指定事件類型設定 AWS Lambda 函數。	寫入	identitypool*
SetDatasetConfiguration [僅限許可]	准許配置資料集	寫入	dataset*
SetIdentityPoolConfiguration	准許設定推播同步的必要組態	寫入	identitypool*
SubscribeToDataset	准許訂閱，即可在資料集由另一個裝置修改時收到通知	寫入	dataset*
UnsubscribeFromDataset	准許取消訂閱，在資料集由另一個裝置修改時將不會收到通知	寫入	dataset*
UpdateRecords	准許張貼更新以記錄和新增及刪除資料集和使用者的記錄	寫入	dataset*

Amazon Cognito Sync 定義的資源類型

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

資源類型	ARN	條件索引鍵
dataset	arn:${Partition}:cognito-sync:${Region}:${Account}:identitypool/${IdentityPoolId}/identity/${IdentityId}/dataset/${DatasetName}
identity	arn:${Partition}:cognito-sync:${Region}:${Account}:identitypool/${IdentityPoolId}/identity/${IdentityId}
identitypool	arn:${Partition}:cognito-sync:${Region}:${Account}:identitypool/${IdentityPoolId}

Amazon Cognito Sync 條件索引鍵

Cognito Sync 沒有可用於政策陳述式之 Condition 元素的服務特定內容金鑰。如需可供所有服務使用之全域內容索引鍵的清單，請參閱可用的條件索引鍵。