AddZoneToVpcEndpoint - - Centre de documentation Alibaba Cloud

Ajoute une zone à un point de terminaison.

Description de l'opération

AddZoneToVpcEndpoint est une opération asynchrone. Après l'envoi d'une requête, le système renvoie un identifiant de requête, mais la zone du point de terminaison n'a pas encore été ajoutée. Le système ajoute la zone en arrière-plan. Vous pouvez appeler ListVpcEndpointZones pour interroger l'état de la zone du point de terminaison :
- Si la zone du point de terminaison est dans l'état Creating, la zone du point de terminaison est en cours d'ajout.
- Si vous pouvez trouver la zone dans le point de terminaison, la zone du point de terminaison a été ajoutée.
AddZoneToVpcEndpoint ne prend pas en charge l'ajout simultané de zones à la même instance de point de terminaison.

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.

privatelink:AddZoneToVpcEndpoint

create

*VpcEndpoint.

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du point de terminaison auquel vous souhaitez ajouter une zone. Vous pouvez appeler DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
ZoneId	string	Oui	L'identifiant de la zone à ajouter.	cn-hangzhou-b
VSwitchId	string	Oui	Le vSwitch dans la zone à ajouter. Le système crée automatiquement une interface réseau élastique (ENI) de point de terminaison dans ce vSwitch.	vsw-hjkshjvdkdvd****
ip	string	Non	L'adresse IP de l'interface réseau élastique (ENI) du point de terminaison dans la zone à ajouter. Vous pouvez spécifier une adresse IP active dans le vSwitch de la zone. Le système attribue automatiquement une adresse IP à l'interface réseau élastique (ENI) du point de terminaison à partir du contrôleur d'interface réseau (NIC) si vous n'en spécifiez pas.	192.XX.XX.32
EndpointId	string	Oui	L'identifiant du point de terminaison auquel vous souhaitez ajouter une zone.	ep-hp33b2e43fays7s8****
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides : true : effectue un test à blanc sans ajouter la zone. Le système vérifie les paramètres requis, la syntaxe de la requête et les limites du service. Si la requête échoue au test à blanc, l'erreur correspondante est renvoyée. Si la requête réussit le test à blanc, le code d'erreur DryRunOperation est renvoyé. false (par défaut) : effectue un test à blanc et envoie la requête. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'opération est exécutée.	false
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII.	0c593ea1-3bea-11e9-b96b-88e9fe637760
RegionId	string	Oui	L'adresse IPv6 de l'interface réseau élastique (ENI) du point de terminaison dans la zone à ajouter. Vous pouvez spécifier une adresse IPv6 active dans le vSwitch de la zone. Le système attribue automatiquement une adresse IPv6 à l'interface réseau élastique (ENI) du point de terminaison à partir du contrôleur d'interface réseau (NIC) si vous n'en spécifiez pas.	2408:4005:3b6:**:6955:c3cb:34c:**
Ipv6Address	string	Non	L'adresse IPv6 de l'ENI du point de terminaison dans la zone que vous souhaitez ajouter.	2408:4005:3b6:**:6955:c3cb:34c:**

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	0c593ea1-3bea-11e9-b96b-88e9fe637760

Exemples

JSON format

{
  "RequestId": "0c593ea1-3bea-11e9-b96b-88e9fe637760"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	OperationDenied.EndpointProtected	The operation is not allowed because of EndpointProtected.	La protection gérée est activée pour le point de terminaison. L'opération n'est pas autorisée.
400	EndpointNotFound	The specified Endpoint does not exist.	Le point de terminaison n'a pas été trouvé.
400	EndpointOperationDenied	The specified operation of endpoint is not allowed.	Le point de terminaison est en cours de traitement. Les opérations ne sont pas autorisées.
400	EndpointLocked	The specified Endpoint is locked.	Le point de terminaison est verrouillé.
400	EndpointConnectionOperationDenied	The endpoint is being connected.	La connexion du point de terminaison est en cours de traitement. Les opérations ne sont pas autorisées.
400	EndpointZoneDuplicated	The zone is duplicated for the Endpoint.	Les zones en double ne sont pas autorisées sous le service de point de terminaison.
400	EndpointServiceNotSupportedZone	The specified endpoint service does not support the zone.	Le service de point de terminaison ne prend pas en charge la zone spécifiée.
400	QuotaMisMatched	The resource you applied for has exceeded the quota.	Les ressources demandées dépassent le quota.
400	EndpointDuplicated	The endpoint of the service already exists and cannot be created again.	Un point de terminaison pour ce service existe déjà. La création en double n'est pas autorisée.
400	EndpointServiceDeleted	The specified Service is already deleted.	Le service de point de terminaison a été supprimé.
400	EndpointServiceResourceNotFound	The specified service resource is not found.	La ressource du service de point de terminaison est introuvable.
400	VSwitchNotFound	The specified VSwitch does not exist.
400	EniIpUnavailable	The specified IP address is unavailable.	L'adresse IP spécifiée n'est pas disponible.
400	EndpointProtected	The specified Endpoint is protected.	La protection des opérations est déjà activée pour le point de terminaison.
400	VSwitchStatusNotAllowed	The specified vswitch status is not Available.	Le vSwitch n'est pas encore disponible.
400	VpcNatServiceException	The vpcNat service is busy	Le service VPC NAT est occupé. Réessayez plus tard.
400	ResourceNotEnough.VSwitchIp	The specified resource of VSwitchIp is not enough.	Le nombre d'adresses IP disponibles dans le vSwitch est insuffisant.
400	OperationDenied.VSwitchNotSupportDualstack	The specified VSwitch does not support dualstack.	Le vSwitch ne prend pas en charge la double pile.
400	OperationDenied.AddressIpVersionNotSupportSpecifyIpv6	The AddressIpVersion of the endpoint does not support specifying IPv6 address.	L'AddressIpVersion du point de terminaison ne permet pas de spécifier une adresse IPv6.
400	IllegalParam.Ip	The specified parameter IP is invalid.	Le format d'adresse IP spécifié ne répond pas aux exigences.
400	IllegalParam.Ipv6Address	The specified parameter Ipv6Address is invalid.	Le format d'adresse IPv6 spécifié ne répond pas aux exigences.

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

Notes de version

Consultez Notes de version pour la liste complète.