GetUser - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetUser	A operação que você deseja executar. Defina o valor como GetUser.
Tid	Long	Sim	3***	O ID do locatário. Chame a operação GetUserActiveTenant para consultar o ID do locatário.
Uid	String	Não	22973492647626****	O UID do usuário. Visualize seu UID passando o ponteiro sobre a foto de perfil no canto superior direito do console do Data Management (DMS).
UserId	String	Não	51****	O ID do usuário. Chame a operação ListUsers para consultar o ID do usuário.
RegionId	String	Não	cn-hangzhou	O ID da região onde o DMS está ativado. Defina este parâmetro com o ID da região mais próxima dos seus serviços. Para obter mais informações sobre os valores válidos do parâmetro, consulte Parâmetro RegionID.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
User	Object		As informações sobre o usuário.
State	String	NORMAL	O status do usuário. Valores válidos: NORMAL: O usuário está normal. DISABLE: O usuário está desativado. DELETE: O usuário foi excluído.
CurResultCount	Long	28	A quantidade de linhas consultadas no dia atual.
UserId	String	51****	O ID do usuário.
LastLoginTime	String	2021-11-08 11:26:21	A última vez em que o usuário fez login no console.
MaxResultCount	Long	10000	O número máximo de linhas que podem ser consultadas no dia atual.
ParentUid	Long	140692647406****	O UID da conta Alibaba Cloud do usuário. Nota Uma conta Alibaba Cloud pode conter um ou mais usuários RAM.
RoleIdList	Array of Integer	1	O ID da função atribuída ao usuário. Valores válidos: 1: função de usuário comum. 2: função de administrador de banco de dados (DBA). 3: função de administrador do DMS. 4: função de administrador de segurança. 6: função de usuário somente leitura de esquema.
RoleNameList	Array of String	USER	O nome da função atribuída ao usuário. Valores válidos: USER: usuário comum. DBA: DBA. ADMIN: administrador do DMS. SECURITY_ADMIN: administrador de segurança. STRUCT_READ_ONLY: usuário somente leitura de esquema.
NickName	String	User_NickName	O apelido do usuário.
MaxExecuteCount	Long	2000	O número máximo de consultas que podem ser executadas no dia atual.
CurExecuteCount	Long	3	A quantidade de consultas executadas no dia atual.
Mobile	String	1389223****	O número de telefone celular usado para receber notificações. Nota O sistema retorna este parâmetro se o usuário tiver definido um número de telefone celular no console. Para definir um número de telefone celular no console, passe o ponteiro sobre a foto de perfil no canto superior direito e clique em no ícone Editar ao lado de Notice. O sistema não retorna este parâmetro se o usuário não tiver definido um número de telefone celular.
Uid	String	22275482072787****	O UID do usuário.
Email	String	Uesr_email	O endereço de e-mail usado para receber notificações. Nota O sistema retorna este parâmetro se o usuário tiver definido um endereço de e-mail no console. Para definir um endereço de e-mail no console, passe o ponteiro sobre a foto de perfil no canto superior direito e clique em no ícone Editar ao lado de Notice. O sistema não retorna este parâmetro se o usuário não tiver definido um endereço de e-mail.
DingRobot	String	https://XXX.dingtalk.com/robot/send?access_token=***	A URL do chatbot do DingTalk usada para receber notificações. Nota O sistema retorna este parâmetro se o usuário tiver definido uma URL de chatbot do DingTalk no console. Para definir uma URL de chatbot do DingTalk no console, passe o ponteiro sobre a foto de perfil no canto superior direito e clique em no ícone Editar ao lado de Notice. O sistema não retorna este parâmetro se o usuário não tiver definido uma URL de chatbot do DingTalk.
Webhook	String	http://dms-XXX.aliyun.com:8***	A URL do webhook usada para receber notificações. Nota Se o usuário tiver definido uma URL de webhook, o DMS envia notificações para a URL especificada. O sistema não retorna este parâmetro se o usuário não tiver definido uma URL de webhook.
SignatureMethod	String	NONE	O método de assinatura usado para proteger conexões quando uma URL de webhook é utilizada. Valores válidos: NONE: sem assinatura. HMAC_SHA1: HMAC_SHA1.
NotificationMode	String	EMAIL	O método de notificação. O sistema retorna um ou mais valores. Valores válidos: SMS: mensagem de texto. EMAIL: e-mail. DingTalk: DingTalk. DINGROBOT: chatbot do DingTalk. WEBHOOK: webhook.
RequestId	String	804BB128-CAFA-5DD0-BA1E-43DDE488****	O ID da solicitação.
ErrorCode	String	UnknownError	O código de erro retornado.
ErrorMessage	String	Unknown server error	A mensagem de erro retornada.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.