ListUserRatePlanInstances - 查询用户套餐实例列表

查询该用户已购买的套餐实例及其详细信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
esa:ListUserRatePlanInstanceslist
  • 全部资源
    *

请求参数

名称类型必填描述示例值
CheckRemainingSiteQuotastring

是否筛选有剩余站点配额的套餐实例。支持:

  • true:筛选有剩余站点配额的套餐实例。
  • false:查询用户下所有的套餐实例。
true
Statusstring

套餐实例状态。支持:

  • online:正常服务状态。
  • offline:到期但未超期,处于不可用的状态。
  • disable:已释放状态。
  • overdue:欠费状态。
online
SortBystring

排序字段,默认按照新购时间排序。支持:

  • CreateTime:新购时间。
  • ExpireTime:到期时间。
CreateTime
SortOrderstring

排序标识,默认为降序。支持:

  • asc:升序。
  • desc:降序。
asc
PageNumberinteger

页码。取值范围为:1~100000。 默认值为 1

1
PageSizeinteger

页面大小。

500
InstanceIdstring

套餐实例 ID,可通过调用 ListSites 接口获取。

sp-xcdn-96wblslz****

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE
InstanceInfoarray<object>

查询到的该用户下符合条件的套餐实例。

Itemobject

套餐实例详情。

InstanceIdstring

套餐实例 ID。

sp-xcdn-96wblslz****
PlanNamestring

套餐实例对应的套餐名称。

basic
PlanTypestring

套餐实例对应的套餐类型,取值:

  • normal:固定版套餐。
  • enterprise:企业版套餐。
normal
SiteQuotastring

套餐实例下的站点数量配额。

1
ExpireTimestring

套餐实例的到期时间。

YYYY-MM-DDThh:mm:ssZ
Durationinteger

套餐实例的购买时长,单位:月。

3
CreateTimestring

套餐实例的新购时间。

YYYY-MM-DDThh:mm:ssZ
Sitesarray<object>

已经绑定到当前套餐实例下的站点列表。

Itemobject

绑定的站点的详情。

SiteIdlong

站点 ID。

123456****
SiteNamestring

站点名称。

example.com
SiteStatusstring

站点状态。取值:

  • pending:站点待配置。
  • active:站点已激活。
  • offline:站点已下线。
  • moved:站点已被顶替。
pending
Statusstring

套餐实例状态。取值:

  • online:正常服务状态。
  • offline:到期但未超期,处于不可用的状态。
  • disable:已释放状态。
online
Coveragesstring

该站点可绑定的站点的加速区域范围,多个用(,)隔开。取值:

  • domestic:国内。
  • overseas:全球(不包含国内)。
  • global:全球(包含国内)。
domestic,overseas
BillingModestring

付费类型。支持:

  • PREPAY:预付费。
  • POSTPAY:后付费。
PREPAY
PageNumberinteger

页码。

1
PageSizeinteger

整页大小。

10
TotalCountinteger

总条数。

68
TotalPageinteger

总页数。

1

示例

正常返回示例

JSON格式

{
  "RequestId": "CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE",
  "InstanceInfo": [
    {
      "InstanceId": "sp-xcdn-96wblslz****",
      "PlanName": "basic",
      "PlanType": "normal",
      "SiteQuota": "1",
      "ExpireTime": "YYYY-MM-DDThh:mm:ssZ ",
      "Duration": 3,
      "CreateTime": "YYYY-MM-DDThh:mm:ssZ ",
      "Sites": [
        {
          "SiteId": 0,
          "SiteName": "example.com",
          "SiteStatus": "pending"
        }
      ],
      "Status": "online",
      "Coverages": "domestic,overseas",
      "BillingMode": "PREPAY",
      "PlanTraffic": "",
      "Layer4Traffic": "",
      "Layer4TrafficIntl": "",
      "CrossborderTraffic": "",
      "EdgeRoutineRquest": "",
      "StaticRequest": "",
      "SmartRoutingRequest": "",
      "EdgeWafRequest": "",
      "DdosInstanceLevel": "",
      "DdosBurstableDomesticProtection": "",
      "DdosBurstableOverseasProtection": "",
      "BotInstanceLevel": ""
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 68,
  "TotalPage": 1
}

错误码

HTTP status code错误码错误信息描述
400InvalidParameterThe specified parameter is invalid.输入参数规范校验失败。
400InternalExceptionFailed to call the service. Try again later or contact technical support.调用服务失败,请稍后重试或联系客服咨询详情。

访问错误中心查看更多错误码。