Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Dedicated Distributed Storage Service/ Referencia de la API/ Descripción de la API/ Obtención de detalles de grupos de almacenamiento de DSS
Actualización más reciente 2024-04-24 GMT+08:00

Obtención de detalles de grupos de almacenamiento de DSS

Función

Esta API se utiliza para obtener los grupos de almacenamiento de DSS solicitados por un tenant. Se admite la consulta de filtro y la consulta de paginación.

URI

GET /v1/{project_id}/pools/detail

Tabla 1 describe los parámetros.
Tabla 1 Descripción de parámetro

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

El ID del proyecto.

Para obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Tabla 2 Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

limit

No

Integer

Número máximo de resultados de consulta que se pueden devolver. El valor debe ser un entero mayor que 0.

offset

No

Integer

Posición inicial de una consulta de paginación. El valor debe ser un entero positivo o 0.

NOTA:

Este parámetro indica que se consultan todos los grupos de almacenamiento después de este desplazamiento de consulta de paginación.

status

No

String

El estado del grupo de almacenamiento. El valor puede ser available, deploying o extending. Para obtener más información, consulte Estado del grupo de almacenamiento de DSS.

name

No

String

Nombre del grupo de almacenamiento.

usage

No

Boolean

Si se devuelve la información de capacidad del grupo de almacenamiento. El valor puede ser true o false. El valor true indica devolver la información de capacidad. El valor predeterminado es false.

Solicitud

Solicitud de ejemplo

GET https://{endpoint}/v1/{project_id}/pools/detail?status=available&usage=true

Respuesta

Parámetros de respuesta

Tabla 3 describe los parámetros de respuesta.
Tabla 3 Parámetros de respuesta

Parámetro

Tipo

Descripción

pools

Array of objects

Los detalles del grupo de almacenamiento. Para obtener más información, véase Tabla 4.

count

Integer

Número de grupos de almacenamiento.

Descripción de los parámetros del grupo de almacenamiento devueltos
Tabla 4 Descripción de parámetro

Parámetro

Tipo

Descripción

name

String

Nombre del grupo de almacenamiento.

id

String

El ID del grupo de almacenamiento.

project_id

String

El ID del proyecto al que pertenece el grupo.

capacity

Integer

La capacidad del grupo de almacenamiento solicitada, en TB.

type

String

El tipo de grupo de almacenamiento. El valor puede ser el siguiente:

  • SAS: grupo de almacenamiento de E/S alto
  • SSD: grupo de almacenamiento de E/S ultraalto

status

String

El estado del grupo de almacenamiento. Para obtener más información, consulte Estado del grupo de almacenamiento de DSS.

availability_zone

String

La zona de disponibilidad donde reside el grupo de almacenamiento.

created_at

String

La hora en que se creó el grupo de almacenamiento.

Formato de hora: UTC AAAA-MM-DDTHH:MM:SS

total_capacity_gb

Integer

La capacidad total del grupo de almacenamiento, en GB. (Este parámetro no se devuelve si el estado del grupo de almacenamiento es deploying.)

used_capacity_gb

Integer

La capacidad utilizada del grupo de almacenamiento, en GB. (Este parámetro no se devuelve si el estado del grupo de almacenamiento es deploying.)

provisioned_capacity_gb

Integer

La capacidad asignada del grupo de almacenamiento, en GB. (Este parámetro no se devuelve si el estado del grupo de almacenamiento es deploying.)

max_over_subscription_ratio

Float

La relación de sobrecompromiso del grupo de almacenamiento. (Este parámetro no se devuelve si el estado del grupo de almacenamiento es deploying.)

  • Ejemplo de respuesta
    {
         "pools" : [ {
         "name" : "dedicatedStorage01",
         "id" : "c950ee97-587c-4f24-8a74-3367e3da570f",
         "project_id" : "63d910f2705a487ebe4e1c274748d9e1",
         "capacity" : 1000,
         "type" : "SSD",
         "availability_zone" : "AZ1",
         "status" : "available",
         "created_at" : "2014-12-18T15:57:56.299000",
         "total_capacity_gb": 850,
         "used_capacity_gb": 300,
         "provisioned_capacity_gb":700,
         "max_over_subscription_ratio": 1.0
         }, 
    {
         "name" : "dedicatedStorage02",
         "id" : "6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
         "project_id" : "63d910f2705a487ebe4e1c274748d9e1",
         "capacity" : 1000,
         "type" : "SSD",
         "availability_zone" : "AZ1",
         "status" : "available",
         "created_at" : "2014-12-18T15:57:56.299000",
         "total_capacity_gb": 850,
         "used_capacity_gb": 300,
         "provisioned_capacity_gb":700,
         "max_over_subscription_ratio": 1.0
      } ] ,
        "count": 2
    }
  • Respuesta de error
    {
      "error": {
        "message": "invalid filter limit!",
        "code": "DSS.1003"
      }
    }

Valor devuelto

Códigos de error

Véase Códigos de error.