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

Consulta informações sobre uma instância especificada 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:DescribeAccelerator

get

*Accelerator

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId `deprecated`	string	Sim	A região onde a instância do Global Accelerator está implantada. Defina o valor como cn-hangzhou.	cn-hangzhou
AcceleratorId	string	Sim	O ID da instância do Global Accelerator que você deseja consultar.	ga-bp1odcab8tmno0hdq****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações retornadas.
DdosId `deprecated`	string	O ID da instância Anti-DDoS associada à instância do Global Accelerator.	ddoscoo-cn-zz11vq7j****
DnsName	string	O nome canônico (CNAME) atribuído à instância do Global Accelerator.	ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com
Description	string	A descrição da instância do Global Accelerator.	Accelerator
RequestId	string	O ID da solicitação.	6FEA0CF3-D3B9-43E5-A304-D217037876A8
InstanceChargeType	string	O método de cobrança da instância do Global Accelerator.	PREPAY
CreateTime	integer	O carimbo de data/hora que indica quando a instância do Global Accelerator foi criada.	1650643200
CrossDomainBandwidthPackage	object	Os detalhes do plano de largura de banda entre regiões associado à instância do Global Accelerator. Este parâmetro é retornado apenas pelo site internacional da Alibaba Cloud (www.alibabacloud.com).
Bandwidth	integer	A largura de banda do plano de largura de banda entre regiões. Unidade: Mbps.	2
InstanceId	string	O ID do plano de largura de banda entre regiões.	gbwp-bp1d8xk8bg139j0fw****
SecondDnsName	string	O CNAME da instância Anti-DDoS associada à instância do Global Accelerator.	ga-bp1f609c76zg6zuna****-1.aliyunga0047.com
Name	string	O nome da instância do Global Accelerator.	Accelerator
BasicBandwidthPackage	object	Os detalhes do plano de largura de banda básico associado à instância do Global Accelerator.
Bandwidth	integer	A largura de banda do plano de largura de banda básico. Unidade: Mbps.	2
BandwidthType	string	O tipo de largura de banda do plano de largura de banda básico. Valores válidos: Basic: largura de banda de aceleração padrão. Enhanced: largura de banda de aceleração aprimorada. Advanced: largura de banda de aceleração premium.	Basic
InstanceId	string	O ID do plano de largura de banda básico.	gbwp-bp1d8xk8bg139j0fw****
State	string	O status da instância do Global Accelerator. Valores válidos: init: A instância está sendo inicializada. active: A instância está disponível. configuring: A instância está sendo configurada. binding: A instância está sendo associada. unbinding: A instância está sendo desassociada. deleting: A instância está sendo excluída. finacialLocked: A instância está bloqueada financeiramente.	active
ExpiredTime	integer	O carimbo de data/hora que indica quando a instância do Global Accelerator expira.	1653235200
CenId	string	O ID da instância da Cloud Enterprise Network (CEN) associada à instância do Global Accelerator.	cen-hjkduu767hc****
RegionId `deprecated`	string	A região onde a instância do Global Accelerator está implantada.	cn-hangzhou
Spec	string	A especificação 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: Super Large I. 200: Super Large II. Nota As especificações Large III e superiores estão disponíveis apenas para usuários na lista de permissões. Para usar essas especificações, entre em contato com o gerente da sua conta. As definições de diferentes especificações variam. Para mais informações, consulte Especificações da instância.	1
AcceleratorId	string	O ID da instância do Global Accelerator.	ga-bp1odcab8tmno0hdq****
BandwidthBillingType	string	O método de cobrança da largura de banda. Valores válidos: BandwidthPackage: pagamento por plano de largura de banda. CDT: pagamento por transferência de dados.	CDT
IpSetConfig	object	A configuração da área de aceleração.
AccessMode	string	O modo de acesso da área de aceleração. Valores válidos: UserDefine: personalizado. Você pode selecionar áreas e regiões de aceleração com base nas necessidades do seu negócio. O Global Accelerator fornece um elastic IP address (EIP) separado para cada região de aceleração. Anycast: automático. Você não precisa configurar uma área de aceleração. O Global Accelerator fornece um EIP Anycast para várias regiões. Os usuários podem se conectar ao ponto de acesso mais próximo da rede da Alibaba Cloud usando o EIP Anycast.	UserDefine
CrossPrivateState	string	Indica se a largura de banda entre fronteiras está ativada. true: ativada. false: desativada.	false
ResourceGroupId	string	O ID do grupo de recursos.	rg-acfmw2vwdbujqbq
Tags	array<object>	As tags do recurso.
	object	A tag do recurso.
