Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ Estructura de datos/ Estructura de datos para crear ECS
Actualización más reciente 2022-11-08 GMT+08:00
Compartir

Estructura de datos para crear ECS

Notas

Las API de ECS pueden ser de V1 o V1.1. Las API V1 solo se pueden usar para crear ECS de pago por uso, mientras que las API V1.1 se pueden usar para crear ECS de pago por uso y anuales/mensuales.

Para los campos descritos en esta sección, use las API V1.1 para ECS anuales/mensuales.

Contenidos

Descripción del campo publicip

Este campo es utilizado por las siguientes API:
  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 1 Descripción del campo publicip

Parámetro

Obligatorio

Tipo

Descripción

id

No

String

Especifica el ID del EIP existente asignado al ECS que se va a crear. El valor está en formato UUID.

Solo se pueden asignar EIPs en estado DOWN.

eip

No

Object

Especifica un EIP que se asignará automáticamente a un ECS.

Para más detalles, consulte Tabla 3.

delete_on_termination

No

Boolean

Especifica si se libera el EIP cuando se elimina el ECS al que está enlazado el EIP.

  • true: El EIP se libera cuando se elimina el ECS.
  • false: El EIP no se libera cuando se elimina el ECS.

El valor predeterminado es false.

NOTA:

Este parámetro solo está disponible para EIP de pago por uso.

Se pueden configurar id o eip en el campo publicip.

Descripción del campo security_groups

Este campo es utilizado por las siguientes API:

  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 2 Descripción del campo security_groups

Parámetro

Obligatorio

Tipo

Descripción

id

No

String

Especifica el ID del grupo de seguridad al que se va a agregar un ECS. La configuración tendrá efecto en las NICs de ECS. Debe especificar el ID de un grupo de seguridad existente en formato UUID. De lo contrario, se utilizará el grupo de seguridad predeterminado en la capa subyacente.

Descripción del campo eip

Este campo es utilizado por las siguientes API:
  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 3 Descripción del campo eip

Parámetro

Obligatorio

Tipo

Descripción

iptype

Sí

String

Especifica el tipo de EIP.

Para obtener más información, consulte la descripción del campo publicip en Asignar un EIP.

bandwidth

Sí

Object

Especifica el ancho de banda de EIP.

Para más detalles, consulte Descripción del campo bandwidth.

Descripción del campo bandwidth

Este campo es utilizado por las siguientes API:
  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 4 Descripción del campo bandwidth

Parámetro

Obligatorio

Tipo

Descripción

size

Sí

Integer

Especifica el tamaño del ancho de banda.

Especifica el ancho de banda (Mbit/s). El valor varía de 1 a 300.

El intervalo específico puede variar dependiendo de la configuración en cada región. Puede ver el rango de ancho de banda de cada región en la consola de gestión.

El incremento mínimo para el ajuste de ancho de banda varía dependiendo del rango de ancho de banda.
  • El incremento mínimo es de 1 Mbit/s si el ancho de banda permitido oscila entre 0 Mbit/s y 300 Mbit/s (con 300 Mbit/s incluidos).
  • El incremento mínimo es de 50 Mbit/s si el ancho de banda permitido oscila entre 300 Mbit/s y 1000 Mbit/s (con 1000 Mbit/s incluidos).
  • El incremento mínimo es de 500 Mbit/s si el ancho de banda permitido es mayor que 1000 Mbit/s.
NOTA:

Este parámetro es obligatorio cuando sharetype se establece en PER y es opcional cuando sharetype se establece en WHOLE con un ID especificado.

sharetype

Sí

String

Especifica el tipo de uso compartido de ancho de banda.

Valores enumerados: PER (indica ancho de banda exclusivo) y WHOLE (indica compartir)

chargemode

No

String

Especifica el modo de facturación del ancho de banda.

  • Si el valor del campo es traffic, el ECS se factura por el tráfico.
  • Si el valor del campo es otro, se producirá un error al crear el ECS.

Descripción del campo ipv6_bandwidth

