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

Obtém as informações de um usuário específico.

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 resources.

*

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 valor deste parâmetro.	3***
Uid	string	Não	O UID do usuário. Você pode visualizar seu UID clicando na foto do perfil no canto superior direito do console do DMS.	22973492647626****
UserId	string	Não	O ID do usuário. Você pode chamar a operação ListUsers para obter o valor deste parâmetro.	51****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
User	object	As informações do usuário.
State	string	O estado do usuário. Valores válidos: NORMAL: normal DISABLE: desativado DELETE: 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 hora em que o usuário fez o último login no console.	2021-11-08 11:26:21
MaxResultCount	integer	O número máximo de linhas consultadas no dia atual.	10000
ParentUid	integer	O UID da conta Alibaba Cloud. Nota Um único UID de conta Alibaba Cloud pode conter vários UIDs de usuários RAM.	140692647406****
RoleIdList	object
RoleIds	array	A lista de IDs de função.
	integer	Os IDs de função. Valores válidos: 1: usuário comum 2: DBA 3: administrador 4: administrador de segurança 6: usuário com somente leitura de estrutura	1
RoleNameList	object
RoleNames	array	A lista de nomes de função.
	string	Os nomes de função. Valores válidos: USER: usuário comum DBA: DBA ADMIN: administrador SECURITY_ADMIN: administrador de segurança STRUCT_READ_ONLY: usuário com somente leitura de estrutura	USER
NickName	string	O apelido do usuário.	User_NickName
MaxExecuteCount	integer	O número máximo de consultas no dia atual.	2000
CurExecuteCount	integer	O número de consultas no dia atual.	3
Mobile	string	O número de telefone celular do usuário. Nota Se você configurou um número de telefone celular nas configurações de Notificação clicando na foto do perfil no canto superior direito do console, este parâmetro será retornado. Se você não configurou um número de telefone celular, este parâmetro não será retornado.	1389223****
Uid	string	O UID do usuário de destino.	22275482072787****
Email	string	O endereço de e-mail usado para receber notificações de mensagens. Nota Se você configurou um endereço de e-mail nas configurações de Notificação clicando na foto do perfil no canto superior direito do console, este parâmetro será retornado. Se você não configurou um endereço de e-mail, este parâmetro não será retornado.	Uesr_email
DingRobot	string	O chatbot do DingTalk usado para receber notificações de mensagens. Nota Se você configurou um chatbot do DingTalk nas configurações de Notificação clicando na foto do perfil no canto superior direito do console, este parâmetro será retornado. Se você não configurou um chatbot do DingTalk, este parâmetro não será retornado.	https://XXX.dingtalk.com/robot/send?access_token=***
Webhook	string	O webhook usado para receber notificações de mensagens. Nota Se você configurou um webhook, o sistema envia notificações de mensagens para a URL especificada quando as notificações são geradas no DMS. Se você não configurou um webhook, este parâmetro não será retornado.	http://dms-XXX.aliyun.com:8***
SignatureMethod	string	O método de assinatura para o webhook. Valores válidos: NONE: sem assinatura HMAC_SHA1: HMAC_SHA1	NONE
NotificationMode	string	Os métodos de notificação. Vários valores podem ser retornados. 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.	Unknown server error
Success	boolean	Especifica 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.