注意事项

本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

请求地址：https://vod.volcengineapi.com?Action=GetDomainPlayRule&Version=2023-07-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

参数	类型	是否必选	示例值	描述
Action	String	是	`GetDomainPlayRule`	接口名称。当前 API 的名称为 `GetDomainPlayRule`。
Version	String	是	`2023-07-01`	接口版本。当前 API 的版本为 `2023-07-01`。
SpaceName	String	否	`test`	空间名称。您可调用 ListSpace 接口获取当前账号下所有空间的名称。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
PlayRule	Integer	`1`	调度策略。取值如下： `0`: 随机分发。 `1`: 按默认域名分发。 `2`: 按固定比例分发。
RuleWeights	Object[]	`-`	域名权重配置。仅当 `PlayRule` 为 `2` 时返回。
Domain	String	`example.volcengine.com`	加入点播调度的域名。
Weight	Long	`70`	加入点播调度的域名的比例。取值范围为 [0,100]。所有域名的比例之和必须为 100。
DefaultDomain	String	`example.volcengine.com`	默认域名。仅当 `PlayRule` 为 `1` 时返回。

请求示例

以下为指定空间的请求 URL 示例。调用时还需按照公共请求参数说明提供鉴权信息。

https://vod.volcengineapi.com?Action=GetDomainPlayRule&Version=2023-07-01&SpaceName=test

返回示例

以下示例根据参数定义构造，展示按默认域名分发（PlayRule=1）时的响应结构，不是实际调用记录。

{
  "ResponseMetadata": {
    "RequestId": "example-request-id",
    "Action": "GetDomainPlayRule",
    "Version": "2023-07-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "PlayRule": 1,
    "DefaultDomain": "vod.example.com"
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。

最近更新时间：2026.09.18 22:33:01

这个页面对您有帮助吗？

有用

无用

视频点播

注意事项 #

请求说明 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #