创建媒体直播输入。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| 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 类型时必填。 | |
| 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 |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"InputId": "SEGK5KA6KYKAWQQH"
}错误码
访问错误中心查看更多错误码。