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

Invoca a operação CreateVpcPeerConnection para criar uma conexão de peering de VPC.

Descrição da operação

Antes de criar uma conexão de peering de VPC, observe os seguintes itens:

CreateVpcPeerConnection é uma operação assíncrona. Após chamar esta operação, o sistema retorna um InstanceId, mas a conexão de peering de VPC ainda não foi criada e a tarefa de criação ainda está sendo executada em segundo plano. Você pode chamar GetVpcPeerConnectionAttribute para consultar o status da conexão de peering de VPC.
- Se a conexão de peering de VPC estiver no estado Creating, a conexão de peering de VPC está sendo criada.
- Se a conexão de peering de VPC estiver no estado Activated, a conexão de peering de VPC foi criada.
- Se a conexão de peering de VPC estiver no estado Accepting, a conexão de peering de VPC foi criada entre contas e deve ser aceita pelo receptor.
Você não pode chamar a operação CreateVpcPeerConnection para criar conexões de peering de VPC simultaneamente na mesma VPC.

Ao criar uma conexão de peering de VPC, o sistema ativa automaticamente o Cloud Data Transfer (CDT) para transferência de dados não transfronteiriça.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:CreateVpcPeerConnection

create

*All resources

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região onde você deseja criar uma conexão de peering de VPC. Você pode invocar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
VpcId	string	Sim	O ID da VPC que atua como iniciador para criar uma conexão de peering de VPC.	vpc-bp1gsk7h12ew7oegk****
AcceptingAliUid	integer	Sim	O ID da conta Alibaba Cloud à qual pertence o receptor da conexão de peering de VPC. Se você inserir seu próprio ID de conta Alibaba Cloud, uma conexão de peering de VPC da mesma conta será criada. Se você inserir o ID de outra conta Alibaba Cloud, uma conexão de peering de VPC entre contas será criada. Nota Se a conta do receptor for um usuário do Resource Access Management (RAM), você deve inserir o ID da conta Alibaba Cloud à qual o usuário RAM pertence em AcceptingAliUid.	1210123456123456
AcceptingRegionId	string	Sim	O ID da região onde o receptor da conexão de peering de VPC está implantado. Para criar uma conexão de peering de VPC intrarregional, insira o mesmo ID de região do iniciador. Para criar uma conexão de peering de VPC inter-regional, insira um ID de região diferente do iniciador.	cn-hangzhou
AcceptingVpcId	string	Sim	O ID da VPC que atua como receptor da conexão de peering de VPC.	vpc-bp1vzjkp2q1xgnind****
Name	string	Não	O nome da conexão de peering de VPC. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês e pode conter dígitos, sublinhados (_) e hifens (-).	vpcpeer
Description	string	Não	A 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 ou um caractere chinês e não pode começar com `http://` ou `https://`.	description
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run para esta solicitação. Valores válidos: true: realiza um dry run e não cria uma conexão de peering de VPC. O sistema verifica se os parâmetros obrigatórios foram especificados, o formato da solicitação e os limites do serviço. Se a solicitação falhar no dry run, o erro correspondente será retornado. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false (padrão): envia uma solicitação normal. Se a solicitação passar no dry run, um código de status HTTP 2xx será retornado e a operação será executada.	false
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId de cada solicitação de API pode ser diferente.	02fb3da4-130e-11e9-8e44-001****
ResourceGroupId	string	Não	O ID do grupo de recursos. Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?.	rg-acfmxazb4ph6aiy****
Bandwidth	integer	Não	A largura de banda da conexão de peering de VPC. Unidade: Mbit/s. O valor deve ser um número inteiro positivo. Nota Se você deseja especificar este parâmetro, certifique-se de que está criando uma conexão de peering inter-regional.	100
LinkType	string	Não	O tipo de link. Valores válidos: Platinum e Gold. Valor padrão: Gold. Nota Se você deseja especificar este parâmetro, certifique-se de que está criando uma conexão de peering inter-regional.	Gold
Tag	array<object>	Não	As informações da tag.
	object	Não	As informações da tag.
