UpdateTransitRouterPeerAttachmentAttribute - - Centro de documentación de Alibaba Cloud

Modifica una conexión interregional en un transit router Enterprise Edition.

Notas de uso

UpdateTransitRouterPeerAttachmentAttribute es una operación asíncrona. Después de enviar la solicitud, el sistema devuelve el ID de solicitud, pero la operación continúa ejecutándose en segundo plano. Llame a ListTransitRouterPeerAttachments para consultar el estado de una conexión interregional.

Si una conexión interregional se encuentra en el estado Modifying, significa que se está modificando. En este caso, consulte la conexión, pero no realice otras operaciones.
Si una conexión interregional se encuentra en el estado Attached, significa que la modificación se completó.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer, ya que genera dinámicamente el código de ejemplo correspondiente a distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	UpdateTransitRouterPeerAttachmentAttribute	La operación que desea ejecutar. Establezca el valor en UpdateTransitRouterPeerAttachmentAttribute.
ClientToken	String	No	02fb3da4-130e-11e9-8e44-001****	El token de cliente que garantiza la idempotencia de la solicitud. Genere este valor desde el cliente y asegúrese de que sea único para cada solicitud. ClientToken solo admite caracteres ASCII. Nota Si no establece este parámetro, ClientToken toma el valor de RequestId. El valor de RequestId puede variar en cada solicitud de API.
TransitRouterAttachmentId	String	Sí	tr-attach-ft94dcrbc3e5taun3x	El ID de la conexión interregional.
TransitRouterAttachmentName	String	No	testname	El nuevo nombre de la conexión interregional. El nombre debe tener entre 2 y 128 caracteres, y puede contener letras, dígitos, guiones bajos (_) y guiones (-). Debe comenzar con una letra.
TransitRouterAttachmentDescription	String	No	testdesc	La nueva descripción de la conexión interregional. La descripción debe tener entre 2 y 256 caracteres. Debe comenzar con una letra y no puede empezar con `http://` ni con `https://`.
AutoPublishRouteEnabled	Boolean	No	false	Especifica si se habilita el transit router local Enterprise Edition para anunciar automáticamente las rutas de la conexión interregional al transit router par. Valores válidos: false (predeterminado): no. true: sí.
DryRun	Boolean	No	false	Especifica si se realiza una comprobación previa para validar información como permisos y el estado de la instancia. Valores válidos: false (predeterminado): comprueba la solicitud. Si la validación es correcta, se modifica la conexión interregional. true: realiza la comprobación previa sin ejecutar la operación. La conexión interregional no se modifica aunque la solicitud pase la validación. Con este valor, el sistema verifica los parámetros obligatorios y la sintaxis de la solicitud. Si la comprobación falla, se devuelve un mensaje de error. Si la comprobación es correcta, el sistema devuelve el ID de la solicitud.
Bandwidth	Integer	No	2	El valor máximo de ancho de banda de la conexión interregional. Unidad: Mbit/s. Este parámetro especifica el ancho de banda máximo de la conexión interregional cuando BandwidthType se establece en BandwidthPackage. Este parámetro especifica el umbral de limitación de ancho de banda de la conexión interregional cuando BandwidthType se establece en DataTransfer.
CenBandwidthPackageId	String	No	cenbwp-3xrxupouolw5ou****	El ID del plan de ancho de banda que se utiliza para asignar ancho de banda a la conexión interregional. Nota Si establece BandwidthType en DataTransfer, no necesita configurar este parámetro.
BandwidthType	String	No	BandwidthPackage	El método de asignación de ancho de banda. Valores válidos: BandwidthPackage: asigna ancho de banda desde un plan de ancho de banda. DataTransfer: el ancho de banda se factura según el método de medición por transferencia de datos.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	A01FEDD7-7D69-4EB3-996D-CF79F6F885CA	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=UpdateTransitRouterPeerAttachmentAttribute
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&TransitRouterAttachmentId=tr-attach-ft94dcrbc3e5taun3x
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testdesc
&AutoPublishRouteEnabled=false
&DryRun=false
&Bandwidth=2
&CenBandwidthPackageId=cenbwp-3xrxupouolw5ou****
&BandwidthType=BandwidthPackage
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateTransitRouterPeerAttachmentAttributeResponse>
    <RequestId>A01FEDD7-7D69-4EB3-996D-CF79F6F885CA</RequestId>
</UpdateTransitRouterPeerAttachmentAttributeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A01FEDD7-7D69-4EB3-996D-CF79F6F885CA"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.	El mensaje de error devuelto porque el ID de la instancia de red no existe.

Para obtener una lista de códigos de error, visite el Centro de errores de API.