Consulta de detalles de una transferencia de disco de EVS
Función
Esta API se utiliza para consultar los detalles de una transferencia de disco de EVS, incluidos la hora de creación de la transferencia, El ID de transferencia y el nombre de la transferencia.
Método de invocación
Para obtener más información, consulte Invocación de las API.
URI
GET /v2/{project_id}/os-volume-transfer/{transfer_id}
| 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ámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| transfer | VolumeTransfer object | Los detalles de la transferencia de disco. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| 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
GET https://{endpoint}/v2/{project_id}/os-volume-transfer/{transfer_id}
https://{endpoint}/v2/{project_id}/os-volume-transfer/{transfer_id} Ejemplos de respuestas
Código de estado: 200
OK
{
"transfer" : {
"id" : "cac5c677-73a9-4288-bb9c-b2ebfb547377",
"created_at" : "2015-02-25T03:56:53.081642",
"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 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
Códigos de error
Consulte Códigos de error.
