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	授予权限，从而以主用户的身份连接到终端节点指定的信令通道	Write	channel*
ConnectAsViewer	授予权限，从而以查看者的身份连接到终端节点指定的信令通道	Write	channel*
CreateSignalingChannel	授予权限以创建信令通道	Write	channel*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateStream	授予权限以创建 Kinesis 视频流	写入	stream*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteEdgeConfiguration	授予删除 Kinesis 视频流边缘配置的权限	写入	stream*
DeleteSignalingChannel	授予权限以删除现有信令通道	Write	channel*
DeleteStream	授予权限以删除现有 Kinesis 视频流	写入	stream*
DescribeEdgeConfiguration	授予权限以描述您 Kinesis 视频流的边缘配置	读取	stream*
DescribeImageGenerationConfiguration	授予权限以描述您 Kinesis 视频流的映像生成配置	读取	stream*
DescribeMappedResourceConfiguration	授予描述映射到 Kinesis 视频流的资源的权限	列出	stream*
DescribeMediaStorageConfiguration	授予描述信令通道的媒体存储配置的权限	读取	channel*
DescribeNotificationConfiguration	授予权限以描述您 Kinesis 视频流的通知配置	读取	stream*
DescribeSignalingChannel	授予权限以描述指定的信令通道	List	channel*
DescribeStream	授予权限以描述指定的 Kinesis 视频流	List	stream*
GetClip	授予权限以从视频流中获取媒体剪辑	读取	stream*
GetDASHStreamingSessionURL	授予创建 fo URL r MPEG-DASH 视频流的权限	读取	stream*
GetDataEndpoint	授予权限以获取指定流的终端节点，用于对 Kinesis Video Streams 读取或写入媒体数据。	读取	stream*
GetHLSStreamingSessionURL	授予URL为HLS视频流创建的权限	读取	stream*
GetIceServerConfig	授予获取ICE服务器配置的权限	读取	channel*
GetImages	授予权限以从您 Kinesis 视频流中获取生成的映像	读取	stream*
GetMedia	授予权限以返回 Kinesis 视频流的媒体内容	Read	stream*
GetMediaForFragmentList	授予权限以仅读取并返回持久性存储中的媒体数据。	Read	stream*
GetSignalingChannelEndpoint	授予权限以获取信令通道的具有指定协议和角色组合的终端节点	读取	channel*
JoinStorageSession	授予加入通道的存储会话的权限	写入	channel*
JoinStorageSessionAsViewer	授予以观众身份加入频道存储会话的权限	写入	channel*
ListEdgeAgentConfigurations	授予列出边缘代理配置的权限	列出
ListFragments	授予权限以根据指定了范围的分页标记或选择器类型，列出存档存储中的片段。	List	stream*
ListSignalingChannels	授予权限以列出您的信令通道	List
ListStreams	授予权限以列出您的 Kinesis 视频流	List
ListTagsForResource	授予权限以提取与您的资源关联的标签	Read	channel
			stream
ListTagsForStream	授予权限以提取与 Kinesis 视频流关联的标签	Read	stream*
PutMedia	授予权限以将媒体数据发送到 Kinesis 视频流	写入	stream*
SendAlexaOfferToMaster	授予向大师发送 Alexa SDP 报价的权限	写入	channel*
StartEdgeConfigurationUpdate	授予权限以开始您 Kinesis 视频流的边缘配置更新	写入	stream*
TagResource	授予权限以将一组标签附加到资源	Tagging	channel
			stream
				aws:RequestTag/${TagKey} aws:TagKeys
TagStream	授予权限以将一组标签附加到 Kinesis 视频流	Tagging	stream*
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	授予权限以从您的资源删除一个或多个标签	Tagging	channel
			stream
				aws:TagKeys
UntagStream	授予权限以从 Kinesis 视频流中删除一个或多个标签	Tagging	stream*
				aws:TagKeys
UpdateDataRetention	授予权限以更新 Kinesis 视频流的数据保留期限	写入	stream*
UpdateImageGenerationConfiguration	授予权限以更新您 Kinesis 视频流的映像生成配置	写入	stream*
UpdateMediaStorageConfiguration	授予创建或更新信令通道和流之间映射的权限	写入	channel*
UpdateNotificationConfiguration	授予权限以更新您 Kinesis 视频流的通知配置	写入	stream*
UpdateSignalingChannel	授予权限以更新现有信令通道	Write	channel*
UpdateStream	授予权限以更新现有 Kinesis 视频流	Write	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 定义了以下可在策略元素Condition中使用的条件键。IAM您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。

要查看适用于所有服务的全局条件键，请参阅可用的全局条件键。

条件键	描述	类型
aws:RequestTag/${TagKey}	根据每个标签的允许值集筛选请求	String
aws:ResourceTag/${TagKey}	根据与流关联的标签值筛选操作	String
aws:TagKeys	根据在请求中是否具有必需标签键以筛选请求	ArrayOfString