Todos os produtos
Search
Central de documentação

:ListAccelerators

Última atualização: Jul 08, 2026

Consulta instâncias do Global Accelerator (GA) que pertencem à sua conta.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringYesListAccelerators

A operação que você deseja executar. Defina o valor como ListAccelerators.

RegionIdStringYescn-hangzhou

O ID da região onde a instância do GA está implantada. Defina o valor como cn-hangzhou.

PageNumberIntegerNo1

O número da página a ser retornada. Valor padrão: 1.

PageSizeIntegerNo10

O número de entradas a serem retornadas em cada página. Valor máximo: 50. Valor padrão: 10.

AcceleratorIdStringNoga-bp1odcab8tmno0hdq****

O ID da instância do GA.

StateStringNoactive

O status da instância do GA. Valores válidos:

  • init: A instância do GA está sendo inicializada.
  • active: A instância do GA está disponível.
  • configuring: A instância do GA está sendo configurada.
  • binding: A instância do GA está sendo associada.
  • unbinding: A instância do GA está sendo desassociada.
  • deleting: A instância do GA está sendo excluída.
  • finacialLocked: A instância do GA está bloqueada devido a pagamentos em atraso.
ResourceGroupIdStringNorg-aekztkx4zwc****

O ID do grupo de recursos.

Tag.N.KeyStringNotag-key

A chave de tag do recurso. A chave de tag não pode ser uma string vazia.

A chave de tag pode ter até 64 caracteres e não pode conter http:// ou https://. Ela não pode começar com aliyun ou acs:.

Você pode especificar até 20 chaves de tag.

Tag.N.ValueStringNotag-value

O valor de tag do recurso. O valor de tag pode ser uma string vazia.

O valor de tag pode ter até 128 caracteres e não pode começar com acs: ou aliyun. O valor de tag não pode conter http:// ou https://.

Você pode especificar até 20 valores de tag.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
TotalCountInteger10

O número total de entradas retornadas.

PageSizeInteger10

O número de entradas retornadas em cada página.

RequestIdStringDE77A7F3-3B74-41C0-A5BC-CAFD188C28B6

O ID da solicitação.

AcceleratorsArray of Accelerators

As informações sobre as instâncias do GA.

DnsNameStringga-bp15u1i2hmtbk8c3i****.aliyunga0019.com

O nome canônico (CNAME) atribuído à instância do GA.

TypeStringInvalid parameter

Um parâmetro inválido.

SecondDnsNameStringga-bp1f609c76zg6zuna****-1.aliyunga0047.com

O CNAME usado para associar a instância do GA a uma instância do Anti-DDoS Pro/Premium.

SpecString1

A especificação da instância do GA. Valores válidos:

  • 1: Small Ⅰ
  • 2: Small Ⅱ
  • 3: Small Ⅲ
  • 5: Medium Ⅰ
  • 8: Medium Ⅱ
  • 10: Medium Ⅲ
  • 20: Large Ⅰ
  • 30: Large Ⅱ
  • 40: Large Ⅲ
  • 50: Large Ⅳ
  • 60: Large Ⅴ
  • 70: Large Ⅵ
  • 80: Large VⅡ
  • 90: Large VⅢ
  • 100: Super Large Ⅰ
  • 200: Super Large Ⅱ
Nota As instâncias do GA de Large III e acima não estão disponíveis por padrão. Para usar essas instâncias, entre em contato com seu gerente de conta da Alibaba Cloud.

Cada especificação de instância fornece capacidades diferentes. Para mais informações, consulte Especificações de instância.

StateStringactive

O status da instância do GA. Valores válidos:

  • init: A instância do GA está sendo inicializada.
  • active: A instância do GA está disponível.
  • configuring: A instância do GA está sendo configurada.
  • binding: A instância do GA está sendo associada.
  • unbinding: A instância do GA está sendo desassociada.
  • deleting: A instância do GA está sendo excluída.
  • finacialLocked: A instância do GA está bloqueada devido a pagamentos em atraso.
CreateTimeLong1650643200

O timestamp que indica o momento em que a instância do GA foi criada.

CenIdStringcen-hjfufhjfuwff****

O ID da instância do Cloud Enterprise Network (CEN) associada à instância do GA.

DdosIdStringddoscoo-cn-zz11vq7j****

O ID da instância do Anti-DDoS Pro/Premium associada à instância do GA.

BasicBandwidthPackageObject

Os detalhes sobre o plano de largura de banda básico associado à instância do GA.

BandwidthInteger2

O valor de largura de banda do plano de largura de banda básico. Unidade: Mbit/s.

BandwidthTypeStringBasic

O tipo de largura de banda fornecido pelo plano de largura de banda básico. Valores válidos:

  • Basic: padrão
  • Enhanced: aprimorado
  • Advanced: premium
InstanceIdStringgbwp-bp1d8xk8bg139j0fw****

O ID do plano de largura de banda básico.

RegionIdStringcn-hangzhou

O ID da região onde a instância do GA está implantada. cn-hangzhou é retornado.

InstanceChargeTypeStringPREPAY

O método de cobrança da instância do GA. Apenas PREPAY é retornado. Esse valor indica o método de cobrança por assinatura.

AcceleratorIdStringga-bp1odcab8tmno0hdq****

