更新推流码信息
更新时间不可用
更新指定推流码关联的流配置模板。
PUT
https://api.sd-rtn.com/{region}/v1/projects/{appId}/rtls/ingress/streamkeys/{streamkey}注意
该接口仅支持更新已绑定的流配置模板。
鉴权
regionstring必填
创建推流码的区域。声网支持分区域创建推流码,目前支持以下区域:
cn:中国大陆ap:除中国大陆以外的亚洲区域na:北美eu:欧洲
注意
- 请确保设置的
region与输入的源流在同一个区域。 - 请确保设置的
region与推流使用的域名在同一个区域。 - 请确保传入
region的值为小写。
appIdstring必填
声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。App ID 是一个项目的唯一标识。
streamkeystring必填
要更新的推流码。
X-Request-IDstring本次请求的 UUID(通用唯一识别码)。传入该字段后,声网服务器会在响应 Header 中返回该字段。声网推荐你对 X-Request-ID 赋值。如果不赋值,声网服务器会自动生成一个 UUID 传入。
请求包体为 JSON Object 类型的 settings 字段。
关联的流配置模板 ID,具体请见流配置模板。请确保它已经被创建。
如果想要解除之前绑定的模板,且不再绑定新的模板,可以设置为 null。
响应
请求示例
curl --request PUT \
--url "https://api.sd-rtn.com/:region/v1/projects/:appId/rtls/ingress/streamkeys/:streamkey" \
--header 'Authorization: Basic <credentials>' \
--header 'X-Request-ID: <string>' \
-H 'Content-Type: application/json' \
-d '{
"settings": {
"templateId": "test"
}
}'响应示例
{
"message": "string"
}