文档首页/ 内容分发网络 CDN/ API参考/ API/ 域名操作/ 查询加速域名基础信息 - ListDomainConfigs
更新时间:2025-11-27 GMT+08:00
分享

查询加速域名基础信息 - ListDomainConfigs

功能介绍

查询加速域名的基础信息,包含cname状态、加速域名是否支持复制配置。

  • 单租户调用频率:5次/s。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v1.0/cdn/configuration/domains

表1 Query参数

参数

是否必选

参数类型

描述

domain_names

String

参数解释:

加速域名

说明:
  • 多个域名使用英文半角逗号分隔

  • 当查询cname状态时,该参数必传

约束限制:

仅支持查询已经在CDN添加成功的域名

取值范围:

不涉及

默认取值:

不涉及

item

String

参数解释:

查询数据类型

约束限制:

不涉及

取值范围:

  • cname_status: 域名cname状态

  • copy: 查询账号下哪些加速域名支持复制配置。

默认取值:

不涉及

enterprise_project_id

String

参数解释:

企业项目id。您可以通过调用企业项目管理服务(EPS)的查询企业项目列表接口(ListEnterpriseProject)查询企业项目id

约束限制:

当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户鉴权Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

cname_status

Array of CnameStatus objects

域名cname状态。

表4 CnameStatus

参数

参数类型

描述

status

Integer

域名cname状态

domain_name

String

加速域名

状态码:400

表5 响应Body参数

参数

参数类型

描述

error

ErrMsg object

用于返回具体的错误码和错误消息

表6 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET https://cdn.myhuaweicloud.com/v1.0/cdn/configuration/domains?domain_names=www.example.com&item=cname_status

响应示例

状态码:200

成功响应。

{
  "CnameStatus" : [ {
    "status" : 0,
    "domain_name" : "www.example.com"
  } ]
}

状态码

状态码

描述

200

成功响应。

400

错误响应。

错误码

请参见错误码

相关文档