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 cuentas/ Consulta de las cuotas de una cuenta

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

Ver PDF

Consulta de las cuotas de una cuenta

Función

Esta API se utiliza para consultar las cuotas de una cuenta especificada.

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/domains/{domain_id}

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

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
type	No	String	Tipo de la cuota que desea consultar. Las opciones incluyen: user: usuarios de IAM group: grupos de usuarios idp: proveedores de identidad agency: delegaciones policy: políticas personalizadas assigment_group_mp: número máximo de permisos que se pueden asignar a un grupo de usuarios para un proyecto IAM assigment_agency_mp: número máximo de permisos que se pueden asignar a una agencia assigment_group_ep: número máximo de permisos que se pueden asignar a un grupo de usuarios para un proyecto de empresa assigment_user_ep: número máximo de permisos que se pueden asignar a un usuario para un proyecto de empresa mapping: asignación de cuota de regla para todos los proveedores de identidad de la cuenta

Parámetros de solicitud

**Tabla 3** Parámetros en el encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario de IAM (sin requisitos de permiso especiales).

Parámetros de respuesta

Código de estado: 200

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

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

**Tabla 6** 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. El número de reglas de asignación de proveedores de identidad utilizadas se personaliza y no se devuelve.

Ejemplo de solicitud

Solicitud de consulta de las cuotas de una cuenta

GET https://iam.myhuaweicloud.com/v3.0/OS-QUOTA/domains/{domain_id}

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{ 
  "quotas" : { 
    "resources" : [ 
               { 
                  "max" : 1000, 
                  "min" : 50, 
                  "quota" : 50, 
                  "type" : "user", 
                  "used" : 10 
                }, 
               { 
                  "max" : 300, 
                  "min" : 10, 
                  "quota" : 20, 
                  "type" : "group", 
                  "used" : 8 
                }, 
               { 
                  "max" : 20, 
                  "min" : 10, 
                  "quota" : 10, 
                  "type" : "idp", 
                  "used" : 9 
                },
               { 
                  "max" : 300, 
                  "min" : 10, 
                  "quota" : 50, 
                  "type" : "agency", 
                  "used" : 12 
                }, 
               { 
                  "max" : 300, 
                  "min" : 128, 
                  "quota" : 200, 
                  "type" : "policy", 
                  "used" : 8 
                },
               { 
                  "max" : 500, 
                  "min" : 50, 
                  "quota" : 200, 
                  "type" : "assigment_group_mp", 
                  "used" : 8 
                },
               { 
                  "max" : 500, 
                  "min" : 50, 
                  "quota" : 200, 
                  "type" : "assigment_agency_mp", 
                  "used" : 8 
                },
               { 
                  "max" : 5000, 
                  "min" : 50, 
                  "quota" : 500, 
                  "type" : "assigment_group_ep", 
                  "used" : 8 
                },
               { 
                  "max" : 5000, 
                  "min" : 50, 
                  "quota" : 500, 
                  "type" : "assigment_user_ep", 
                  "used" : 8 
                },
               { 
                  "max" : 100, 
                  "min" : 10, 
                  "quota" : 10, 
                  "type" : "mapping", 
                  "used" : null 
                }
             ] 
            } 
}

Código de estado: 400

Parámetros no válidos.

{
  "error_msg" : "Request parameter %(key)s is invalid.",
  "error_code" : "IAM.0007"
}

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.
400	Parámetros no válidos.
401	Error de autenticación.
403	Acceso denegado.
404	No se puede encontrar el recurso solicitado.
500	Error de servidor interno.