AllocateIpv6InternetBandwidth - IPv6 Gateway - Centre de documentation Alibaba Cloud

Active la bande passante Internet pour une adresse IPv6 dans un VPC afin que l'adresse IPv6 puisse communiquer sur Internet. Une fois la bande passante Internet activée, l'adresse IPv6 peut à la fois initier des connexions sortantes vers Internet et être accessible depuis Internet.

Description de l'opération

Vous pouvez activer la bande passante Internet pour les types d'adresses IPv6 suivants :
- Adresses IPv6 attribuées aux interfaces réseau élastiques (ENI) des instances ECS.
- Adresses IPv6 non associées qui ne sont attachées à aucune instance de ressource.
Avant d'appeler cette opération, assurez-vous que l'adresse IPv6 cible existe déjà. Cela signifie qu'une instance ECS dans le VPC s'est vu attribuer une adresse IPv6, ou qu'une adresse IPv6 non associée a été créée en appelant AllocateIpv6Address.
Une fois la bande passante Internet activée, l'adresse IPv6 peut à la fois initier des connexions sortantes vers Internet et être accessible depuis Internet. Pour autoriser l'accès au réseau public vers Internet, appelez CreateIpv6EgressOnlyRule pour configurer une règle de sortie uniquement IPv6.
L'opération AllocateIpv6InternetBandwidth ne prend pas en charge les achats simultanés de bande passante Internet pour la même adresse IPv6.
Scénarios :
- Accès Internet IPv6 pour les instances ECS : permet aux instances ECS d'accéder à Internet ou de fournir des services via IPv6.
- Accès Internet pour les adresses IPv6 non associées : fonctionne avec les tables de routage de passerelle IPv6 pour acheminer le trafic Internet vers les IDC sur site et autres environnements.
- Communication sortante uniquement : fonctionne avec CreateIpv6EgressOnlyRule pour autoriser l'accès au réseau public et rejeter les connexions entrantes depuis Internet.

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

create

*Ipv6InternetBandwidth.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de la passerelle IPv6. Vous pouvez appeler l'opération DescribeRegions pour interroger l'identifiant de la région.	cn-huhehaote
Ipv6GatewayId	string	Non	L'identifiant de la passerelle IPv6.	ipv6gw-uf6hcyzu65v98v3du****
Ipv6AddressId	string	Oui	L'identifiant de l'adresse IPv6.	ipv6-2zen5j4axcp5l5qyy****
InternetChargeType	string	Non	Les méthodes de facturation pour la bande passante Internet IPv6. Valeurs valides : PayByTraffic : facturation par transfert de données. PayByBandwidth (par défaut) : facturation par bande passante.	PayByBandwidth
Bandwidth	integer	Oui	La bande passante Internet de l'adresse IPv6. Unité : Mbit/s. Si InternetChargeType est défini sur PayByTraffic, les valeurs valides sont de 1 à 1000. Si InternetChargeType est défini sur PayByBandwidth, les valeurs valides sont de 1 à 2000.	200
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur de paramètre depuis votre client pour garantir l'unicité entre les différentes requêtes. ClientToken ne prend en charge que les caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides : true : effectue un test à blanc sans associer de liste de préfixes à une table de routage. Le système vérifie la paire AccessKey, l'autorisation de l'utilisateur Resource Access Management (RAM) et les paramètres requis. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'erreur `DryRunOperation` est renvoyé. false (par défaut) : envoie une requête normale. Si la vérification réussit, un code d'état HTTP 2xx est renvoyé et la liste de préfixes est associée à une table de routage.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object
InternetBandwidthId	string	L'identifiant d'instance de la bande passante Internet associée à la passerelle IPv6 après l'activation de la bande passante Internet.	ipv6bw-uf6hcyzu65v98v3du****
Ipv6AddressId	string	L'identifiant de l'adresse IPv6.	ipv6-2zen5j4axcp5l5qyy****
RequestId	string	L'identifiant de la requête.	6972A26E-99B1-4367-9890-FBDEBB0F5E7D

Exemples

JSON format

