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

Consulta a lista de regiões de aceleração para uma instância específica do Global Accelerator (GA).

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:ListIpSets

list

*IpSet

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	A região onde a instância do Global Accelerator (GA) está implantada. Defina o valor como cn-hangzhou.	cn-hangzhou
PageNumber	integer	Não	O número da página da lista. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para uma consulta paginada. Valor máximo: 100. Valor padrão: 10.	10
AcceleratorId	string	Sim	O ID da instância do Global Accelerator (GA).	ga-bp1yeeq8yfoyszmqy****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
TotalCount	integer	O número total de entradas na lista.	2
PageSize	integer	O número de entradas por página em uma consulta paginada.	10
RequestId	string	O ID da solicitação.	A9B4E54C-9CCD-4002-91A9-D38C6C209192
PageNumber	integer	O número da página da lista.	1
IpSets	array<object>	A lista de instâncias de área de aceleração.
	array<object>	A lista de instâncias de área de aceleração.
AccelerateRegionId	string	O ID da área de aceleração.	cn-hangzhou
IpVersion	string	A versão do protocolo de endereço IP. Valores válidos: IPv4 IPv6 DUAL_STACK	IPv4
Bandwidth	integer	A largura de banda alocada para a área de aceleração. Unidade: Mbps.	2
IspType	string	O tipo de linha da área de aceleração. Valores válidos: BGP (padrão): linhas BGP (multi-ISP). BGP_PRO: linhas premium BGP (multi-ISP).	BGP
State	string	O status da área de aceleração. Valores válidos: init: Inicializando. active: Em execução. updating: Configurando. deleting: Excluindo.	active
IpSetId	string	O ID da instância da região de aceleração.	ips-bp11r5jb8ogp122xl****
IpAddressList	array	A lista de endereços IP acelerados.
	string	A lista de endereços IP acelerados.	121.43..XX.XX
ServiceId	string	O ID do serviço ao qual a instância gerenciada pertence. Nota Este parâmetro é válido apenas quando ServiceManaged está definido como True.	ALB
ServiceManaged	boolean	Indica se a instância é gerenciada. Valores válidos: true: A instância é gerenciada. false: A instância não é gerenciada.	true
ServiceManagedInfos	array<object>	A lista de políticas de ação que o usuário pode executar na instância gerenciada. Nota Este parâmetro é válido apenas quando ServiceManaged está definido como True. Quando a instância está no estado gerenciado, as operações do usuário na instância são restritas e certas ações são proibidas.
	object	A lista de políticas de ação que o usuário pode executar na instância gerenciada.
Action	string	O nome da ação da política gerenciada. Valores válidos: Create: Criar uma instância. Update: Atualizar a instância atual. Delete: Excluir a instância atual. Associate: Referenciar ou ser referenciado pela instância atual. UserUnmanaged: Deixar de gerenciar a instância. CreateChild: Criar um recurso filho sob a instância atual.	Update
ChildType	string	O tipo do recurso filho. Valores válidos: Listener: recurso de listener. IpSet: recurso de região de aceleração. EndpointGroup: recurso de grupo de endpoints. ForwardingRule: recurso de regra de encaminhamento. Endpoint: recurso de endpoint. EndpointGroupDestination: recurso de mapeamento de protocolo do grupo de endpoints sob um listener de roteamento personalizado. EndpointPolicy: recurso de política de tráfego do endpoint sob 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 da política gerenciada é gerenciada. Valores válidos: true: A ação da política gerenciada é gerenciada. O usuário não pode executar a ação especificada por Action na instância gerenciada. false: A ação da política gerenciada não é gerenciada. O usuário pode executar a ação especificada por Action na instância gerenciada.	false

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 2,
  "PageSize": 10,
  "RequestId": "A9B4E54C-9CCD-4002-91A9-D38C6C209192",
  "PageNumber": 1,
  "IpSets": [
    {
      "AccelerateRegionId": "cn-hangzhou",
      "IpVersion": "IPv4",
      "Bandwidth": 2,
      "IspType": "BGP",
      "State": "active",
      "IpSetId": "ips-bp11r5jb8ogp122xl****",
      "IpAddressList": [
        "121.43..XX.XX"
      ],
      "ServiceId": "ALB",
      "ServiceManaged": true,
      "ServiceManagedInfos": [
        {
          "Action": "Update",
          "ChildType": "Listener",
          "IsManaged": false
        }
      ]
    }
  ]
}

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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.