All Products
Search
Document Center

Anti-DDoS:DescribeDdosCredit

Last Updated:Mar 01, 2024

Queries the details of the security credit score of the current Alibaba Cloud account in a specific region.

Operation description

You can call the DescribeDdosCredit operation to query the details of the security credit score of the current Alibaba Cloud account in a specific region. The details include the security credit score, security credit level, and the time period after which blackhole filtering is automatically deactivated.

Limits

You can call this operation up to 10 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DdosRegionIdstringYes

The ID of the region.

Note You can call the DescribeRegions operation to query the most recent region list.
cn-hangzhou

Response parameters

ParameterTypeDescriptionExample
object
Successboolean

Indicates whether the request was successful. Valid values:

  • true: yes
  • false: no
true
RequestIdstring

The ID of the request.

E1F7BD73-8E9D-58D9-8658-CFC97112C641
DdosCreditobject

The details of the security credit score of the current Alibaba Cloud account in the specified region.

Scoreinteger

The security credit score. The full score is 1000.

550
ScoreLevelstring

The security credit level. Valid values:

  • A: outstanding
  • B: excellent
  • C: good
  • D: average
  • E: poor
  • F: poorer
D
BlackholeTimeinteger

The time period after which blackhole filtering is automatically deactivated in the specified region. Unit: minutes.

150

Examples

Sample success responses

JSONformat

{
  "Success": true,
  "RequestId": "E1F7BD73-8E9D-58D9-8658-CFC97112C641",
  "DdosCredit": {
    "Score": 550,
    "ScoreLevel": "D",
    "BlackholeTime": 150
  }
}

Error codes

For a list of error codes, visit the Service error codes.