本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 個標籤 | 標記 | |||
CreateStream | 准許建立 Amazon Kinesis 串流 | 寫入 | |||
DecreaseStreamRetentionPeriod | 准許減少串流的保留期間,這是資料記錄加入至串流之後可供存取的時間長度 | 寫入 | |||
DeleteResourcePolicy | 准許刪除與指定串流或取用者相關聯的資源政策 | 寫入 | |||
DeleteStream | 准許刪除串流及其所有碎片和資料 | 寫入 | |||
DeregisterStreamConsumer | 准許使用 Kinesis 資料串流取消註冊串流消費者 | 寫入 | |||
DescribeLimits | 准許描述帳戶的碎片限制和使用量 | 讀取 | |||
DescribeStream | 准許描述指定的串流 | 讀取 | |||
DescribeStreamConsumer | 准許取得已註冊串流消費者的說明 | 讀取 | |||
DescribeStreamSummary | 准許提供指定 Kinesis 資料串流的摘要說明,其中不含碎片清單 | 讀取 | |||
DisableEnhancedMonitoring | 准許停用增強型監控 | 寫入 | |||
EnableEnhancedMonitoring | 准許對碎片層級指標啟用增強型 Kinesis 資料串流監控 | 寫入 | |||
GetRecords | 准許從碎片取得資料記錄 | 讀取 | |||
GetResourcePolicy | 准許取得與指定串流或取用者相關聯的資源政策 | 讀取 | |||
GetShardIterator | 准許取得碎片迭代器。碎片迭代器會在傳回給請求者之後 5 分鐘到期 | 讀取 | |||
IncreaseStreamRetentionPeriod | 准許增加串流的保留期間,這是資料記錄加入至串流之後可供存取的時間長度 | 寫入 | |||
ListShards | 准許列出串流中的碎片,並針對每個碎片提供相關資訊 | 清單 | |||
ListStreamConsumers | 准許列出已註冊且使用強化廣發功能從 Kinesis 串流接收資料的串流消費者,並提供每個消費者的相關資訊 | 清單 | |||
ListStreams | 准許列出您的串流 | 清單 | |||
ListTagsForStream | 准許列出指定 Amazon Kinesis 串流的標籤 | 讀取 | |||
MergeShards | 准許將串流中的兩個相鄰碎片合併為單一碎片,以降低串流輸入和傳輸資料的容量 | 寫入 | |||
PutRecord | 准許將單一資料記錄從生產者寫入至 Amazon Kinesis 串流 | 寫入 | |||
PutRecords | 准許在單一呼叫中將多個資料記錄從生產者寫入 Amazon Kinesis 串流 (也稱為 a PutRecords 請求) | 寫入 | |||
PutResourcePolicy | 准許將資源政策連接至指定串流或取用者 | 寫入 | |||
RegisterStreamConsumer | 准許使用 Kinesis 資料串流註冊串流消費者 | 寫入 | |||
RemoveTagsFromStream | 准許將標籤從指定的 Kinesis 資料串流中移除。成功完成這項操作之後,移除的標籤會遭到刪除且無法復原 | 標記 | |||
SplitShard | 准許將 Kinesis 資料串流中的一個碎片分割為兩個新的碎片,以增加串流輸入和傳輸資料的容量 | 寫入 | |||
StartStreamEncryption | 准許使用指定串流的 AWS KMS 金鑰來啟用或停用伺服器端加密 | 寫入 | |||
StopStreamEncryption | 准許為指定的串流停用伺服器端加密 | 寫入 | |||
SubscribeToShard | 准許使用強化廣發功能接聽特定碎片 | 讀取 | |||
UpdateShardCount | 准許將指定串流的碎片計數更新為指定的碎片數量 | 寫入 | |||
UpdateStreamMode | 准許更新資料串流的容量模式 | 寫入 |
Amazon Kinesis Data Streams 定義的資源類型
下列資源類型由此服務定義,可用於 IAM 許可政策陳述式的 Resource
元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
Amazon Kinesis Data Streams 的條件索引鍵
Amazon Kinesis Data Streams 定義下列條件索引鍵,可用於 IAM 政策的 Condition
元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵。
條件索引鍵 | 描述 | Type |
---|---|---|
aws:RequestTag/${TagKey} | 依請求中的標籤鍵值對是否存在篩選存取權 | 字串 |
aws:ResourceTag/${TagKey} | 依連接到資源的標籤鍵值對篩選存取權 | 字串 |
aws:TagKeys | 依請求中是否存在標籤索引鍵來篩選存取 | ArrayOfString |