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 2024-09-04 GMT+08:00

Creación de discos de EVS (obsoleto)

Función

Esta API se utiliza para crear uno o varios discos de EVS. Esta invocación a la API existe solo por razones de compatibilidad y no está destinada a ser utilizada. Use otra API.

Método de invocación

Para obtener más información, consulte Invocación a las API.

URI

POST /v2/{project_id}/cloudvolumes

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

El ID del proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

Un token obtenido de IAM tiene una validez de 24 horas. Cuando utilice un token para autenticación, guarde un caché para evitar invocar con frecuencia a la API.

Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

volume

CreateDiskOption object

La información del disco que se va a crear.

OS-SCH-HNT:scheduler_hints

No

CreateVolumeSchedulerHints object

云硬盘调度参数,可用于指定云硬盘创建到某个专属存储池中

Tabla 4 CreateDiskOption

Parámetro

Obligatorio

Tipo

Descripción

availability_zone

String

La zona de disponibilidad donde desea crear el disco.

backup_id

No

String

El ID de copia de respaldo. Este parámetro es obligatorio cuando se crea el disco a partir de una copia de respaldo.

count

No

Integer

El número de discos que se crearán por un lote. Si no se especifica este parámetro, solo se creará un disco. Puede crear un máximo de 100 discos por un lote. Si el disco se crea a partir de una copia de respaldo, la creación por lotes no es posible y este parámetro debe establecerse en 1.

Si el valor especificado es un número decimal, se utilizará la parte numérica por defecto.

description

No

String

La descripción del disco. Puede escribir hasta 85 caracteres.

enterprise_project_id

No

String

El ID del proyecto de empresa. Este ID se asocia con el disco durante la creación del disco.

imageRef

No

String

El ID de la imagen. Si se especifica este parámetro, el disco se crea a partir de una imagen.

metadata

No

Map<String,String>

La información de metadatos del disco. El valor puede ser los siguientes: __system__cmkid:

El ID de CMK de encriptación de metadata. Este parámetro se utiliza junto con __system__encrypted para la encriptación. La longitud de cmkid se fija en 36 bytes.

NOTA:

Para obtener detalles sobre cómo obtener el ID de clave, véase Consulta de la lista de claves.

__system__encrypted:

El campo de encriptación de metadata. El valor puede ser 0 (no cifra) o 1 (cifra). Si no se especifica este parámetro, el atributo de encriptación del disco es el mismo que el del origen de datos. Si el disco no se crea a partir de un origen de datos, el disco no se cifra de forma predeterminada.

[full_clone]

Si el disco se crea a partir de una instantánea y es necesario utilizar la clonación vinculada, establezca este parámetro en 0.

[hw:passthrough]

  • Si el valor de este parámetro es true, el tipo de dispositivo de disco es SCSI, lo que permite que los sistemas operativos de ECS accedan directamente a los medios de almacenamiento subyacentes y admite comandos de reserva de SCSI.

  • Si el valor de este parámetro es false, el tipo de dispositivo de disco es VBD, que solo admite comandos simples de lectura/escritura de SCSI.

  • Si este parámetro no está disponible, el tipo de dispositivo de disco es VBD.

multiattach

No

Boolean

Si el disco se puede compartir. El valor puede ser true (se puede compartir) o false (no se puede compartir).

name

No

String

El nombre del disco.

Si crea un disco, el valor name es el nombre del disco, que puede contener un máximo de 64 caracteres.

Si crea varios discos (el valor de count es mayor que 1), el sistema automáticamente agrega un guion seguido de un número incremental de cuatro dígitos, como -0000, al final de cada nombre de disco. Ejemplo de nombre de disco: volume-0001 o volume-0002

shareable

No

String

Si el disco se puede compartir. El valor puede ser true (se puede compartir) o false (no se puede compartir). \n Este campo ha sido desaprobado. Use multiattach.

size

Integer

