CreateInstance - ENS - Centro de documentación de Alibaba Cloud

Crea una instancia de suscripción. Esta operación se puede reemplazar por RunInstances. No se agregarán nuevas funciones a CreateInstance.

Descripción de la operación

Frecuencia de llamadas por usuario: 10 llamadas por segundo.
Dado que la creación de instancias es una operación asíncrona, aumente el tiempo de espera de la solicitud según sea necesario. Cuando la API devuelve Code=0, esto solo indica que la solicitud fue exitosa, no que la instancia se haya creado correctamente. Se devuelve un ID de instancia tras una solicitud exitosa. A continuación, puede consultar la instancia por su ID para verificar si se ha creado.
Restricción InvalidUserData.NotInWhiteList: Solo las cuentas agregadas a la lista blanca correspondiente con permisos de compra pueden crear instancias. De lo contrario, se devuelve un error.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ens:CreateInstance

create

*Instance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceType	string	Sí	El tipo de instancia. Para obtener más información sobre los tipos de instancia, consulte Límites.	ens.se1.tiny
EnsRegionId	string	Sí	El ID de la región.	cn-hangzhou
Password	string	No	La contraseña de la instancia. La contraseña debe tener entre 8 y 30 caracteres de longitud y debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Se admiten los siguientes caracteres especiales: ()`~!@#$%^&*-_+=\|{}[]:;'<>,.?/	yourPassword:1
Period	string	Sí	La duración de la suscripción. Valores válidos: 1 a 9 y 12. Unidad: meses.	12
ImageId	string	No	El ID de la imagen que se utiliza para iniciar la instancia.	yourImage ID
SystemDisk.Size	string	No	El tamaño del disco en la nube del sistema. Unidad: GiB. El valor debe ser un múltiplo de 10 y no puede ser menor que el tamaño de la imagen. Para el rango válido, consulte los valores SystemDiskMinSize y SystemDiskMaxSize devueltos por DescribeAvailableResourceInfo. 20 GiB y 40 GiB son configuraciones comunes y no indican que solo se admitan estos dos valores.	40
Quantity	string	Sí	El número de instancias.	1
DataDisk.1.Size	string	No	El tamaño del primer disco en la nube de datos. Unidad: GiB. El tamaño debe ser de al menos 20 GiB y un múltiplo de 10.	50
InternetChargeType	string	No	Este parámetro es obligatorio cuando crea una instancia por primera vez. Si ya tiene recursos de instancia, se utiliza el método de facturación existente de forma predeterminada. Valores válidos: BandwidthByDay: ancho de banda pico diario. 95BandwidthByMonth: ancho de banda percentil 95 mensual.	95BandwidthByMonth
AutoRenewPeriod	string	No	El período de renovación automática. Este parámetro es obligatorio cuando AutoRenew se establece en True. Valores válidos: 1 a 12. Unidad: meses.	12
AutoRenew	string	No	Especifica si se debe habilitar la renovación automática. Valores válidos: True \| False (valor predeterminado).	True
IpType	string	No	El tipo de IP. Valores válidos: ipv4 (valor predeterminado): IPv4. ipv6: IPv6. ipv4Andipv6: IPv4 e IPv6. Valores válidos: ipv4 : IPv4 ipv6 : IPv6 ipv4Andipv6 : IPv4 e IPv6	ipv4
KeyPairName	string	No	El nombre del par de claves. Solo se admite un único nombre.	TestKeyPairName
UserData	string	No	Los datos personalizados. Los datos deben comenzar con `#!`. La longitud máxima es de 256 caracteres y el tamaño máximo es de 16 KB. Solo se admiten scripts de datos personalizados. No se admite la representación de InstanceMetaData. Puede pasar datos personalizados codificados en Base64. Cuando llama a la API para iniciar una solicitud, los datos personalizados que especifica no se cifran. No pase información confidencial como contraseñas y claves privadas en texto sin formato. Si necesita pasar contraseñas o claves privadas, cifre primero el contenido y luego codifíquelo en Base64 antes de pasarlo. Descifre el contenido de la misma manera dentro de la instancia. Para obtener más información, consulte Formato de datos.	#!/bin/sh echo "Hello World. The time is now $(date -R)!" \| tee /home/output.txt
VSwitchId	string	No	El ID del vSwitch.	YourVSwitchId
PrivateIpAddress	string	No	La dirección IP privada. Si especifica una dirección IP privada, también debe especificar el parámetro VSwitchId. El vSwitch debe crearse con antelación. De lo contrario, se devuelve un error.	10.10.10.10
PaymentType	string	No	El método de pago. Actualmente, este es un valor fijo de Subscription (instancia de suscripción). No se admite su modificación. Valores válidos: Subscription : Suscripción.	Subscription
InstanceName	string	No	El nombre de la instancia. Convenciones de nomenclatura: El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras y caracteres chinos. El nombre debe comenzar con una letra mayúscula, una letra minúscula o un carácter chino. No puede comenzar con http:// o https://. El nombre puede contener dígitos, dos puntos (:), guiones bajos (_), puntos (.) o guiones (-). Si no se especifica este parámetro, el valor predeterminado es el InstanceId de la instancia.	test：Instance_Name.1-2
HostName	string	No	El nombre de host de la instancia. Convenciones de nomenclatura generales: Los puntos (.) y los guiones (-) no se pueden usar como primer o último carácter ni se pueden usar consecutivamente. Convenciones de nomenclatura específicas: Instancias de Windows: El nombre de host debe tener entre 2 y 15 caracteres de longitud. No se admiten puntos (.). El nombre de host no puede consistir completamente en dígitos. Se permiten letras mayúsculas, letras minúsculas, dígitos y guiones (-). Otras instancias (como Linux): El nombre de host debe tener entre 2 y 64 caracteres de longitud. Se admiten múltiples puntos (.). Cada segmento separado por un punto puede contener letras mayúsculas, letras minúsculas, dígitos y guiones (-).	test-HostName
UniqueSuffix	boolean	No	Especifica si se deben agregar sufijos secuenciales a HostName e InstanceName. Los sufijos secuenciales comienzan desde 001 y no pueden exceder 999. Ejemplo: LocalHost001, LocalHost002, MyInstance001 y MyInstance002. Valor predeterminado: false.	false
PublicIpIdentification	boolean	No	Especifica si se puede asignar una dirección IP pública a la instancia especificada. Valores válidos: true (valor predeterminado): Se puede asignar una dirección IP pública. false: No se puede asignar una dirección IP pública.	true
PasswordInherit	boolean	No	Especifica si se debe usar la contraseña preestablecida de la imagen. Valores válidos: true: Se utiliza la contraseña preestablecida de la imagen. El parámetro Password debe estar vacío y debe asegurarse de que la imagen tenga una contraseña preestablecida. false: No se utiliza la contraseña preestablecida de la imagen.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	4A431388-2D4B-46F4-A96B-D4E6BD0688C1
InstanceIds	object
InstanceId	array	La lista de ID de instancias.
	string	La lista de ID de instancias.	[i-7ecpqvkicnchxccozrp**,i-6ecpqvkicnchxccozrp**]
Code	integer	El código de retorno. Un valor de 0 indica éxito. Nota Si llama a esta operación de API mediante un SDK, el tipo de retorno es Integer. Si llama a esta operación de API mediante un método común o HTTP, el tipo de retorno es String.	0

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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.	The specified instance ID does not exist.
400	NoPermission	Permission denied.
400	CallInterface	Call Interface Happen Error.	An error occurred when you call the operation.
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.	The specified virtual switch ID 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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.