CreateTransitRouterPeerAttachment - - Centro de documentación de Alibaba Cloud

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

Contexto

De forma predeterminada, se proporciona 1 Kbit/s de ancho de banda para la comunicación interregional entre transit routers. Esto le permite probar la conectividad de redes IPv4 interregionales. Para que los servicios desplegados en diferentes regiones se comuniquen entre sí, cree una conexión interregional y asigne recursos de ancho de banda a dicha conexión.

Los transit routers Enterprise Edition permiten asignar recursos de ancho de banda a las conexiones interregionales mediante los siguientes métodos:

Asignar recursos de ancho de banda desde un plan de ancho de banda:

Adquiera un plan de ancho de banda y luego asigne recursos de dicho plan a las conexiones interregionales. Para obtener más información, consulte CreateCenBandwidthPackage.

Usar recursos de ancho de banda con pago por transferencia de datos:

Establezca un valor máximo de ancho de banda para una conexión interregional. Posteriormente, se le cobra según la cantidad de datos transferidos a través de la conexión. Para obtener más información, consulte Cross-region data transfers.

Notas de uso

CreateTransitRouterPeerAttachment es una operación asíncrona. Después de enviar una solicitud, el sistema devuelve el ID de la conexión interregional, 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 estado Attaching, significa que se está creando. Puede consultar la conexión interregional, pero no puede realizar otras operaciones.
Si una conexión interregional se encuentra en estado Attached, significa que la conexión ya se creó.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateTransitRouterPeerAttachment	La operación que desea ejecutar. Establezca el valor en CreateTransitRouterPeerAttachment.
ClientToken	String	No	02fb3da4-130e-11e9-8e44-001****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero asegúrese de que sea único entre diferentes solicitudes. ClientToken solo puede contener caracteres ASCII. Nota Si no establece este parámetro, el sistema utiliza automáticamente RequestId como ClientToken. El valor de RequestId de cada solicitud de API puede ser diferente.
CenId	String	No	cen-j3jzhw1zpau2km****	El ID de la instancia de Cloud Enterprise Network (CEN).
TransitRouterId	String	No	tr-bp1su1ytdxtataupl****	El ID del transit router Enterprise Edition local.
RegionId	String	No	cn-hangzhou	El ID de la región donde se despliega el transit router Enterprise Edition local. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
TransitRouterAttachmentName	String	No	testname	El nombre de la conexión interregional. El nombre debe tener entre 2 y 128 caracteres de longitud, y puede contener letras, dígitos, guiones bajos (_) y guiones (-). Debe comenzar con una letra.
TransitRouterAttachmentDescription	String	No	testdesc	La descripción de la conexión interregional. La descripción debe tener entre 2 y 256 caracteres de longitud. Debe comenzar con una letra, pero no puede empezar con `http://` o `https://`.
PeerTransitRouterId	String	Sí	tr-m5eq27g6bndum7e88****	El ID del transit router par.
PeerTransitRouterRegionId	String	No	cn-qingdao	El ID de la región donde se despliega el transit router par.
AutoPublishRouteEnabled	Boolean	No	false	Especifica si se habilita el transit router Enterprise Edition local para anunciar automáticamente las rutas de la conexión interregional al transit router par. Valores válidos: false (predeterminado): no. true: sí.
Bandwidth	Integer	No	2	El valor de ancho de banda de la conexión interregional. Unidad: Mbit/s. Si establece BandwidthType en BandwidthPackage, este parámetro especifica el ancho de banda disponible para la conexión interregional. Si establece BandwidthType en DataTransfer, este parámetro especifica el límite de ancho de banda de la conexión interregional.
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.
DryRun	Boolean	No	false	Especifica si se comprueba la solicitud sin ejecutar la operación. El sistema verifica los permisos y el estado de las instancias especificadas. Valores válidos: false (predeterminado): comprueba la solicitud. Si la solicitud pasa la comprobación, se crea la conexión interregional. true: comprueba la solicitud pero no ejecuta la operación. La conexión interregional no se crea aunque la solicitud pase la comprobación. Si utiliza este valor, el sistema verifica los parámetros obligatorios y la sintaxis de la solicitud. Si la solicitud no supera la comprobación previa, se devuelve un mensaje de error. Si la solicitud pasa la comprobación, el sistema devuelve el ID de la solicitud.
BandwidthType	String	No	BandwidthPackage	El método utilizado para asignar ancho de banda a la conexión interregional. Valores válidos: BandwidthPackage: asigna ancho de banda desde un plan de ancho de banda. DataTransfer: utiliza ancho de banda con pago por transferencia de datos.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
TransitRouterAttachmentId	String	tr-attach-nwkiqfvw22qesz****	El ID de la conexión interregional.
RequestId	String	59422BF5-BAAD-4CFD-9019-9557BD3ACFA3	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=CreateTransitRouterPeerAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&TransitRouterId=tr-bp1su1ytdxtataupl****
&RegionId=cn-hangzhou
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testdesc
&PeerTransitRouterId=tr-m5eq27g6bndum7e88****
&PeerTransitRouterRegionId=cn-qingdao
&AutoPublishRouteEnabled=false
&Bandwidth=2
&CenBandwidthPackageId=cenbwp-3xrxupouolw5ou****
&DryRun=false
&BandwidthType=BandwidthPackage
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

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

<CreateTransitRouterPeerAttachmentResponse>
    <TransitRouterAttachmentId>tr-attach-nwkiqfvw22qesz****</TransitRouterAttachmentId>
    <RequestId>59422BF5-BAAD-4CFD-9019-9557BD3ACFA3</RequestId>
</CreateTransitRouterPeerAttachmentResponse>

Formato JSON

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

{
  "TransitRouterAttachmentId" : "tr-attach-nwkiqfvw22qesz****",
  "RequestId" : "59422BF5-BAAD-4CFD-9019-9557BD3ACFA3"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.	El mensaje de error devuelto porque la región especificada no admite la operación.
400	NoPermission.AliyunServiceRolePolicyForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	El mensaje de error devuelto porque no tiene autorización para crear el rol vinculado al servicio AliyunServiceRolePolicyForCEN para el servicio cen.aliyuncs.com. Debe obtener el permiso ram:CreateServiceLinkedRole antes de poder realizar la operación.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	El mensaje de error devuelto porque el ID del transit router no es válido.
400	IllegalParam.PeerTransitRouterId	PeerTransitRouterId is illegal.	El mensaje de error devuelto porque el ID del transit router par no es válido.
400	OperationUnsupported.TransitRouterId	TransitRouterId is unsupported.	El mensaje de error devuelto porque los transit routers Basic Edition no admiten la operación.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	El mensaje de error devuelto porque no se especificó ningún valor de ancho de banda.

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