UpdateStream - Amazon Kinesis Video Streams
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

UpdateStream

更新流媒体元数据，例如设备名称和媒体类型。

您必须提供流的流 Amazon 资源名称（ARN）。

要在更新直播之前确保您拥有最新版本的直播，您可以指定直播版本。Kinesis Video Streams 为每个直播分配一个版本。更新流时，Kinesis Video Streams reis Video Streis Vid 要获取最新的直播版本，请使用DescribeStream API。

UpdateStream是一个异步操作，需要花费一定时间才能完成。

请求语法

POST /updateStream HTTP/1.1
Content-type: application/json

{
   "CurrentVersion": "string",
   "DeviceName": "string",
   "MediaType": "string",
   "StreamARN": "string",
   "StreamName": "string"
}

URI 请求参数

该请求不使用任何 URI 参数。

请求正文

请求接受采用 JSON 格式的以下数据。

CurrentVersion

要更新其元数据的流的流。

类型：字符串

长度限制：最小长度为 1。最大长度为 64。

模式：[a-zA-Z0-9]+

必需：是

DeviceName

写入流的 Authorized 的设备的名称。

注意

在当前的实现中，Kinesis Video Streams 不使用这个名称。

类型：字符串

长度限制：最小长度为 1。最大长度为 128。

模式：[a-zA-Z0-9_.-]+

必需：否

MediaType

直播的媒体类型。用于MediaType向直播的消费者指定直播所包含的内容类型。有关媒体类型的更多信息，请参阅媒体类型。如果您选择指定MediaType，请参阅命名要求。

要在主机上播放视频，必须指定正确的视频类型。例如，如果流中的视频是 H.264，则指定video/h264为MediaType。

类型：字符串

长度限制：最小长度为 1。最大长度为 128。

模式：[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

必需：否

StreamARN

要更新其元数据的流 ARN。

类型：字符串

长度限制：最小长度为 1。长度上限为 1024。

模式：arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

必需：否

StreamName

要更新其元数据的流的流。

直播名称是直播的标识符，并且每个账户和区域都必须是唯一的。

类型：字符串

长度限制：最小长度为 1。长度上限为 256。

模式：[a-zA-Z0-9_.-]+

必需：否

响应语法

HTTP/1.1 200

响应元素

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

错误

有关所有操作常见错误的信息，请参阅常见错误。

ClientLimitExceededException

Kinesis Video Streams 限制了请求，因为您已超出允许的客户端呼叫限制。稍后再尝试打电话。

HTTP 状态代码：400

InvalidArgumentException

此输入参数的值无效。

HTTP 状态代码：400

NotAuthorizedException

调用者没有权限执行此操作。

HTTTP 状态代码：401

ResourceInUseException

当输入StreamARN或ChannelARN输入CLOUD_STORAGE_MODE已映射到其他 Kinesis Video Stream 资源，或者如果提供的输入StreamARN或未ChannelARN处于 “活动” 状态，请尝试以下方法之一：

  1. 用于确定给定频道的直播映射到什么的DescribeMediaStorageConfiguration API。

  2. 用于确定给定流映射到的频道的DescribeMappedResourceConfiguration API。

  3. DescribeSignalingChannel用于确定资源状态的DescribeStream或 API。

HTTP 状态代码：400

ResourceNotFoundException

Amazon Kinesis Video Streams reams 找不到你指定的直播。

HTTP 状态代码：404

VersionMismatchException

您指定的直播版本不是最新版本。要获取最新版本，请使用 DescribeStreamAPI。

HTTP 状态代码：400

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：