UpdateTransitRouterVpcAttachmentZones - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Modifica as zonas e os vSwitches associados a uma conexão VPC.

Descrição da operação

Ao adicionar uma zona e um vSwitch para uma conexão VPC, certifique-se de que o vSwitch tenha pelo menos um endereço IP disponível. Ao modificar as zonas e os vSwitches de uma conexão VPC, o transit router da Enterprise Edition cria uma interface de rede elástica (ENI) no vSwitch. A ENI ocupa um endereço IP no vSwitch. A ENI encaminha o tráfego entre a VPC e o transit router da Enterprise Edition.
UpdateTransitRouterVpcAttachmentZones é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Você pode chamar a operação ListTransitRouterVpcAttachments para consultar o status de uma conexão VPC.
- Se uma conexão VPC estiver no estado Modifying, a conexão VPC está sendo modificada. Você pode consultar a conexão VPC, mas não pode realizar outras operações.
- Se uma conexão VPC estiver no estado Attached, a conexão VPC foi modificada.

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

cen:UpdateTransitRouterVpcAttachmentZones

update

*TransitRouterVpcAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que ele seja único para diferentes solicitações. O token pode conter apenas caracteres ASCII. Nota Se você não definir esse parâmetro, ClientToken será definido com o valor de RequestId. O valor de RequestId para cada solicitação de API pode ser diferente.	123e4567-e89b-12d3-a456-42665544****
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos: true: realiza apenas um dry run. O sistema verifica os parâmetros obrigatórios, a sintaxe da solicitação e os limites. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false (padrão): realiza um dry run e executa a solicitação.	false
TransitRouterAttachmentId	string	Sim	O ID da conexão VPC.	tr-attach-9bbqyygouv4cpn****
AddZoneMappings	array<object>	Não	As zonas e os vSwitches que você deseja adicionar à conexão VPC.
	object	Não	O ID do vSwitch que você deseja adicionar à conexão VPC. Você pode especificar no máximo 10 vSwitches em cada chamada.
VSwitchId	string	Não	O ID do vSwitch que você deseja adicionar à conexão VPC. Você pode especificar no máximo 10 vSwitches em cada chamada. Se a conexão VPC pertencer à conta atual da Alibaba Cloud, você pode chamar a operação DescribeVSwitches para consultar os IDs dos vSwitches e das zonas da VPC. Se a conexão VPC pertencer a outra conta da Alibaba Cloud, você pode chamar a operação ListGrantVSwitchesToCen para consultar os IDs dos vSwitches e das zonas da VPC.	vsw-wz988dda8ldm4uvmx****
ZoneId	string	Não	O ID da zona na qual o vSwitch que você deseja adicionar à conexão VPC está implantado. Você pode especificar no máximo 10 vSwitches em cada chamada.	cn-hangzhou-h
RemoveZoneMappings	array<object>	Não	As zonas e os vSwitches que você deseja remover da conexão VPC.
	object	Não	As zonas e os vSwitches que você deseja remover da conexão VPC. Você pode especificar no máximo 10 pares de zonas e vSwitches em cada chamada.
VSwitchId	string	Não	O ID do vSwitch que você deseja remover da conexão VPC. Você pode remover no máximo 10 vSwitches de uma VPC em cada chamada.	vsw-wz9f5izl6wshndmta****
ZoneId	string	Não	O ID da zona na qual o vSwitch que você deseja remover da conexão VPC está implantado.	cn-hangzhou-i

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	595AE52F-49FF-5788-A677-0DD1467941A1

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "595AE52F-49FF-5788-A677-0DD1467941A1"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.ZoneId	The specified ZoneId is illegal.	The error message returned because the specified zone is invalid.
400	IncorrectStatus.TransitRouterAttachment	The status of TransitRouterAttachment is incorrect.	The error message returned because the status of the transit router attachment does not support this operation. Try again later.
400	IllegalParam.VSwitchId	VSwitchId is illegal.	The error message returned because the specified vSwitch ID is invalid.
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.	The error message returned because the ID of the network instance does not exist.
400	OperationUnsupported.ServiceMode	The specified TransitRouter does not support the operation.	The error message returned because the transit router mode does not support this operation.
400	IllegalParam.AddOrRemoveZoneMappings	The specified AddZoneMappings or RemoveZoneMappings are illegal.	The error message returned because the AddZoneMappings or RemoveZoneMappings parameter is set to an invalid value.
400	IncorrectStatus.Vpc	The resource is not in a valid state for the attachment operation.	The error message returned because the status of the VPC does not support this operation. Try again later.
400	OperationDenied.RouteEntryOnEni	Operation is failed because there is at least one route entry which next hop is the specified eni.	The error message returned because this operation is not supported when a route points to an ENI.
400	IncorrectStatus.VpcRouteEntry	The resource is not in a valid state for the attachment operation.	The error message returned because the status of the VPC route entry does not support this operation. Try again later.
400	IncorrectStatus.VpcSwitch	The resource is not in a valid state for the attachment operation.	The error message returned because the status of the vSwitch does not support this operation. Try again later.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	The error message returned because this operation is not supported by the specified type of transit router.
400	InsufficientIpAddr.vsw	Insufficient available IP addresses in the vSwitch.	The error message returned because the number of available IP addresses in the vSwitch is insufficient.
400	OperationFailed.VSwitchIpv6CidrNotAllocated	The specified vswitch does not have IPv6 address allocated.	The specified vswitch does not have IPv6 address allocated.
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.	The error message returned because the specified transit router mode is not supported.
400	OperationInvalid.EniReferencedIPv6RouteEntryExisted	Operation is failed because there is at least one route entry(IPv6) which next hop is network interface that the specified attachment referenced.	Operation is failed because there is at least one route entry(IPv6) which next hop is network interface that the specified attachment referenced.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.
404	IllegalParam.ZoneId	The specified ZoneId is illegal.
404	InvalidVSwitchId.NotFound	The specified VSwitchId is not found.	The error message returned because the specified vSwitch ID does not exist.
409	IncorrectStatus.VpcSwitch	The resource is not in a valid state for the attachment operation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.