GetCdnDomains

本接口用于查询当前用户下所有域名列表信息，包含加速域名、域名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	产品类型：file：大文件下载，video：音视频点播，page：图片小文件，wcdn：全站加速，默认为空，代表当前用户下全部产品类型（包括wcdn产品，不支持live：流媒体直播），支持同时查询多个产品类型，两个类型之间用英文逗号（半角）隔开
FuzzyMatch	否	String	on	域名过滤是否使用模糊匹配，取值为on：开启，off：关闭，默认为on

返回参数

参数名称	参数类型	示例值	参数说明
PageNumber	Long	1	页码
PageSize	Long	20	单页大小
TotalCount	Long	10	总条数
Domains	Domain[]		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	page	产品类型：file：大文件下载，video：音视频点播，page：图片小文件，live：流媒体直播
CdnSubType	String	page	加速业务子类型，业务子类型是为了细分业务，默认不填写，目前作为已废弃的历史遗留字段Projectld
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=&DomainStatus=online&CdnType&FuzzyMatch=on 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetCdnDomains
x-version: 2019-06-01

POST方式：

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/x-www-form-urlencoded

PageSize=20&PageNumber=1&DomainName=&DomainStatus=online&CdnType&FuzzyMatch=on

返回示例

{
  "PageNumber": 1,
  "PageSize": 20,
  "TotalCount": 4,
  "Domains": [
    {
      "Description": "",
      "ModifiedTime": "2016-09-21T15:37+0800",
      "CreatedTime": "2016-09-21T15:37+0800",
      "IcpRegistration": "鄂ICP备15011961号-1",
      "DomainId": "2D09RCM",
      "CdnType": "live",
      "Cname": "www.test.com.hdlvcloud.ks-cdn.com",
      "CdnSubType": "video",
      "DomainName": "www.test.com",
      "DomainStatus": "online"
    },
    {
      "Description": "",
      "ModifiedTime": "2016-09-19T19:34+0800",
      "CreatedTime": "2016-09-19T19:34+0800",
      "IcpRegistration": "京ICP证030173号-1",
      "DomainId": "2D09RDG",
      "CdnType": "live",
      "Cname": "test2.com.hlsvcloud.ks-cdn.com",
      "CdnSubType": "video",
      "DomainName": "test2.com", 
     "DomainStatus": "online"
    },
    {
      "Description": "",
      "ModifiedTime": "2016-09-19T19:34+0800",
      "CreatedTime": "2016-09-19T19:34+0800",
      "IcpRegistration": "京ICP证030173号-1",
      "DomainId": "2D09RDG",
      "CdnType": "live",
      "Cname": "test3.com.hlsvcloud.ks-cdn.com",  
      "CdnSubType": "video",
      "DomainName": "test3.com", 
     "DomainStatus": "online"
    },
    {
      "Description": "",
      "ModifiedTime": "2016-09-19T17:49+0800",
      "CreatedTime": "2016-09-19T17:49+0800",
      "IcpRegistration": "粤B2-20090191-2",
      "DomainId": "2D09RDK",
      "CdnType": "live",
      "Cname": "www.test4.com.hlsvcloud.ks-cdn.com",
      "CdnSubType": "video",
      "DomainName": "www.test4.com", 
     "DomainStatus": "online"
    }
  ]
}

错误码

为了帮您快速定位问题，CDN将错误码集中归类，请到【使用须知】查看详情。

文档导读

上一篇：域名列表服务

下一篇：启用停用加速域名

纯净模式常规模式

纯净模式

点击可全屏预览文档内容