Creación de grupos de usuarios
Función
Esta API se proporciona para que el administrador cree un grupo 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 de conexión de IAM, consulte Regions y puntos de conexión.
URI
POST /v3/groups
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ámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
Sí |
Object |
Información del grupo de usuarios. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
description |
No |
String |
Descripción del grupo de usuarios, que debe contener menos de o igual a 255 caracteres. |
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 |
Sí |
String |
Nombre del grupo de usuarios, que debe contener menos de o igual a 64 caracteres. |
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
Object |
Información del grupo de usuarios. |
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
POST https://iam.myhuaweicloud.com/v3/groups
{ "group": { "description": "IAMDescription", "domain_id": "d78cbac186b744899480f25bd0...", "name": "IAMGroup" } }
Ejemplo de respuesta
Código de estado: 201
El grupo de usuarios se crea correctamente.
{ "group": { "description": "IAMDescription", "links": { "self": "https://iam.myhuaweicloud.com/v3/groups/077a4c7bcd8010d53fb7c003e9d966c2" }, "id": "077a4c7bcd8010d53fb7c003e9d966c2", "create_time": 1578969208707, "domain_id": "d78cbac186b744899480f25bd0...", "name": "IAMGroup" } }
Códigos de estado
Código de estado |
Descripción |
---|---|
201 |
El grupo de usuarios se crea correctamente. |
400 |
Parámetros no válidos. |
401 |
Error de autenticación. |
403 |
Acceso denegado. |
409 |
Se produce un conflicto de recursos. |
Códigos de error
Ninguno