全部产品
Search

搜索本产品

    视频直播：AddLivePackageConfig - 添加直播封装配置

    文档中心

    视频直播：AddLivePackageConfig - 添加直播封装配置

    更新时间：Jan 13, 2026

    调用AddLivePackageConfig添加直播封装配置。

    接口说明

    • 域名第一次添加封装配置时，会同步下发播放域名加速相关配置，3～5 分钟后可生效。

    • 若播放域名对应的区域为海外区域时（新加坡、德国、日本、印尼），可能会存在延迟较大的问题，建议配置完成后请先测试验证是否符合预期。

    • 调用本接口增加直播封装配置，需要重新推流后才生效。

    QPS 限制

    本接口的单用户 QPS 限制为 300 次/分钟。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    live:AddLivePackageConfig

    create

    *Domain

    acs:cdn:*:{#accountId}:domain/{#DomainName}

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    否

    地域 ID。

    cn-shanghai
    DomainName

    string

    是

    直播域名（主播放域名）。

    example.com
    AppName

    string

    是

    AppName 名称与推流地址中的 AppName 名称对应，模板才能生效。不超过 255 字符，支持数字、大小写字母、短横线（-）、下划线（_），短横线、下划线不能位于首位。也支持取值为单个星号（*）字符，即可匹配所有 AppName。

    AppName
    StreamName

    string

    是

    StreamName 名称与推流地址中的 StreamName 名称对应，模板才能生效。不超过 255 字符，支持数字、大小写字母、短横线（-）、下划线（_），短横线、下划线不能位于首位。也支持取值为单个星号（*）字符，即可匹配所有 StreamName。

    StreamName
    Protocol

    string

    是

    直播协议与封装格式。取值：

    • HLS_CMAF

    • LLHLS_TS （低延迟）

    • LLHLS_CMAF（低延迟）

    • DASH_CMAF

    • HLSDASH_CMAF

    HLS_CMAF
    SegmentNum

    integer

    否

    直播 M3U8 切片个数。

    • 取值范围：3～10。

    • 默认值：3。

    3
    SegmentDuration

    integer

    否

    切片时长，单位：秒。

    • 如 Protocol 为 HLS_CMAF，取值范围 1～10，默认 5 秒；

    • 如 Protocol 为 LLHLS_*，取值范围 1～2，默认 1 秒。

    5
    PartDuration

    integer

    否

    Part 切片时长，单位：毫秒。

    • SegmentDuration 为 1s 时，取值范围 100～500ms，默认 350ms。

    • SegmentDuration 为 2s 时，取值范围 100～1000ms，默认 700ms。

    • 仅当 Protocol 为 LLHLS_*时有效。

    350
    IgnoreTranscode

    boolean

    否

    是否忽略转码流，取值：

    • true（默认值）：忽略。

    • false：不忽略。

    true

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    05D00B48-DF50-5DC0-A07D-A250DFAE****

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "05D00B48-DF50-5DC0-A07D-A250DFAE****"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 MissingParam %s, please check and try again later. 参数缺失，请检查后重试。
    400 InvalidParams %s, please check and try again later. 参数无效，请检查后重试。
    400 ConfigAlreadyExists %s Please check and try again later. 配置已存在，请检查后重试。
    400 InvalidProtocol %s, please check and try again later. 参数Protocol无效，请检查后重试。
    400 InvalidSegmentNum %s, please check and try again later. 参数SegmentNum无效，请检查后重试。
    400 InvalidSegmentDuration %s, please check and try again later. 参数SegmentDuration无效，请检查后重试。
    400 InvalidPartDuration %s, please check and try again later. 参数PartDuration无效，请检查后重试。
    500 DomainConfigFailed %s
    500 InternalErr %s, please try again. 内部错误，请稍后重试。
    409 ConfigConflicts %s, please check and try again later. 配置冲突，请检查后重试。

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。