CreateVpcPeerConnection - : Central de Documentação do Alibaba Cloud

Observações de uso

Antes de criar uma conexão de peering de VPC, verifique se os seguintes requisitos foram atendidos:

O Cloud Data Transfer (CDT) deve estar ativado para gerencie o faturamento de transferências de dados intrarregionais. Para ativar o CDT, chame a operação OpenCdtService.

A operação CreateVpcPeerConnection é assíncrona. Após o envio da solicitação, o sistema retorna um id de solicitação e um id de VPC e execute a tarefa em segundo plano. Chame a operação GetVpcPeerConnectionAttribute para consultar o status da tarefa.
- Se a conexão de peering de VPC estiver no estado Creating, ela está sendo criada.
- Se a conexão de peering de VPC estiver no estado Activated, a criação foi concluída.
- Se a conexão de peering de VPC estiver no estado Accepting, ela foi criada entre contas diferentes e o receptor está aceitando a conexão.
Não chame a operação CreateVpcPeerConnection repetidamente em um curto período.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateVpcPeerConnection	Operação a ser executada. Defina o valor como CreateVpcPeerConnection.
RegionId	String	Sim	cn-hangzhou	id da região onde a conexão de peering de VPC será criada. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
VpcId	String	Sim	vpc-bp1gsk7h12ew7oegk****	id da VPC solicitante.
AcceptingAliUid	Long	Sim	1210123456123456	id da conta Alibaba Cloud à qual a VPC receptora pertence. Para criar uma conexão de peering de VPC na mesma conta Alibaba Cloud, insira o id da sua conta. Para criar uma conexão de peering de VPC entre contas diferentes, insira o id da conta Alibaba Cloud par. Nota Se a VPC receptora pertencer a um usuário do Resource Access Management (RAM), defina AcceptingAliUid como o id da conta Alibaba Cloud correspondente.
AcceptingRegionId	String	Sim	cn-hangzhou	id da região da VPC receptora para a conexão de peering de VPC. Para conexões intrarregionais, insira o mesmo id de região da VPC solicitante. Para conexões inter-regionais, insira um id de região diferente do da VPC solicitante.
AcceptingVpcId	String	Sim	vpc-bp1vzjkp2q1xgnind****	id da VPC receptora.
Name	String	Não	vpcpeer	Nome da conexão de peering de VPC. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.
Description	String	Não	description	Descrição da conexão de peering de VPC. A descrição deve ter de 2 a 256 caracteres. Deve começar com uma letra e não pode iniciar com `http://` ou `https://`.
DryRun	Boolean	Não	false	Define se apenas uma simulação (dry run) será executada, sem realizar a solicitação real. Valores válidos: true: execute apenas a simulação. O sistema verifica problemas potenciais na solicitação, como valores de parâmetros ausentes, sintaxe incorreta e limites de serviço. Se a simulação falhar, uma mensagem de erro é retornada. Se for bem-sucedida, o código de erro `DryRunOperation` é retornado. false (padrão): execute a simulação e a solicitação real. Se a simulação for bem-sucedida, um código de status HTTP 2xx é retornado e a operação é executada.
ClientToken	String	Não	02fb3da4-130e-11e9-8e44-001****	Token de cliente usado para garantir a idempotência da solicitação. Gere o token no cliente, garantindo que seja exclusivo entre solicitações diferentes. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres. Nota Se este parâmetro não for especificado, o sistema usará automaticamente o client token como o request ID. O request ID pode variar a cada solicitação.
ResourceGroupId	String	Não	rg-acfmxazb4ph6aiy****	id do grupo de recursos. Para mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	id da solicitação.
InstanceId	String	pcc-lnk0m24khwvtkm****	id da conexão de peering de VPC.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	OperationFailed.CdtNotOpened	The operation failed because the Cdt service is not opened.	Falha na operação porque o serviço Cloud Data Transfer (CDT) não está ativado.
400	ResourceAlreadyExist.RouterInterface	The specified resource of %s already exists.	A interface de roteador especificada já existe.
400	ResourceAlreadyExist.VpcPeer	The specified resource of %s already exists.	A conexão de peering de VPC especificada já existe.
400	UnsupportedRegion	The feature of %s is not supported in the region of %s.	Conexões de peering de VPC não são suportadas nesta região.
400	OperationFailed.NotExist.ResourceGroup	The operation failed because the resource group does not exist.	Falha na operação porque o grupo de recursos não existe.
400	OperationFailed.AcceptUserCdtNotOpened	The operation failed because the Cdt service of accept user is not opened.	Falha na operação porque o CDT não está ativado para o par.
400	OperationFailed.AcceptUserCrossBorderCdtNotOpened	The operation failed because the CrossBorderCdt service of accept user is not opened.	Falha na operação porque o serviço transfronteiriço do CDT não está ativado para o par.
400	IncorrectBusinessStatus.AcceptUserVpcPeer	The business status of %s [%s] is incorrect.	A VPC par está em um estado comercial inválido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.