Key	string	Não	A chave da tag do recurso. Você deve especificar pelo menos uma chave de tag e pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag do recurso. Você deve especificar pelo menos um valor de tag e pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
InstanceId	string	O ID da instância da conexão de peering de VPC criada.	pcc-lnk0m24khwvtkm****
RequestId	string	O ID da solicitação.	54B48E3D-DF70-471B-AA93-08E683A1B45

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationFailed.CdtNotOpened	The operation failed because the Cdt service is not opened.	A operação de criação falhou porque o serviço CDT não está ativado.
400	OperationFailed.CrossBorderCdtNotOpened	The operation failed because the CrossBorderCdt service is not opened.	O recurso de transferência de dados transfronteiriça da Alibaba Cloud não está ativado.
400	IncorrectStatus.Vpc	The status of %s [%s] is incorrect.	O status da instância conectada à VPC do iniciador está incorreto.
400	IncorrectStatus.AcceptingVpc	The status of %s [%s] is incorrect.	O status da VPC do receptor está incorreto.
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	OperationDenied.CloudBoxExistsInVpc	The operation is not allowed because the CloudBox device exists in vpc.	Você não pode criar uma instância de conexão de peering de VPC porque existem instâncias do CloudBox na VPC do iniciador.
400	OperationDenied.CloudBoxExistsInAcceptingVpc	The operation is not allowed because the CloudBox device exists in accepting vpc.	Você não pode criar uma instância de conexão de peering de VPC porque existem instâncias do CloudBox na VPC do receptor.
400	QuotaExceeded.VpcPeerCountPerVpc	The quota of %s is exceeded, usage %s/%s.	O número de conexões de peering de VPC na VPC especificada excede o limite.
400	UnsupportedRegion	The feature of %s is not supported in the region of %s.	A funcionalidade de peering de VPC não é suportada nesta região.
400	QuotaExceeded.VpcPeerCountPerUserPerRegion	The quota of %s is exceeded, usage %s/%s.	O número de instâncias de peering de VPC em uma única região excede o limite.
400	IncorrectBusinessStatus.VpcPeer	The business status of %s [%s] is incorrect.	A operação não é permitida porque o status atual da instância é anormal.
400	OperationFailed.NotExist.ResourceGroup	The operation failed because the resource group does not exist.	A operação falhou porque o grupo de recursos não existe.
400	OperationFailed.AcceptUserCdtNotOpened	The operation failed because the Cdt service of accept user is not opened.	A operação falhou porque o serviço CDT par não está ativado.
400	OperationFailed.AcceptUserCrossBorderCdtNotOpened	The operation failed because the CrossBorderCdt service of accept user is not opened.	A operação falhou porque o serviço CDT transfronteiriço par não está ativado.
400	IncorrectBusinessStatus.AcceptUserVpcPeer	The business status of %s [%s] is incorrect.	O status de faturamento da conexão de peering de VPC par é anormal.
400	OperationFailed.ViolativeVpcPeer	The creation operation fails because it is not allowed to create a vpc peer instance between the originating region and the receiving region.	A operação falhou porque a criação de instâncias de peering de VPC entre a região iniciadora e a região receptora não é permitida.
400	QuotaExceeded.CrossRegionVpcPeerCountPerVpc	The quota of %s is exceeded, usage %s/%s.	O número de conexões de peering de VPC inter-regionais na VPC especificada excede o limite.
400	QuotaExceeded.IntraRegionVpcPeerCountPerVpc	The quota of %s is exceeded, usage %s/%s.	O número de conexões de peering de VPC intrarregionais na VPC especificada excede o limite.
400	OperationDenied.OperateShareResource	The operation is not allowed because of operating shared resource.	A operação falhou porque foi executada em recursos compartilhados.
400	IncorrectBusinessStatus.AcceptVpcPeer	The business status of peer account is incorrect.	O status de faturamento da conexão de peering de VPC par é anormal.
400	OperationFailed.InterRegionLinkTypeNotSupported	The same region not supported link type feature.	As conexões intrarregionais não suportam o recurso de tipo de link.
400	OperationFailed.RegionIdNotSupportLinkType	The feature link type is not supported in the region.	A região não suporta as configurações gold, silver e bronze para esta funcionalidade.
400	OperationFailed.SpecificLinkTypeNotSupported	The operation failed because the special link type of user is not opened.	A conta não suporta tipos de link especiais.
400	OperationFailed.CrossBusinessNotAllowed	Operation failed because receiver and accepter belong to different business site.	Você não pode criar uma conexão de peering de VPC porque o iniciador e o receptor pertencem a sites diferentes.
400	OperationFailed.ChargeTypeNotSupported	Operation failed because the CDT charge type of receiver or accepter does not support the Underlay link type.	A operação falhou porque o método de faturamento CDT do iniciador ou receptor não suporta o tipo de link underlay.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.