Queries the status information about the Dynamic Route for CDN (DCDN) service. The status information includes the current billing method, the activation time of the service, the next effective billing method, and the current service state.

Debugging

Note The maximum number of times that each user can call this operation per second is 30.

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDcdnService

The operation that you want to perform. Set the value to DescribeDcdnService.

Response parameters

Parameter Type Example Description
ChangingAffectTime String 2018-03-31T16:00:00Z

The start time when the next billing method takes effect. The time is displayed in UTC.

ChangingChargeType String PayByBandwidth

The next billing method that takes effect. Valid values:

  • PayByTraffic: traffic
  • PayByBandwidth: bandwidth
  • PayByBandwidth95: 95th percentile bandwidth
  • PayByBandwidth_monthavg: monthly average bandwidth
  • PayByBandwidth_month4th: the fourth peak bandwidth in each month
  • PayByBandwidth_monthday95avg: monthly average 95th percentile bandwidth
  • PayByBandwidth_nighthalf95: 95th percentile bandwidth of half idle bandwidth in the nighttime
InstanceId String FP-mkqgwxxxx

The ID of the instance.
InternetChargeType String PayByTraffic

The current billing method. Valid values:

  • PayByTraffic: traffic
  • PayByBandwidth: bandwidth
  • PayByBandwidth95: 95th percentile bandwidth
  • PayByBandwidth_monthavg: monthly average bandwidth
  • PayByBandwidth_month4th: the fourth peak bandwidth in each month
  • PayByBandwidth_monthday95avg: monthly average 95th percentile bandwidth
  • PayByBandwidth_nighthalf95: 95th percentile bandwidth of half idle bandwidth in the nighttime
OpeningTime String 2018-03-19T11:16:11Z

The time when the DCDN service was activated. The time follows the ISO 8601 standard.
OperationLocks Array

The lock status of the DCDN service.
LockReason
LockReason String financial

The reason why the service was locked. For example, a value of financial indicates that an overdue payment exists.

RequestId String EF2AEBC2-EDBD-41CF-BF64-7E095D42D6EF

The ID of the request.
WebsocketChangingTime String 2018-03-19T11:16:11Z

The time when the changes of the WebSocket configuration take effect. The value is the same as that of the ChangingAffectTime parameter. This parameter can be displayed in the console only if the specified time is later than the current time.

WebsocketChangingType String websocketbps

The next effective billing method of WebSocket. Valid values: websockettraffic and websocketbps. A value of websockettraffic indicates that you are billed based on the traffic volume. A value of websocketbps indicates that you are billed based on the bandwidth.

WebsocketType String websocketbps

The current billing method of WebSocket. Valid values: websockettraffic and websocketbps. A value of websockettraffic indicates that you are billed based on the traffic volume. A value of websocketbps indicates that you are billed based on the bandwidth.

Examples

Sample requests

http://dcdn.aliyuncs.com?Action=DescribeDcdnService
&<Common request parameters>

Sample success responses

XML format 

<DescribeDcdnServiceResponse>
      <ChangingChargeType>PayByBandwidth</ChangingChargeType>
      <OpeningTime>2018-03-19T11:16:11Z</OpeningTime>
      <InstanceId>FP-mkqgwxxxx</InstanceId>
      <RequestId>EF2AEBC2-EDBD-41CF-BF64-7E095D42D6EF</RequestId>
      <ChangingAffectTime>2018-03-31T16:00:00Z</ChangingAffectTime>
      <OperationLocks>
            <LockReason>
                  <LockReason>financial</LockReason>
            </LockReason>
      </OperationLocks>
      <InternetChargeType>PayByTraffic</InternetChargeType>
</DescribeDcdnServiceResponse>

JSON format 

{
    "ChangingChargeType": "PayByBandwidth",
    "OpeningTime": "2018-03-19T11:16:11Z",
    "InstanceId": "FP-mkqgwxxxx",
    "RequestId": "EF2AEBC2-EDBD-41CF-BF64-7E095D42D6EF",
    "ChangingAffectTime": "2018-03-31T16:00:00Z",
    "OperationLocks": {
        "LockReason": [
            {
                "LockReason": "financial"
            }
        ]
    },
    "InternetChargeType": "PayByTraffic"
}

Error codes

For a list of error codes, visit the API Error Center.