Amazon Kinesis Data Streams 的動作、資源和條件索引鍵

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

參考資料：

• 了解如何設定此服務。

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

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

Amazon Kinesis Data Streams 定義的動作

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

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

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

注意

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

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

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AddTagsToStream	准許新增或更新指定 Amazon Kinesis 串流的標籤。每個串流最多可以擁有 10 個標籤	標記	stream*
CreateStream	准許建立 Amazon Kinesis 串流	寫入	stream*
DecreaseStreamRetentionPeriod	准許減少串流的保留期間，這是資料記錄加入至串流之後可供存取的時間長度	寫入	stream*
DeleteResourcePolicy	准許刪除與指定串流或取用者相關聯的資源政策	寫入	consumer*
			stream*
DeleteStream	准許刪除串流及其所有碎片和資料	寫入	stream*
DeregisterStreamConsumer	准許使用 Kinesis 資料串流取消註冊串流消費者	寫入	consumer*
DescribeLimits	准許描述帳戶的碎片限制和使用量	讀取
DescribeStream	准許描述指定的串流	讀取	stream*
DescribeStreamConsumer	准許取得已註冊串流消費者的說明	讀取	consumer*
DescribeStreamSummary	准許提供指定 Kinesis 資料串流的摘要說明，其中不含碎片清單	讀取	stream*
DisableEnhancedMonitoring	准許停用增強型監控	寫入
EnableEnhancedMonitoring	准許對碎片層級指標啟用增強型 Kinesis 資料串流監控	寫入
GetRecords	准許從碎片取得資料記錄	讀取	stream*
GetResourcePolicy	准許取得與指定串流或取用者相關聯的資源政策	讀取	consumer*
			stream*
GetShardIterator	准許取得碎片迭代器。碎片迭代器會在傳回給請求者之後 5 分鐘到期	讀取	stream*
IncreaseStreamRetentionPeriod	准許增加串流的保留期間，這是資料記錄加入至串流之後可供存取的時間長度	寫入	stream*
ListShards	准許列出串流中的碎片，並針對每個碎片提供相關資訊	清單	stream*
ListStreamConsumers	准許列出已註冊且使用強化廣發功能從 Kinesis 串流接收資料的串流消費者，並提供每個消費者的相關資訊	清單	stream*
ListStreams	准許列出您的串流	清單
ListTagsForStream	准許列出指定 Amazon Kinesis 串流的標籤	讀取	stream*
MergeShards	准許將串流中的兩個相鄰碎片合併為單一碎片，以降低串流輸入和傳輸資料的容量	寫入	stream*
PutRecord	准許將單一資料記錄從生產者寫入至 Amazon Kinesis 串流	寫入	stream*
PutRecords	授予在單一呼叫中將多個資料記錄從生產者寫入 Amazon Kinesis 串流的權限 (也稱為 PutRecords 請求)	寫入	stream*
PutResourcePolicy	准許將資源政策連接至指定串流或取用者	寫入	consumer*
			stream*
RegisterStreamConsumer	准許使用 Kinesis 資料串流註冊串流消費者	寫入	stream*
RemoveTagsFromStream	准許將標籤從指定的 Kinesis 資料串流中移除。成功完成這項操作之後，移除的標籤會遭到刪除且無法復原	標記	stream*
SplitShard	准許將 Kinesis 資料串流中的一個碎片分割為兩個新的碎片，以增加串流輸入和傳輸資料的容量	寫入	stream*
StartStreamEncryption	授與使用指定串流的 AWS KMS 金鑰啟用或更新伺服器端加密的權限	寫入	kmsKey*
			stream*
StopStreamEncryption	准許為指定的串流停用伺服器端加密	寫入	kmsKey*
			stream*
SubscribeToShard	准許使用強化廣發功能接聽特定碎片	讀取	consumer*
UpdateShardCount	准許將指定串流的碎片計數更新為指定的碎片數量	寫入
UpdateStreamMode	准許更新資料串流的容量模式	寫入

Amazon Kinesis Data Streams 定義的資源類型

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

資源類型	ARN	條件索引鍵
stream	arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}
consumer	arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}
kmsKey	arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}

Amazon Kinesis Data Streams 的條件索引鍵

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