Consulta de discos EVS (preterido)
Função
Esta API é usada para consultar todos os discos EVS. Esta API foi preterida. Use outra API.
Método de chamada
Para obter detalhes, consulte Chamada de APIs.
URI
GET /v2/{project_id}/cloudvolumes
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| project_id | Sim | String | O ID do projeto. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| marker | Não | String | O ID do último registro na página anterior. O valor retornado é o valor do item após este. O ID do último registro na página anterior. O valor retornado é o valor do item após este. |
| name | Não | String | O nome do disco. |
| status | Não | String | O status do disco. |
| limit | Não | Integer | O número máximo de resultados de consulta que podem ser retornados. O valor padrão é 1000. Padrão: 1000 |
| availability_zone | Não | String | A informação da AZ. |
| sort_key | Não | String | Palavra-chave com base na qual os resultados retornados são classificados. O valor pode ser id, status, size ou created_at, e o valor padrão é created_at. Padrão: created_at Valores de enumeração:
|
| sort_dir | Não | String | A ordem de classificação do resultado. O valor pode ser desc (ordem decrescente) ou asc (ordem crescente), e o valor padrão é desc. Padrão: desc |
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| X-Auth-Token | Sim | String | Um token obtido do IAM é válido por apenas 24 horas. Ao usar um token para autenticação, armazene-o em cache para evitar chamar a API com frequência. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| volumes | Array of DiskSummary objects | A lista de discos retornados. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | String | O ID do disco. |
| links | Array of Link objects | O URI do disco. |
| name | String | O nome do disco. Você pode inserir até 85 caracteres. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| href | String | O link de atalho correspondente. |
| rel | String | O nome do marcador do link de atalho. |
Código de status: 400
| Parâmetro | Tipo | Descrição |
|---|---|---|
| error | Error object | A mensagem de erro retornada se ocorrer um erro. Para obter detalhes, consulte Parâmetros no campo error. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| code | String | O código de erro retornado se ocorrer um erro. Para os 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
Nenhum
Exemplo de respostas
Código de status: 200
OK
{
"volumes" : [ {
"id" : "e6cf4401-15f6-44bd-ae2b-cff4dc9523e6",
"links" : [ {
"href" : "https://volume.az0.dc1.domainname.com/v2/cd631140887d4b6e9c786b67a6dd4c02/volumes/e6cf4401-15f6-44bd-ae2b-cff4dc9523e6",
"rel" : "self"
}, {
"href" : "https://volume.az0.dc1.domainname.com/cd631140887d4b6e9c786b67a6dd4c02/volumes/e6cf4401-15f6-44bd-ae2b-cff4dc9523e6",
"rel" : "bookmark"
} ],
"name" : "hallo5"
}, {
"id" : "4c5e8203-f70e-4717-90cd-4a8f636888d1",
"links" : [ {
"href" : "https://volume.az0.dc1.domainname.com/v2/cd631140887d4b6e9c786b67a6dd4c02/volumes/4c5e8203-f70e-4717-90cd-4a8f636888d1",
"rel" : "self"
}, {
"href" : "https://volume.az0.dc1.domainname.com/cd631140887d4b6e9c786b67a6dd4c02/volumes/4c5e8203-f70e-4717-90cd-4a8f636888d1",
"rel" : "bookmark"
} ],
"name" : "hallo4"
} ]
} 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.
