All Products
Search

This Product

    Edge Security Acceleration:ListDDoSInstances

    Document Center

    Edge Security Acceleration:ListDDoSInstances

    Last Updated:Mar 06, 2026

    Retrieves a list of purchased DDoS protection instances.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request syntax

    GET  HTTP/1.1

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    SortBy

    string

    No

    Sort field. Default: CreateTime.

    • CreateTime: Time when the instance was purchased.

    Valid values:

    • CreateTime :

      CreateTime

    CreateTime
    SortOrder

    string

    No

    Sort order:

    • asc: ascending.

    • desc: descending.

    asc
    PageNumber

    integer

    No

    Page number. Default: 1.

    1
    PageSize

    integer

    No

    Number of entries per page. Default: 20. Maximum: 500. Valid values: integers from 1 to 500.

    20
    Status

    string

    No

    Instance status.

    Valid values:

    • offline :

      offline

    • overdue :

      overdue

    • disable :

      disable

    • online :

      online

    online
    InstanceId

    string

    No

    Instance ID.

    esa-ddos-b1e0l80ugfeo
    SiteInstanceId

    string

    No

    Associated site package instance ID.

    esa-site-a71k7bw1adf

    Response elements

    Element

    Type

    Description

    Example

    object

    Response schema

    RequestId

    string

    Request ID

    9F1DC265-BF10-5C9C-B607-760265C5F365
    InstanceInfo

    array<object>

    Instance details

    object

    Instance details

    InstanceId

    string

    Instance ID

    sp-ddddxxxxx
    CreateTime

    string

    Time when the instance was purchased

    2025-07-01T07:59:07Z
    Status

    string

    Instance status. Valid values:

    • online: Normal service status.

    • offline: Expired but not overdue. Instance is unavailable.

    • disable: Released.

    • overdue: Service suspended due to overdue payment.

    online
    DDoSBurstableDomesticProtection

    string

    DDoS protection specification for the Chinese mainland

    cn_300
    DDoSBurstableOverseasProtection

    string

    DDoS protection specification for regions outside the Chinese mainland

    overseas_300
    SiteInstanceId

    string

    Associated site package instance ID

    esa-site-b0s6kmx0r0n4
    ReserveReleaseTime

    string

    Scheduled release time

    2026-03-25T16:00:00Z
    PageNumber

    integer

    Page number. Default: 1.

    1
    PageSize

    integer

    Number of entries per page

    20
    TotalCount

    integer

    Total number of entries

    100
    TotalPage

    integer

    Total number of pages

    2

    Examples

    Success response

    JSON format

    {
  "RequestId": "9F1DC265-BF10-5C9C-B607-760265C5F365",
  "InstanceInfo": [
    {
      "InstanceId": "sp-ddddxxxxx",
      "CreateTime": "2025-07-01T07:59:07Z",
      "Status": "online",
      "DDoSBurstableDomesticProtection": "cn_300",
      "DDoSBurstableOverseasProtection": "overseas_300",
      "SiteInstanceId": "esa-site-b0s6kmx0r0n4",
      "ReserveReleaseTime": "2026-03-25T16:00:00Z"
    }
  ],
  "PageNumber": 1,
  "PageSize": 20,
  "TotalCount": 100,
  "TotalPage": 2
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter is invalid. The specified parameter is invalid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.