Todos los productos
Search
Centro de documentos

Quick BI:UpdateUser

Última actualización: Sep 09, 2026

Actualiza la información de un miembro especificado de una organización.

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:UpdateUser

update

*Todos los recursos.

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

UserId

string

Sí

El ID del usuario que se va a actualizar. Este ID de usuario es el UserID de Quick BI, no el UID de Alibaba Cloud.

fe67f61a35a94b7da1a34ba174a7****

AdminUser

boolean

No

Especifica si se debe asignar el rol de administrador de la organización. Valores válidos:

  • true: Sí.

  • false: No.

Importante Este parámetro está obsoleto. Cuando se especifica RoleIds, este parámetro no surte efecto.

true

AuthAdminUser

boolean

No

Especifica si se debe asignar el rol de administrador de gestión de permisos de la organización. Valores válidos:

  • true: Sí.

  • false: No.

Importante Este parámetro está obsoleto y no se recomienda. Cuando se especifica RoleIds, este parámetro no surte efecto.

true

UserType

integer

No

El tipo de usuario del miembro de la organización. Valores válidos:

  • 1: Desarrollador.

  • 2: Visitante.

  • 3: Analista.

Valores válidos:

  • 1 :

    Desarrollador.

  • 2 :

    Visitante.

  • 3 :

    Analista.

1

NickName

string

No

El apodo.

  • Validación de formato: la longitud máxima es de 50 caracteres.

  • Validación de formato especial: caracteres chinos, letras en inglés, dígitos, _ \ / | () ] [

prueba

RoleIds

string

No

Los ID de los roles de organización preestablecidos o personalizados que se van a asignar al usuario, separados por comas (,). Se admite un máximo de tres ID de rol. Valores válidos:

  • Administrador de la organización (rol preestablecido): 111111111

  • Administrador de gestión de permisos (rol preestablecido): 111111112

  • Usuario común (rol preestablecido): 111111113

111111111,456

IsDeleted

boolean

No

El estado del usuario. Valores válidos:

  • false: Activado.

  • true: Desactivado.

false

CopilotModules

string

No

La información de modificación de cuota de módulos inteligentes.

Pase el parámetro como una matriz JSON. Cada elemento de la matriz contiene los siguientes campos:

moduleType -- El módulo inteligente.

  • smartQAskNum -- Cantidad de preguntas de Smart Q.

  • smartQDevNum -- Construcción de Smart Q.

  • qreport -- Informe de Smart Q.

  • qExploreNum -- Edición de exploración de Smart Q.

status -- Especifica si se debe habilitar el módulo.

  • 0 -- Revocar la autorización.

  • 1 -- Conceder la autorización.

[ { "moduleType": "smartQAskNum", "status": 1 }, { "moduleType": "smartQDevNum", "status": 0 } ]

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

RequestId

string

El ID de la solicitud.

DC4E1E63-B337-44F8-8C22-6F00DF67E2C3

Result

boolean

El resultado de la ejecución de la operación. Valores válidos:

  • true: La operación se realizó correctamente.

  • false: La operación falló.

true

Success

boolean

Indica si la solicitud se realizó correctamente. Valores válidos:

  • true: La solicitud se realizó correctamente.

  • false: La solicitud falló.

true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "DC4E1E63-B337-44F8-8C22-6F00DF67E2C3",
  "Result": true,
  "Success": true
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 NickName.AlreadyIn.Organization The alias already exists. El apodo ya existe.
400 Fobbiden.Action The organization owner must have the administrator role. El propietario de la organización no se puede configurar con un rol que no sea de administrador.
400 Organization.Developers.ReachedTheUpperLimit The developers of the organization have reached the upper limit:%s El número de desarrolladores de la organización ha alcanzado el límite máximo de %s. Póngase en contacto con el administrador de la organización para aumentar la cuota de desarrolladores.
400 Organization.Viewers.ReachedTheUpperLimit The visitors of the organization have reached the upper limit:%s. El número de visualizadores de la organización ha alcanzado el límite máximo de %s. Póngase en contacto con el administrador de la organización para aumentar la cuota de visualizadores.
400 Organization.Analysts.ReachedTheUpperLimit The analysts of the organization have reached the upper limit:%s. El número de analistas de la organización ha alcanzado el límite máximo de %s. Póngase en contacto con el administrador de la organización para aumentar la cuota de analistas.
400 Instance.Over.MaxLicense You have reached the maximum number of users that can be added. Please upgrade the configurations or remove some users first.
400 Mail.Invalid Email/phone number is invalid. La dirección de correo electrónico o el número de teléfono no son válidos.
400 OrganizationDeveloper.CanNotChangeTo.AnalystOrViewer Organization user can not change developer to analyst or viewer. El desarrollador actual tiene permisos administrativos o de desarrollo en el espacio de trabajo y no se puede cambiar a analista o visor.
400 OrgAdminOrPermissionAdmin.CannotChangeTo.Viewer Organization admin or permission admin can not change to viewer. Los administradores de la organización o los administradores de gestión de permisos no se pueden configurar como visualizadores en Configuración.
400 ChangeTo.Viewer.Error The organization user type cannot be changed because the user already belongs to a workspace. El usuario ya pertenece a un espacio de trabajo. El tipo de usuario no se puede cambiar a visitante. Primero elimine al usuario del espacio de trabajo.
400 UserAnalyst.NotSupport.ThisRole This role has permissions that analysts cannot grant. El rol tiene permisos que un analista no puede otorgar.
400 Viewer.CannotHave.CustomRole Organization viewer cannot have custom roles. Los visitantes de la organización no pueden tener roles personalizados.
400 User.OrganizationRole.NotExist User %s must have role in organization. El usuario %s debe tener al menos un rol en la organización.
400 RoleCount.ExceedsLimit.Error The user role cannot exceed three. El número de roles de usuario no puede exceder 3.
400 BindRole.NotExist.Error Bind role not exist, %s. El rol vinculado no existe. %s.
400 Robot.Module.Exhausted The Quota of %s module has been exhausted. Se ha agotado la cuota del módulo %s.

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.