Todos los productos
Search
Centro de documentos

Global Accelerator:ListAccelerators

Última actualización: Sep 01, 2026

Consulta una lista de instancias de Global Accelerator.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ga:ListAccelerators

list

*Accelerator

acs:ga:{#regionId}:{#accountId}:ga/*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

RegionId deprecated

string

Sí

El ID de la región de la instancia de Global Accelerator. Establezca el valor en cn-hangzhou.

cn-hangzhou

PageNumber

integer

No

El número de página. Valor predeterminado: 1.

1

PageSize

integer

No

El número de entradas por página. Valor máximo: 50. Valor predeterminado: 10.

10

AcceleratorId

string

No

El ID de la instancia de Global Accelerator.

ga-bp1odcab8tmno0hdq****

State

string

No

El estado de la instancia de Global Accelerator. Valores válidos:

  • init: La instancia se está inicializando.

  • active: La instancia está activa.

  • configuring: La instancia se está configurando.

  • binding: La instancia se está vinculando.

  • unbinding: La instancia se está desvinculando.

  • deleting: La instancia se está eliminando.

  • finacialLocked: La instancia está bloqueada debido a un pago vencido.

active

ResourceGroupId

string

No

El ID del grupo de recursos.

rg-aekztkx4zwc****

Tag

array<object>

No

Las etiquetas del recurso.

object

No

Las etiquetas del recurso.

Key

string

No

La clave de etiqueta del recurso de Global Accelerator. La clave de etiqueta no puede ser una cadena vacía.

La clave de etiqueta puede tener hasta 64 caracteres de longitud y no puede comenzar con aliyun o acs:. No puede contener http:// o https://.

Puede especificar hasta 20 claves de etiqueta.

tag-key

Value

string

No

El valor de etiqueta del recurso de Global Accelerator. El valor de etiqueta puede ser una cadena vacía.

El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con aliyun o acs:. No puede contener http:// o https://.

Puede especificar hasta 20 valores de etiqueta.

tag-value

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

La respuesta contiene una lista de elementos.

TotalCount

integer

El número de entradas devueltas.

10

PageSize

integer

El número de entradas por página.

10

RequestId

string

El ID de la solicitud.

DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6

Accelerators

array<object>

Los detalles de las instancias de Global Accelerator.

array<object>

Los detalles de las instancias de Global Accelerator.

DnsName

string

El nombre canónico (CNAME) asignado a la instancia de Global Accelerator.

ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com

Type

string

Este parámetro no es válido.

None

SecondDnsName

string

El CNAME que se asigna a la instancia de Global Accelerator después de asociarla con una instancia de Anti-DDoS Pro/Premium.

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

Spec

string

El tipo de instancia de la instancia de Global Accelerator. Valores válidos:

  • 1: Small I

  • 2: Small II

  • 3: Small III

  • 5: Medium I

  • 8: Medium II

  • 10: Medium III

  • 20: Large I

  • 30: Large II

  • 40: Large III

  • 50: Large IV

  • 60: Large V

  • 70: Large VI

  • 80: Large VII

  • 90: Large VIII

  • 100: Extra Large I

  • 200: Extra Large II

Nota

Actualmente, los tipos de instancia Large III y superiores están disponibles solo para usuarios en la lista blanca. Para utilizar estos tipos de instancia, póngase en contacto con su administrador de cuenta.

Los diferentes tipos de instancia tienen distintas definiciones. Para obtener más información, consulte Tipos de instancia.

1

State

string

El estado de la instancia de Global Accelerator. Valores válidos:

  • init: La instancia se está inicializando.

  • active: La instancia está activa.

  • configuring: La instancia se está configurando.

  • binding: La instancia se está vinculando.

  • unbinding: La instancia se está desvinculando.

  • deleting: La instancia se está eliminando.

  • finacialLocked: La instancia está bloqueada debido a un pago vencido.

active

CreateTime

integer

La marca de tiempo que indica cuándo se creó la instancia de Global Accelerator.

1650643200

CenId

string

La instancia de Cloud Enterprise Network (CEN) que está vinculada a la instancia de Global Accelerator.

cen-hjfufhjfuwff****

DdosId deprecated

string

El ID de la instancia de Anti-DDoS Pro/Premium que está asociada con la instancia de Global Accelerator.

ddoscoo-cn-zz11vq7j****

BasicBandwidthPackage

object

Los detalles del plan de ancho de banda básico que está asociado con la instancia de Global Accelerator.

Bandwidth

integer

El ancho de banda del plan de ancho de banda básico. Unidad: Mbit/s.

2

BandwidthType

string

El tipo de ancho de banda. Valores válidos:

  • Basic: ancho de banda de aceleración estándar.

  • Enhanced: ancho de banda de aceleración mejorada.

  • Advanced: ancho de banda de aceleración premium.

Basic

InstanceId

string

El ID del plan de ancho de banda básico.

gbwp-bp1d8xk8bg139j0fw****

RegionId deprecated

string

El ID de la región de la instancia de Global Accelerator. El valor se establece en cn-hangzhou.

cn-hangzhou

InstanceChargeType

string

El método de facturación de la instancia de Global Accelerator.

PREPAY

AcceleratorId

string

El ID de la instancia de Global Accelerator.

ga-bp1odcab8tmno0hdq****

Description

string

La descripción de la instancia de Global Accelerator.

Accelerator

Bandwidth

integer

El ancho de banda de la instancia de Global Accelerator. Unidad: Mbit/s.

5

BandwidthBillingType

string

El método de facturación del ancho de banda.

  • BandwidthPackage: pago por plan de ancho de banda.

  • CDT: pago por transferencia de datos.

CDT

ExpiredTime

integer

La marca de tiempo que indica cuándo caduca la instancia de Global Accelerator.

1653235200

Name

string

El nombre de la instancia de Global Accelerator.

Accelerator

CrossDomainBandwidthPackage

object

Los detalles del plan de ancho de banda de aceleración entre dominios que está asociado con la instancia de Global Accelerator.

Esta matriz solo se devuelve en el sitio web internacional de Alibaba Cloud (www.alibabacloud.com).

Bandwidth

integer

El ancho de banda del plan de ancho de banda de aceleración entre dominios. Unidad: Mbit/s.

2

InstanceId

string

El ID del plan de ancho de banda de aceleración entre dominios.

gbwp-bp1d8xk8bg139j0fw****

IpSetConfig

object

La configuración del área de aceleración.

AccessMode

string

El modo de acceso del área de aceleración. Valores válidos:

  • UserDefine: modo de acceso cercano personalizado. Puede seleccionar áreas y regiones de aceleración según sus necesidades comerciales. Global Accelerator proporciona una dirección IP elástica (EIP) independiente para cada región de aceleración.

  • Anycast: modo de acceso cercano automático. No necesita configurar un área de aceleración. Global Accelerator proporciona una EIP Anycast para múltiples regiones en todo el mundo. Los usuarios pueden conectarse al punto de acceso más cercano de la red de Alibaba Cloud mediante la EIP Anycast.

UserDefine

ResourceGroupId

string

El ID del grupo de recursos.

rg-aekztkx4zwc****

Tags

array<object>

Las etiquetas del recurso.

object

Las etiquetas del recurso.

Key

string

La clave de etiqueta.

test-key

Value

string

El valor de etiqueta.

tast-value

CrossBorderMode

string

El tipo de aceleración transfronteriza para la instancia que utiliza el método de facturación por transferencia de datos. Valores válidos:

  • bpgPro: ancho de banda premium para aceleración transfronteriza.

  • private: Línea dedicada para aceleración entre dominios.

bpgPro

CrossBorderStatus

boolean

Indica si la transferencia de datos transfronteriza está habilitada para la instancia de Global Accelerator. Valores válidos:

  • true: La transferencia de datos transfronteriza está habilitada, lo que permite acelerar la transferencia de datos a través de fronteras.

  • false: La transferencia de datos transfronteriza está deshabilitada, por lo que no se puede acelerar la transferencia de datos a través de fronteras.

false

UpgradableStatus

string

El estado de actualización de la instancia de Global Accelerator. Valores válidos:

  • notUpgradable: La instancia no necesita actualizarse.

  • upgradable: La instancia se puede actualizar a la versión más reciente.

  • upgradeFailed: Error al actualizar la instancia.

notUpgradable

ServiceId

string

El ID del servicio que administra la instancia.

Nota

Este parámetro se devuelve solo cuando ServiceManaged se establece en True.

ALB

ServiceManaged

boolean

Indica si la instancia es una instancia administrada. Valores válidos:

  • true: La instancia es una instancia administrada.

  • false: La instancia no es una instancia administrada.

true

ServiceManagedInfos

array<object>

Las acciones que puede realizar en la instancia administrada.

Nota
  • Este parámetro se devuelve solo cuando ServiceManaged se establece en True.

  • Cuando la instancia se encuentra en estado administrado, tiene permisos limitados para realizar operaciones en la instancia.

object

Las acciones que puede realizar en la instancia administrada.

Action

string

El nombre de la acción en la instancia administrada. Valores válidos:

  • Create: crear una instancia.

  • Update: actualizar la instancia actual.

  • Delete: eliminar la instancia actual.

  • Associate: asociar la instancia con otros recursos.

  • UserUnmanaged: desasociar la instancia del servicio.

  • CreateChild: crear un recurso secundario en la instancia.

Update

ChildType

string

El tipo de recurso secundario. Valores válidos:

  • Listener: listener.

  • IpSet: región de aceleración.

  • EndpointGroup: grupo de endpoints.

  • ForwardingRule: regla de reenvío.

  • Endpoint: endpoint.

  • EndpointGroupDestination: asignación de protocolo de un grupo de endpoints asociado con un listener de enrutamiento personalizado.

  • EndpointPolicy: política de tráfico de un endpoint asociado con un listener de enrutamiento personalizado.

Nota

Este parámetro se devuelve solo cuando Action se establece en CreateChild.

Listener

IsManaged

boolean

Indica si la acción especificada está administrada. Valores válidos:

  • true: La acción especificada está administrada y no puede realizar dicha acción en la instancia administrada.

  • false: La acción especificada no está administrada y puede realizar dicha acción en la instancia administrada.

false

DdosConfigList

array<object>

La lista de configuraciones de Anti-DDoS Pro/Premium.

object

DdosId

string

El ID de la instancia de Anti-DDoS Pro/Premium.

ddoscoo-cn-a8w4ekcb**

DdosRegionId

string

El ID de la región de la instancia de Anti-DDoS Pro/Premium.

cn-hangzhou

PageNumber

integer

El número de página.

1

Ejemplos

Respuesta exitosa

JSON Formato

{
  "TotalCount": 10,
  "PageSize": 10,
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "Accelerators": [
    {
      "DnsName": "ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com",
      "Type": "None",
      "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
        }
      ],
      "DdosConfigList": [
        {
          "DdosId": "ddoscoo-cn-a8w4ekcb**",
          "DdosRegionId": "cn-hangzhou"
        }
      ]
    }
  ],
  "PageNumber": 1
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

500 UnknownError An error occurred while processing your request. Please try again. If the error persists, please submit a ticket. An error occurred while the request was being processed. Try again later.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.