文档

ListAccelerators - 查询全球加速实例列表

更新时间:

调用ListAccelerators接口查询全球加速实例列表。

调试

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

授权信息

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

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

请求参数

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

全球加速所在的地域 ID,仅取值cn-hangzhou

cn-hangzhou
PageNumberinteger

列表的页码,默认值为 1

1
PageSizeinteger

分页查询时每页的行数。最大值:50。默认值:10

10
AcceleratorIdstring

全球加速实例 ID。

ga-bp1odcab8tmno0hdq****
Statestring

全球加速实例的状态。取值:

  • init:初始化。
  • active:可用。
  • configuring:配置中。
  • binding:绑定中。
  • unbinding:解绑中。
  • deleting:删除中。
  • finacialLocked:欠费锁定。
active
ResourceGroupIdstring

资源组 ID。

rg-aekztkx4zwc****
Tagobject []

资源标签。

Keystring

全球加速资源的标签键。一旦输入该值,则不允许为空字符串。

最多支持 64 个字符,不能以aliyunacs:开头,不能包含http://或者https://

最多支持输入 20 个标签键。

tag-key
Valuestring

全球加速资源的标签值。一旦输入该值,可以为空字符串。

最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

最多支持输入 20 个标签值。

tag-value

返回参数

名称类型描述示例值
object

返回信息列表。

TotalCountinteger

列表条目数。

10
PageSizeinteger

分页查询时每页的行数。

10
RequestIdstring

请求 ID。

DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
Acceleratorsobject []

全球加速实例信息。

DnsNamestring

全球加速实例分配的 CNAME 地址。

ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com
Typestring

无效参数。

无效参数
SecondDnsNamestring

全球加速与 DDoS 高防联动后分配的 CNAME。

ga-bp1f609c76zg6zuna****-1.aliyunga0047.com
Specstring

全球加速实例的规格,取值:

  • 1:小型Ⅰ。
  • 2:小型Ⅱ。
  • 3:小型Ⅲ。
  • 5:中型Ⅰ。
  • 8:中型Ⅱ。
  • 10:中型Ⅲ。
  • 20:大型Ⅰ。
  • 30:大型Ⅱ。
  • 40:大型Ⅲ。
  • 50:大型 IV。
  • 60:大型 V。
  • 70:大型 VI。
  • 80:大型 VII。
  • 90:大型 VIII。
  • 100:超大型Ⅰ。
  • 200:超大型Ⅱ。
说明 目前,大型Ⅲ及以上规格仅白名单开放。如需使用,请联系阿里云客户经理。

实例规格不同,定义也不同。更多信息,请参见实例规格

1
Statestring

全球加速实例的状态。取值:

  • init:初始化。

  • active:可用。

  • configuring:配置中。

  • binding:绑定中。

  • unbinding:解绑中。

  • deleting:删除中。

  • finacialLocked:欠费锁定。

active
CreateTimelong

全球加速实例创建时间的时间戳。

1650643200
CenIdstring

全球加速实例绑定的云企业网实例。

cen-hjfufhjfuwff****
DdosIdstring

与全球加速实例绑定的 DDoS 高防实例 ID。

ddoscoo-cn-zz11vq7j****
BasicBandwidthPackageobject

全球加速实例绑定的基础带宽包的详情。

Bandwidthinteger

基础带宽包的带宽值,单位:Mbps。

2
BandwidthTypestring

基础带宽包的带宽类型。取值:

  • Basic:标准加速带宽。

  • Enhanced:增强加速带宽。

  • Advanced:精品加速带宽。

Basic
InstanceIdstring

基础带宽包的实例 ID。

gbwp-bp1d8xk8bg139j0fw****
RegionIdstring

全球加速实例所在的地域 ID,仅取值cn-hangzhou

cn-hangzhou
InstanceChargeTypestring

全球加速实例的计费方式。

PREPAY
AcceleratorIdstring

全球加速实例 ID。

ga-bp1odcab8tmno0hdq****
Descriptionstring

全球加速实例的描述信息。

Accelerator
Bandwidthinteger

全球加速实例的带宽,单位:Mbps。

5
BandwidthBillingTypestring

带宽计费方式。

  • BandwidthPackage:按带宽包计费。
  • CDT:按流量计费。
CDT
ExpiredTimelong

全球加速实例到期时间的时间戳。

1653235200
Namestring

全球加速实例的名称。

Accelerator
CrossDomainBandwidthPackageobject

全球加速实例绑定的跨地域加速包的详情。

仅国际站返回该数组。

Bandwidthinteger

跨地域加速包的带宽值,单位:Mbps。

2
InstanceIdstring

跨地域加速包的实例 ID。

gbwp-bp1d8xk8bg139j0fw****
IpSetConfigobject

加速区域配置。

AccessModestring

加速区域接入模式。取值:

  • UserDefine:自定义就近接入模式。您可以根据业务需要,定向选择加速区域和地域,全球加速为每个加速地域提供独立的 EIP。
  • Anycast:采用自动就近接入模式。您无需配置加速区域。全球加速在全球多地域提供一个 Anycast EIP,用户可通过 Anycast EIP 从就近接入点进入阿里云加速网络。
