GetUser - - Centro de documentación de Alibaba Cloud

Consulta los detalles de un usuario.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que invoque esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	GetUser	La operación que desea ejecutar. Establezca el valor en GetUser.
Tid	Long	Sí	3***	El ID del inquilino. Puede invocar la operación GetUserActiveTenant para consultar el ID del inquilino.
Uid	String	No	22973492647626****	El UID del usuario. Puede consultar su UID al pasar el puntero sobre la imagen de perfil en la esquina superior derecha de la consola de Data Management (DMS).
UserId	String	No	51****	El ID del usuario. Puede invocar la operación ListUsers para consultar el ID del usuario.
RegionId	String	No	cn-hangzhou	El ID de la región donde está activado DMS. Establezca este parámetro en el ID de la región más cercana a sus servicios. Para obtener más información sobre los valores válidos del parámetro, consulte Parámetro RegionID.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
User	Object		La información del usuario.
State	String	NORMAL	El estado del usuario. Valores válidos: NORMAL: El usuario se encuentra en estado normal. DISABLE: El usuario está deshabilitado. DELETE: El usuario está eliminado.
CurResultCount	Long	28	El número de filas consultadas durante el día actual.
UserId	String	51****	El ID del usuario.
LastLoginTime	String	2021-11-08 11:26:21	La última vez que el usuario inició sesión en la consola.
MaxResultCount	Long	10000	El número máximo de filas que se pueden consultar durante el día actual.
ParentUid	Long	140692647406****	El UID de la cuenta de Alibaba Cloud del usuario. Nota Una cuenta de Alibaba Cloud puede contener uno o más usuarios de RAM.
RoleIdList	Array of Integer	1	El ID del rol asignado al usuario. Valores válidos: 1: Rol de usuario regular. 2: Rol de administrador de base de datos (DBA). 3: Rol de administrador de DMS. 4: Rol de administrador de seguridad. 6: Rol de usuario de solo lectura de esquema.
RoleNameList	Array of String	USER	El nombre del rol asignado al usuario. Valores válidos: USER: Usuario regular. DBA : DBA. ADMIN: Administrador de DMS. SECURITY_ADMIN: Administrador de seguridad. STRUCT_READ_ONLY: Usuario de solo lectura de esquema.
NickName	String	User_NickName	El apodo del usuario.
MaxExecuteCount	Long	2000	El número máximo de consultas que se pueden ejecutar durante el día actual.
CurExecuteCount	Long	3	El número de consultas ejecutadas durante el día actual.
Mobile	String	1389223****	El número de celular utilizado para recibir notificaciones. Nota El sistema devuelve este parámetro si el usuario configuró un número de celular en la consola. Para configurar un número de celular en la consola, pase el puntero sobre la imagen de perfil en la esquina superior derecha y haga clic en el icono de edición junto a Notice. El sistema no devuelve este parámetro si el usuario no configuró un número de celular.
Uid	String	22275482072787****	El UID del usuario.
Email	String	Uesr_email	La dirección de correo electrónico utilizada para recibir notificaciones. Nota El sistema devuelve este parámetro si el usuario configuró una dirección de correo electrónico en la consola. Para configurar una dirección de correo electrónico en la consola, pase el puntero sobre la imagen de perfil en la esquina superior derecha y haga clic en el icono de edición junto a Notice. El sistema no devuelve este parámetro si el usuario no configuró una dirección de correo electrónico.
DingRobot	String	https://XXX.dingtalk.com/robot/send?access_token=***	La URL del chatbot de DingTalk utilizada para recibir notificaciones. Nota El sistema devuelve este parámetro si el usuario configuró una URL de chatbot de DingTalk en la consola. Para configurar una URL de chatbot de DingTalk en la consola, pase el puntero sobre la imagen de perfil en la esquina superior derecha y haga clic en el icono de edición junto a Notice. El sistema no devuelve este parámetro si el usuario no configuró una URL de chatbot de DingTalk.
Webhook	String	http://dms-XXX.aliyun.com:8***	La URL del webhook utilizada para recibir notificaciones. Nota Si el usuario configuró una URL de webhook, DMS envía notificaciones a la URL especificada. El sistema no devuelve este parámetro si el usuario no configuró una URL de webhook.
SignatureMethod	String	NONE	El método de firma utilizado para proteger las conexiones cuando se usa una URL de webhook. Valores válidos: NONE: Sin firma. HMAC_SHA1: HMAC_SHA1.
NotificationMode	String	EMAIL	El método de notificación. El sistema devuelve uno o más valores. Valores válidos: SMS: Mensaje de texto. EMAIL: Correo electrónico. DingTalk: DingTalk. DINGROBOT: Chatbot de DingTalk. WEBHOOK: Webhook.
RequestId	String	804BB128-CAFA-5DD0-BA1E-43DDE488****	El ID de la solicitud.
ErrorCode	String	UnknownError	El código de error devuelto.
ErrorMessage	String	Unknown server error	El mensaje de error devuelto.
Success	Boolean	true	Indica si la solicitud fue exitosa. Valores válidos: true: La solicitud fue exitosa. false: La solicitud falló.

Ejemplos

Solicitudes de ejemplo

http(s)://dms-enterprise.aliyuncs.com/?Action=GetUser
&Tid=3***
&Uid=22973492647626****
&UserId=51****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<GetUserResponse>
    <User>
        <NotificationMode/>
        <Email>Uesr_email</Email>
        <RoleNameList>
            <RoleNames>USER</RoleNames>
            <RoleNames>ADMIN</RoleNames>
        </RoleNameList>
        <NickName>User_NickName</NickName>
        <MaxExecuteCount>2000</MaxExecuteCount>
        <CurResultCount>28</CurResultCount>
        <LastLoginTime>2021-11-09 13:39:21</LastLoginTime>
        <Uid>22275482072787****</Uid>
        <RoleIdList>
            <RoleIds>1</RoleIds>
            <RoleIds>3</RoleIds>
        </RoleIdList>
        <MaxResultCount>10000</MaxResultCount>
        <State>NORMAL</State>
        <UserId>51****</UserId>
        <CurExecuteCount>3</CurExecuteCount>
        <ParentUid>140692647406****</ParentUid>
    </User>
    <RequestId>804BB128-CAFA-5DD0-BA1E-43DDE488****</RequestId>
    <Success>true</Success>
</GetUserResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "User" : {
    "NotificationMode" : "",
    "Email" : "Uesr_email",
    "RoleNameList" : {
      "RoleNames" : [ "USER", "ADMIN" ]
    },
    "NickName" : "User_NickName",
    "MaxExecuteCount" : 2000,
    "CurResultCount" : 28,
    "LastLoginTime" : "2021-11-09 13:39:21",
    "Uid" : "22275482072787****",
    "RoleIdList" : {
      "RoleIds" : [ 1, 3 ]
    },
    "MaxResultCount" : 10000,
    "State" : "NORMAL",
    "UserId" : "51****",
    "CurExecuteCount" : 3,
    "ParentUid" : "140692647406****"
  },
  "RequestId" : "804BB128-CAFA-5DD0-BA1E-43DDE488****",
  "Success" : true
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.