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/ Identity and Access Management/ Referencia de la API/ API/ Gestión de proyectos/ Consulta de las cuotas de un proyecto

Actualización más reciente 2024-08-01 GMT+08:00

Ver PDF

Consulta de las cuotas de un proyecto

Función

Esta API se utiliza para consultar las cuotas de un proyecto especificado.

Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.

URI

GET /v3.0/OS-QUOTA/projects/{project_id}

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto que se va a consultar. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación.

Parámetros de solicitud

**Tabla 2** Parámetros en el encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Un token con permisos de administrador de seguridad o un token de usuario de IAM. (No se requieren permisos especiales, pero el alcance del token debe ser el proyecto especificado en la URL.)

Parámetros de respuesta

**Tabla 3** Parámetros en el cuerpo de respuesta
Parámetro	Tipo	Descripción
quotas	object	Información de cuota de la cuenta.

**Tabla 4** quotas
Parámetro	Tipo	Descripción
resources	Array of objects	Información de recursos.

**Tabla 5** resources
Parámetro	Tipo	Descripción
max	Integer	Cuota máxima.
min	Integer	Cuota mínima.
quota	Integer	Cuota actual.
type	String	Tipo de cuota.
used	Integer	Cuota utilizada.

Ejemplo de solicitud

Solicitud de consulta de la cuota del proyecto

GET https://iam.myhuaweicloud.com/v3.0/OS-QUOTA/projects/{project_id}

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{ 
  "quotas" : { 
                "resources" : [ 
                      { 
                           "max" : 50, 
                           "min" : 0, 
                           "quota" : 10, 
                           "type" : "project", 
                           "used" : 4 
                         } 
                     ] 
               } 
}

Código de estado: 403

Acceso denegado.

Ejemplo 1

{ 
   "error_msg" : "You are not authorized to perform the requested action.", 
   "error_code" : "IAM.0002" 
 }

Ejemplo 2

{ 
   "error_msg" : "Policy doesn't allow %(actions)s to be performed.", 
   "error_code" : "IAM.0003" 
 }

Código de estado: 404

No se puede encontrar el recurso solicitado.

{
  "error_msg" : "Could not find %(target)s: %(target_id)s.",
  "error_code" : "IAM.0004"
}

Código de estado: 500

Error de servidor interno.

{ 
  "error_msg" : "An unexpected error prevented the server from fulfilling your request.", 
  "error_code" : "IAM.0006" 
}

Códigos de estado

Código de estado	Descripción
200	La solicitud se ha realizado correctamente.
401	Error de autenticación.
403	Acceso denegado.
404	No se puede encontrar el recurso solicitado.
500	Error de servidor interno.