ListAccelerators - Global Accelerator: Central de Documentação do Alibaba Cloud

Consulta uma lista de instâncias do Global Accelerator.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ga:ListAccelerators

list

*Accelerator

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId `deprecated`	string	Sim	O ID da região da instância do Global Accelerator. Defina o valor como cn-hangzhou.	cn-hangzhou
PageNumber	integer	Não	O número da página. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valor máximo: 50. Valor padrão: 10.	10
AcceleratorId	string	Não	O ID da instância do Global Accelerator.	ga-bp1odcab8tmno0hdq****
State	string	Não	O estado da instância do Global Accelerator. Valores válidos: init: A instância está sendo inicializada. active: A instância está ativa. configuring: A instância está sendo configurada. binding: A instância está sendo vinculada. unbinding: A instância está sendo desvinculada. deleting: A instância está sendo excluída. finacialLocked: A instância está bloqueada devido a um pagamento em atraso.	active
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-aekztkx4zwc****
Tag	array<object>	Não	As tags do recurso.
	object	Não	As tags do recurso.
Key	string	Não	A chave da tag do recurso do Global Accelerator. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Você pode especificar até 20 chaves de tag.	tag-key
Value	string	Não	O valor da tag do recurso do Global Accelerator. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Você pode especificar até 20 valores de tag.	tag-value

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta contém uma lista de itens.
TotalCount	integer	O número de entradas retornadas.	10
PageSize	integer	O número de entradas por página.	10
RequestId	string	O ID da solicitação.	DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
Accelerators	array<object>	Os detalhes das instâncias do Global Accelerator.
	array<object>	Os detalhes das instâncias do Global Accelerator.
DnsName	string	O nome canônico (CNAME) atribuído à instância do Global Accelerator.	ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com
Type	string	Este parâmetro é inválido.	None
SecondDnsName	string	O CNAME atribuído à instância do Global Accelerator após ser associada a uma instância do Anti-DDoS Pro/Premium.	ga-bp1f609c76zg6zuna****-1.aliyunga0047.com
Spec	string	O tipo de instância da instância do 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 Atualmente, os tipos de instância Large III e superiores estão disponíveis apenas para usuários na lista de permissões. Para usar esses tipos de instância, entre em contato com o gerente da sua conta. Diferentes tipos de instância têm diferentes definições. Para mais informações, consulte Tipos de instância.	1
State	string	O estado da instância do Global Accelerator. Valores válidos: init: A instância está sendo inicializada. active: A instância está ativa. configuring: A instância está sendo configurada. binding: A instância está sendo vinculada. unbinding: A instância está sendo desvinculada. deleting: A instância está sendo excluída. finacialLocked: A instância está bloqueada devido a um pagamento em atraso.	active
CreateTime	integer	O carimbo de data/hora que indica quando a instância do Global Accelerator foi criada.	1650643200
CenId	string	A instância do Cloud Enterprise Network (CEN) que está vinculada à instância do Global Accelerator.	cen-hjfufhjfuwff****
DdosId `deprecated`	string	O ID da instância do Anti-DDoS Pro/Premium que está associada à instância do Global Accelerator.	ddoscoo-cn-zz11vq7j****
BasicBandwidthPackage	object	Os detalhes do plano de largura de banda básico que está associado à instância do Global Accelerator.
Bandwidth	integer	The bandwidth of the basic bandwidth plan. Unit: Mbit/s.	2
BandwidthType	string	The type of the bandwidth. Valid values: Basic: standard acceleration bandwidth. Enhanced: enhanced acceleration bandwidth. Advanced: premium acceleration bandwidth.	Basic
InstanceId	string	The ID of the basic bandwidth plan.	gbwp-bp1d8xk8bg139j0fw****
RegionId `deprecated`	string	O ID da região da instância do Global Accelerator. O valor é definido como cn-hangzhou.	cn-hangzhou
InstanceChargeType	string	O método de cobrança da instância do Global Accelerator.	PREPAY
AcceleratorId	string	O ID da instância do Global Accelerator.	ga-bp1odcab8tmno0hdq****
Description	string	A descrição da instância do Global Accelerator.	Accelerator
Bandwidth	integer	A largura de banda da instância do Global Accelerator. Unidade: Mbit/s.	5
BandwidthBillingType	string	O método de cobrança da largura de banda. BandwidthPackage: pagamento por plano de largura de banda. CDT: pagamento por transferência de dados.	CDT
ExpiredTime	integer	O carimbo de data/hora que indica quando a instância do Global Accelerator expira.	1653235200
Name	string	O nome da instância do Global Accelerator.	Accelerator
CrossDomainBandwidthPackage	object	Os detalhes do plano de largura de banda de aceleração entre domínios que está associado à instância do Global Accelerator. Esta matriz é retornada apenas pelo site internacional do Alibaba Cloud (www.alibabacloud.com).
Bandwidth	integer	The bandwidth of the cross-domain acceleration bandwidth plan. Unit: Mbit/s.	2
InstanceId	string	The ID of the cross-domain acceleration bandwidth plan.	gbwp-bp1d8xk8bg139j0fw****
IpSetConfig	object	A configuração da área de aceleração.
AccessMode	string	The access mode of the acceleration area. Valid values: UserDefine: custom nearby access mode. You can select acceleration areas and regions based on your business needs. Global Accelerator provides a separate elastic IP address (EIP) for each acceleration region. Anycast: automatic nearby access mode. You do not need to configure an acceleration area. Global Accelerator provides an Anycast EIP for multiple regions across the globe. Users can connect to the nearest access point of the Alibaba Cloud network using the Anycast EIP.	UserDefine
ResourceGroupId	string	O ID do grupo de recursos.	rg-aekztkx4zwc****
Tags	array<object>	As tags do recurso.
	object	As tags do recurso.
