Creación de una agencia
Función
Esta API se proporciona para que el administrador cree 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
POST /v3.0/OS-AGENCY/agencies
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 |
---|---|---|---|
name |
Sí |
String |
Nombre de la agencia, que debe contener menos de o igual a 64 caracteres. |
domain_id |
Sí |
String |
ID de la cuenta de delegación. |
trust_domain_id |
No |
String |
ID de la cuenta delegada. Debe especificarse el trust_domain_id o trust_domain_name. Si se especifican ambos, tiene prioridad el trust_domain_name. |
trust_domain_name |
No |
String |
Nombre de la cuenta delegada. Debe especificarse el trust_domain_id o trust_domain_name. Si se especifican ambos, tiene prioridad el trust_domain_name. |
description |
No |
String |
Descripción de la agencia, que debe contener menos de o igual a 255 caracteres. |
duration |
No |
String |
Período de validez de la agencia. Unidad: día. 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
POST https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies
{ "agency": { "name": "IAMAgency", "domain_id": "d78cbac186b744899480f25bd...", "trust_domain_id": "c2cd82a33fb043dc9304bf72a...", "trust_domain_name": "IAMDomainB", "duration": "FOREVER", "description": "IAMDescription" } }
Ejemplo de respuesta
Código de estado: 201
La agencia se crea con éxito.
{ "agency": { "description": "IAMDescription", "trust_domain_id": "a2cd82a33fb043dc9304bf72a0f...", "id": "078ade0fc20010004f8fc0034fad529d", "duration": "FOREVER", "create_time": "2020-01-20T12:59:20.811642", "expire_time": null, "domain_id": "d78cbac186b744899480f25bd02...", "name": "IAMAgency" } }
Códigos de estado
Código de estado |
Descripción |
---|---|
201 |
La agencia se crea con éxito. |
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. |
500 |
Error de servidor interno. |
Códigos de error
Ninguno