Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> MapReduce Service> Referencia de la API> API V2> Gestión de delegación> Actualización de la asignación entre un usuario (grupo) y una delegación de IAM

Actualización más reciente 2023-07-28 GMT+08:00

Ver PDF

Actualización de la asignación entre un usuario (grupo) y una delegación de IAM

Función

Esta API se utiliza para actualizar la asignación entre un usuario o grupo de usuarios y una delegación de IAM.

Restricciones

Ninguna

Depuración

Puede depurar esta API a través de la autenticación automática en API Explorer. API Explorer puede generar automáticamente código SDK de ejemplo y proporcionar la depuración de código SDK de ejemplo.

URI

Formato de URI
PUT /v2/{project_id}/clusters/{cluster_id}/agency-mapping

Descripción de parámetro

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	El ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
cluster_id	Sí	String	El ID del clúster. Para obtener más información acerca de cómo obtener el ID de clúster, consulte Obtención de un ID de clúster.

Parámetros de solicitud

**Tabla 2** Parámetro de solicitud
Parámetro	Obligatorio	Tipo	Descripción
agency_mappings	Sí	Array of AgencyMapping objects	La asignación entre usuarios o grupos de usuarios y delegación. Para obtener más información, consulte Tabla 3.

**Tabla 3** parámetros de agency_mappings
Parámetro	Obligatorio	Tipo	Descripción
agency	Sí	String	Nombre de la delegación de IAM vinculada a la asignación.
identifier_type	Sí	String	El tipo de delegación. Valores posibles: User: indica que la asignación es para usuarios. La lista de nombres de usuario se muestra en identifiers. Group: indica que la asignación es para grupos de usuarios. La lista de nombres de usuario se muestra en identifiers.
identifiers	Sí	Array of String	La lista de usuarios o grupos de usuarios asignados a la delegación de IAM. Inicie sesión en la consola de gestión de IAM y elija Users o User Groups en el panel de navegación izquierdo para obtener la lista de nombres de usuarios o grupos de usuarios.
agency_id	Sí	String	El ID de la delegación vinculada a la asignación. Inicie sesión en la consola de gestión de IAM y elija Agencies en el panel de navegación izquierdo. En la página Agencies que se muestra, mueva el cursor sobre el nombre de la agencia para obtener el ID de la delegación.

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
result	String	El resultado de la operación de la solicitud de actualización de una asignación. Valores posibles: succeeded: La operación es exitosa. failed: Error en la operación.

Código de estado: 400

**Tabla 5** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_code	String	El código de error.
error_msg	String	La descripción del error.

Ejemplo

Solicitud de ejemplo

Solicitud de ejemplo para actualizar la asignación entre un usuario o grupo de usuarios y una delegación de IAM

PUT https://{endpoint}/v2/{project_id}/clusters/{cluster_id}/agency-mapping

{
  "agency_mappings" : [ {
    "agency" : "agency01",
    "identifier_type" : "User",
    "identifiers" : [ "test" ],
    "agency_id" : "xxxx"
  } ]
}

Ejemplo de respuesta
La actualización de la asignación entre un usuario o grupo de usuarios y una delegación de IAM es exitosa.
```
{
  "result" : "succeeded"
}
```