DescribeIpv6Addresses - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Consulta endereços IPv6 em uma região.

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

vpc:DescribeIpv6Addresses

list

*Ipv6InternetBandwidth

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região na qual você deseja consultar endereços IPv6. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-huhehaote
Ipv6AddressId	string	Não	O ID do endereço IPv6 que você deseja consultar. Você pode inserir no máximo 20 IDs de endereços IPv6 em cada solicitação de API. Separe os IDs de endereços IPv6 com vírgulas (,).	ipv6-2zen5j4axcp5l5qyy****
Ipv6Address	string	Não	O endereço IPv6 que você deseja consultar.	2408:XXXX:153:3921:851c:c435:7b12:1c5f
Name	string	Não	O nome do endereço IPv6 que você deseja consultar. O nome deve ter de 0 a 128 caracteres e não pode começar com `http://` ou `https://`.	test
AddressType	string	Não	O tipo de endereço IP. Valores válidos: IPv6Address (padrão): indica uma instância IPv6 usada para consultar um único endereço IPv6. IPv6Prefix: indica uma instância IPv6 usada para consultar blocos CIDR de prefixo.	IPv6Address
AssociatedInstanceId	string	Não	O ID da instância à qual o endereço IPv6 está atribuído.	i-2ze72wuqj4y3jl4f****
AssociatedInstanceType	string	Não	O tipo de instância associada ao endereço IPv6. Valores válidos: EcsInstance: instância do Elastic Compute Service (ECS) em uma virtual private cloud (VPC) NetworkInterface: interface de rede elástica (ENI) secundária	EcsInstance
NetworkType	string	Não	O tipo de comunicação suportado pelo endereço IPv6. Valores válidos: Private Public	Private
VpcId	string	Não	O ID da VPC à qual o endereço IPv6 pertence.	vpc-bp15zckdt37pq72zv****
VSwitchId	string	Não	O ID do vSwitch ao qual o endereço IPv6 pertence.	vsw-25navfgbue4g****
Ipv6InternetBandwidthId	string	Não	O ID da largura de banda de Internet que você comprou para o endereço IPv6.	ipv6bw-uf6hcyzu65v98v3du****
IncludeReservationData	boolean	Não	Especifica se devem ser retornadas informações sobre pedidos pendentes. Valores válidos: false (padrão) true	false
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o gateway IPv6 pertence.	rg-bp67acfmxazb4ph****
Tag	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag N. Você pode especificar no máximo 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.	FinanceDept
Value	string	Não	O valor da tag N. O valor da tag pode ter até 128 caracteres. Pode ser uma string vazia. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://. Cada chave de tag corresponde a um valor de tag. Você pode especificar no máximo 20 valores de tag por vez.	yunke
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
RegionId	string	Sim	O ID da região na qual você deseja consultar endereços IPv6. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-huhehaote
ServiceManaged	boolean	Não	Indica se a instância é gerenciada. Valores válidos: true false Se você não especificar este parâmetro, todas as instâncias serão consultadas.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PageSize	integer	O número de entradas retornadas por página. Valor máximo: 50. Valor padrão: 10.	10
RequestId	string	O ID da solicitação.	AA4486A8-B6AE-469E-AB09-820EF8ECFA2B
PageNumber	integer	O número da página retornada. Valor padrão: 1.	1
TotalCount	integer	O número de entradas retornadas.	2
Ipv6Addresses	object
Ipv6Address	array<object>	Os detalhes do endereço IPv6.
	array<object>
