Actualización de la información del grupo de usuarios
Función
Esta API se proporciona para que el administrator actualice la información del 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
PATCH /v3/groups/{group_id}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
group_id |
Sí |
String |
ID de grupo de usuarios. Para obtener más información sobre cómo obtener un ID 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á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. Se debe especificar name o description. |
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 debe contener menos de o igual a 64 caracteres. Se debe especificar name o description. |
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
PATCH https://iam.myhuaweicloud.com/v3/groups/{group_id}
{ "group": { "description": "IAMDescription", "domain_id": "d78cbac186b744899480f25bd02...", "name": "IAMGroup" } }
Ejemplo de respuesta
Código de estado: 200
La solicitud se ha realizado correctamente.
{ "group": { "description": "IAMDescription", "links": { "self": "https://iam.myhuaweicloud.com/v3/groups/077a4da48a00251f3f9dc0032103400f" }, "id": "077a4da48a00251f3f9dc0032103400f", "create_time": 1578969360636, "domain_id": "d78cbac186b744899480f25bd...", "name": "IAMGroup" } }
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. |
409 |
Se produce un conflicto de recursos. |
501 |
La API no está disponible. |
Códigos de error
Ninguno