Consulta de los 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, incluida la hora de creación de la transferencia, el ID de la transferencia y el nombre de la transferencia.
Método de invocación
Para obtener más información, consulte Invocación a 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 sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto. |
|
transfer_id |
Sí |
String |
El ID de transferencia. |
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ámetros de respuesta
Código de estado: 200
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
transfer |
VolumeTransfer object |
Los detalles de la transferencia del disco. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
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 |
|---|---|---|
|
Código |
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 errores. |
|
message |
String |
El mensaje de error devuelto si se produce un error. |
Ejemplo de solicitudes
GET https://{endpoint}/v2/{project_id}/os-volume-transfer/{transfer_id}
https://{endpoint}/v2/{project_id}/os-volume-transfer/{transfer_id}
Ejemplo de respuestas
Código de estado: 200
Aceptar
{
"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
Error en la solicitud
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
Códigos de estado
|
Código de estado |
Descripción |
|---|---|
|
200 |
Aceptar |
|
400 |
Error en la solicitud |
Códigos de error
Consulte Códigos de error.
