Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Elastic Volume Service/ Referencia de la API/ Las API obsoletas/ API de Cinder/ Gestión de transferencias de discos/ Consulta de todas las transferencias de discos de EVS
Actualización más reciente 2026-04-23 GMT+08:00
Ver PDF
Compartir

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 de las API.

URI

GET /v3/{project_id}/os-volume-transfer

Tabla 1 Parámetros de ruta

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.
Tabla 2 Parámetros de consulta

Parámetro

Obligatorio

Tipo

Descripción

limit

No

Integer

Cantidad máxima de resultados de consultas que se pueden devolver. El valor debe ser un número 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 número entero mayor que 0 pero menor que el número de transferencias de disco.

Parámetros de solicitud

Tabla 3 Parámetros de encabezado 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

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

transfers

Array of VolumeTransferSummary objects

La descripción general de las transferencias de disco.
Tabla 5 VolumeTransferSummary

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.
Tabla 6 Link

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

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

Definición

La información de error devuelta si se produce un error.

Rango

N/D
Tabla 8 Error

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}/v3/{project_id}/os-volume-transfer?limit=50

Ejemplos de respuestas

Código de estado: 200

OK

{
  "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

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.