{
  "InternetBandwidthId": "ipv6bw-uf6hcyzu65v98v3du****",
  "Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
  "RequestId": "6972A26E-99B1-4367-9890-FBDEBB0F5E7D"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	IllegalParam.Bandwidth	The param of %s is illegal.	La valeur de bande passante spécifiée n'est pas valide.
400	MissingParam.Ipv6InstanceId	The param of Ipv6InstanceId is missing.	L'Ipv6InstanceId n'est pas spécifié.
400	InvalidIpv6Instance.NotFound	The specified Ipv6AddressId or Ipv6InternetBandwidthId is not found.
400	IllegalParam.ChargeType	The param of %s is illegal.	Le ChargeType spécifié n'est pas valide. Reportez-vous à la description de la métrique dans la référence de l'API, modifiez le paramètre, puis réessayez.
400	IllegalParam.InternetChargeType	The param of %s is illegal.	L'InternetChargeType spécifié n'est pas valide. Reportez-vous à la description de la métrique dans la référence de l'API, modifiez le paramètre, puis réessayez.
400	OperationUnsupported.PrePaid	%s is unsupported.	La facturation par abonnement n'est pas prise en charge pour la bande passante Internet IPv6. Reportez-vous à la description de la métrique dans la référence de l'API, modifiez le paramètre, puis réessayez.
400	OperationFailed.Ipv6GatewayDisMatchIpv6Address	The operation is failed because of %s.	L'adresse IPv6 et la passerelle IPv6 spécifiées ne se trouvent pas dans le même VPC. Vérifiez que votre saisie est correcte.
400	OperationFailed.InternetBandwidthAlreadyExisted	The operation is failed because of %s.	La bande passante Internet est déjà activée pour l'instance IPv6 actuelle. Ne l'activez pas à nouveau.
400	OperationFailed.Ipv6GatewayNotExist	The operation is failed because of %s.	Aucune instance de passerelle IPv6 n'existe dans le VPC auquel appartient l'adresse IPv6 actuelle. Créez une passerelle IPv6 avant d'effectuer cette opération.
400	IncorrectStatus.Ipv6Instance	The status of %s [%s] is incorrect.	L'instance IPv6 spécifiée est dans un état transitoire. Réessayez plus tard.
400	IllegalParam.Ipv6Address	The param of %s is illegal.	L'adresse IPv6 n'est pas valide.
400	UnsupportedFeature.InternetChargeTypeOnFreeIpv6Address	The feature of %s is not supported.	L'instance IPv6 actuelle est dans un état détaché et ne prend pas en charge le type de facturation spécifié. Reportez-vous à la description de la métrique dans la référence de l'API, modifiez le paramètre, puis réessayez.
400	UnsupportedFeature.InternetChargeTypeOnStaticIsp	The feature of %s is not supported.	L'instance IPv6 actuelle est une instance mono-FAI et ne prend pas en charge le type de facturation spécifié. Reportez-vous à la description de la métrique dans la référence de l'API, modifiez le paramètre, puis réessayez.
400	OperationUnsupported.ULA	%s is unsupported.	L'opération actuelle ne prend pas en charge les adresses ULA.
400	OperationFailed.OpenCdtServiceFirst	The operation is failed because of %s.	Le type de facturation spécifié nécessite l'activation de Cloud Data Transfer (CDT). Activez CDT et réessayez.
400	OperationFailed.UpgradeCdtServiceFirst	The operation is failed because of cdt is not upgraded.	Le type d'instance que vous avez spécifié nécessite une mise à niveau de la facturation de Cloud Data Transfer (CDT). Mettez à niveau CDT et réessayez.
400	OperationUnsupported.PrivateGUA	This operation does not support private GUA addresses.	L'opération actuelle ne prend pas en charge les adresses GUA privées.
400	OperationDenied.UnSupportedBindTypeCloudInstance	Internet bandwidth cannot be allocated to the IPv6 address bound to the cloud service instance.	La bande passante Internet ne peut pas être activée pour une adresse IPv6 rattachée à une instance de service cloud.
404	ResourceNotFound.Ipv6Address	The specified resource of %s is not found.	L'adresse IPv6 spécifiée n'existe pas. Vérifiez que votre saisie est correcte.

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

Notes de version

Consultez Notes de version pour la liste complète.