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 una transferencia de disco de EVS

Función

Esta API se utiliza para crear una transferencia de disco de EVS. Una vez creada la transferencia, se devuelve un ID de transferencia y una clave de autenticación. Después de crear una transferencia de disco, el estado del disco cambia de available a awaiting-transfer*. Una vez aceptada la transferencia, el estado del disco cambia nuevamente a available.

Restricciones

Una transferencia de disco solo se puede crear cuando el estado del disco está available. Las restricciones detalladas son las siguientes:

No se pueden transferir discos anuales/mensuales. No se pueden transferir discos congelados. No se pueden transferir los discos cifrados. No se pueden transferir los discos que tengan copias de respaldo e instantáneas. Los discos aplicados con políticas de copia de respaldo no se pueden transferir. No se pueden transferir los discos de DSS. No se pueden transferir los discos de DESS.

Método de invocación

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

URI

POST /v2/{project_id}/os-volume-transfer

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.

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

transfer

CreateVolumeTransferOption object

El marcador de creación de transferencia.

Tabla 4 CreateVolumeTransferOption

Parámetro

Obligatorio

Tipo

Descripción

name

String

El nombre de la transferencia. Puede escribir hasta 64 caracteres.

volume_id

String

El ID del disco. Para obtener el ID del disco, véase Consulta de detalles sobre todos los discos.

Parámetros de respuesta

Código de estado: 202

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

transfer

CreateVolumeTransferDetail object

La información de transferencia.

Tabla 6 CreateVolumeTransferDetail

Parámetro

Tipo

Descripción

auth_key

String

La clave de autenticación de la transferencia de disco.

created_at

String

La hora en que se creó la transferencia.

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

id

String

El ID de transferencia.

links

Array of Link objects

Los enlaces de transferencia.

name

String

El nombre de la transferencia.

volume_id

String

El ID del disco.

Código de estado: 400

Tabla 8 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 9 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 error.

message

String

El mensaje de error devuelto si se produce un error.

Ejemplo de solicitudes

Creación de una transferencia de disco (El ID del disco es c86b9af4-151d-4ead-b62c-5fb967af0e37 y el nombre de la transferencia es first volume)

POST https://{endpoint}/v2/{project_id}/os-volume-transfer

{
  "transfer" : {
    "volume_id" : "c86b9af4-151d-4ead-b62c-5fb967af0e37",
    "name" : "first volume"
  }
}

Ejemplo de respuestas

Código de estado: 202

Aceptado

{
  "transfer" : {
    "id" : "1a7059f5-8ed7-45b7-8d05-2811e5d09f24",
    "created_at" : "2015-02-25T03:56:53.081642",
    "name" : "first volume",
    "volume_id" : "c86b9af4-151d-4ead-b62c-5fb967af0e37",
    "auth_key" : "9266c59563c84664",
    "links" : [ {
      "href" : "https://localhost/v2/firstproject/os-volume-transfer/3",
      "rel" : "self"
    }, {
      "href" : "https://localhost/firstproject/os-volume-transfer/3",
      "rel" : "bookmark"
    } ]
  }
}

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.