Listado de grupos de usuarios
Función
Esta API se proporciona para que el administrador muestre una lista de todos los grupos de usuarios.
Se puede llamar 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 finales de IAM, consulte Regions y puntos de conexión.
URI
GET /v3/groups
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
domain_id |
No |
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 agencia. |
name |
No |
String |
Nombre del grupo de usuarios, que puede contener un máximo de 64 caracteres. Para obtener más información sobre cómo obtener un nombre de grupo de usuarios, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y agencia. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
Content-Type |
Sí |
String |
Rellene application/json;charset=utf8 en este campo. |
X-Auth-Token |
Sí |
String |
Consulte Acciones. |
Parámetros de respuesta
Parámetro |
Tipo |
Description |
---|---|---|
Array of objects |
Información del grupo de usuarios. |
|
Object |
Información de enlace de recurso. |
Parámetro |
Tipo |
Descripción |
---|---|---|
description |
String |
Descripción del grupo de usuarios. |
id |
String |
ID de grupo de usuarios. |
domain_id |
String |
ID de la cuenta a la que pertenece el grupo de usuarios. |
name |
String |
Nombre del grupo de usuarios. |
Object |
Enlace de recurso de grupo de usuarios. |
|
create_time |
Long |
Hora en la que se creó el grupo de usuarios. |
Solicitud de ejemplo
GET https://iam.myhuaweicloud.com/v3/groups
Ejemplo de respuesta
Código de estado: 200
La solicitud se ha realizado correctamente.
{ "groups": [ { "domain_id": "d78cbac186b744899480f25bd02...", "create_time": 1536293929624, "name": "IAMGroupA", "description": "IAMDescription", "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/groups/5b050baea9db472c88cbae67..." }, "id": "5b050baea9db472c88cbae6..." }, { "domain_id": "d78cbac186b744899480f25...", "create_time": 1578107542861, "name": "IAMGroupB", "description": "IAMDescription", "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb7a4e2d" }, "id": "07609e7eb200250a3f7dc003cb..." } ], "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/groups" } }
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. |
Códigos de error
Ninguno