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

Consulta as informações de um usuário.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dms:GetUser

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Tid	integer	Não	O ID do locatário. Você pode chamar a operação GetUserActiveTenant para obter o ID do locatário.	3***
Uid	string	Não	O UID da conta Alibaba Cloud. Você pode visualizar seu UID passando o ponteiro sobre a foto do perfil no canto superior direito do console do Data Management (DMS).	22973492647626****
UserId	string	Não	O ID do usuário. Você pode chamar a operação ListUsers para consultar o ID do usuário.	51****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
User	object	As informações do usuário.
State	string	O status do usuário. Valores válidos: NORMAL: O usuário está normal. DISABLE: O usuário está desativado. DELETE: O usuário está excluído.	NORMAL
CurResultCount	integer	O número de linhas consultadas no dia atual.	28
UserId	string	O ID do usuário.	51****
LastLoginTime	string	A última vez em que o usuário fez login no console.	2021-11-08 11:26:21
MaxResultCount	integer	O número máximo de linhas que podem ser consultadas no dia atual.	10000
ParentUid	integer	O UID da conta Alibaba Cloud do usuário. Nota Uma conta Alibaba Cloud pode conter um ou mais usuários RAM.	140692647406****
RoleIdList	object
RoleIds	array	The list of role IDs.
	integer	The ID of the role that is assigned to the user. Valid values: 1: a regular user role. 2: a database administrator (DBA) role. 3: a DMS administrator role. 4: a security administrator role. 6: a schema read-only user role.	1
RoleNameList	object
RoleNames	array	The list of role names.
	string	The name of the role that is assigned to the user. Valid values: USER: a regular user. DBA : a DBA. ADMIN: a DMS administrator. SECURITY_ADMIN: a security administrator. STRUCT_READ_ONLY: a schema read-only user.	USER
NickName	string	O apelido do usuário.	User_NickName
MaxExecuteCount	integer	O número máximo de consultas que podem ser executadas no dia atual.	2000
CurExecuteCount	integer	O número de consultas executadas no dia atual.	3
Mobile	string	O número de celular do usuário. Nota O sistema retorna este parâmetro se o usuário tiver definido um número de celular no console. Para definir um número de celular no console, passe o ponteiro sobre a foto do perfil no canto superior direito e clique no ícone Editar ao lado de Aviso. O sistema não retorna este parâmetro se o usuário não tiver definido um número de celular.	1389223****
Uid	string	O UID do usuário.	22275482072787****
Email	string	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 do perfil no canto superior direito e clique no ícone Editar ao lado de Aviso. O sistema não retorna este parâmetro se o usuário não tiver definido um endereço de e-mail.	Uesr_email
DingRobot	string	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 do perfil no canto superior direito e clique no ícone Editar ao lado de Aviso. O sistema não retorna este parâmetro se o usuário não tiver definido uma URL de chatbot do DingTalk.	https://XXX.dingtalk.com/robot/send?access_token=***
Webhook	string	A URL do webhook usada para receber notificações. Nota Se o usuário tiver definido uma URL de webhook, o DMS enviará 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.	http://dms-XXX.aliyun.com:8***
SignatureMethod	string	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.	NONE
NotificationMode	string	O método de notificação. O sistema retorna um ou mais valores. Valores válidos: SMS: mensagem de texto. EMAIL: e-mail. DINGDING: DingTalk. DINGROBOT: chatbot do DingTalk. WEBHOOK: webhook.	EMAIL
RequestId	string	O ID da solicitação.	804BB128-CAFA-5DD0-BA1E-43DDE488****
ErrorCode	string	O código de erro.	UnknownError
ErrorMessage	string	A mensagem de erro retornada se a solicitação falhar.	Unknown server error
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "User": {
    "State": "NORMAL",
    "CurResultCount": 28,
    "UserId": "51****",
    "LastLoginTime": "2021-11-08 11:26:21",
    "MaxResultCount": 10000,
    "ParentUid": 0,
    "RoleIdList": {
      "RoleIds": [
        1
      ]
    },
    "RoleNameList": {
      "RoleNames": [
        "USER"
      ]
    },
    "NickName": "User_NickName",
    "MaxExecuteCount": 2000,
    "CurExecuteCount": 3,
    "Mobile": "1389223****",
    "Uid": "22275482072787****",
    "Email": "Uesr_email",
    "DingRobot": "https://XXX.dingtalk.com/robot/send?access_token=***",
    "Webhook": "http://dms-XXX.aliyun.com:8***",
    "SignatureMethod": "NONE",
    "NotificationMode": "EMAIL"
  },
  "RequestId": "804BB128-CAFA-5DD0-BA1E-43DDE488****",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "Unknown server error",
  "Success": true
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.