更新媒体直播输入。
接口说明
调用本接口更新媒体直播输入。
仅当媒体直播输入未绑定到媒体直播频道时,允许更新输入,不允许更新已经绑定了频道的输入。
QPS 限制
本接口的单用户 QPS 限制为 50 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:UpdateMediaLiveInput |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InputId |
string |
是 |
输入 ID。 |
SEGK5KA6KYKAWQQH |
| Name |
string |
是 |
输入实例名称。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 64 字符。 |
myinput |
| SecurityGroupIds |
array |
否 |
要绑定的安全组 ID 列表,Type 为 PUSH 类型时必填。 |
["G6G4X5T4SZYPSTT5"] |
|
string |
否 |
要绑定的安全组 ID。 |
G6G4X5T4SZYPSTT5 |
|
| InputSettings |
array<object> |
是 |
输入设置。最多 2 个,对应主输入和备输入。 |
|
|
object |
否 |
|||
| FlowId |
string |
否 |
MediaConnect Flow 的 Flow ID,Type 为 MEDIA_CONNECT 时必填。 |
******81-9693-40dc-bbab-db5e49****** |
| SourceUrl |
string |
否 |
拉流的流地址,Type 为 PULL 类型时必填。 |
rtmp://domain/app/stream |
| StreamName |
string |
否 |
推流的流名称,Type 为 PUSH 类型时必填。长度限制英文 255 字符。 |
mystream |
| SrtPassphrase |
string |
否 |
SRT 加密配置,SRT 流的密码,由 10~79 个 ASCII 编码可见的字符组成。Type 为 SRT_PUSH,SRT_PULL 时选填。 如果加密配置不为空,则所有 SRT 客户端必须使用正确的密码才能发布或播放,否则 SRT 连接将被拒绝。 |
srtencryption |
| SrtMaxBitrate |
integer |
否 |
SRT 流的最大码率,单位 bps。取值范围[100, 100000000]。Type 为 SRT_PUSH,SRT_PULL 时选填。 |
3000000 |
| FlowOutputName |
string |
否 |
MediaConnect Flow 的输出名称,Type 为 MEDIA_CONNECT 时必填。 |
myFlowOutputName |
| SrtLatency |
integer |
否 |
SRT 流的延迟,单位 ms。取值范围[100, 10000]。Type 为 SRT_PUSH,SRT_PULL 时选填。 |
1000 |
| SrtPbKeyLen |
integer |
否 |
SRT 加密配置,SRT 流的密钥长度。可选值:0, 16, 24, 32。Type 为 SRT_PUSH,SRT_PULL 时选填。 |
16 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
******3B-0E1A-586A-AC29-742247****** |
示例
正常返回示例
JSON格式
{
"RequestId": "******3B-0E1A-586A-AC29-742247******"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。