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 proyecto empresarial/ Consulta de grupos de usuarios asociados a un proyecto empresarial

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

Ver PDF

Consulta de grupos de usuarios asociados a un proyecto empresarial

Función

Esta API se utiliza para consultar los grupos de usuarios asociados directamente a un proyecto de empresa 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-PERMISSION/enterprise-projects/{enterprise_project_id}/groups

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	Sí	String	ID del proyecto de empresa para consultar los permisos de un grupo de usuarios asociado.

Parámetros de solicitud

**Tabla 2** Parámetros en el encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token autenticado con permiso iam:permissions:listGroupsOnEnterpriseProject o Security Administrator. El domain_id de la cuenta a la que pertenece el enterprise_project_id debe ser el mismo que el domain_id en el token.

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros en el cuerpo de respuesta
Parámetro	Tipo	Descripción
groups	Array of objects	Información del grupo de usuarios.

**Tabla 4** ListGroupsForEnterpriseProjectResDetail
Parámetro	Tipo	Descripción
createTime	Integer	Hora en la que se creó el grupo de usuarios.
description	String	Descripción del grupo de usuarios.
domainId	String	ID de cuenta.
id	String	ID de grupo de usuarios.
name	String	Nombre del grupo de usuarios.

Ejemplo de solicitud

Solicitud de consulta de grupos de usuarios asociados a un proyecto de empresa

GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{ 
  "groups" : [ { 
    "createTime" : 1552093271000, 
    "description" : null, 
    "domainId" : "dc7f62ae236c47b8836014c16d64d...", 
    "id" : "e6bde2403bda43e2813a1a6848963...", 
    "name" : "auth" 
  } ] 
}

Códigos de estado

Código de estado	Descripción
200	La solicitud se ha realizado correctamente.
400	Error de parámetro.
401	Error de autenticación.
403	Acceso denegado.
404	No se puede encontrar el recurso solicitado.
415	Tipo de contenido incorrecto.
500	Se produjo un error del sistema.