Creación de una delegación
Función
Esta API se proporciona para que el administrador cree una delegación.
Se puede invocar 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 Regiones 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 | Token de acceso emitido a un usuario para acreditar su identidad y sus permisos. Para obtener más información sobre los permisos requeridos por el token, consulte Acciones. |
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
Sí | object | Información de delegación. |
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
name | Sí | String | Nombre de la delegación, 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 delegación, que debe contener menos de o igual a 255 caracteres. |
duration | No | String | Período de validez de la delegación. Unidad: día. Valor predeterminado: FOREVER. Opciones:
|
Parámetros de respuesta
Parámetro | Tipo | Descripción |
|---|---|---|
object | Información de delegación. |
Parámetro | Tipo | Descripción |
|---|---|---|
create_time | String | Hora en que se creó la delegación. NOTA: El valor es una hora UTC en el formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por ejemplo, 2023-06-28T08:56:33.710000Z. Para obtener más información sobre los formatos de fecha y hora, consulte ISO-8601. |
description | String | Descripción de la delegación. |
domain_id | String | ID de la cuenta de delegación. |
duration | String | Período de validez de la delegación. Unidad: hora.
|
expire_time | String | Tiempo de vencimiento de la delegación. null indica que la agencia tiene validez ilimitada. NOTA: El valor es una hora UTC en el formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por ejemplo, 2023-06-28T08:56:33.710000Z. Para obtener más información sobre los formatos de fecha y hora, consulte ISO-8601. |
id | String | ID de delegación. |
name | String | Nombre de la delegación. |
trust_domain_id | String | ID de la cuenta delegada. |
trust_domain_name | String | Nombre de la cuenta delegada. |
Solicitud de ejemplo
Solicitud para crear una delegación llamada IAMAgency con un período de validez ilimitado para la cuenta delegada cuyo ID sea c2cd82a33fb043dc9304bf72a... y cuyo nombre es IAMDomainB
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 delegación 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 delegación 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
