UpdateWorkspaceUsersRole - Quick BI - Centro de documentación de Alibaba Cloud

Actualiza los roles de los miembros del espacio de trabajo por lotes. Los roles existentes se sobrescriben.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

quickbi-public:UpdateWorkspaceUsersRole

update

*Todos los recursos.

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
WorkspaceId	string	Sí	El ID del espacio de trabajo.	95296e95-ca89-4c7d-8af9-dedf0ad0****
UserIds	string	Sí	Los ID de usuario. Los ID son ID de usuario de Quick BI, no UID de Alibaba Cloud. Puede especificar varios ID de usuario separados por comas (,).	136516262323**,124498444445**
RoleId	integer	Sí	El ID del rol preestablecido del espacio de trabajo. Los roles existentes se sobrescriben. Valores válidos: 25: administrador del espacio de trabajo 26: desarrollador del espacio de trabajo 27: analista del espacio de trabajo 30: visor del espacio de trabajo Valores válidos: 25 : Administrador del espacio de trabajo. 26 : Desarrollador del espacio de trabajo. 27 : Analista del espacio de trabajo. 30 : Visor del espacio de trabajo.	25

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
Success	boolean	Indica si la solicitud se realizó correctamente. Valores válidos: true: la solicitud se realizó correctamente. Es posible que algunos miembros se actualicen correctamente, mientras que otros fallen. Para conocer los motivos de los errores, consulte FailureDetail en la respuesta. false: la solicitud falla y no se persiste ningún dato.	true
RequestId	string	El ID de la solicitud.	7AAB95D7-2E11-4FE2-94BC-858E4FC0C976
Result	object	El resultado de la ejecución de la operación.
Failure	integer	El número de usuarios cuyos roles no se pudieron actualizar.	0
FailureDetail	object	Los motivos de los errores de actualización.
Success	integer	El número de usuarios cuyos roles se actualizaron correctamente.	2
Total	integer	El número total de usuarios por actualizar.	2

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Success": true,
  "RequestId": "7AAB95D7-2E11-4FE2-94BC-858E4FC0C976",
  "Result": {
    "Failure": 0,
    "FailureDetail": {
      "test": "test",
      "test2": 1
    },
    "Success": 2,
    "Total": 2
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Workspace.NotIn.Organization	The workspace is not owned by the organization.	El espacio de trabajo no pertenece a la organización.
400	User.RoleType.Valid	The role ID is invalid.	El ID del rol no es válido.
400	Workspace.Not.Exist	The group workspace does not exist.	El espacio de trabajo de grupo no existe.
400	Workspace.Type.Error	The type of group workspace is invalid.	El tipo de espacio de trabajo de grupo no es válido.
400	Remove.AdminRoleOf.WorkspaceOwner	The owner of the group workspace must be assigned the administrator role.	No se puede eliminar el rol de administrador del propietario del espacio de trabajo.
400	User.NotIn.Workspace	The user is not a member of the group workspace.	El usuario no pertenece al espacio de trabajo.
400	AnalystUser.NotSupport.AdminOrDevRole	Analyst users do not support granting workspace administrator or developer roles.
400	Viewer.CannotHave.CustomRole	Organization viewer cannot have custom roles.	Los visitantes de la organización no pueden tener roles personalizados.
400	UserAnalyst.NotSupport.ThisRole	This role has permissions that analysts cannot grant.	El rol tiene permisos que un analista no puede otorgar.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.