Creación de una transferencia de disco de EVS
Función
Esta API se utiliza para crear una transferencia de disco de EVS. Después de crear 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 vuelve a ser available.
Restricciones
Una transferencia de disco solo se puede crear cuando el estado del disco es available. Las restricciones detalladas son las siguientes:
Los discos de facturación anual/mensual no se pueden transferir.
Los discos congelados no se pueden transferir.
Los discos encriptados no se pueden transferir.
Los discos que tienen copias de respaldo e instantáneas no se pueden transferir.
Los discos que se aplican con políticas de copia de respaldo no se pueden transferir.
Los discos de DSS no se pueden transferir.
Los discos de DESS no se pueden transferir.
Método de invocación
Para obtener más información, consulte Invocación de 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, 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 de usuario. Se puede obtener invocando 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 ingresar hasta 64 caracteres. |
| volume_id | Sí | String | El ID del disco. Para obtener el ID del disco, consulte Consulta de detalles sobre todos los discos de EVS. |
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 tiempo: 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 | Definición El enlace de acceso directo correspondiente. Rango N/D |
| rel | String | Definición El nombre del marcador del enlace de acceso directo. Rango N/D |
Código de estado: 400
| Parámetro | Tipo | Descripción |
|---|---|---|
| error | Error object | Definición La información de error devuelta si se produce un error. Rango N/D |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Definición El código de error devuelto si se produce un error. Rango Para obtener más información sobre el código de error, consulte Códigos de error. |
| message | String | Definición El mensaje de error devuelto si se produce un error. Rango N/D |
Ejemplos 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"
}
} Ejemplos de respuestas
Código de estado: 202
Accepted
{
"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
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 202 | Accepted |
| 400 | Bad Request |
Códigos de error
Consulte Códigos de error.
