Obtenção de detalhes de um pool de armazenamento do DSS
Função
Esta API é usada para obter os detalhes de um pool de armazenamento do DSS específico.
URI
GET /v1/{project_id}/pools/{dss_id}
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
O ID do projeto. Para saber como obter o ID do projeto, consulte Obtenção de um ID de projeto. |
dss_id |
Sim |
String |
O ID do pool de armazenamento. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
usage |
Não |
Boolean |
Se as informações de capacidade do pool de armazenamento são retornadas. O valor pode ser true ou false. O valor true indica para retornar as informações de capacidade. O valor padrão é false. |
Solicitação
Exemplos de solicitações
GET https://{endpoint}/v1/{project_id}/pools/{dss_id}?usage=true
Resposta
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
name |
String |
O nome do pool de armazenamento. |
id |
String |
O ID do pool de armazenamento. |
project_id |
String |
O ID do projeto ao qual o pool pertence. |
capacity |
Integer |
A capacidade do pool de armazenamento solicitada, em GB. |
type |
String |
O tipo de pool de armazenamento. O valor pode ser o seguinte:
|
status |
String |
O status do pool de armazenamento. Para mais detalhes, consulte Status do pool de armazenamento do DSS. |
availability_zone |
String |
A AZ onde o pool de armazenamento reside. |
created_at |
String |
A hora em que o pool de armazenamento foi criado. Formato da hora: UTC YYYY-MM-DDTHH:MM:SS |
total_capacity_gb |
Integer |
A capacidade total do pool de armazenamento, em GB. (Esse parâmetro não será retornado se o status do pool de armazenamento for deploying.) |
used_capacity_gb |
Integer |
A capacidade usada do pool de armazenamento, em GB. (Esse parâmetro não será retornado se o status do pool de armazenamento for deploying.) |
provisioned_capacity_gb |
Integer |
A capacidade alocada do pool de armazenamento, em GB. (Esse parâmetro não será retornado se o status do pool de armazenamento for deploying.) |
max_over_subscription_ratio |
Float |
A taxa de excesso de comprometimento do pool de armazenamento. (Esse parâmetro não será retornado se o status do pool de armazenamento for deploying.) |
- Exemplo de resposta
{ "name" : "dedicatedStorage01", "id" : "c950ee97-587c-4f24-8a74-3367e3da570f", "project_id" : "63d910f2705a487ebe4e1c274748d9e1", "capacity" : 100, "type" : "SSD", "availability_zone" : "AZ1", "status" : "available", "created_at" : "2014-12-18T15:57:56.299000", "total_capacity_gb": 1000, "used_capacity_gb": 300, "provisioned_capacity_gb":700, "max_over_subscription_ratio": 1.0 }
- Resposta de erro
{ "error": { "message": "invalid dss id!", "code": "DSS.1001" } }
Valores retornados
- Normal
- Anormal
Consulte Descrição do código de erro.
Códigos de erro
Consulte Códigos de erro.