Key	string	A chave da tag.	tag-key
Value	string	O valor da tag.	tag-value
CrossBorderMode	string	O tipo de aceleração entre fronteiras. Este parâmetro é retornado para instâncias com pagamento por transferência de dados. bpgPro: largura de banda premium para aceleração entre fronteiras.	bpgPro
CrossBorderStatus	boolean	Indica se o recurso de linha entre fronteiras está ativado para a instância do Global Accelerator. Valores válidos: true: O recurso de linha entre fronteiras está ativado. Você pode usar o Global Accelerator para acelerar a transmissão de dados entre fronteiras. false: O recurso de linha entre fronteiras está desativado. Você não pode usar o Global Accelerator para acelerar a transmissão 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. upgradeFailed: Falha ao atualizar a instância.	notUpgradable
ServiceId	string	O ID do serviço que gerencia a instância. Nota Este parâmetro é válido 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 realizar na instância gerenciada. Nota Este parâmetro é válido apenas quando ServiceManaged está definido como True. Quando a instância é gerenciada, você não pode realizar algumas operações na instância.
	object	As ações que você pode realizar na instância gerenciada.
Action	string	O nome da ação na instância gerenciada. Valores válidos: Create: cria uma instância. Update: atualiza a instância atual. Delete: exclui a instância atual. Associate: associa a instância a outros recursos. UserUnmanaged: remove o gerenciamento da instância. CreateChild: cria um recurso filho na instância.	Update
ChildType	string	O tipo do recurso filho. Valores válidos: Listener: listener. IpSet: região de aceleração. EndpointGroup: grupo de endpoints. ForwardingRule: regra de encaminhamento. Endpoint: endpoint. EndpointGroupDestination: mapeamento de protocolo de um grupo de endpoints associado a um listener de roteamento personalizado. EndpointPolicy: política de acesso de um endpoint associado a um listener de roteamento personalizado. Nota Este parâmetro é válido apenas quando Action está definido como CreateChild.	Listener
IsManaged	boolean	Indica se a ação especificada é gerenciada. Valores válidos: true: A ação é gerenciada. Você não pode realizar a ação especificada na instância gerenciada. false: A ação não é gerenciada. Você pode realizar a ação especificada na instância gerenciada.	false
DdosConfigList	array<object>	A lista de instâncias Anti-DDoS associadas à instância do Global Accelerator.
	object
DdosId	string	O ID da instância Anti-DDoS associada à instância do Global Accelerator.	ddoscoo-cn-zz11vq7j****
DdosRegionId	string	A região onde a instância Anti-DDoS está implantada. Valores válidos: cn-hangzhou: parte continental da China. ap-southeast-1: fora da parte continental da China.	ap-southeast-1
Bandwidth	integer	A largura de banda da instância padrão do Global Accelerator. Unidade: Mbps. Nota Este parâmetro é válido apenas quando o modo de acesso da área de aceleração é Anycast.	200

Exemplos

Resposta de sucesso

JSON formato

{
  "DdosId": "ddoscoo-cn-zz11vq7j****",
  "DnsName": "ga-bp15u1i2hmtbk8c3i****.aliyunga0019.com",
  "Description": "Accelerator",
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8\t",
  "InstanceChargeType": "PREPAY",
  "CreateTime": 1650643200,
  "CrossDomainBandwidthPackage": {
    "Bandwidth": 2,
    "InstanceId": "gbwp-bp1d8xk8bg139j0fw****"
  },
  "SecondDnsName": "ga-bp1f609c76zg6zuna****-1.aliyunga0047.com",
  "Name": "Accelerator",
  "BasicBandwidthPackage": {
    "Bandwidth": 2,
    "BandwidthType": "Basic",
    "InstanceId": "gbwp-bp1d8xk8bg139j0fw****"
  },
  "State": "active",
  "ExpiredTime": 1653235200,
  "CenId": "cen-hjkduu767hc****",
  "RegionId": "cn-hangzhou",
  "Spec": "1",
  "AcceleratorId": "ga-bp1odcab8tmno0hdq****",
  "BandwidthBillingType": "CDT",
  "IpSetConfig": {
    "AccessMode": "UserDefine"
  },
  "CrossPrivateState": "false",
  "ResourceGroupId": "rg-acfmw2vwdbujqbq",
  "Tags": [
    {
      "Key": "tag-key",
      "Value": "tag-value"
    }
  ],
  "CrossBorderMode": "bpgPro",
  "CrossBorderStatus": false,
  "UpgradableStatus": "notUpgradable",
  "ServiceId": "ALB",
  "ServiceManaged": true,
  "ServiceManagedInfos": [
    {
      "Action": "Update",
      "ChildType": "Listener",
      "IsManaged": false
    }
  ],
  "DdosConfigList": [
    {
      "DdosId": "ddoscoo-cn-zz11vq7j****",
      "DdosRegionId": "ap-southeast-1"
    }
  ],
  "Bandwidth": 200
}

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.