Este campo es utilizado por las siguientes API:
  • Creating ECSs: /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 5 Descripción del campo ipv6_bandwidth

Parámetro

Obligatorio

Tipo

Descripción

id

No

String

Especifica el ID de un ancho de banda IPv6.

Descripción del campo extendparam para asignar EIP

Este campo es utilizado por la siguiente API:

Creating ECSs /v1.1/{project_id}/cloudservers

Tabla 6 Descripción del campo extendparam para asignar EIP

Parámetro

Obligatorio

Tipo

Descripción

chargingMode

No

String

Especifica el modo de facturación de un EIP.

Opciones:

  • prePaid: indica el modo de facturación anual/mensual.
  • postPaid: indica el modo de facturación de pago por uso.
    NOTA:

    Si sharetype en el parámetro de bandwidth con un ID especificado se establece en WHOLE, solo se permiten EIP de pago por uso y el parámetro prePaid no está disponible.

Descripción del campo extendparam para crear discos

Este campo es utilizado por las siguientes API:

  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 7 Descripción del campo extendparam para crear discos

Parámetro

Obligatorio

Tipo

Descripción

resourceSpecCode

No

String

Especifica el código de las especificaciones del disco, como SATA, SAS o SSD.

NOTA:

Este campo ha sido descartado.

resourceType

No

String

Especifica el tipo de recurso.

NOTA:

Este campo ha sido descartado.

snapshotId

No

String

Especifica el ID de instantánea o el ID del disco de datos original contenido en la imagen de ECS completo.

Casos de aplicación:

Este parámetro se utiliza si se crea un ECS utilizando una imagen de ECS completo y la imagen contiene uno o más discos de datos.

Si utiliza una imagen ECS completa para crear un ECS, el sistema restaura automáticamente el tipo de datos y los datos de los discos de datos de la imagen. El parámetro snapshotId permite especificar el tipo de disco para el disco de datos original después de la restauración.

NOTA:
  • Se recomienda establecer snapshotId para cada disco de datos original. De lo contrario, los discos de datos originales sin snapshotId especificados utilizarán la configuración predeterminada.
  • Si tiene que cambiar un tamaño de disco, asegúrese de que el tamaño de disco cambiado es mayor o igual que el tamaño del disco de datos original. De lo contrario, la restauración de los datos del disco de datos original fallará.

Reglas de trabajo:

snapshotId identifica de forma única un disco de datos original contenido en una imagen de ECS completo. Puede utilizar snapshotId para obtener la información del disco de datos original para la restauración de datos.

Obtención de snapshotId a través de la consola de gestión:

Inicie sesión en la consola de gestión, seleccione Elastic Volume Service > Snapshot. A continuación, utilice el nombre del disco de datos original para encontrar el ID de instantánea o el ID de disco original.

Obtención de snapshotId a través de la API:

Si ha obtenido el ID de imagen completo de ECS, obtenga el ID de copia de seguridad de Cloud Backup and Recovery (CBR) o Cloud Server Backup Service (CSBS) asociado con el ID de imagen completo de ECS siguiendo las instrucciones proporcionadas en la API para consultar los detalles de la imagen.
  • Si se utiliza la copia de seguridad de CBR, utilice el ID de copia de seguridad de CBR para obtener la copia de seguridad. El resource_id o snapshot_id contenidos en el campo secundario de la respuesta es el snapshotId deseado. Para obtener más información, consulta la API de "Consulta de una copia de seguridad especificada" en la Guía del usuario de Cloud Backup and Recovery.
  • Si se utiliza la copia de seguridad CSBS, utilice el ID de copia de seguridad CSBS para obtener la copia de seguridad. El source_volume_id o snapshot_id contenidos en el campo volume_backups en la respuesta es el snapshotId deseado. Para obtener más información, consulta la API de "Consulta de una copia de seguridad única" en la Guía del usuario del Cloud Server Backup Service.

Descripción del campo extendparam para crear ECS

