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

Modifica o nome, a descrição e as configurações de IPv6 de um vSwitch.

Descrição da operação

A API ModifyVSwitchAttribute é uma API assíncrona, o que significa que o sistema retorna um ID de solicitação, mas as informações de configuração do vSwitch ainda não foram modificadas com sucesso e a tarefa de modificação em segundo plano do sistema ainda está em andamento. Você pode chamar a operação DescribeVSwitchAttributes para consultar o status de modificação do vSwitch:
- Quando o status do vSwitch estiver como Pending, indica que as informações de configuração do vSwitch estão sendo modificadas.
- Quando o status do vSwitch estiver como Available, indica que o vSwitch está disponível.
A API ModifyVSwitchAttribute não suporta a modificação simultânea das informações de configuração do mesmo vSwitch.

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:ModifyVSwitchAttribute

update

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VSwitchId	string	Sim	O ID do vSwitch.	vsw-25nacdfvue4****
VSwitchName	string	Não	O novo nome do vSwitch. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	VSwitch-1
RegionId	string	Não	O ID da região onde o vSwitch está implantado. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
Description	string	Não	A nova descrição do vSwitch. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.	This is my vswitch.
Ipv6CidrBlock	integer	Não	Os últimos oito bits do bloco CIDR IPv6 do vSwitch. Valores válidos: 0 a 255. Você pode definir este parâmetro apenas quando o recurso IPv6 estiver ativado para a nuvem privada virtual (VPC) à qual o vSwitch pertence.	10
EnableIPv6	boolean	Não	Especifica se o recurso IPv6 deve ser ativado para o vSwitch. Valores válidos: true: ativa o recurso IPv6. false: desativa o recurso IPv6. Este é o valor padrão.	false
VpcIpv6CidrBlock	string	Não	O bloco CIDR IPv6 da VPC à qual o vSwitch pertence. Você pode definir este parâmetro apenas quando o recurso IPv6 estiver ativado para a VPC.	2408:XXXX:312:3e00::/56

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	The format of the specified vSwitch name is invalid. Specify the name in the valid format.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	The format of the vSwitch description is invalid.
400	Forbidden.VRouterNotFound	specified virtual switch is not found during access authentication.	The specified vSwitch is not found during access authentication.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	You cannot create an IPv6 address for a CloudBox instance.
400	OperationFailed.Ipv6InstanceExist	Operation failed because vswitch has ipv6 instance.	IPv6 instances exist in the vSwitch.
400	IncorrectStatus.VpcRouteEntry	The status of the specified routeEntry is invalid.	The status of the VPC route entry is invalid.
400	OperationFailed.IPv6Disabled	Operation failed because IPv6 is not enabled for the vSwitch.	The IPv6 feature is disabled.
400	ParamExclusive.DisableIpv6AndIpv6CidrBlock	DisableIpv6 and Ipv6Cidr are mutually exclusive.	You cannot modify Ipv6Cidr and DisableIpv6 at the same time.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	The status of the CEN instance is invalid.
400	DependencyViolation.IPv6CidrReservation	The specified resource of [%s] depends on [%s], so the operation cannot be completed.	The specified resource of [%s] depends on [%s], so the operation cannot be completed.
400	IllegalParam.VpcIpv6CidrBlock	The parameter of VpcIPv6CidrBlock is illegal.
400	OperationFailed.Ipv6AlreadyEnabled	Operation failed because the IPv6 is enabled already.
400	OperationFailed.Ipv6CidrBlockExisted	Operation failed because the specified IPv6 CIDR block is used already.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.	The error message returned because the Description parameter is set to an invalid value.
400	OperationFailed.VpcIpv6Disabled	Operation failed because the VPC has not enabled IPv6.
400	IncorrectStatus.VSwitch	The specified vSwitch status is invalid.	The virtual switch status is abnormal.
400	OperationFailed.Ipv6CidrBlockUsed	Operation failed because the specified IPv6 CIDR block is used already.
400	TaskConflict	The operation is too frequent. Please wait a moment and try again.	The system is unavailable. Try again later.
500	SystemBusy	The system is busy. Please try again later.	The system is busy. Please try again later.
404	InvalidVSwitchId.NotFound	The specified virtual switch does not exists.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.