Consulta de todas las transferencias de discos de EVS
Función
Esta API se utiliza para consultar todas las transferencias de discos de EVS del tenant actual.
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
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ámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
limit |
No |
Integer |
El número máximo de resultados de consulta que se pueden devolver. El valor debe ser un entero mayor que 0. |
offset |
No |
Integer |
El desplazamiento de la consulta. Se consultarán todas las transferencias de disco después de este desplazamiento. El valor debe ser un entero mayor que 0 pero menor que el número de transferencias de disco. |
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 |
---|---|---|
transfers |
Array of VolumeTransferSummary objects |
La descripción general de las transferencias de discos. |
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 |
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, véase Códigos de error. |
message |
String |
El mensaje de error devuelto si se produce un error. |
Ejemplo de solicitudes
GET https://{endpoint}/v2/{project_id}/os-volume-transfer
Ejemplo de respuestas
Código de estado: 200
Aceptar
{ "transfers" : [ { "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" } ] }, { "id" : "f26c0dee-d20d-4e80-8dee-a8d91b9742a1", "name" : "second volume transfer", "volume_id" : "673db275-379f-41af-8371-e1652132b4c1", "links" : [ { "href" : "https://localhost/v2/firstproject/os-volume-transfer/2", "rel" : "self" }, { "href" : "https://localhost/firstproject/os-volume-transfer/2", "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.