Este campo es utilizado por las siguientes API:
  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 8 Descripción del campo extendparam para crear ECS (para APIs V1)

Parámetro

Obligatorio

Tipo

Descripción

chargingMode

No

Integer

Especifica el modo de facturación.

  • 0: indica el modo de facturación de pago por uso. El valor predeterminado es 0.

regionID

No

String

Especifica el identificador de la región en la que reside el ECS.

Consulte Regiones y endpoint.

CB_CSBS_BACKUP

No

String

Especifica un ID de política CSBS y un ID de almacén CSBS.

Por ejemplo, un ID de política CSBS obtenido en la consola es fdcaa27d-5be4-4f61-afe3-09ff79162c04.

Un ID de almacén de CSBS es 332a9408-463f-436a-9e92-78dad95d1ac4.

El valor CB_CSBS_BACKUP es "{\"policy_id\":\"fdcaa27d-5be4-4f61-afe3-09ff79162c04\",\"vault_id\":\"332a9408-463f-436a-9e92-78dad95d1ac4\"}".
Tabla 9 Descripción del campo extendparam para crear ECS (para APIs V1.1)

Parámetro

Obligatorio

Tipo

Descripción

chargingMode

No

String

Especifica el modo de facturación.

Opciones:

  • prePaid: indica el modo de facturación anual/mensual.
  • postPaid: indica el modo de facturación de pago por uso.
  • El valor predeterminado es postPaid.
    NOTA:

    Cuando chargingMode está configurado en prePaid (indicando que el ECS creado se factura en pagos anuales/mensuales) y el ECS se inicia con una clave SSH, op_svc_userid en metadata es obligatorio.

regionID

No

String

Especifica el ID de la región donde reside el ECS.

Consulte Regiones y endpoint.

periodType

No

String

Especifica el período de suscripción.

Opciones:

  • month: indica que la suscripción está en la unidad de mes.
  • year: indica que la suscripción está en la unidad del año.
    NOTA:

    Este parámetro es válido y obligatorio si chargingMode está configurado en prePaid.

periodNum

No

Integer

Especifica el número de períodos de suscripción.

Opciones:

  • Si periodType es month, el rango de valor es entre 1 y 9.
  • Si periodType es year, el rango de valor es entre 1 y 3.
    NOTA:
    • Este parámetro es válido y obligatorio si chargingMode está configurado en prePaid.
    • El valor del parámetro debe ser un entero positivo.

isAutoRenew

No

String

Especifica si la renovación automática está habilitada.

  • true: indica que la renovación automática está activada.
  • false: indica que la renovación automática está deshabilitada.
    NOTA:

    Este parámetro es válido cuando chargingMode se establece en prePaid. Si no se especifica este parámetro, la renovación automática está deshabilitada de forma predeterminada.

isAutoPay

No

String

Especifica si el pedido se paga automáticamente o manualmente.

  • true: El pedido se pagará automáticamente.
  • false: El pedido debe ser pagado manualmente.
NOTA:

Este parámetro es válido cuando chargingMode se establece en prePaid. Si no se especifica este parámetro, el pedido debe pagarse manualmente de forma predeterminada.

support_auto_recovery

No

Boolean

Especifica si se habilitará la recuperación automática de ECS.

  • true: habilita esta función.
  • false: desactiva esta función.
NOTA:

Este parámetro es de tipo boolean. Si se importa un carácter non-boolean, el valor del parámetro se establece en false.

marketType

No

String

Especifica un ECS de spot Al crear un ECS spot, establezca el valor del parámetro en spot.

NOTA:

Este parámetro solo tiene efecto cuando chargingMode se establece en postPaid y marketType se establece en spot.

spotPrice

No

String

Especifica el precio más alto por hora que acepta para un ECS spot.

NOTA:
  • Este parámetro solo tiene efecto cuando chargingMode se establece en postPaid y marketType se establece en spot.
  • Cuando chargingMode se establece en postPaid y marketType se establece en spot, si el parámetro spotPrice no se especifica o se especifica en null, el precio de pago por uso se utiliza de forma predeterminada.
  • El valor spotPrice debe ser menor o igual que el precECS y mayor o igual que el precio de mercado de ECS.

