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.