Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Dedicated Distributed Storage Service/ Referência de API/ Descrição da API/ Obtenção de detalhes de um pool de armazenamento do DSS
Atualizado em 2024-09-25 GMT+08:00

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}

A Tabela 1 descreve os parâmetros.
Tabela 1 Descrição do parâmetro

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.

Tabela 2 Parâmetro de solicitação

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

A Tabela 3 descreve os parâmetros de resposta.
Tabela 3 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:

  • SAS: pool de armazenamento de I/O alta
  • SSD: pool de armazenamento de I/O ultra-alta

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

Códigos de erro

Consulte Códigos de erro.