Descripción del campo metadata para crear discos

Este campo es utilizado por las siguientes API:

  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 10 Descripción del campo metadata para crear discos

Parámetro

Obligatorio

Tipo

Descripción

__system__encrypted

No

String

Especifica el encriptación en metadata. El valor puede ser 0 (encriptación desactivada) o 1 (encriptación activada).

Si este parámetro no existe, el disco no se cifrará de forma predeterminada.

__system__cmkid

No

String

Especifica el ID de CMK, que indica el encriptación en metadata. Este parámetro se utiliza con __system__encrypted.

NOTA:

Para obtener más información sobre cómo obtener el ID de CMK, consulte Consulta de la lista de CMK.

Descripción del campo de metadata para crear ECS

Este campo es utilizado por las siguientes API:

  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 11 metadata reserved field description

Parámetro

Obligatorio

Tipo

Descripción

op_svc_userid

No

String

Especifica el ID de usuario.

NOTA:

Cuando chargingMode en el parámetro extendparam se establece en prePaid (indicando que el ECS creado se factura en pagos anuales/mensuales) y el ECS está conectado con una clave SSH, este campo es obligatorio.

agency_name

No

String

Especifica el nombre de la delegación de IAM.

Una delegación es creada por un administrador tenant en Identity and Access Management (IAM) para proporcionar credenciales temporales para que los ECS accedan a los servicios en la nube.

Descripción del campo os:scheduler_hints

Este campo es utilizado por las siguientes API:
  • Creating ECSs /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
  • Creating ECSs (native API): /v2.1/{project_id}/servers
Tabla 12 Descripción del campo os:scheduler_hints (parámetros de solicitud)

Parámetro

Obligatorio

Tipo

Descripción

group

No

String

Especifica un ID de grupo ECS, que está en formato UUID.

Obtenga el valor del parámetro de la consola o realizando las operaciones proporcionadas en Consulta de grupos de ECS.

NOTA:

Asegúrese de que el grupo ECS utiliza la política antiafinidad. No se recomienda utilizar otras políticas.

tenancy

No

String

Crea los ECS en un host dedicado o compartido.

El valor de este parámetro puede ser dedicated o shared.

dedicated_host_id

No

String

Especifica el ID de host dedicado.

NOTA:

Un ID de DeH solo tiene efecto cuando tenancy se establece en dedicated.
Tabla 13 Descripción del campo os:scheduler_hints (parámetros de respuesta)

Parámetro

Tipo

Descripción

group

Array of strings

Especifica un ID de grupo de ECS, que está en formato UUID.

Obtenga el valor del parámetro de la consola o realizando las operaciones proporcionadas en Consulta de grupos de ECS.

tenancy

Array of strings

Crea los ECS en un host dedicado o compartido.

El valor de este parámetro puede ser dedicated o shared.

dedicated_host_id

Array of strings

Especifica el ID de host dedicado.

NOTA:

Un ID de DeH solo tiene efecto cuando tenancy se establece en dedicated.

Descripción del campo server_tags

Este campo es utilizado por las siguientes API:
  • Creating ECSs: /v1/{project_id}/cloudservers
  • Creating ECSs: /v1.1/{project_id}/cloudservers
Tabla 14 server_tags field description

Parámetro

Obligatorio

Tipo

Descripción

key

Sí

String

Especifica la clave de etiqueta.

La clave puede contener un máximo de 36 caracteres de Unicode. No puede dejarse en blanco ni contener ASCII (0-31) o los siguientes caracteres: =*<>\,|/

La clave de etiqueta de un ECS debe ser única.

value

Sí

String

Especifica el valor de etiqueta.

El valor puede contener un máximo de 43 caracteres Unicode y puede dejarse en blanco. No puede contener ASCII (0-31) ni los siguientes caracteres: =*<>\,|/
Tema principal: Estructura de datos