Consulta de todas as transferências de disco EVS
Função
Esta API é usada para consultar todas as transferências de disco EVS do locatário atual.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
GET /v2/{project_id}/os-volume-transfer
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
O ID do projeto. Para obter detalhes sobre como obter o ID de projeto, consulte Obtenção de um ID de projeto. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
limit |
Não |
Integer |
O número máximo de resultados de consulta que podem ser retornados. O valor deve ser um número inteiro maior que 0. |
offset |
Não |
Integer |
O deslocamento da consulta. Todas as transferências de disco após esse deslocamento serão consultadas. O valor deve ser um número inteiro maior que 0, mas menor que o número de transferências de discos. |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
O token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário. |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
transfers |
Array of VolumeTransferSummary objects |
Visão geral das transferências de disco. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
id |
String |
O ID da transferência. |
links |
Array of Link objects |
Os links de transferência. |
name |
String |
O nome da transferência. |
volume_id |
String |
O ID do disco. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
href |
String |
O link de atalho correspondente. |
rel |
String |
O nome do marcador do link de atalho. Padrão: next |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error |
Error object |
A mensagem de erro retornada se ocorrer um erro. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
code |
String |
O código de erro retornado se ocorrer um erro. Para obter detalhes sobre códigos de erro e seus significados, consulte Códigos de erro. |
message |
String |
A mensagem de erro retornada se ocorrer um erro. |
Exemplo de solicitações
GET https://{endpoint}/v2/{project_id}/os-volume-transfer
Exemplo de respostas
Código de status: 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 status: 400
Bad Request
{ "error" : { "message" : "XXXX", "code" : "XXX" } }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
OK |
400 |
Bad Request |
Códigos de erro
Consulte Códigos de erro.