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
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
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
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
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. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
transfer |
Sí |
CreateVolumeTransferOption object |
El marcador de creación de transferencia. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
Sí |
String |
El nombre de la transferencia. Puede escribir hasta 64 caracteres. |
volume_id |
Sí |
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
Parámetro |
Tipo |
Descripción |
---|---|---|
transfer |
CreateVolumeTransferDetail object |
La información de transferencia. |
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. |
Parámetro |
Tipo |
Descripción |
---|---|---|
href |
String |
El enlace de acceso directo correspondiente. |
rel |
String |
El nombre del marcador de enlace de acceso directo. Valor predeterminado: next |
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error |
Error object |
El mensaje de error devuelto si se produce un 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.