Aceptación de una transferencia de disco de EVS
Función
Esta API se utiliza para aceptar una transferencia de disco de EVS mediante un ID de transferencia y una clave de autenticación.
Restricciones
Las restricciones 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/{transfer_id}/accept
| 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. |
| transfer_id | Sí | String | El ID de transferencia. Para obtener más información sobre cómo obtener el ID, consulte id en el cuerpo de respuesta en Creación de una transferencia de disco de EVS. |
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 |
|---|---|---|---|
| accept | Sí | El marcador de aceptación de transferencia. |
Parámetros de respuesta
Código de estado: 202
| Parámetro | Tipo | Descripción |
|---|---|---|
| transfer | VolumeTransferSummary object | La información de transferencia. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| 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
Aceptación de una transferencia de disco (a través del ID de transferencia y la clave de autenticación)
POST https://{endpoint}/v2/{project_id}/os-volume-transfer/{transfer_id}/accept
{
"accept" : {
"auth_key" : "9266c59563c84664"
}
} Ejemplos de respuestas
Código de estado: 202
Accepted
{
"transfer" : {
"id" : "cac5c677-73a9-4288-bb9c-b2ebfb547377",
"name" : "first volume transfer",
"volume_id" : "894623a6-e901-4312-aa06-4275e6321cce",
"links" : [ {
"href" : "https://localhost/v2/firstproject/os-volume-transfer/1",
"rel" : "self"
}, {
"href" : "https://localhost/firstproject/os-volume-transfer/1",
"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.