VpcId	string	O ID da VPC à qual o endereço IPv6 pertence.	vpc-bp15zckdt37pq72zv****
Status	string	O status do endereço IPv6. Pending Available	Available
Ipv6AddressId	string	O ID do endereço IPv6.	ipv6-2zen5j4axcp5l5qyy****
AllocationTime	string	A hora em que o endereço IPv6 foi criado.	2020-12-20T14:56:09Z
Ipv6AddressName	string	O nome do endereço IPv6.	test
Ipv6AddressDescription	string	A descrição do endereço IPv6.	test
AssociatedInstanceType	string	O tipo de instância associada ao endereço IPv6.	EcsInstance
AssociatedInstanceId	string	O ID da instância associada ao endereço IPv6.	i-2ze72wuqj4y3jl4f****
NetworkType	string	O tipo de conexão suportado pelo endereço IPv6. Valores válidos: Private Public	Private
Ipv6Address	string	O endereço IPv6.	2408:XXXX:153:3921:851c:c435:7b12:1c5f
AddressType	string	O tipo de endereço IPv6. Valores válidos: IPv6Address (padrão): indica um único IP IPv6. IPv6Prefix: indica CIDR IPv6.	IPv6Address
Ipv6Isp	string	O ISP do endereço IPv6. Valores válidos: BGP (padrão) ChinaMobile ChinaUnicom ChinaTelecom	BGP
VSwitchId	string	O ID do vSwitch ao qual o endereço IPv6 pertence.	vsw-25navfgbue4g****
Ipv6GatewayId	string	O ID do gateway IPv6 ao qual o endereço IPv6 pertence.	ipv6gw-2zewg0l66s73b4k2q****
RealBandwidth	integer	A largura de banda de pico do endereço IPv6.	5
Ipv6InternetBandwidth	object	A largura de banda de Internet do endereço IPv6.
InternetChargeType	string	O método de cobrança da largura de banda de Internet do endereço IPv6. Valores válidos: PayByTraffic PayByBandwidth	PayByTraffic
BusinessStatus	string	O status da largura de banda de Internet do endereço IPv6. Valores válidos: Normal FinancialLocked SecurityLocked	Normal
Bandwidth	integer	A largura de banda de Internet dedicada do endereço IPv6. Unidade: Mbit/s.	5
Ipv6InternetBandwidthId	string	O ID da largura de banda de Internet do endereço IPv6.	ipv6bw-hp3b35oq1fj50kbv****
InstanceChargeType	string	O método de cobrança da largura de banda de Internet do endereço IPv6. Valores válidos: Apenas PostPaid pode ser retornado, o que indica o método de cobrança pay-as-you-go.	PostPaid
HasReservationData	boolean	Indica se os dados de renovação estão incluídos. Valores válidos: false true true é retornado apenas quando IncludeReservationData é definido como true e alguns pedidos ainda não entraram em vigor.	false
ReservationInternetChargeType	string	O método de medição usado após a renovação entrar em vigor. PayByTraffic PayByBandwidth	PayByTraffic
ReservationOrderType	string	O tipo de pedido de renovação. Apenas RENEW pode ser retornado, o que indica que o pedido foi feito para renovação do serviço.	RENEW
ReservationActiveTime	string	A hora em que a renovação entra em vigor. A hora é exibida no formato `YYYY-MM-DDThh:mm:ssZ`.	2021-05-23T16:00:00Z
ReservationBandwidth	integer	A largura de banda máxima após a renovação entrar em vigor. Unidade: Mbit/s.	12
ResourceGroupId	string	O ID do grupo de recursos ao qual o gateway IPv6 pertence.	rg-bp67acfmxazb4ph****
Tags	object
Tag	array<object>	A lista de tags.
	object	A lista de tags.
Key	string	A chave da tag. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres. A chave da tag não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	O valor da tag. O valor da tag pode ter até 128 caracteres. Pode ser uma string vazia. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`. Cada chave de tag corresponde a um valor de tag. Você pode especificar até 20 valores de tag por vez.	yunke
ServiceManaged	integer	Indica se a instância é gerenciada. Valores válidos: 1: sim 0: não	1

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": 10,
  "RequestId": "AA4486A8-B6AE-469E-AB09-820EF8ECFA2B",
  "PageNumber": 1,
  "TotalCount": 2,
  "Ipv6Addresses": {
    "Ipv6Address": [
      {
        "VpcId": "vpc-bp15zckdt37pq72zv****",
        "Status": "Available",
        "Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
        "AllocationTime": "2020-12-20T14:56:09Z",
        "Ipv6AddressName": "test",
        "Ipv6AddressDescription": "test",
        "AssociatedInstanceType": "EcsInstance",
        "AssociatedInstanceId": "i-2ze72wuqj4y3jl4f****",
        "NetworkType": "Private",
        "Ipv6Address": "2408:XXXX:153:3921:851c:c435:7b12:1c5f",
        "AddressType": "IPv6Address",
        "Ipv6Isp": "BGP",
        "VSwitchId": "vsw-25navfgbue4g****",
        "Ipv6GatewayId": "ipv6gw-2zewg0l66s73b4k2q****",
        "RealBandwidth": 5,
        "Ipv6InternetBandwidth": {
          "InternetChargeType": "PayByTraffic",
          "BusinessStatus": "Normal",
          "Bandwidth": 5,
          "Ipv6InternetBandwidthId": "ipv6bw-hp3b35oq1fj50kbv****",
          "InstanceChargeType": "PostPaid",
          "HasReservationData": false,
          "ReservationInternetChargeType": "PayByTraffic",
          "ReservationOrderType": "RENEW",
          "ReservationActiveTime": "2021-05-23T16:00:00Z",
          "ReservationBandwidth": 12
        },
        "ResourceGroupId": "rg-bp67acfmxazb4ph****",
        "Tags": {
          "Tag": [
            {
              "Key": "FinanceDept",
              "Value": "yunke"
            }
          ]
        },
        "ServiceManaged": 1
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.Ipv6Address	The param of %s is illegal.	O endereço IPv6 especificado é inválido. Verifique se sua entrada está correta.
400	IllegalParam.NetworkType	The param of %s is illegal.	O NetworkType especificado é inválido. Verifique se o valor está correto.
400	IllegalParam.AddressType	The specified AddressType is illegal.	O parâmetro AddressType especificado é inválido.
400	IllegalParamSize.AssociatedInstanceId	The param size of AssociatedInstanceId is illegal.	O comprimento do parâmetro AssociatedInstanceId é inválido.
400	MissingParam.AssociatedInstanceId	The param of AssociatedInstanceId is missing when AssociatedInstanceType is specified.	O parâmetro AssociatedInstanceId está ausente.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.