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 un grupo de almacenamiento de DSS
Actualización más reciente 2024-04-24 GMT+08:00
Ver PDF
Compartir

Obtención de detalles de un grupo de almacenamiento de DSS

Función

Esta API se utiliza para obtener los detalles de un grupo de almacenamiento DSS especificado.

URI

GET /v1/{project_id}/pools/{dss_id}

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

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

El ID del proyecto.

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

dss_id

Sí

String

El ID del grupo de almacenamiento.
Tabla 2 Parámetro de solicitud

Parámetro

Obligatorio

Tipo

Descripción

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/{dss_id}?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

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 GB.

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 
    {
   "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
}
  • Respuesta de error 
    {
  "error": {
    "message": "invalid dss id!",
    "code": "DSS.1001"
  }
}

Valor devuelto

Códigos de error

Véase Códigos de error.

Tema principal: Descripción de la API