El tamaño del disco, en GiB. Las restricciones son las siguientes:

  • Disco del sistema: 1 GiB a 1,024 GiB

  • Disco de datos: 10 GiB a 32,768 GiB

  • Este parámetro es obligatorio cuando se crea un disco vacío o se utiliza una imagen o una instantánea para crear un disco. Si utiliza una imagen o una instantánea para crear un disco, el tamaño del disco no puede ser menor que el de la imagen o la instantánea.

  • Este parámetro es opcional si crea el disco a partir de una copia de respaldo. Si no se especifica, el tamaño del disco es el mismo que el de la copia de respaldo.

snapshot_id

No

String

El ID de la instantánea. Si se especifica este parámetro, el disco se crea a partir de una instantánea.

volume_type

String

El tipo de disco.

El valor puede ser SATA, SAS, GPSSD, SSD, ESSD, GPSSD2 o ESSD2.

  • SATA: el tipo de E/S común (agotado)

  • SAS: el tipo de E/S alta

  • GPSSD: el tipo de SSD de uso general

  • SSD: el tipo de E/S ultraalta

  • ESSD: el tipo de SSD extrema

  • GPSSD2: el tipo V2 de SSD de uso general

  • ESSD2: el tipo extremo de SSD V2

Si el tipo de disco especificado no está disponible en zona de disponibilidad, no se creará el disco.

NOTA:

Cuando cree un disco a partir de una instantánea, asegúrese de que el tipo de disco del nuevo disco coincida con el del disco de origen de la instantánea.

NOTA:

Para obtener detalles acerca de los tipos de disco, consulte

Tipos de disco y rendimiento.

Valores de enumeración:

  • SATA

  • SAS

  • GPSSD

  • SSD

  • ESSD

  • GPSSD2

  • ESSD2

tags

No

Map<String,String>

La información de la etiqueta del disco.

Tabla 5 CreateVolumeSchedulerHints

Parámetro

Obligatorio

Tipo

Descripción

dedicated_storage_id

No

String

El ID del grupo de almacenamiento dedicado. Si se especifica este parámetro, los discos se crearán en el grupo de almacenamiento especificado.

Parámetros de respuesta

Código de estado: 202

Tabla 6 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

job_id

String

El ID de la tarea. Este parámetro se devuelve cuando se factura el disco según el pago por uso. > > >Puede consultar si la tarea de creación del disco se ha completado por ID de tarea. Para obtener más detalles, véase Consulta del estado de las tareas.

volume_ids

Array of strings

Los ID de los discos que se van a crear. >>Si se devuelve 404 al consultar los detalles de un disco por ID de disco, significa que el disco se está creando o no se ha podido crear. >Puede consultar si la tarea de creación del disco se ha completado por ID de tarea. Para obtener más detalles, véase Consulta del estado de las tareas.

Código de estado: 400

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

El mensaje de error devuelto si se produce un error. Para obtener más detalles, consulte Parámetros en el campo error.

Tabla 8 Error

Parámetro

Tipo

Descripción

code

String

El código de error devuelto si se produce un error. Para conocer los códigos de error y sus significados, véase Códigos de error.

message

String

El mensaje de error devuelto si se produce un error.

Ejemplo de solicitudes

{
  "volume" : {
    "backup_id" : null,
    "count" : 1,
    "availability_zone" : "az1.dc1",
    "description" : "test_volume_1",
    "size" : 120,
    "name" : "test_volume_1",
    "imageRef" : null,
    "volume_type" : "SSD",
    "metadata" : {
      "__system__encrypted" : "0",
      "__system__cmkid" : null
    }
  }
}

Ejemplo de respuestas

Código de estado: 202

Aceptado

{
  "job_id" : "70a599e0-31e7-49b7-b260-868f441e862b"
}

Código de estado: 400

Error en la solicitud

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

Códigos de estado

Código de estado

Descripción

202

Aceptado

400

Error en la solicitud

Códigos de error

Consulte Códigos de error.