CreateVSwitch - ENS: Central de Documentação do Alibaba Cloud

Cria um 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

ens:CreateVSwitch

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
EnsRegionId	string	Sim	O ID do nó ENS.	cn-xian-unicom
CidrBlock	string	Sim	O bloco CIDR do VSwitch. Os seguintes requisitos se aplicam: O comprimento do prefixo deve ser um inteiro de 16 a 29. O bloco CIDR do VSwitch deve ser um subconjunto do bloco CIDR da VPC à qual o VSwitch pertence. O bloco CIDR do VSwitch não pode ser igual ao bloco CIDR de destino de uma rota existente na VPC, mas pode ser um subconjunto do bloco CIDR de destino.	172.16.0.0/24
VSwitchName	string	Não	O nome do VSwitch. Os seguintes requisitos se aplicam: O nome deve ter de 2 a 128 caracteres. O nome deve começar com uma letra ou um caractere chinês e não pode começar com `http://` ou `https://`. O nome pode conter dígitos, dois-pontos (:), underscores (_) e hífens (-). Valor padrão: uma string vazia.	Test vSwitch
Description	string	Não	A descrição do VSwitch. 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://`.	This is my vswitch.
NetworkId	string	Não	O ID da rede à qual o VSwitch pertence.	n-257gqcdfvx6n****
Tag	array<object>	Não	As tags do recurso. Você pode especificar até 20 tags.
	object	Não	Uma tag de recurso.
Key	string	Não	A chave da tag. A chave da tag não pode começar com `aliyun`, `acs:`, `http://` ou `https://`. A chave da tag pode ter até 64 caracteres. A chave da tag não pode ser uma string vazia.	team
Value	string	Não	O valor da tag. Pode ter até 128 caracteres, pode ser uma string vazia e não pode começar com `acs:` nem conter `http://` ou `https://`.	Deep
Ipv6CidrBlock	string	Não		2408:XXXX:0:a600::/110

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
VSwitchId	string	O ID do VSwitch.	vsw-5****
RequestId	string	O ID da solicitação.	CEF72CEB-54B6-4AE8-B225-F876FF7BA984

Exemplos

Resposta de sucesso

JSON formato

{
  "VSwitchId": "vsw-5****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NoPermission	Permission denied.
400	CallInterface	Call Interface Happen Error.	An error occurred when you call the operation.
400	Invalid%s	The specified parameter %s is invalid.
400	Missing%s	You must specify the parameter %s.
400	NetworkNotFound	The specified network is not found.	Network not found, please check network id.
400	IncorrectStatus.Network	The status of the network is incorrect.	The status of the network is incorrect.
400	QuotaExceeded	The number of resources has reached the quota limit.	The number of resources has reached the quota limit.
400	Network.SecondaryCidrNotFound	The network secondary CIDR is not found.
400	VSwitch.Ipv6CidrBlockOverlapped	The specified IPv6 CIDR block overlaps with existing vSwitches.
400	VSwitch.CidrBlockOverlapped	The specified CIDR block overlaps with existing vswitches.
400	VSwitch.InvalidIpv6CidrBlock	Invalid IPv6 CIDR value.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.