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
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
El ID del proyecto. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
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. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
volume |
Sí |
CreateDiskOption object |
La información del disco que se va a crear. |
OS-SCH-HNT:scheduler_hints |
No |
CreateVolumeSchedulerHints object |
云硬盘调度参数,可用于指定云硬盘创建到某个专属存储池中 |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
availability_zone |
Sí |
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]
|
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 |
Sí |
Integer |
El tamaño del disco, en GiB. Las restricciones son las siguientes:
|
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 |
Sí |
String |
El tipo de disco. El valor puede ser SATA, SAS, GPSSD, SSD, ESSD, GPSSD2 o ESSD2.
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 Valores de enumeración:
|
tags |
No |
Map<String,String> |
La información de la etiqueta del disco. |
Parámetros de respuesta
Código de estado: 202
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
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. |
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.