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.
Actualización más reciente 2023-03-20 GMT+08:00

Creación de BMS

Función

Esta API se utiliza para crear uno o más BMS.

Fondo para configurar el modo de autenticación de inicio de sesión

El inicio de sesión en un BMS se puede autenticar mediante un par de claves o una contraseña. Por motivos de seguridad, se recomienda utilizar la autenticación de pares de claves.

  • Par de claves

    Se utiliza un par de claves para la autenticación de inicio de sesión en BMS.

    Método para invocar a las API: Use el campo key_name para especificar el archivo de clave usado para iniciar sesión en el BMS. Para obtener más información sobre el uso del campo key_name, consulte Tabla 2.

  • Contraseña

    Si elige la contraseña inicial para la autenticación en un BMS, puede iniciar sesión en un BMS utilizando el nombre de usuario y su contraseña inicial. La contraseña inicial del usuario root se utiliza para la autenticación en Linux, mientras que la del usuario Administrator se utiliza para la autenticación en Windows.

    Métodos para invocar las API:

    • Método 1 (recomendado): Utilice el campo adminPass para especificar la contraseña inicial de inicio de sesión de la cuenta de administrador especificada. Para obtener más información acerca de cómo utilizar el campo adminPass, consulte Tabla 2.

      Para los BMS de Linux con Cloud-Init, si se especifica el campo user_data, el campo adminPass no es válido. Para los BMS de Windows con Cloudbase-Init, si se especifica admin_pass en el campo metadata, el campo adminPass no es válido.

    • Método 2:
      • Para los BMS de Linux con Cloud-Init, utilice el campo user_data para inyectar datos. Para obtener más información, véase Tabla 2.
      • Para los BMS de Windows con Cloudbase-Init, usa admin_pass en el campo metadata para inyectar datos. Para obtener más información, véase Tabla 3.

    Las imágenes públicas contienen Cloud-Init o Cloudbase-Init de forma predeterminada. Para las imágenes privadas, debe comprobar si Cloud-Init o Cloudbase-Init está instalado.

Restricciones

  • No se admite la inyección de archivos.
  • Actualmente, solo se pueden crear los BMS anuales/mensuales.
  • Las imágenes del mercado no se pueden utilizar para crear los BMS.

Precauciones

  • Si se utiliza el modo de la autenticación de AK/SK, establezca la región en el código de ejemplo basándose en la columna Region de la sección "Bare Metal Server (BMS)" en Regiones y puntos de conexión y establezca serviceName (abreviatura de nombre de servicio) en BMS.
  • Para obtener más información acerca de los puntos de conexión, consulte la columna Endpoint de la sección "Bare Metal Server (BMS)" en Regiones y puntos de conexión.

URI

POST /v1/{project_id}/baremetalservers

Tabla 1 enumera los parámetros.

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

