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

Modifica a configuração de um vSwitch especificado.

Descrição da operação

ModifyVSwitchAttribute é uma operação assíncrona. Após chamar esta operação, o sistema retorna um ID de solicitação, mas a configuração do vSwitch ainda não foi modificada. A tarefa de modificação ainda está sendo executada em segundo plano. Você pode chamar DescribeVSwitchAttributes para consultar o status de modificação do vSwitch:\n - Se o vSwitch estiver no estado Pending, a configuração está sendo modificada.\n - Se o vSwitch estiver no estado Available, o vSwitch está disponível.\n- ModifyVSwitchAttribute não suporta modificações simultâneas no 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.\n\nO 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 do vSwitch. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
Description	string	Não	A nova descrição do vSwitch.\n\nA descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.	Este é o meu vSwitch
Ipv6CidrBlock	integer	Não	Os últimos 8 bits do bloco CIDR IPv6 do vSwitch. Valores válidos: 0 a 255.\n\nVocê pode definir este parâmetro apenas quando o IPv6 estiver ativado para a VPC à qual o vSwitch pertence. Este parâmetro permite alocar um bloco CIDR IPv6 para o vSwitch. Após a alocação do bloco CIDR IPv6, ele não pode ser alterado para outro bloco CIDR. Certifique-se de que o bloco CIDR não se sobreponha aos de outros vSwitches na mesma VPC.	10
Ipv6CidrMask	integer	Não	A máscara do bloco CIDR IPv6 do vSwitch. Você pode definir este parâmetro apenas quando o IPv6 estiver ativado para a VPC à qual o vSwitch pertence.\n\n> Somente 64 é suportado.	64
EnableIPv6	boolean	Não	Especifica se o IPv6 deve ser ativado para o vSwitch. Valores válidos:\n\n- true: Ativa o IPv6. O IPv6 deve estar ativado para a VPC à qual o vSwitch pertence. Você também deve especificar Ipv6CidrBlock para alocar um bloco CIDR IPv6 para o vSwitch.\n- false (padrão): Desativa o IPv6. Antes de desativar o IPv6 para o vSwitch, certifique-se de que nenhum endereço IPv6 esteja em uso. Você não pode especificar Ipv6CidrBlock ao mesmo tempo.	false
VpcIpv6CidrBlock	string	Não	O bloco CIDR IPv6 da VPC à qual o vSwitch pertence.\nSe a VPC tiver vários blocos CIDR IPv6, você pode especificar este parâmetro para indicar o intervalo do bloco CIDR IPv6 para o vSwitch. Se você não especificar este parâmetro, o bloco CIDR IPv6 atribuído quando o IPv6 foi ativado para a VPC será usado.	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.	O formato do nome do vSwitch é inválido. Verifique o formato do nome do vSwitch.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	A descrição do vSwitch é inválida.
400	Forbidden.VRouterNotFound	specified virtual switch is not found during access authentication.	O switch virtual especificado não foi encontrado durante a autenticação de acesso.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	O CloudBox não suporta a criação de IPv6.
400	OperationFailed.Ipv6InstanceExist	Operation failed because vswitch has ipv6 instance.	Existem instâncias IPv6 no vSwitch.
400	IncorrectStatus.VpcRouteEntry	The status of the specified routeEntry is invalid.	A entrada de rota da VPC está em um estado incorreto.
400	OperationFailed.IPv6Disabled	Operation failed because IPv6 is not enabled for the vSwitch.	A operação especificada falhou porque o recurso IPv6 não está ativado.
400	ParamExclusive.DisableIpv6AndIpv6CidrBlock	DisableIpv6 and Ipv6Cidr are mutually exclusive.	Conflito de operação. Você não pode modificar o Ipv6Cidr e desativar o recurso IPv6 simultaneamente.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	O estado atual do CBN está incorreto.
400	DependencyViolation.IPv6CidrReservation	The specified resource of [%s] depends on [%s], so the operation cannot be completed.	O recurso [%s] depende de um bloco CIDR IPv6 reservado. Exclua o recurso dependente antes de realizar esta operação.
400	IllegalParam.VpcIpv6CidrBlock	The parameter of VpcIPv6CidrBlock is illegal.	O parâmetro VpcIPv6CidrBlock é inválido.
400	OperationFailed.Ipv6AlreadyEnabled	Operation failed because the IPv6 is enabled already.	A operação falhou porque o IPv6 já está ativado.
400	OperationFailed.Ipv6CidrBlockExisted	Operation failed because the specified IPv6 CIDR block is used already.	A operação falhou porque o bloco CIDR IPv6 especificado já está em uso.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	O bloco CIDR IPv6 é inválido.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.	O formato da descrição do recurso especificado é inválido. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
400	OperationFailed.VpcIpv6Disabled	Operation failed because the VPC has not enabled IPv6.	A operação atual não é suportada porque o IPv6 não está ativado para a VPC.
400	IncorrectStatus.VSwitch	The specified vSwitch status is invalid.
400	OperationFailed.Ipv6CidrBlockUsed	Operation failed because the specified IPv6 CIDR block is used already.	A operação falhou porque o bloco CIDR IPv6 especificado já está em uso.
400	TaskConflict	The operation is too frequent. Please wait a moment and try again.	As operações de EIP são muito frequentes.
400	OperationDenied.HasSecondaryZone	The operation is not allowed because the VSwitch has a secondary zone.	Operações IPv6 não são permitidas quando o vSwitch tem uma zona secundária configurada.
400	OperationDenied.VpcIpv6CidrBlockNotExist	The specified VpcIpv6CidrBlock does not exist in the VPC.	O VpcIpv6CidrBlock especificado não existe na VPC.
400	OperationDenied.AvailableCidrInsufficient	Insufficient available CIDR blocks for allocation. This is either because the VPC has no remaining address space, or because the candidate CIDR contains destination networks of active non-system routes in the VPC.	A operação foi rejeitada porque os recursos de bloco CIDR disponíveis são insuficientes.
400	OperationDenied.Ipv6CidrMaskInvalid	The specified Ipv6CidrMask is invalid, only %s is allowed.	A máscara IPv6 especificada é inválida. Apenas %s é suportado.
400	MissingParam.Ipv6CidrBlockOrIpv6CidrMask	Ipv6CidrBlock or Ipv6CidrMask must be specified.	Pelo menos um dos parâmetros Ipv6CidrBlock ou Ipv6CidrMask deve ser especificado.
500	SystemBusy	The system is busy. Please try again later.	O sistema está ocupado. Tente novamente mais tarde.
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.