GetValidDomainList

Last updated:2021-03-17 10:54:01

GetValidDomainList

Description

You can call this operation to query valid domain names by time period.

  • A valid domain name is in the online, offline, or configuring state.
  • Notes:
    • You can call the GetCdnDomains operation to query only valid domain names at the current time.
    • You can call the GetValidDomainList operation to query valid domain names by time period. For example, you can call this operation to query a deleted domain name and its ID. Then, you can use the domain name or ID to query statistical data such as the bandwidth and traffic of the deleted domain name in its validity period.

Request syntax

The API request contains the specified directory /2016-09-01/statistics/GetValidDomainList, common request headers, and operation-specific request parameters. For more information, see the sample request.

Request parameters

Parameter Required Type Description
StartTime Yes String The beginning of the time range to query. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mm+0800 format. The time must be in UTC+8. Example: 2016-08-01T21:14+0800.
EndTime Yes String The end of the time range to query. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mm+0800 format. The time must be in UTC+8. The end time must be later than the start time. Example: 2016-08-01T21:14+0800.
CdnType Yes String The business type. Valid values: file, video, page, live, and all.

Response parameters

Parameter Type Description
Domains Domainlist[] The valid domain names.

Domainlist

Parameter Type Description
Domain String The domain name.
DomainId String The ID of the domain name.
CdnType String The business type of the domain name. Valid values: file, video, page, and live.

Examples

Sample request

GET method:

GET /2016-09-01/statistics/GetValidDomainList?StartTime=2006-01-01T00:00%2B0800&EndTime=2116-01-01T00:00%2B0800&CdnType=all 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetValidDomainList
x-version: 2016-09-01

POST method:

POST /2016-09-01/statistics/GetValidDomainList 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: StartStopCdnDomain
x-version: 2016-09-01
Content-Type: application/x-www-form-urlencoded

StartTime:2006-01-01T00:00+0800&EndTime:2116-01-01T00:00+0800
&CdnType:all

Sample response

{
  "Domainlist": [
    {
      "CdnType": "live",
      "DomainId": "2D09S3K",
      "Domain": "plu.rtmplive.ks-cdn.com"
    },
    {
      "CdnType": "live",
      "DomainId": "2D09RRX",
      "Domain": "rtmp3.plu.cn"
    },
    {
      "CdnType": "live",
      "DomainId": "2D09S03",
      "Domain": "plu.hlslive.ks-cdn.com"
    },
    {
      "CdnType": "live",
      "DomainId": "2D09RQK",
      "Domain": "plu.hdllive.ks-cdn.com"
    },
    {
      "CdnType": "download",
      "DomainId": "2D09X3P",
      "Domain": "hls3.plu.cn"
    },
    {
      "CdnType": "download",
      "DomainId": "2D09X7A",
      "Domain": "hlstime3.plu.cn"
    },
    {
      "CdnType": "live",
      "DomainId": "2D09SA6",
      "Domain": "realflv3.plu.cn"
    }
  ]
}

Did you find the above information helpful?

Unhelpful
Mostly Unhelpful
A little helpful
Helpful
Very helpful

What might be the problems?

Insufficient
Outdated
Unclear or awkward
Redundant or clumsy
Lack of context for the complex system or functionality

More suggestions

0/200

Please give us your feedback.

Submitted

Thank you for your feedback.

问题反馈