UserDefine
ResourceGroupIdstring

资源组 ID。

rg-aekztkx4zwc****
Tagsobject []

资源标签。

Keystring

标签键。

test-key
Valuestring

标签值。

tast-value
CrossBorderModestring

用于带宽计费方式为按流量计费(CDT)的实例,显示其跨境加速类型,取值:

  • bpgPro:精品带宽跨境加速。
  • private:联通跨境专线加速。
bpgPro
CrossBorderStatusboolean

全球加速实例是否开启跨境线路功能。取值:

  • true:开启跨境线路功能,可以加速跨境线路。

  • false:关闭跨境线路功能,不可以加速跨境线路。

false
UpgradableStatusstring

全球加速实例的可升级状态。取值:

  • notUpgradable:当前实例不需要升级。
  • upgradable:当前实例可升级至最新版本。
  • upgradeFailed:当前实例执行过升级操作且升级失败。
notUpgradable
ServiceIdstring

托管实例所属的服务方 ID。

说明 仅在 ServiceManaged 参数为 True 时有效。
ALB
ServiceManagedboolean

是否为托管实例。取值:

  • true:是托管实例。
  • false:不是托管实例。
true
ServiceManagedInfosobject []

用户在此托管实例下可执行的动作策略列表。

说明
  • 仅在 ServiceManaged 参数为 True 时有效。
  • 当实例处于托管状态时,用户对实例的操作会受到限制,某些操作行为会被禁止。
  • Actionstring

    托管策略动作名称,取值:

    • Create:创建实例。

    • Update:更新当前实例。

    • Delete:删除当前实例。

    • Associate:引用/被引用当前实例。

    • UserUnmanaged:用户解托管实例

    • CreateChild:在当前实例下创建子资源

    Update
    ChildTypestring

    子资源类型,取值:

    • Listener:监听资源。

    • IpSet:加速地域资源。

    • EndpointGroup:终端节点组资源。

    • ForwardingRule:转发策略资源。

    • Endpoint:终端节点资源。

    • EndpointGroupDestination:自定义路由监听下的终端节点组协议映射资源。

    • EndpointPolicy:自定义路由监听下的终端节点通行策略资源。

    说明 仅在 Action 参数为 CreateChild 时有效
    Listener
    IsManagedboolean

    托管策略动作是否被托管,取值:

    • true:托管策略动作被托管,用户无权在托管实例下执行 Action 指定的操作。

    • false:托管策略动作未被托管,用户可在托管实例下执行 Action 指定的操作。

    false
    PageNumberinteger

    列表的页码。

    1

    示例

    正常返回示例

    JSON格式

    {
      "TotalCount": 10,
      "PageSize": 10,
      "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
      "Accelerators": [
        {
          "DnsName": "ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com",
          "Type": "无效参数",
          "SecondDnsName": "ga-bp1f609c76zg6zuna****-1.aliyunga0047.com",
          "Spec": "1",
          "State": "active",
          "CreateTime": 1650643200,
          "CenId": "cen-hjfufhjfuwff****",
          "DdosId": "ddoscoo-cn-zz11vq7j****",
          "BasicBandwidthPackage": {
            "Bandwidth": 2,
            "BandwidthType": "Basic",
            "InstanceId": "gbwp-bp1d8xk8bg139j0fw****"
          },
          "RegionId": "cn-hangzhou",
          "InstanceChargeType": "PREPAY",
          "AcceleratorId": "ga-bp1odcab8tmno0hdq****",
          "Description": "Accelerator",
          "Bandwidth": 5,
          "BandwidthBillingType": "CDT",
          "ExpiredTime": 1653235200,
          "Name": "Accelerator",
          "CrossDomainBandwidthPackage": {
            "Bandwidth": 2,
            "InstanceId": "gbwp-bp1d8xk8bg139j0fw****"
          },
          "IpSetConfig": {
            "AccessMode": "UserDefine"
          },
          "ResourceGroupId": "rg-aekztkx4zwc****",
          "Tags": [
            {
              "Key": "test-key",
              "Value": "tast-value"
            }
          ],
          "CrossBorderMode": "bpgPro",
          "CrossBorderStatus": false,
          "UpgradableStatus": "notUpgradable",
          "ServiceId": "ALB",
          "ServiceManaged": true,
          "ServiceManagedInfos": [
            {
              "Action": "Update",
              "ChildType": "Listener",
              "IsManaged": false
            }
          ]
        }
      ],
      "PageNumber": 1
    }

    错误码

    HTTP status code错误码错误信息描述
    500UnknownErrorAn error occurred while processing your request. Please try again. If the error persists, please submit a ticket.处理请求时出现错误,请稍后重试。

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

    变更历史

    变更时间变更内容概要操作
    2023-08-15OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:500
    出参OpenAPI 返回结构发生变更
    2023-07-20OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:500
    2023-06-14OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:500
    出参OpenAPI 返回结构发生变更
    2023-04-06OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:500
    出参OpenAPI 返回结构发生变更
    • 本页导读 (1)
    文档反馈