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

Actualización de un disco de EVS

Función

Esta API se utiliza para actualizar un disco de EVS.

Método de invocación

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

URI

PUT /v2/{project_id}/volumes/{volume_id}

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

El ID del proyecto.

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

volume_id

String

El ID del disco.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

El token del usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

volume

CinderUpdateVolumeOption object

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

Tabla 4 CinderUpdateVolumeOption

Parámetro

Obligatorio

Tipo

Descripción

name

No

String

El nombre del disco. Puede escribir hasta 64 caracteres.

description

No

String

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

metadata

No

Map<String,String>

Los metadatos del disco.

La longitud de key o value bajo metadata no puede contener más de 255 bytes.

display_description

No

String

La descripción del disco. Puede especificar description u display_description. Si se especifican ambos, se utiliza el valor description. Puede escribir hasta 85 caracteres.

display_name

No

String

El nombre del disco. Puede especificar name u display_name. Si se especifican ambos, se utiliza el valor name. Puede escribir hasta 64 caracteres.

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

volume

CreateVolumeDetail object

La información del disco creado.

Tabla 6 CreateVolumeDetail

Parámetro

Tipo

Descripción

id

String

El ID del disco.

links

Array of Link objects

El URI del disco.

name

String

El nombre del disco.

status

String

El estado del disco. Para obtener más detalles, consulte Estado del disco de EVS.

attachments

Array of VolumeAttachment objects

La información de conexión.

availability_zone

String

La AZ a la que pertenece el disco.

bootable

String

Si el disco es arrancable. true: el disco es arrancable. false: el disco no se puede arrancar.

encrypted

Boolean

Este campo no se admite actualmente.

created_at

String

La hora en que se creó el disco.

Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

description

String

La descripción del disco.

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

  • 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 V2 de SSD extrema. Si el tipo de disco especificado no está disponible en la AZ, no se podrá crear el disco.

replication_status

String

El campo reservado.

consistencygroup_id

String

El ID del grupo de consistencia al que pertenece el disco.

source_volid

String

El ID del disco de origen.

Este campo no se admite actualmente.

snapshot_id

String

El ID de la instantánea.

metadata

VolumeMetadata object

Los metadatos.

size

Integer

El tamaño del disco, en GiB.

user_id

String

El ID del usuario que utiliza el disco.

updated_at

String

La hora en que se actualizó el disco.

shareable

Boolean

Si el disco se puede compartir. Nota: Este campo ha sido obsoleto. Use multiattach.

multiattach

Boolean

Si el disco se puede compartir. true: el disco se puede compartir. false: el disco no se puede compartir.

storage_cluster_id

String

El campo reservado.

Tabla 8 VolumeAttachment

Parámetro

Tipo

Descripción

attached_at

String

La hora a la que se ha conectado el disco.

Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

attachment_id

String

El ID del archivo adjunto.

device

String

El nombre del dispositivo.

host_name

String

Nombre del host físico que alberga el servidor en la nube al que está conectado el disco.

id

String

El ID del disco conectado.

server_id

String

El ID del servidor al que está conectado el disco.

volume_id

String

El ID del disco.

Tabla 9 VolumeMetadata

Parámetro

Tipo

Descripción

__system__cmkid

String

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:

Utilice una solicitud de HTTPS para obtener el ID de clave. Para obtener más detalles, consulte Consulta de la lista de claves.

__system__encrypted

String

El campo de encriptación de metadata. El valor puede ser 0 (sin encriptación) o 1 (encriptación). Si este parámetro no aparece, el disco no está cifrado.

full_clone

String

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

String

Si este parámetro se establece en 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. Se admiten comandos de reserva SCSI.

Si este parámetro se establece en false, el tipo de dispositivo de disco es VBD, que también es el tipo predeterminado. VBD solo admite los comandos simples de lectura/escritura de SCSI.

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

Código de estado: 400

Tabla 10 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

El mensaje de error devuelto si se produce un error.

Tabla 11 Error

Parámetro

Tipo

Descripción

code

String

El código de error devuelto si se produce un error.

Para obtener más detalles sobre los códigos de error y sus significados, consulte Códigos de errores.

message

String

El mensaje de error devuelto si se produce un error.

Ejemplo de solicitudes

Actualización del nombre y descripción del disco de EVS

PUT https://{endpoint}/v2/{project_id}/volumes/{volume_id}

{
  "volume" : {
    "name" : "test_volume",
    "description" : "test"
  }
}

Ejemplo de respuestas

Código de estado: 200

Aceptar

{
  "volume" : {
    "attachments" : [ ],
    "availability_zone" : "az-dc-1",
    "bootable" : "false",
    "created_at" : "2016-05-25T02:38:40.392463",
    "description" : "create for api test",
    "encrypted" : false,
    "id" : "8dd7c486-8e9f-49fe-bceb-26aa7e312b66",
    "links" : [ {
      "href" : "https://volume.localdomain.com:8776/v2/5dd0b0056f3d47b6ab4121667d35621a/volumes/8dd7c486-8e9f-49fe-bceb-26aa7e312b66",
      "rel" : "self"
    }, {
      "href" : "https://volume.localdomain.com:8776/5dd0b0056f3d47b6ab4121667d35621a/volumes/8dd7c486-8e9f-49fe-bceb-26aa7e312b66",
      "rel" : "bookmark"
    } ],
    "metadata" : {
      "hw:passthrough" : true
    },
    "name" : "openapi_vol01",
    "replication_status" : "disabled",
    "multiattach" : false,
    "size" : 40,
    "status" : "creating",
    "user_id" : "39f6696ae23740708d0f358a253c2637",
    "volume_type" : "SATA"
  }
}

Código de estado: 400

Error en la solicitud

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

Códigos de estado

Código de estado

Descripción

200

Aceptar

400

Error en la solicitud

Códigos de error

Consulte Códigos de error.