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

Cria uma instância por assinatura. Esta operação pode ser substituída por RunInstances. Nenhum novo recurso será adicionado ao CreateInstance.

Descrição da operação

Frequência de chamadas por usuário: 10 chamadas por segundo.
Como a criação da instância é uma operação assíncrona, aumente o tempo limite da solicitação conforme necessário. Quando a API retornar Code=0, isso indica apenas que a solicitação foi bem-sucedida, não que a instância foi criada com êxito. Um ID de instância é retornado após uma solicitação bem-sucedida. Você pode então consultar a instância pelo seu ID para verificar se ela foi criada.
Restrição InvalidUserData.NotInWhiteList: Apenas contas adicionadas à whitelist relevante com permissões de compra podem criar instâncias. Caso contrário, um erro será retornado.

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

create

*Instance.

acs:ens:*:{#accountId}:instance/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceType	string	Sim	O tipo de instância. Para obter detalhes sobre os tipos de instância, consulte Limites.	ens.se1.tiny
EnsRegionId	string	Sim	O ID da região.	cn-hangzhou
Password	string	Não	A senha da instância. A senha deve ter de 8 a 30 caracteres e conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Os seguintes caracteres especiais são suportados: ()`~!@#$%^&*-_+=\|{}[]:;'<>,.?/	yourPassword:1
Period	string	Sim	A duração da assinatura. Valores válidos: 1 a 9 e 12. Unidade: meses.	12
ImageId	string	Não	O ID da imagem usada para iniciar a instância.	yourImage ID
SystemDisk.Size	string	Não	O tamanho do disco em nuvem do sistema. Unidade: GiB. O valor deve ser um múltiplo de 10 e não pode ser menor que o tamanho da imagem. Para o intervalo válido, consulte os valores SystemDiskMinSize e SystemDiskMaxSize retornados por DescribeAvailableResourceInfo. 20 GiB e 40 GiB são configurações comuns e não indicam que apenas esses dois valores são suportados.	40
Quantity	string	Sim	O número de instâncias.	1
DataDisk.1.Size	string	Não	O tamanho do primeiro disco em nuvem de dados. Unidade: GiB. O tamanho deve ser de pelo menos 20 GiB e um múltiplo de 10.	50
InternetChargeType	string	Não	Este parâmetro é obrigatório quando você cria uma instância pela primeira vez. Se você já possui recursos de instância, o método de cobrança existente é usado por padrão. Valores válidos: BandwidthByDay: largura de banda de pico diária. 95BandwidthByMonth: largura de banda no 95º percentil mensal.	95BandwidthByMonth
AutoRenewPeriod	string	Não	O período de renovação automática. Este parâmetro é obrigatório quando AutoRenew está definido como True. Valores válidos: 1 a 12. Unidade: meses.	12
AutoRenew	string	Não	Especifica se a renovação automática deve ser ativada. Valores válidos: True \| False (padrão).	True
IpType	string	Não	O tipo de IP. Valores válidos: ipv4 (padrão): IPv4. ipv6: IPv6. ipv4Andipv6: IPv4 e IPv6. Valores válidos: ipv4 : IPv4 ipv6 : IPv6 ipv4Andipv6 : IPv4 e IPv6	ipv4
KeyPairName	string	Não	O nome do par de chaves. Apenas um único nome é suportado.	TestKeyPairName
UserData	string	Não	Os dados personalizados. Os dados devem começar com `#!`. O comprimento máximo é de 256 caracteres e o tamanho máximo é de 16 KB. Apenas scripts de dados personalizados são suportados. A renderização de InstanceMetaData não é suportada. Você pode passar dados personalizados codificados em Base64. Ao chamar a API para iniciar uma solicitação, os dados personalizados especificados não são criptografados. Não passe informações confidenciais, como senhas e chaves privadas, em texto simples. Se precisar passar senhas ou chaves privadas, criptografe o conteúdo primeiro e depois codifique-o em Base64 antes de passá-lo. Descriptografe o conteúdo da mesma maneira dentro da instância. Para mais informações, consulte Formato de dados.	#!/bin/sh echo "Hello World. The time is now $(date -R)!" \| tee /home/output.txt
VSwitchId	string	Não	O ID do vSwitch.	YourVSwitchId
PrivateIpAddress	string	Não	O endereço IP privado. Se você especificar um endereço IP privado, também deverá especificar o parâmetro VSwitchId. O vSwitch deve ser criado antecipadamente. Caso contrário, um erro será retornado.	10.10.10.10
PaymentType	string	Não	O método de pagamento. Atualmente, este é um valor fixo de Subscription (instância por assinatura). A modificação não é suportada. Valores válidos: Subscription : Assinatura.	Subscription
InstanceName	string	Não	O nome da instância. Convenções de nomenclatura: O nome deve ter de 2 a 128 caracteres e pode conter letras e caracteres chineses. O nome deve começar com uma letra maiúscula, uma letra minúscula ou um caractere chinês. Não pode começar com http:// ou https://. O nome pode conter dígitos, dois pontos (:), sublinhados (_), pontos (.) ou hifens (-). Se este parâmetro não for especificado, o valor padrão será o InstanceId da instância.	test：Instance_Name.1-2
HostName	string	Não	O nome do host da instância. Convenções gerais de nomenclatura: Pontos (.) e hifens (-) não podem ser usados como primeiro ou último caractere e não podem ser usados consecutivamente. Convenções específicas de nomenclatura: Instâncias Windows: O nome do host deve ter de 2 a 15 caracteres. Pontos (.) não são suportados. O nome do host não pode consistir inteiramente em dígitos. Letras maiúsculas, letras minúsculas, dígitos e hifens (-) são permitidos. Outras instâncias (como Linux): O nome do host deve ter de 2 a 64 caracteres. Múltiplos pontos (.) são suportados. Cada segmento separado por um ponto pode conter letras maiúsculas, letras minúsculas, dígitos e hifens (-).	test-HostName
UniqueSuffix	boolean	Não	Especifica se sufixos sequenciais devem ser adicionados a HostName e InstanceName. Os sufixos sequenciais começam em 001 e não podem exceder 999. Exemplo: LocalHost001, LocalHost002, MyInstance001 e MyInstance002. Valor padrão: false.	false
PublicIpIdentification	boolean	Não	Especifica se um endereço IP público pode ser atribuído à instância especificada. Valores válidos: true (padrão): Um endereço IP público pode ser atribuído. false: Um endereço IP público não pode ser atribuído.	true
PasswordInherit	boolean	Não	Especifica se a senha predefinida da imagem deve ser usada. Valores válidos: true: A senha predefinida da imagem é usada. O parâmetro Password deve estar vazio e você deve garantir que a imagem tenha uma senha predefinida. false: A senha predefinida da imagem não é usada.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	4A431388-2D4B-46F4-A96B-D4E6BD0688C1
InstanceIds	object
InstanceId	array	A lista de IDs de instância.
	string	A lista de IDs de instância.	[i-7ecpqvkicnchxccozrp**,i-6ecpqvkicnchxccozrp**]
Code	integer	O código de retorno. Um valor igual a 0 indica sucesso. Nota Se você chamar esta operação de API usando um SDK, o tipo de retorno é Integer. Se você chamar esta operação de API usando um método comum ou HTTP, o tipo de retorno é String.	0

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4A431388-2D4B-46F4-A96B-D4E6BD0688C1",
  "InstanceIds": {
    "InstanceId": [
      "[i-7ecpqvkicnchxccozrp****,i-6ecpqvkicnchxccozrp****]"
    ]
  },
  "Code": 0
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	StockNotEnough	The specified instance type has insufficient resource.
400	InvalidUserData.NotInWhiteList	The specified user is not authroized to perform this operation.
400	MissingParameter	The input parameter that is mandatory for processing this request is not supplied.
400	InstanceIdNotFound	The input parameter instancdId that is not found.
400	NoPermission	Permission denied.
400	CallInterface	Call Interface Happen Error.
400	InvalidParameter	The input parameter is Invalid.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.
400	InvalidDiskSize.ValueNotSupported	The specified disk capacity is invalid. Specify another capacity and try again.
400	InvalidParameter.Bandwidth	The specified parameter InternetChargeType is not valid.
400	InvalidParameter.Image	The specified image does not support.
400	InvalidParameter.InstanceType	The specified parameter InstanceType is not valid.
400	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
400	unsupported_Ipv6Feature	This ensregion does not support creating instance of the IPv6 type. Select another type.
400	Forbidden.CreateInstance	The user is not in the Goods whitelist of creating instance interface.
400	ENS_OperationUnsupported_KeyPairName	The KeyPairNameis not available or image not support ssh key.
400	ENS_DependencyViolation_WindowsInstance	The instance creating is window, only user password to login.
400	ENS_PASSWORDORKEYPAIRNAME_MODULE_NOT_CHOOSEN	The required module pwd or keyPairName is not inputed
400	InvalidPrivateIpAddress	Specified private IP address is not in the CIDR block of virtual switch.
400	InvalidVSwitchId.NotFound	Specified virtual switch does not exist.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.
400	InvalidPasswordParam.Mismatch	The input password should be null when passwordInherit is true.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.