DescribeIpv6Addresses - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Consulte les adresses IPv6 dans une région.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vpc:DescribeIpv6Addresses

list

*Bande passante Internet IPv6

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région dans laquelle vous souhaitez interroger les adresses IPv6. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.	cn-huhehaote
Ipv6AddressId	string	Non	L'identifiant de l'adresse IPv6 que vous souhaitez interroger. Vous pouvez saisir jusqu'à 20 identifiants d'adresses IPv6 par requête API. Séparez les identifiants d'adresses IPv6 par des virgules (,).	ipv6-2zen5j4axcp5l5qyy****
Ipv6Address	string	Non	L'adresse IPv6 que vous souhaitez interroger.	2408:XXXX:153:3921:851c:c435:7b12:1c5f
Name	string	Non	Le nom de l'adresse IPv6 que vous souhaitez interroger.	test
AddressType	string	Non	Le type d'adresse IP. Valeurs valides :	IPv6Address
AssociatedInstanceId	string	Non	L'identifiant de l'instance à laquelle l'adresse IPv6 est attribuée.	i-2ze72wuqj4y3jl4f****
AssociatedInstanceType	string	Non	Le type d'instance associée à l'adresse IPv6. Valeurs valides :	EcsInstance
NetworkType	string	Non	Le type de communication pris en charge par l'adresse IPv6. Valeurs valides :	Private
VpcId	string	Non	L'identifiant du VPC auquel l'adresse IPv6 appartient.	vpc-bp15zckdt37pq72zv****
VSwitchId	string	Non	L'identifiant du vSwitch auquel l'adresse IPv6 appartient.	vsw-25navfgbue4g****
Ipv6InternetBandwidthId	string	Non	L'identifiant de la bande passante Internet que vous avez achetée pour l'adresse IPv6.	ipv6bw-uf6hcyzu65v98v3du****
IncludeReservationData	boolean	Non	Indique si les informations sur les commandes en attente doivent être renvoyées. Valeurs valides :	false
ResourceGroupId	string	Non	L'identifiant du groupe de ressources auquel la passerelle IPv6 appartient.	rg-bp67acfmxazb4ph****
Tag	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de la balise N. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de la balise ne peut pas être une chaîne vide.	FinanceDept
Value	string	Non	La valeur de la balise N.	yunke
PageNumber	integer	Non	Le numéro de page. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page. Valeur maximale : 50. Valeur par défaut : 10.	10
RegionId	string	Oui	L'identifiant de la région dans laquelle vous souhaitez interroger les adresses IPv6. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.	cn-huhehaote
ServiceManaged	boolean	Non	Indique si l'instance est gérée. Valeurs valides :	false

Éléments de réponse

Élément	Type	Description	Exemple
	object
PageSize	integer	Le nombre d'entrées renvoyées par page. Valeur maximale : 50. Valeur par défaut : 10.	10
RequestId	string	L'identifiant de la requête.	AA4486A8-B6AE-469E-AB09-820EF8ECFA2B
PageNumber	integer	Le numéro de la page renvoyée. Valeur par défaut : 1.	1
TotalCount	integer	Le nombre d'entrées renvoyées.	2
Ipv6Addresses	object
Ipv6Address	array<object>	Les détails de l'adresse IPv6.
	array<object>
VpcId	string	L'identifiant du VPC auquel l'adresse IPv6 appartient.	vpc-bp15zckdt37pq72zv****
Status	string	L'état de l'adresse IPv6.	Available
Ipv6AddressId	string	L'identifiant de l'adresse IPv6.	ipv6-2zen5j4axcp5l5qyy****
AllocationTime	string	L'heure à laquelle l'adresse IPv6 a été créée.	2020-12-20T14:56:09Z
Ipv6AddressName	string	Le nom de l'adresse IPv6.	test
Ipv6AddressDescription	string	La description de l'adresse IPv6.	test
AssociatedInstanceType	string	Le type d'instance associée à l'adresse IPv6.	EcsInstance
AssociatedInstanceId	string	L'identifiant de l'instance associée à l'adresse IPv6.	i-2ze72wuqj4y3jl4f****
NetworkType	string	Le type de connexion pris en charge par l'adresse IPv6. Valeurs valides :	Private
Ipv6Address	string	L'adresse IPv6.	2408:XXXX:153:3921:851c:c435:7b12:1c5f
AddressType	string	Le type d'adresse IPv6. Valeurs valides :	IPv6Address
Ipv6Isp	string	Le FAI de l'adresse IPv6. Valeurs valides :	BGP
VSwitchId	string	L'identifiant du vSwitch auquel l'adresse IPv6 appartient.	vsw-25navfgbue4g****
Ipv6GatewayId	string	L'identifiant de la passerelle IPv6 à laquelle l'adresse IPv6 appartient.	ipv6gw-2zewg0l66s73b4k2q****
RealBandwidth	integer	La bande passante de crête de l'adresse IPv6.	5
Ipv6InternetBandwidth	object	La bande passante Internet de l'adresse IPv6.
InternetChargeType	string	La méthode de facturation de la bande passante Internet de l'adresse IPv6. Valeurs valides :	PayByTraffic
BusinessStatus	string	L'état de la bande passante Internet de l'adresse IPv6. Valeurs valides :	Normal
Bandwidth	integer	La bande passante Internet dédiée de l'adresse IPv6. Unité : Mbit/s.	5
Ipv6InternetBandwidthId	string	L'identifiant de la bande passante Internet de l'adresse IPv6.	ipv6bw-hp3b35oq1fj50kbv****
InstanceChargeType	string	La méthode de facturation de la bande passante Internet de l'adresse IPv6. Valeurs valides :	PostPaid
HasReservationData	boolean	Indique si les données de renouvellement sont incluses. Valeurs valides :	false
ReservationInternetChargeType	string	La méthode de comptage utilisée après la prise d'effet du renouvellement.	PayByTraffic
ReservationOrderType	string	Le type de commande de renouvellement. Seul RENEW peut être renvoyé, ce qui indique que la commande est passée pour le renouvellement du service.	RENEW
ReservationActiveTime	string	L'heure à laquelle le renouvellement prend effet. L'heure est affichée au format `YYYY-MM-DDThh:mm:ssZ`.	2021-05-23T16:00:00Z
ReservationBandwidth	integer	La bande passante maximale après la prise d'effet du renouvellement. Unité : Mbit/s.	12
ResourceGroupId	string	L'identifiant du groupe de ressources auquel la passerelle IPv6 appartient.	rg-bp67acfmxazb4ph****
Tags	object
Tag	array<object>	La liste des balises.
	object	La liste des balises.
Key	string	La clé de la balise. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de la balise ne peut pas être une chaîne vide.	FinanceDept
Value	string	La valeur de la balise.	yunke
ServiceManaged	integer	Indique si l'instance est gérée. Valeurs valides :	1

Exemples

JSON format

{
  "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
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	IllegalParam.Ipv6Address	The param of %s is illegal.
400	IllegalParam.NetworkType	The param of %s is illegal.
400	IllegalParam.AddressType	The specified AddressType is illegal.
400	IllegalParamSize.AssociatedInstanceId	The param size of AssociatedInstanceId is illegal.
400	MissingParam.AssociatedInstanceId	The param of AssociatedInstanceId is missing when AssociatedInstanceType is specified.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.