CreateVpcPeerConnection - - Centro de documentación de Alibaba Cloud

Cree una conexión de emparejamiento de VPC.

Notas de uso

Antes de crear una conexión de emparejamiento de VPC, asegúrese de cumplir con los siguientes requisitos:

Cloud Data Transfer (CDT) debe estar activado para gestionar la facturación de las transferencias de datos dentro de la misma frontera. Para activar CDT, llame a la operación OpenCdtService.

CreateVpcPeerConnection es una operación asíncrona. Tras enviar la solicitud, el sistema devuelve un ID de solicitud y un ID de VPC y ejecuta la tarea en segundo plano. Llame a la operación GetVpcPeerConnectionAttribute para consultar el estado de la tarea.
- Si la conexión de emparejamiento de VPC se encuentra en estado Creating, significa que se está creando.
- Si la conexión de emparejamiento de VPC se encuentra en estado Activated, significa que ya se creó correctamente.
- Si la conexión de emparejamiento de VPC se encuentra en estado Accepting, indica que se creó entre cuentas distintas y el receptor está aceptando la conexión.
No puede llamar repetidamente a la operación CreateVpcPeerConnection en un periodo corto de tiempo.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda ejecutar esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente 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í	CreateVpcPeerConnection	La operación que desea realizar. Establezca el valor en CreateVpcPeerConnection.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde desea crear la conexión de emparejamiento de VPC. Llame a la operación DescribeRegions para obtener la lista más reciente de regiones.
VpcId	String	Sí	vpc-bp1gsk7h12ew7oegk****	El ID de la VPC solicitante.
AcceptingAliUid	Long	Sí	1210123456123456	El ID de la cuenta de Alibaba Cloud a la que pertenece la VPC receptora. Para crear una conexión de emparejamiento de VPC dentro de su propia cuenta de Alibaba Cloud, introduzca el ID de su cuenta. Para crear una conexión de emparejamiento de VPC entre su cuenta y otra cuenta de Alibaba Cloud, introduzca el ID de la cuenta par. Nota Si la VPC receptora pertenece a un usuario de Resource Access Management (RAM), establezca el valor de AcceptingAliUid como el ID de la cuenta de Alibaba Cloud correspondiente.
AcceptingRegionId	String	Sí	cn-hangzhou	El ID de región de la VPC receptora para la conexión de emparejamiento que desea crear. Para crear una conexión de emparejamiento de VPC dentro de la misma región, introduzca un ID de región idéntico al de la VPC solicitante. Para crear una conexión de emparejamiento de VPC entre regiones, introduzca un ID de región diferente al de la VPC solicitante.
AcceptingVpcId	String	Sí	vpc-bp1vzjkp2q1xgnind****	El ID de la VPC receptora.
Name	String	No	vpcpeer	El nombre de la conexión de emparejamiento de VPC. 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.
Description	String	No	description	La descripción de la conexión de emparejamiento de VPC. La descripción debe tener entre 2 y 256 caracteres de longitud. Debe comenzar con una letra, pero no puede empezar con `http://` ni con `https://`.
DryRun	Boolean	No	false	Especifique si se realiza solo una prueba sin ejecutar la solicitud real. Valores válidos: true: realiza únicamente la prueba. El sistema comprueba posibles problemas en la solicitud, como valores de parámetros faltantes, sintaxis incorrecta o límites del servicio. Si la prueba falla, se devuelve un mensaje de error. Si la prueba se supera, se devuelve el código de error `DryRunOperation`. false (predeterminado): realiza la prueba y ejecuta la solicitud real. Si la prueba se supera, se devuelve un código de estado HTTP 2xx y se lleva a cabo la operación.
ClientToken	String	No	02fb3da4-130e-11e9-8e44-001****	El token de cliente utilizado para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse de que sea único para cada solicitud distinta. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el token de cliente como ID de solicitud. El ID de solicitud puede variar en cada petición.
ResourceGroupId	String	No	rg-acfmxazb4ph6aiy****	El ID del resource group. Para obtener más información sobre los resource groups, consulte ¿Qué es un resource group?

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	El ID de la solicitud.
InstanceId	String	pcc-lnk0m24khwvtkm****	El ID de la conexión de emparejamiento de VPC.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=CreateVpcPeerConnection
&RegionId=cn-hangzhou
&VpcId=vpc-bp1gsk7h12ew7oegk****
&AcceptingAliUid=1210123456123456
&AcceptingRegionId=cn-hangzhou
&AcceptingVpcId=vpc-bp1vzjkp2q1xgnind****
&Name=vpcpeer
&Description=description
&DryRun=false
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&ResourceGroupId=rg-acfmxazb4ph6aiy****
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

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

<CreateVpcPeerConnectionResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <InstanceId>pcc-lnk0m24khwvtkm****</InstanceId>
</CreateVpcPeerConnectionResponse>

Formato JSON

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "InstanceId" : "pcc-lnk0m24khwvtkm****"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	OperationFailed.CdtNotOpened	The operation failed because the Cdt service is not opened.	La operación falló porque Cloud Data Transfer (CDT) no está activado.
400	ResourceAlreadyExist.RouterInterface	The specified resource of %s already exists.	La interfaz de router especificada ya existe.
400	ResourceAlreadyExist.VpcPeer	The specified resource of %s already exists.	La conexión de emparejamiento de VPC especificada ya existe.
400	UnsupportedRegion	The feature of %s is not supported in the region of %s.	Las conexiones de emparejamiento de VPC no son compatibles con esta región.
400	OperationFailed.NotExist.ResourceGroup	The operation failed because the resource group does not exist.	La operación falló porque el resource group no existe.
400	OperationFailed.AcceptUserCdtNotOpened	The operation failed because the Cdt service of accept user is not opened.	La operación falló porque CDT no está activado para el par.
400	OperationFailed.AcceptUserCrossBorderCdtNotOpened	The operation failed because the CrossBorderCdt service of accept user is not opened.	La operación falló porque el servicio transfronterizo de CDT no está activado para el par.
400	IncorrectBusinessStatus.AcceptUserVpcPeer	The business status of %s [%s] is incorrect.	La VPC par se encuentra en un estado de negocio no válido.

Para consultar la lista de códigos de error, visite Códigos de error del servicio.