Modificación de una agencia
Función
Esta API se proporciona para que el administrador modifique una agencia.
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
PUT /v3.0/OS-AGENCY/agencies/{agency_id}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
agency_id |
Sí |
String |
ID de agencia. Para obtener detalles sobre cómo obtener una ID de agencia, 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 de la agencia. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
trust_domain_id |
No |
String |
ID de la cuenta delegada. Si se especifican trust_domain_id y trust_domain_name, el trust_domain_name tiene prioridad. Al menos uno de estos cuatro parámetros debe especificarse para la agencia. |
trust_domain_name |
No |
String |
Nombre de la cuenta delegada. Si se especifican trust_domain_id y trust_domain_name, el trust_domain_name tiene prioridad. Al menos uno de estos cuatro parámetros debe especificarse para la agencia. |
description |
No |
String |
Descripción de la agencia, que debe contener menos de o igual a 255 caracteres. Al menos uno de estos cuatro parámetros debe especificarse para la agencia. |
duration |
No |
String |
Período de validez de la agencia. Unidad: día. Al menos uno de estos cuatro parámetros debe especificarse para la agencia. Opciones:
|
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
object |
Información de la agencia. |
Parámetro |
Tipo |
Descripción |
---|---|---|
create_time |
String |
Hora en que se creó la agencia. |
description |
String |
Descripción de la agencia. |
domain_id |
String |
ID de la cuenta de delegación. |
duration |
String |
Período de validez de la agencia. Unidad: hora.
|
expire_time |
String |
Tiempo de vencimiento de la agencia. null indica que la agencia tiene validez ilimitada. |
id |
String |
ID de agencia. |
name |
String |
Nombre de la agencia. |
trust_domain_id |
String |
ID de la cuenta delegada. |
trust_domain_name |
String |
Nombre de la cuenta delegada. |
Solicitud de ejemplo
PUT https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies/{agency_id}
{ "agency": { "trust_domain_id": "b2cd82a33fb043dc9304bf72...", "trust_domain_name": "IAMDomainB", "description": "IAMDescription", "duration": "ONEDAY" } }
Ejemplo de respuesta
Código de estado: 200
La agencia se modifica con éxito.
{ "agency": { "description": "IAMDescription", "trust_domain_id": "b2cd82a33fb043dc9304bf72a0...", "id": "0760a9e2a60026664f1fc0031f9f205e", "duration": "ONEDAY", "create_time": "2020-01-04T03:37:16.000000", "expire_time": "2020-01-21T13:06:11.241588", "domain_id": "d78cbac186b744899480f25...", "name": "IAMAgency" } }
Códigos de estado
Código de estado |
Descripción |
---|---|
200 |
La agencia se modifica con éxito. |
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. |
Códigos de error
Ninguno