O ID da instância do GA.

DescriptionStringAccelerator

A descrição da instância do GA.

BandwidthInteger5

O valor de largura de banda da instância do GA. Unidade: Mbit/s.

BandwidthBillingTypeStringCDT

O método de cobrança de largura de banda.

  • BandwidthPackage: cobrado com base em planos de largura de banda.
  • CDT: cobrado com base na transferência de dados.
ExpiredTimeLong1653235200

O timestamp que indica o momento em que a instância do GA expira.

NameStringAccelerator

O nome da instância do GA.

CrossDomainBandwidthPackageObject

Os detalhes sobre o plano de largura de banda de aceleração entre regiões associado à instância do GA.

Este array é retornado apenas para instâncias do GA criadas no site internacional (alibabacloud.com).

BandwidthInteger2

A largura de banda fornecida pelo plano de largura de banda de aceleração entre regiões. Unidade: Mbit/s.

InstanceIdStringgbwp-bp1d8xk8bg139j0fw****

O ID do plano de largura de banda de aceleração entre regiões.

IpSetConfigObject

As configurações da área de aceleração.

AccessModeStringUserDefine

O modo de acesso da área de aceleração. Valores válidos:

  • UserDefine: modo de acesso por proximidade personalizado. Selecione áreas de aceleração e regiões com base em suas necessidades de negócio. O GA aloca um EIP separado para cada região de aceleração.
  • Anycast: modo de acesso por proximidade automático. Não é necessário especificar uma área de aceleração. O GA aloca um EIP Anycast para múltiplas regiões em todo o mundo. Os usuários podem se conectar ao ponto de acesso mais próximo da rede de transmissão global da Alibaba Cloud enviando solicitações ao EIP Anycast.
ResourceGroupIdStringrg-aekztkx4zwc****

O ID do seu grupo de recursos da Alibaba Cloud.

TagsArray of Tags

A tag da instância.

KeyStringtest-key

A chave de tag.

ValueStringtast-value

O valor de tag.

CrossBorderModeStringbpgPro

O tipo de aceleração entre fronteiras. Este parâmetro é retornado para instâncias do GA com pagamento por transferência de dados cujo faturamento é gerenciado pelo Cloud Data Transfer (CDT). Valores válidos:

bpgPro: linhas BGP Pro

PageNumberInteger1

O número da página retornada.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=ListAccelerators
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&AcceleratorId=ga-bp1odcab8tmno0hdq****
&State=active
&ResourceGroupId=rg-aekztkx4zwc****
&Tag=[{"Key":"tag-key","Value":"tag-value"}]
&Common request parameters

Respostas de exemplo bem-sucedidas

XML formato

HTTP/1.1 200 OK
Content-Type:application/xml

<ListAcceleratorsResponse>
    <TotalCount>10</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6</RequestId>
    <Accelerators>
        <DnsName>ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com</DnsName>
        <Type>Invalid parameter</Type>
        <SecondDnsName>ga-bp1f609c76zg6zuna****-1.aliyunga0047.com</SecondDnsName>
        <Spec>1</Spec>
        <State>active</State>
        <CreateTime>1650643200</CreateTime>
        <CenId>cen-hjfufhjfuwff****</CenId>
        <DdosId>ddoscoo-cn-zz11vq7j****</DdosId>
        <BasicBandwidthPackage>
            <Bandwidth>2</Bandwidth>
            <BandwidthType>Basic</BandwidthType>
            <InstanceId>gbwp-bp1d8xk8bg139j0fw****</InstanceId>
        </BasicBandwidthPackage>
        <RegionId>cn-hangzhou</RegionId>
        <InstanceChargeType>PREPAY</InstanceChargeType>
        <AcceleratorId>ga-bp1odcab8tmno0hdq****</AcceleratorId>
        <Description>Accelerator</Description>
        <Bandwidth>5</Bandwidth>
        <BandwidthBillingType>CDT</BandwidthBillingType>
        <ExpiredTime>1653235200</ExpiredTime>
        <Name>Accelerator</Name>
        <CrossDomainBandwidthPackage>
            <Bandwidth>2</Bandwidth>
            <InstanceId>gbwp-bp1d8xk8bg139j0fw****</InstanceId>
        </CrossDomainBandwidthPackage>
        <IpSetConfig>
            <AccessMode>UserDefine</AccessMode>
        </IpSetConfig>
        <ResourceGroupId>rg-aekztkx4zwc****</ResourceGroupId>
        <Tags>
            <Key>test-key</Key>
            <Value>tast-value</Value>
        </Tags>
        <CrossBorderMode>bpgPro</CrossBorderMode>
    </Accelerators>
    <PageNumber>1</PageNumber>
</ListAcceleratorsResponse>

JSON formato

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 10,
  "PageSize" : 10,
  "RequestId" : "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "Accelerators" : [ {
    "DnsName" : "ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com",
    "Type": "Invalid parameter".
    "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"
  } ],
  "PageNumber" : 1
}

Códigos de erro

HttpCodeCódigo de erroMensagem de erroDescrição
500UnknownErrorAn error occurred while processing your request. Please try again. If the error persists, please submit a ticket.A mensagem de erro retornada porque ocorreu um erro ao processar a solicitação. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro de serviço.