查询后付费套餐实例列表。
接口说明
此接口用于查询用户账户下的后付费套餐实例列表,支持按照多种条件进行筛选和排序。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CheckRemainingSiteQuota |
string |
否 |
检查是否有剩余站点配额。取值范围:
|
true |
| SortBy |
string |
否 |
按哪个字段排序。取值:
枚举值:
|
CreateTime |
| SortOrder |
string |
否 |
排序方式。取值:
枚举值:
|
desc |
| PageNumber |
integer |
否 |
分页查询时设置的页码。取值大于等于 1。 |
1 |
| PageSize |
integer |
否 |
分页查询时每页的大小,取值范围 1-500。 |
12 |
| Status |
string |
否 |
实例状态。取值:
枚举值:
|
online |
| InstanceId |
string |
否 |
实例 ID,用于精确查找单个实例。 |
sp-dps-xxxxxx |
| UnrelatedType |
string |
否 |
实例是否加购 bot 或 ddos。 枚举值:
|
bot |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应信息。 |
||
| RequestId |
string |
请求 ID。 |
15C66C7B-671A-4297-9187-2C4477247A123425345 |
| InstanceInfo |
array<object> |
实例信息列表。 |
|
|
array<object> |
套餐实例详情。 |
||
| InstanceId |
string |
实例 ID。 |
sp-xcdn-96wblslz**** |
| PlanName |
string |
套餐英文名称。 |
basic |
| PlanType |
string |
套餐实例对应的套餐类型,取值:
|
normal |
| SiteQuota |
string |
站点配额。 |
1 |
| CreateTime |
string |
实例创建时间,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。 |
2026-04-19T11:15:20Z |
| Sites |
array<object> |
站点列表。 |
|
|
object |
已经绑定到当前套餐实例下的站点列表。 |
||
| SiteId |
integer |
站点 ID。 |
123456**** |
| SiteName |
string |
站点名称。 |
example.com |
| SiteStatus |
string |
站点状态。取值:
|
pending |
| Status |
string |
实例状态。 |
online |
| Coverages |
string |
该实例可绑定的站点的加速区域范围,多个用(,)隔开。取值:
|
domestic |
| BillingMethod |
string |
计费方式。取值:
|
SUBSCRIBE |
| PlanNameCn |
string |
套餐名称(中文)。 |
test-plan |
| BillingMode |
string |
计费模式。取值:
|
POSTPAY |
| ExpectedUpdateTime |
string |
预约变配时间,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。 |
2026-04-19T11:15:20Z |
| PageNumber |
integer |
当前页码,同请求参数的 PageNumber。 |
1 |
| PageSize |
integer |
每页大小。 |
20 |
| TotalCount |
integer |
总记录数。 |
1 |
| TotalPage |
integer |
总页数。 |
2 |
示例
正常返回示例
JSON格式
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A123425345",
"InstanceInfo": [
{
"InstanceId": "sp-xcdn-96wblslz****",
"PlanName": "basic",
"PlanType": "normal",
"SiteQuota": "1",
"CreateTime": "2026-04-19T11:15:20Z",
"Sites": [
{
"SiteId": 0,
"SiteName": "example.com",
"SiteStatus": "pending"
}
],
"Status": "online",
"Coverages": "domestic",
"BillingMethod": "SUBSCRIBE",
"PlanNameCn": "test-plan",
"BillingMode": "POSTPAY",
"ExpectedUpdateTime": "2026-04-19T11:15:20Z"
}
],
"PageNumber": 1,
"PageSize": 20,
"TotalCount": 1,
"TotalPage": 2
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid. | 输入参数规范校验失败。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。