Key	string	The tag key.	test-key
Value	string	The tag value.	tast-value
CrossBorderMode	string	O tipo de aceleração transfronteiriça para a instância que usa o método de cobrança por transferência de dados. Valores válidos: bpgPro: largura de banda premium para aceleração transfronteiriça. private: Linha dedicada para aceleração entre domínios.	bpgPro
CrossBorderStatus	boolean	Indica se a transferência de dados transfronteiriça está ativada para a instância do Global Accelerator. Valores válidos: true: A transferência de dados transfronteiriça está ativada, o que pode acelerar a transferência de dados entre fronteiras. false: A transferência de dados transfronteiriça está desativada, o que não pode acelerar a transferência de dados entre fronteiras.	false
UpgradableStatus	string	O status de atualização da instância do Global Accelerator. Valores válidos: notUpgradable: A instância não precisa ser atualizada. upgradable: A instância pode ser atualizada para a versão mais recente. upgradeFailed: Falha ao atualizar a instância.	notUpgradable
ServiceId	string	O ID do serviço que gerencia a instância. Nota Este parâmetro é retornado apenas quando ServiceManaged está definido como True.	ALB
ServiceManaged	boolean	Indica se a instância é uma instância gerenciada. Valores válidos: true: A instância é uma instância gerenciada. false: A instância não é uma instância gerenciada.	true
ServiceManagedInfos	array<object>	As ações que você pode executar na instância gerenciada. Nota Este parâmetro é retornado apenas quando ServiceManaged está definido como True. Quando a instância está em um estado gerenciado, você tem permissões limitadas para executar operações na instância.
	object	As ações que você pode executar na instância gerenciada.
Action	string	The name of the action on the managed instance. Valid values: Create: create an instance. Update: update the current instance. Delete: delete the current instance. Associate: associate the instance with other resources. UserUnmanaged: disassociate the instance from the service. CreateChild: create a child resource in the instance.	Update
ChildType	string	The type of the child resource. Valid values: Listener: listener. IpSet: acceleration region. EndpointGroup: endpoint group. ForwardingRule: forwarding rule. Endpoint: endpoint. EndpointGroupDestination: protocol mapping of an endpoint group associated with a custom routing listener. EndpointPolicy: traffic policy of an endpoint associated with a custom routing listener. Nota This parameter is returned only when Action is set to CreateChild.	Listener
IsManaged	boolean	Indicates whether the specified action is managed. Valid values: true: The specified action is managed, and you cannot perform the specified action on the managed instance. false: The specified action is not managed, and you can perform the specified action on the managed instance.	false
DdosConfigList	array<object>	A lista de configurações do Anti-DDoS Pro/Premium.
	object
DdosId	string	The ID of the Anti-DDoS Pro/Premium instance.	ddoscoo-cn-a8w4ekcb**
DdosRegionId	string	The region ID of the Anti-DDoS Pro/Premium instance.	cn-hangzhou
PageNumber	integer	O número da página.	1

Exemplos

Resposta de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
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 Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.