Consulta de detalhes de todas as transferências de disco EVS
Função
Esta API é usada para consultar os detalhes de todas as transferências de disco EVS, incluindo o tempo de criação da transferência, IDs de transferência e nomes de transferência.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
GET /v2/{project_id}/os-volume-transfer/detail
| 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 varia de 1 a 1000 e o valor padrão é 1000. O valor retornado não pode exceder esse limite. |
| 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 VolumeTransfer objects | Os detalhes das transferências de disco. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| created_at | String | A hora em que a transferência foi criada. Formato da hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX |
| 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/detail Exemplo de respostas
Código de status: 200
OK
{
"transfers" : [ {
"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"
} ]
}, {
"id" : "f26c0dee-d20d-4e80-8dee-a8d91b9742a1",
"created_at" : "2015-03-25T03:56:53.081642",
"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.
