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