ModifyRouterInterfaceAttribute - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Modifie la configuration d'une interface de routeur.

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

update

*RouterInterface

acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}

vpc:TargetAccountRDId

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de l'interface de routeur. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	cn-shanghai
RouterInterfaceId	string	Oui	L'identifiant de l'interface de routeur.	ri-2zeo3xzyf38r4urz****
Name	string	Non	Le nom de l'interface de routeur. Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-). Le nom doit commencer par une lettre.	TEST
Description	string	Non	La description de l'interface de routeur. La valeur doit comporter entre 2 et 256 caractères. Elle doit commencer par une lettre, mais ne peut pas commencer par `http://` ou `https://`.	Interface de routeur
OppositeInterfaceId	string	Non	L'identifiant de l'interface de routeur homologue.	ri-2zeo3xzyf38r4urz****
OppositeRouterId	string	Non	L'identifiant du routeur homologue.	vrt-bp1jcg5cmxjbl9xgc****
OppositeRouterType	string	Non	Le type de routeur auquel l'interface de routeur homologue appartient. Valeurs valides : VRouter VBR (par défaut)	VBR
OppositeInterfaceOwnerId	integer	Non	L'identifiant du compte Alibaba Cloud auquel l'interface de routeur homologue appartient.	28768383240243****
HealthCheckSourceIp	string	Non	L'adresse IP source utilisée pour effectuer les vérifications de l'état. L'adresse IP source doit être une adresse IP inutilisée du cloud privé virtuel (VPC) local. Remarque Vous pouvez définir ce paramètre lorsqu'un circuit Express Connect est utilisé.	116.62.XX.XX
HealthCheckTargetIp	string	Non	L'adresse IP de destination utilisée pour effectuer les vérifications de l'état. Remarque Ce paramètre est requis lorsque HealthCheckSourceIp est spécifié.	116.62.XX.XX
HcThreshold	integer	Non	Le seuil de réussite. Unité : paquets. Nous vous recommandons de définir la valeur sur 8. Cette valeur spécifie le nombre de paquets de sondage envoyés lors d'une vérification de l'état.	8
HcRate	integer	Non	La fréquence des vérifications de l'état. Unité : millisecondes. La valeur recommandée est 2000. Cette valeur spécifie l'intervalle auquel les paquets de sondage sont envoyés lors d'une vérification de l'état. Dans cet exemple, HcThreshold est défini sur 8 et HcRate est défini sur 2000. Dans cet exemple, des paquets de sondage sont envoyés de HealthCheckSourceIp (adresse source) à HealthCheckTargetIp (adresse de destination) toutes les 2 000 millisecondes. Si aucune réponse n'est renvoyée huit fois de suite, la vérification de l'état échoue.	2000
DeleteHealthCheckIp	boolean	Non	Indique si les adresses IP de vérification de l'état configurées sur l'interface de routeur doivent être supprimées. Valeurs valides : true false (par défaut)	false

Éléments de réponse

Élément	Type	Description	Exemple
	object	L'identifiant de la requête.
RequestId	string	L'identifiant de la requête.	4EC47282-1B74-4534-BD0E-403F3EE64CAF

Exemples

JSON format

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	Forbidden.FinancialLocked	This RouterInterface is financiel locked because of bills outstanding.
400	InvalidName.Malformed	The attribute name is illegal.	The value of the Name parameter is invalid.
400	InvalidOppositeRouterType.ValueNotSupported	The specified OppositeRouterType is not valid.	The value of the OppositeRouterType parameter is invalid.
400	InvalidDescription.Malformed	The Description is illegal.	The description must be 2 to 256 characters in length and cannot start with http:// or https://.
400	Forbbiden	The Router instance owner error
400	LinkRole.NotSupport	This linkrole is not supported
400	Forbbiden.ModifyIdAndType	Opposite is VBR, cannot modify the ID and type
400	InvalidParam.ModifyRouterInterface	Modify routerinterface param invalid	The parameters for editing the router interface are invalid.
400	INSTANCE_IN_PROCESSIONG	Instance is in processing,please wait and try again
400	IllegalParam.HcThreshold	%s
400	IllegalParam.HcRate	%s
400	InvalidHealthCheckIP.Malformd	Healthcheck sourceip or targetip is not valid.
400	IllegalParam.HcSourceIp	The specified healthCheck Ip is not valid.	The IP address used for health checks is invalid.
400	OperationFailed.OperationLocked	Operation failed because OperationLocked.	The operation failed because the instance is locked due to O&M.
400	IncorrectStatus.RouterInterface	This openeration would not be allowed because status of this RouterInterface is not correct.	The router interface is in an abnormal state.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidRouterInterfaceId.NotFound	The specified RouterInterfaceId does not exist in our records.

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

Notes de version

Consultez Notes de version pour la liste complète.