全部文档
当前文档
最近更新时间：2025-11-21 11:34:08
本接口用于查询当前用户下所有域名列表信息，包含加速域名、域名ID、域名运行状态、产品类型、产品子类型、CNAME域名
支持按域名模糊匹配过滤、域名状态过滤
支持根据域名运行状态、产品类型筛选查询
支持按照指定项目下的域名查询
本接口请求需要包含指定目录/2019-06-01/domain/GetCdnDomains、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。
参数名称 | 是否必选 | 参数类型 | 示例值 | 参数说明 |
|---|---|---|---|---|
PageSize | 否 | Long | 20 | 分页大小，默认20，最大500，取值1～500间整数 |
PageNumber | 否 | Long | 1 | 取第几页。默认为1，取值1～10000 |
DomainName | 否 | String | www.test.com.hdlvcloud.ks-cdn.com | 按域名过滤，默认为空，为空时代表当前用户下所有域名，域名长度最大255，不支持多个域名同时查询 |
ProjectId | 否 | Long | 105672 | 查询指定项目下的域名。默认为空，为空时查询当前用户下所有域名ProjectId可至金山云控制台-资源管理-项目管理查询 |
DomainStatus | 否 | String | online | 按域名状态过滤。默认为空，为空时查询当前用户下所有域名的全部状态，取值为：online：正在运行；offline：已停止；configuring：配置中；configure_failed：配置失败 ；icp_checking：审核中；icp_check_failed：审核失败；locked：已封禁；locking：封禁中 |
CdnType | 否 | String | file | 产品类型：wcdn，对应全站加速。默认为空，代表当前用户泛cdn下全部产品类型（含非wcdn的类型，不支持live：流媒体直播），支持同时查询多个产品类型，两个类型之间用英文逗号（半角）隔开 |
FuzzyMatch | 否 | String | on | 域名过滤是否使用模糊匹配，取值为on：开启，off：关闭，默认为on |
参数名称 | 参数类型 | 示例值 | 参数说明 |
|---|---|---|---|
PageNumber | Long | 1 | 页码 |
PageSize | Long | 20 | 单页大小 |
TotalCount | Long | 10 | 总条数 |
Domains | Domain[] | Domain列表 |
参数名称 | 参数类型 | 示例值 | 参数说明 |
|---|---|---|---|
DomainName | String | www.test.com.hdlvcloud.ks-cdn.com | 加速域名名称 |
DomainId | String | 2D074NB | 域名ID |
Cname | String | example.ksc-test.com.download.ks-cdn.com | 加速域名对应的CNAME域名 |
CdnType | String | wcdn | 产品类型：file：大文件下载，video：音视频点播，page：图片小文件，live：流媒体直播 |
CdnSubType | String | wcdn | 加速业务子类型，业务子类型是为了细分业务，默认不填写，目前作为已废弃的历史遗留字段 |
IcpRegistration | String | 京ICP备10000000号-11 | ICP备案号 |
DomainStatus | String | online | 加速域名状态，具体枚举类型表见使用须知 |
CreatedTime | String | 2021-10-25T11:03+0800 | 加速域名创建时间 |
ModifiedTime | String | 2021-10-25T11:03+0800 | 加速域名最近修改时间 |
Description | String | - | 审核失败原因，正常情况下为空 |
Projectld | int | 0 | 域名所属项目ID |
ProjectName | String | 默认项目 | 域名所属项目名称 |
Region | String | CN | 域名的服务区域，具体枚举类型表见使用须知 |
请求示例
GET方式：
GET /2019-06-01/domain/GetCdnDomains?PageSize=20&PageNumber=1&DomainName=wcdn-&DomainStatus=online&CdnType=wcdn&FuzzyMatch=on 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetCdnDomains
x-version: 2019-06-01POST方式：
POST /2019-06-01/domain/GetCdnDomains 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetCdnDomains
x-version: 2019-06-01
Content-Type: application/json
{
"PageSize": 20,
"PageNumber": 1,
"DomainName": "wcdn-",
"DomainStatus": "online",
"CdnType": "wcdn",
"FuzzyMatch": "on"
}返回示例
{
"PageNumber": 1,
"PageSize": 20,
"TotalCount": 3,
"Domains": [
{
"DomainName": "wcdn-20220304-1.ksc-test.com",
"DomainId": "2D07ANU",
"Cname": "wcdn-20220304-1.ksc-test.com.download.ks-cdn.com",
"CdnType": "wcdn",
"CdnSubType": "wcdn",
"IcpRegistration": "京ICP备12032080号-12",
"DomainStatus": "online",
"CreatedTime": "2022-03-04T15:01+0800",
"ModifiedTime": "2022-03-07T17:32+0800",
"Description": "",
"ProjectId": 0,
"ProjectName": "默认项目"
},
{
"DomainName": "zhu-wcdn-test.ksc-test.com",
"DomainId": "2D07SSS",
"Cname": "zhu-wcdn-test.ksc-test.com.download.ks-cdn.com",
"CdnType": "wcdn",
"CdnSubType": "wcdn",
"IcpRegistration": "京ICP备12032080号-12",
"DomainStatus": "online",
"CreatedTime": "2021-07-08T19:03+0800",
"ModifiedTime": "2021-09-23T13:28+0800",
"Description": "",
"ProjectId": 0,
"ProjectName": "默认项目"
},
{
"DomainName": "wcdn-test3.ksc-test.com",
"DomainId": "2D07U2P",
"Cname": "wcdn-test3.ksc-test.com.download.ks-cdn.com",
"CdnType": "wcdn",
"CdnSubType": "wcdn",
"IcpRegistration": "京ICP备12032080号-12",
"DomainStatus": "online",
"CreatedTime": "2021-06-11T11:22+0800",
"ModifiedTime": "2021-10-18T14:06+0800",
"Description": "",
"ProjectId": 0,
"ProjectName": "默认项目"
}
]
}为了帮您快速定位问题，WCDN将错误码集中归类，请到【使用须知】查看详情。
纯净模式