Especifica el ID del proyecto.

Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Solicitud

  • Parámetros de solicitud

    Parámetro

    Obligatorio

    Tipo

    Descripción

    server

    Object

    Especifica la información del BMS. Para obtener más información, véase Tabla 2.

    Tabla 2 Descripción de la estructura de datos de campo server

    Parámetro

    Obligatorio

    Tipo

    Descripción

    imageRef

    String

    Especifica el ID de imagen o el URL del recurso de imagen utilizado para crear el BMS. El ID tiene el formato de un identificador único universal (UUID).

    Puede obtener el ID de la imagen desde la consola de IMS o siguiendo las instrucciones de Consulta de imágenes en la Referencia de las API de Image Management Service.

    Al usar una API para consultar imágenes, puede agregar el campo ?virtual_env_type=Ironic para filtrar las imágenes del BMS.

    flavorRef

    String

    Especifica el ID de la variante del BMS. El formato es physical.x.x.

    Puede obtener el ID de la variante desde la consola de BMS o usando la API de Consulta de variantes del BMS (API nativa de OpenStack).

    NOTA:

    Para obtener más información sobre las imágenes compatibles con los diferentes tipos de BMS, consulte la sección SO compatibles con diferentes tipos de BMS.

    Solo los tenants de DeC pueden solicitar BMS usando la variante physical.x.x.hba, y solo los discos de DESS se pueden adjuntar a BMS usando esta variante.

    name

    String

    Especifica el nombre del BMS.

    Rango de valores:

    • El valor puede contener un máximo de 63 caracteres que consisten en letras (sin distinción entre mayúsculas y minúsculas), dígitos, guiones bajos (_), guiones (-) y puntos (.).
    • Si se va a crear más de un BMS, las etiquetas similares a -0000 se agregarán automáticamente al final de los nombres del BMS durante la creación. En este caso, el nombre BMS contiene de 1 a 58 caracteres.

    metadata

    Object

    Especifica los metadatos del BMS. El tamaño máximo de los metadatos key y value es de 255 caracteres. Para obtener más información, véase Tabla 3.

    user_data

    No

    String

    Especifica los datos de usuario que se inyectarán durante la creación del BMS. Se pueden inyectar texto, archivos de texto y archivos .gzip.

    Restricciones:

    • El contenido que se va a inyectar debe estar codificado con base64. El tamaño máximo del contenido a inyectar (antes de la codificación) es de 32 KB.
    • Si no se especifica key_name, la contraseña del usuario root para iniciar sesión en el BMS se inyectará de forma predeterminada.
    • Este parámetro es obligatorio cuando se crea un BMS de Linux utilizando el modo de autenticación de contraseña. Su valor es la contraseña inicial de usuario root.

    Requerimientos de complejidad de la contraseña:

    • Contiene de 8 a 26 caracteres.
    • Contiene al menos tres de los siguientes tipos de caracteres: letras mayúsculas, minúsculas, dígitos y characters especiales !@$%^-_=+[{}]:,./?

    Un ejemplo es el siguiente:

    • Utilice una contraseña de texto sin formato (riesgo en la seguridad), por ejemplo, Cloud.1234.
      1
      2
      #!/bin/bash 
      echo 'root:Cloud.1234' | chpasswd ;
      
    • Use una contraseña.
      1
      2
      #!/bin/bash 
      echo 'root:$6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig' | chpasswd -e
      

    donde, $6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig es la contraseña de texto cifrado, que se puede generar de la siguiente manera:

    1. Genere un valor de la sal cifrado.
      1
      2
      [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.mksalt()" 
      $6$V6azyeLwcD3CHlpY
      
    2. Genere una contraseña de texto cifrado basada en el valor de la sal.
      1
      2
      [root@test linux]# python -c "import crypt, getpass, pwd;print crypt.crypt('Cloud.1234','\$6\$V6azyeLwcD3CHlpY')" 
       $6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig
      
    NOTA:

    La inyección de datos no es compatible con los BMS que utilizan una imagen de Linux y el modo de inicio de sesión con contraseña. Para obtener más información sobre cómo inyectar datos de usuario, consulte Inyección de datos de usuario en BMS.

    adminPass

    No

    String

    Especifica la contraseña inicial de inicio de sesión de la cuenta de administrador para iniciar sesión en un BMS mediante la autenticación de contraseña. El administrador de Linux es root y el administrador de Windows es Administrator.

    Requerimientos de complejidad de la contraseña:
    • Contiene de 8 a 26 caracteres.
    • Contiene al menos tres de los siguientes tipos de caracteres: letras mayúsculas, minúsculas, dígitos y characters especiales !@$%^-_=+[{}]:,./?
    • (SO de Linux) No puede contener el nombre de usuario o el nombre de usuario en el sentido inverso.
    • (SO de Windows) No puede contener el nombre de usuario, el nombre de usuario en el orden inverso o más de dos caracteres consecutivos en el nombre de usuario.

    key_name

    No

    String

    Especifica el nombre de un par de claves. Este es un atributo extendido. Para iniciar sesión en el BMS con un par de claves de SSH, establezca el valor en el nombre de una clave privada existente.

    Puedes crear un par de claves usando la API de Creación e importación de un par de claves de SSH (API nativa de OpenStack) o consultar los pares de claves existentes usando la API de Consulta de pares de claves de SSH (API nativa de OpenStack).

    Restricciones:

    • Si se especifican key_name y user_data, user_data solo inyecta datos de usuario.
    • Cuando se utiliza una imagen de Windows para crear un BMS, este parámetro no se puede dejar en blanco porque la imagen de Windows solo admite el inicio de sesión mediante una clave.
    • Para iniciar sesión en un BMS de Windows, descifra el par de claves para obtener una contraseña y utilícelo para iniciar sesión remotamente en el BMS. Para obtener más información, consulte la sección Iniciar sesión con una contraseña de MSTSC.

    security_groups

    No

    Array of objects

    Especifica los grupos de seguridad del BMS. Para obtener más información, véase Tabla 4.

    nics

    Array of objects

    Especifica las NIC del BMS. Para obtener más información, véase Tabla 5.

    Restricciones:

    Se puede conectar un máximo de dos NIC a un BMS. El primero se utilizará como la NIC principal. Si se especifican varias NIC, asegúrese de que todas las NIC pertenecen a la misma VPC.

    availability_zone

    String

    Especifica el nombre de la AZ donde se encuentra el BMS.

    Consulte la sección Regiones y puntos de conexión.

    vpcid

    String

    Especifica el ID de la VPC a la que pertenece el BMS. El valor está en formato UUID. Puede obtener el ID de VPC desde la consola de red o siguiendo las instrucciones en la sección Consulta de detalles de VPC en la Referenciade las API de Virtual Private Cloud.

    publicip

    No

    Object

    Especifica la información de EIP del BMS. Los valores posibles incluyen:

    • Do not use (Este parámetro no está disponible.)
    • Automatically assign: Asignar una nueva EIP.
    • Specify: Especificar una EIP que se ha creado.

    Para obtener más información, véase Tabla 6.

    count

    No

    Integer

    Especifica el número del BMS que se van a crear.

    Restricciones:

    • Si no se especifica este parámetro, el valor predeterminado es 1.
    • Si la cuota es suficiente, el valor máximo es de 24.

    root_volume

    No

    Object

    Especifica las configuraciones de disco del sistema de BMS. Para obtener más información, véase Tabla 7.

    Restricciones:

    Este parámetro es obligatorio si la variante admite el aprovisionamiento rápido de BMS. Para ver cómo comprobar si la variante admite el aprovisionamiento rápido de BMS, consulte la sección Consulta de detalles sobre los parámetros extra_specs de una variante de BMS (API nativa de OpenStack).

    data_volumes

    No

    Array of objects

    Especifica las configuraciones de disco de datos del BMS. Cada estructura de datos representa un disco de datos a crear. Para obtener más información, véase Tabla 8.

    Restricciones:

    Un BMS puede conectar un máximo de 60 discos de EVS (incluidos los discos del sistema y los discos de datos).

    extendparam

    Object

    Especifica el complemento para crear el BMS. Para obtener más información, véase Tabla 9.

    schedulerHints

    No

    Object

    Especifica la información de programación del BMS. Este parámetro es obligatorio para crear un BMS en un DeC.

    Para obtener más información, véase Tabla 10.

    server_tags

    No

    Map<String,String>

    Especifica las etiquetas del BMS.

    • Clave: Una clave de etiqueta contiene un máximo de 36 caracteres Unicode. No se puede dejar en blanco. La clave de etiqueta de un BMS debe ser única. No puede contener caracteres ASCII (0–31) o caracteres especiales =*<>\,|/
    • Valor: un valor de la etiqueta contiene un máximo de 43 caracteres Unicode y se puede dejar en blanco. No puede contener caracteres ASCII (0–31) o caracteres especiales =*<>\,|/
    NOTA:

    Se puede agregar un máximo de 10 etiquetas a un BMS. __type_baremetal es una etiqueta interna del sistema. Por lo tanto, puede agregar un máximo de nueve etiquetas.

    Tabla 3 Descripción de la estructura de datos de campo metadata

    Parámetro

    Obligatorio

    Tipo

    Descripción

    op_svc_userid

    String

    Especifica el ID de usuario. Puede obtener el ID de usuario de My Credential en la consola de gestión.

    BYOL

    No

    String

    Especifica si se proporciona una licencia. El valor puede ser true o false.

    admin_pass

    No

    String

    Especifica la contraseña del administrador del BMS creado con una imagen de Windows.

    Requerimientos de complejidad de la contraseña:
    • Contiene de 8 a 26 caracteres.
    • Contiene al menos tres de los siguientes tipos de caracteres: letras mayúsculas, minúsculas, dígitos y characters especiales !@$%^-_=+[{}]:,./?
    • No puede contener el nombre de usuario, el nombre de usuario al revés o más de dos caracteres consecutivos en el nombre de usuario.

    agency_name

    No

    String

    Especifica el nombre de la delegación de IAM.

    Una delegación proporciona una credencial de seguridad temporal para acceder a un BMS. La representación es creada por el administrador de tenants en la consola IAM.

    NOTA:

    Para obtener y actualizar una delegación, realice los siguientes pasos:

    1. Puede obtener un nombre de delegación válido utilizando la API Listado de delegaciones proporcionada por IAM.
    2. Use la API Actualizar los metadatos de un BMS para cambiar el valor del campo agency_name en los metadatos al nombre de la nueva delegación.
    Tabla 4 Descripción de la estructura de datos de campo security_groups

    Parámetro

    Obligatorio

    Tipo

    Descripción

    id

    No

    String

    Especifica el ID del grupo de seguridad, que tiene efecto para todas las NIC configuradas para el BMS.

    • Si no se especifica este parámetro, el grupo de seguridad predeterminado está enlazado al BMS.
    • Si se requiere este parámetro (en formato UUID), utilice el ID de un grupo de seguridad existente. Para obtener más información acerca de cómo obtener los grupos de seguridad existentes, consulte la sección Consulta de grupos de seguridad en la Referencia de las API de Virtual Private Cloud.
    Tabla 5 Descripción de la estructura de datos de campo nics

    Parámetro

    Obligatorio

    Tipo

    Descripción

    subnet_id

    String

    Especifica la información de subred de una NIC del BMS.

    El valor debe ser el ID de la subred (network_id) creada en la VPC especificada por vpcid y en el formato de UUID. Puede obtener el ID de subred (network_id) desde la consola de VPC o siguiendo las instrucciones en la sección Consulta de subredes en la Referencia de las API de Virtual Private Cloud.

    port_id

    No

    String

    Especifica el ID de NIC de BMS. Si este parámetro no se deja en blanco, se especifica una NIC. En este caso, subnet_id, security_groups, ip_address, ipv6_enable e ipv6_bandwidth no son válidas.

    Puede obtener el ID de la NIC desde la consola de VPC o siguiendo las instrucciones en la sección Consulta de puertos en la Referencia de las API de Virtual Private Cloud.

    Restricciones:

    • La NIC debe estar en el estado DOWN.
    • El ID de VPC de la NIC debe coincidir con la VPC del BMS.

    ip_address

    No

    String

    Especifica la dirección IPv4 de una NIC del BMS.

    Restricciones:

    • Si este parámetro se deja en blanco o se establece en "", una dirección IP no utilizada en la subred de esta red se asigna automáticamente como la dirección IP de la NIC.
    • Si se especifica este parámetro, su valor debe ser una dirección IP no utilizada en el segmento de red de la subred.
    • La dirección IP no se puede especificar al crear los BMS en un lote.
    Tabla 6 Descripción de la estructura de datos de campo publicip

    Parámetro

    Obligatorio

    Tipo

    Descripción

    id

    No

    String

    Especifica el ID de una EIP existente asignado al BMS. El valor está en formato UUID. Puede obtener el ID de EIP desde la consola de red o siguiendo las instrucciones en Consulta de las EIP en las Referencia de las API de Elastic IP.

    Restricciones:

    • Solo se pueden asignar las EIP en el estado DOWN.
    • Las EIP existentes no se pueden utilizar para crear los BMS en un lote. Es decir, este parámetro no es válido en tal caso.

    eip

    No

    Object

    Especifica la configuración para crear una EIP que se asignará automáticamente al BMS. Para obtener más información, véase Tabla 11.

    Puede configurar id y eip en el campo publicip pero no ambos.

    Tabla 7 Descripción de la estructura de datos de campo root_volume

    Parámetro

    Obligatorio

    Tipo

    Descripción

    volumetype

    String

    Especifica el tipo de disco del sistema del BMS. El tipo de disco debe coincidir con el tipo de disco disponible.

    • GPSSD: tipo del disco de SSD de uso general
    • SAS: tipo del disco con E/S alta
    • SSD: tipo del disco con E/S ultraalta

    size

    Integer

    Especifica el tamaño del disco del sistema (GB). El valor oscila entre 40 y 1024.

    Restricciones:

    El tamaño del disco del sistema debe ser mayor o igual al tamaño mínimo del disco del sistema de la imagen (atributo min_disk).

    cluster_id

    No

    String

    Especifica el ID del grupo de almacenamiento al que pertenece el disco del sistema de BMS.

    NOTA:
    • Este parámetro es necesario cuando se utiliza Dedicated Distributed Storage Service (DSS).

    cluster_type

    No

    String

    Especifica el tipo de almacenamiento del disco del sistema de BMS. Un valor de ejemplo es DSS, que indica el servicio de DSS.

    NOTA:
    • Este parámetro es necesario cuando se utiliza DSS.
    Tabla 8 Descripción de la estructura de datos de campo data_volumes

    Parámetro

    Obligatorio

    Tipo

    Descripción

    volumetype

    String

    Especifica el tipo de disco de datos del BMS. El tipo de disco debe coincidir con el tipo de disco disponible.

    • GPSSD: tipo del disco de SSD de uso general
    • SAS: tipo del disco con E/S alta
    • SSD: tipo del disco con E/S ultraalta

    size

    Integer

    Especifica el tamaño del disco de datos (GB). El valor oscila entre 10 y 32768.

    shareable

    No

    Boolean

    Especifica si el disco es compartible.

    • true: el disco de EVS compartido
    • false: el disco de EVS común

    El valor predeterminado es false.

    cluster_id

    No

    String

    Especifica el ID del grupo de almacenamiento al que pertenecen los discos de datos del BMS.

    NOTA:
    • Este parámetro es necesario cuando se utiliza Dedicated Distributed Storage Service (DSS).

    cluster_type

    No

    String

    Especifica el tipo de almacenamiento de los discos de datos del BMS. Un valor de ejemplo es DSS, que indica el servicio de DSS.

    NOTA:
    • Este parámetro es necesario cuando se utiliza DSS.
    Tabla 9 Descripción de la estructura de datos de campo extendparam

    Parámetro

    Obligatorio

    Tipo

    Descripción

    chargingMode

    No

    String

    Especifica el modo de facturación. Rango de valores:

    prePaid: modo de facturación anual/mensual.

    El valor predeterminado es prePaid.

    regionID

    No

    String

    Especifica el identificador de la región donde reside el BMS.

    Consulte la sección Regiones y puntos de conexión.

    periodType

    No

    String

    Specifies the subscription period. Rango de valores:

    • month: indica que la unidad de suscripción es de mes.
    • year: indica que la unidad de suscripción es 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. Rango de valores:

    • Si periodType tiene un valor month, el valor oscila entre 1 y 9.
    • Si periodType tiene el valor de year, el valor es de 1.
    NOTA:

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

    isAutoRenew

    No

    String

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

    • 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 este parámetro no se especifica o se deja en blanco, se deshabilita la renovación automática.

    isAutoPay

    No

    String

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

    • true: El pedido se pagará automáticamente.
    • false: Usted debe pagar manualmente el pedido.
    NOTA:

    Este parámetro es válido cuando chargingMode se establece en prePaid. Si este parámetro no se especifica o se deja en blanco, se requiere un pago manual.

    Tabla 10 Descripción de la estructura de datos de campo schedulerHints

    Parámetro

    Obligatorio

    Tipo

    Descripción

    dec_baremetal

    No

    String

    Especifica si se debe crear el BMS en un DeC. El valor puede ser share o dedicate.

    Restricciones:

    • Si no se especifica este parámetro, el valor predeterminado es share.
    • Para crear un BMS en un DeC, establezca este parámetro en dedicate.
    Tabla 11 Descripción de la estructura de datos de campo eip

    Parámetro

    Obligatorio

    Tipo

    Descripción

    iptype

    String

    Especifica el tipo de la EIP.

    Valores enumerados: 5_bgp y 5_sbgp

    Para obtener más información, consulte el campo publicip en la sección Asignación de una EIP de la Referencia de las API de Elastic IP.

    bandwidth

    Object

    Especifica el ancho de banda de EIP. Para obtener más información, véase Tabla 12.

    extendparam

    Object

    Proporciona la información adicional sobre la EIP. Para obtener más información, véase Tabla 13.

    Tabla 12 Descripción de la estructura de datos de campo bandwidth

    Parámetro

    Obligatorio

    Tipo

    Descripción

    name

    No

    String

    Especifica el nombre del ancho de banda.

    sharetype

    String

    Especifica el tipo de uso compartido de ancho de banda.

    El valor PER indica el ancho de banda dedicado y WHOLE indica el ancho de banda compartido.

    id

    No

    String

    Especifica el ID del ancho de banda compartido. Puede especificar un ancho de banda compartido existente al solicitar una EIP con un ancho de banda WHOLE.

    NOTA:

    Este parámetro es obligatorio cuando sharetype se establece en WHOLE.

    size

    Integer

    • El valor varía de 5 Mbit/s a 2000 Mbit/s de forma predeterminada. (El rango 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.)
    • Especifica el ancho de banda (Mbit/s). El ancho de banda mínimo compartido es de 5 Mbit/s por defecto.
    NOTA:
    • Si se especifica una fracción decimal (por ejemplo, 10.2) o una string de caracteres (por ejemplo, 10), el valor especificado se convertirá automáticamente en un entero. Si el ancho de banda es inferior a 300 Mbit/s, el paso es 1 Mbit/s. Si el ancho de banda es de 300 Mbit/s a 1000 Mbit/s, el paso es de 50 Mbit/s. Si el ancho de banda es de 1000 Mbit/s a 2000 Mbit/s, el paso es de 1000 Mbit/s.
    • Este parámetro es obligatorio cuando sharetype se establece en PER y es opcional cuando sharetype se establece en WHOLE con un ID especificado.

    chargemode

    No

    String

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

    El valor puede ser traffic o bandwidth.

    • Si no se especifica este campo, el modo de facturación es ancho de banda.
    • Si no se especifica este campo, el modo de facturación es ancho de banda.
    Tabla 13 Descripción de la estructura de datos de campo extendparam para asignar una EIP

    Parámetro

    Obligatorio

    Tipo

    Descripción

    chargingMode

    String

    Especifica el modo de facturación de una EIP. Si el modo de facturación de ancho de banda es de bandwidth, se admiten tanto prePaid como postPaid. Si el modo de facturación de ancho de banda es de traffic, solo se admite postPaid.

    Rango de valores:

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

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

  • Ejemplo de solicitud (creando un BMS cargado en modo anual/mensual y con el modo de inicio de sesión con contraseña)
    1
    POST https://{BMS Endpoint}/v1/{project_id}/baremetalservers
    
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    {
        "server": {
            "availability_zone": "az1",
            "name": "bms-75c7",
            "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94",
            "flavorRef": "physical.s3.large",
            "data_volumes": [
                {
                    "volumetype": "SAS",
                    "size": 10,
                    "shareable": false
                }
            ],
            "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb",
            "nics": [
                {
                    "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616",
                    "ip_address": ""
                }
            ],
            "count": 1,
            "schedulerHints": {
                "dec_baremetal": "share"
            },
            "extendparam": {    
                "chargingMode": "prePaid",
                "periodType": "month",
                "periodNum": 1,
                "isAutoRenew": "true",
                "isAutoPay": "true",
                "regionID": "region01"
            },
            "metadata": {
                "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81",
                "BYOL": "false",
                "admin_pass": ""
            },
            "publicip": {
                "id": "1b036bce-26b4-465c-acea-99fdbb0573a3"
            },
            "user_data":  "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiR0Y0pZamUkNGhhUHlNZFR4VWVHc2dTMWFmL1NsMm4vbXZzdy5wSFdjbTVBc084OWFhUFhGNXUvVnJ5OXJiYmZZSW45SmZac2k3SlRmd2Z6djJPbTBHRFZUZTd6RDEnIHwgY2hwYXNzd2QgLWU7",
            "security_groups": [
                {
                    "id": "993f2916-5bad-4f24-bc3c-db539f1a6d19"
                }
            ]
        }
    }
    
  • Ejemplo de solicitud (creando un BMS de Linux cargado en modo anual/mensual y con el modo de inicio de sesión de par de claves)
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    {
        "server": {
            "availability_zone": "az1",
            "name": "bms-3b91",
            "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94",
            "flavorRef": "physical.o2.large",
            "data_volumes": [
                {
                    "volumetype": "SAS",
                    "size": 10,
                    "shareable": true
                }
            ],
            "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb",
            "nics": [
                {
                    "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616",
                    "ip_address": ""
                },
                {
                    "subnet_id": "2b8bcf33-33f2-4a63-aa9c-b1e17ff0ed7f",
                    "ip_address": ""
                }
            ],
            "count": 1,
            "schedulerHints": {
                "dec_baremetal": "share"
            },
            "extendparam": {
                "chargingMode": "prePaid",
                "periodType": "month",
                "periodNum": 1,
                "isAutoRenew": "true",
                "isAutoPay": "true",
                "regionID": "region01"
            },
            "metadata": {
                "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81",
                "BYOL": "false"
            },
            "publicip": {
                "eip": {
                    "iptype": "5_bpg",
                    "bandwidth": {
                        "chargemode": "",
                        "name": "bms-3b91-bandwidth",
                        "size": 1,
                        "sharetype": "PER"
                    }
                    "extendparam": {
                       "chargingMode": "prePaid",
                    }
                }
            },
            "security_groups": [
                {
                    "id": "993f2916-5bad-4f24-bc3c-db539f1a6d19"
                }
            ],
            "key_name": "KeyPair-zbb29"
        }
    }
    

    El siguiente es un ejemplo de user_data generado por el lenguaje Java:

    1
    2
    3
    String userData_org = "#!/bin/bash \r\n echo    'root:xxxxx' | chpasswd ;";
    byte[] userData_byte = userData_org.getBytes();
    String userData = new BASE64Encoder().encode(userData_byte);
    
  • Ejemplo de solicitud (creando un BMS de Windows cargado en modo anual/mensual y con el modo de inicio de sesión de par de claves)
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    { 
         "server": { 
             "availability_zone": "az1", 
             "name": "bms-6a1e", 
             "imageRef": "fd04041a-5f35-45ae-a27c-bf30f921c6b5", 
             "flavorRef": "physical.s3.large", 
             "data_volumes": [ 
                 { 
                     "volumetype": "SAS", 
                     "size": 10, 
                     "shareable": false 
                 } 
             ], 
             "vpcid": "0adc2847-c160-4263-be1f-e03d36e93e32", 
             "nics": [ 
                 { 
                     "subnet_id": "4f1cf6cc-4cc3-41d3-8192-625293dccce0", 
                     "ip_address": "" 
                 } 
             ], 
             "count": 1, 
             "schedulerHints": { 
                 "dec_baremetal": "share" 
             }, 
            "extendparam": { 
                "chargingMode": "prePaid", 
                "periodType": "month", 
                "periodNum": 1, 
                "isAutoRenew": "true", 
                "isAutoPay": "true", 
                "regionID": "region1" 
             }, 
             "metadata": { 
                "op_svc_userid": "8a74baed155b47e8b59fbca853d6cb48", 
                "BYOL": "false" 
             }, 
             "publicip": { 
                 "id": "db9c4f39-fabd-4cc2-8685-82e7715d099f" 
             }, 
             "user_data": "cWF6PTEyMw==", 
             "security_groups": [ 
                 { 
                     "id": "33cf5e40-0b65-4e03-867d-4c67947c49be" 
                 } 
             ], 
             "key_name": "KeyPair-Maoz" 
         } 
     }
    
  • {
        "server": {
            "name": "bms-roce-test",
            "availability_zone": "cn-arm",
            "flavorRef": "physical.kat1.8xlarge.ondemand",
            "imageRef": "6a299c39-f558-4912-b982-fc993a6ed5fd",
            "vpcid": "844ecdc5-8c81-4caa-a3f4-7de41c7ee96e",
            "nics": [
                {
                    "subnet_id": "18cea8f7-1892-42b0-ab4e-ea4287514c2e"
                },
                {
                    "subnet_id": "270dc482-a624-4cef-b90d-42d272917bea"    
                }
            ],
            "security_groups": [
                {
                    "id": "bc2ebcf9-29c9-4679-bdc4-316e638c059d"
                }
            ],
            "extendparam": {
                "chargingMode": 0,
                "regionID": "cn-xian-3"
            },
            "metadata": {
                "op_svc_userid": "e81efc34179c4186bd2bd4f9a2378cac",
                "BYOL": "false"
            },
            "server_tags": [],
            "user_data": "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRzTFRVRzMkajN6VXVTREw4cnFMam1jZTJhQVpQZ3JIYUp0ejk0WmdmaUhtYXljRUdsS1BXOS9EVjlpTjR4cFRpTE1KYnVPTjVsdG1uSHF5bTZNc2Q4T0F5dHRkTTAnIHwgY2hwYXNzd2QgLWU7",
            "count": 1
        }
    }
  • {
        "server": {
            "name": "bms-75c7",
            "availability_zone": "az1",
            "flavorRef": "physical.kat1.8xlarge.ondemand",
            "imageRef": "6a299c39-f558-4912-b982-fc993a6ed5fd",
            "vpcid": "844ecdc5-8c81-4caa-a3f4-7de41c7ee96e",
            "root_volume": {
                "size": 40,
                "volumetype": "SSD"
            },
            "nics": [
                {
                    "subnet_id": "18cea8f7-1892-42b0-ab4e-ea4287514c2e"
                },
                {
                    "subnet_id": "270dc482-a624-4cef-b90d-42d272917bea"    
                }
            ],
            "security_groups": [
                {
                    "id": "bc2ebcf9-29c9-4679-bdc4-316e638c059d"
                }
            ],
            "extendparam": {
                "chargingMode": 0,
                "regionID": "cn-xian-3"
            },
            "metadata": {
                "op_svc_userid": "e81efc34179c4186bd2bd4f9a2378cac",
                "BYOL": "false"
            },
            "server_tags": [],
            "user_data": "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRzTFRVRzMkajN6VXVTREw4cnFMam1jZTJhQVpQZ3JIYUp0ejk0WmdmaUhtYXljRUdsS1BXOS9EVjlpTjR4cFRpTE1KYnVPTjVsdG1uSHF5bTZNc2Q4T0F5dHRkTTAnIHwgY2hwYXNzd2QgLWU7",
            "count": 1
        }
    }

Respuesta

  • Parámetros de respuesta
Tabla 14 Respuesta normal

Parámetro

Tipo

Descripción

order_id

String

Especifica el ID de pedido devuelto después de enviar un pedido. Puede consultar el progreso del procesamiento del pedido basado en el ID. Para consultar el progreso del procesamiento de pedidos, inicie sesión en la consola de gestión y elija Billing > My Orders.

job_id

String

Especifica el ID de tarea devuelto después de ejecutar un comando de tarea. El ID de tarea se puede utilizar para consultar el estado de ejecución de la tarea.

Para obtener más información acerca de cómo consultar el estado de ejecución de la tarea basado en job_id, consulte Consulta de estados de tareas.

Tabla 15 Respuesta anormal

Parámetro

Tipo

Descripción

error

Dictionary data structure [1]

Especifica el error devuelto cuando un envío de tareas encuentra una excepción. Para obtener más información, consulte la sección Estructura de datos de error.

Tabla 16 Estructura de datos de error

Parámetro

Tipo

Descripción

message

String

Especifica el mensaje de error.

code

String

Especifica el código de error.

Ejemplo de la respuesta

  • Respuesta normal
    { 
        "order_id": "CS2009141523OQSEQ",
        "job_id": "ff808081748b760c01748b7f80370003"
    }

Valores devueltos

Valores normales

Valores devueltos

Descripción

200

La solicitud se ha procesado correctamente.

Para obtener más información sobre otros valores devueltos, consulte Códigos de estado.

Códigos de error

Véase Códigos de error.