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

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

參考資料：

• 了解如何設定此服務。

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

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

Amazon Kinesis Video Streams 定義的動作

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

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

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

注意

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

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

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
ConnectAsMaster	准許以主控者身分連接至端點所指定的訊號頻道	寫入	channel*
ConnectAsViewer	准許以檢視者身分連接至端點所指定的訊號頻道	寫入	channel*
CreateSignalingChannel	准許建立訊號頻道	寫入	channel*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateStream	准許建立 Kinesis Video Streams	寫入	stream*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteEdgeConfiguration	准許描述 Kinesis Video Stream 的邊緣組態	寫入	stream*
DeleteSignalingChannel	准許刪除現有的訊號頻道	寫入	channel*
DeleteStream	准許刪除現有的 Kinesis Video Streams	寫入	stream*
DescribeEdgeConfiguration	准許描述 Kinesis 影片串流的邊緣組態	讀取	stream*
DescribeImageGenerationConfiguration	准許描述 Kinesis 視訊串流的映像產生組態	讀取	stream*
DescribeMappedResourceConfiguration	准許描述映射到 Kinesis 視訊串流的資源	列出	stream*
DescribeMediaStorageConfiguration	准許描述訊號頻道的媒體儲存組態	讀取	channel*
DescribeNotificationConfiguration	准許描述 Kinesis 視訊串流的通知組態	讀取	stream*
DescribeSignalingChannel	准許描述指定的訊號頻道	列出	channel*
DescribeStream	准許描述指定的 Kinesis Video Streams	列出	stream*
GetClip	准許從視訊串流取得媒體剪輯	讀取	stream*
GetDASHStreamingSessionURL	准許建立 MPEG-DASH 視訊串流的 URL	讀取	stream*
GetDataEndpoint	准許取得所指定串流的端點，以在 Kinesis Video Streams 中讀取或寫入媒體資料	讀取	stream*
GetHLSStreamingSessionURL	准許建立 HLS 視訊串流的 URL	讀取	stream*
GetIceServerConfig	准許取得 ICE 伺服器組態	讀取	channel*
GetImages	准許從 Kinesis 視訊串流取得產生的映像	讀取	stream*
GetMedia	准許傳回 Kinesis Video Streams 的媒體內容	讀取	stream*
GetMediaForFragmentList	准許只從持久性儲存體讀取和傳回媒體資料	讀取	stream*
GetSignalingChannelEndpoint	針對訊號頻道的通訊協議和角色特定組合，准許取得端點	讀取	channel*
JoinStorageSession	准許加入頻道的儲存工作階段	寫入	channel*
ListEdgeAgentConfigurations	准許列出邊緣代理程式組態	列出
ListFragments	准許根據分頁符記或選擇器類型及指定的範圍，列出存檔儲存體中的片段	列出	stream*
ListSignalingChannels	准許列出您的訊號頻道	列出
ListStreams	准許列出您的 Kinesis Video Streams	列出
ListTagsForResource	准許擷取與資源相關聯的標籤	讀取	channel
			stream
ListTagsForStream	准許擷取與 Kinesis Video Streams 相關聯的標籤	讀取	stream*
PutMedia	准許將媒體資料傳送至 Kinesis Video Streams	寫入	stream*
SendAlexaOfferToMaster	准許將 Alexa SDP 供應項目傳送給主控者	寫入	channel*
StartEdgeConfigurationUpdate	准許啟動 Kinesis 影片串流的邊緣組態更新	寫入	stream*
TagResource	准許將標籤組連接至您的資源	標記	channel
			stream
				aws:RequestTag/${TagKey} aws:TagKeys
TagStream	准許將標籤組連接至您的 Kinesis Video Streams	標記	stream*
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	准許從資源移除一或多個標籤	標記	channel
			stream
				aws:TagKeys
UntagStream	准許從 Kinesis Video Streams 移除一或多個標籤	標記	stream*
				aws:TagKeys
UpdateDataRetention	准許更新 Kinesis Video Streams 的資料保留期間	寫入	stream*
UpdateImageGenerationConfiguration	准許更新 Kinesis 視訊串流的映像產生組態	寫入	stream*
UpdateMediaStorageConfiguration	准許建立或更新訊號頻道和串流之間的映射	寫入	channel*
UpdateNotificationConfiguration	准許更新 Kinesis 視訊串流的通知組態	寫入	stream*
UpdateSignalingChannel	准許更新現有的訊號頻道	寫入	channel*
UpdateStream	准許更新現有的 Kinesis Video Streams	寫入	stream*

Amazon Kinesis Video Streams 定義的資源類型

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

資源類型	ARN	條件索引鍵
stream	arn:${Partition}:kinesisvideo:${Region}:${Account}:stream/${StreamName}/${CreationTime}	aws:ResourceTag/${TagKey}
channel	arn:${Partition}:kinesisvideo:${Region}:${Account}:channel/${ChannelName}/${CreationTime}	aws:ResourceTag/${TagKey}

Amazon Kinesis Video Streams 的條件索引鍵

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

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

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	根據每個標籤的允許值集來篩選要求	字串
aws:ResourceTag/${TagKey}	根據與串流相關聯的標籤值來篩選動作	字串
aws:TagKeys	根據請求中是否存在強制標籤來篩選要求	ArrayOfString