Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/Identity and Access Management/Referência de API/API/Gerenciamento de usuários do IAM/Modificação de informações do usuário
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Modificação de informações do usuário

Função

Essa API é fornecida para que o administrador modifique as informações do usuário do IAM.

A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.

Restrições

Essa API não pode ser usada para alterar o número de celular e o endereço de e-mail de um usuário do IAM. Para alterar o número do celular e o endereço de e-mail, use a API descrita em Modificação das informações do usuário do IAM (recomendado).

URI

PATCH /v3/users/{user_id}

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

user_id

Sim

String

ID do usuário do IAM. Para obter detalhes sobre como obter um ID de usuário, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.

Parâmetros de solicitação

Tabela 2 Parâmetros no cabeçalho da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

Content-Type

Sim

String

Preencha application/json;charset=utf8 nesse campo.

X-Auth-Token

Sim

String

Token de acesso emitido para um usuário para suportar sua identidade e permissões.

Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações.

Tabela 3 Parâmetros no corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

user

Sim

Object

Informações do usuário do IAM.

Tabela 4 user

Parâmetro

Obrigatório

Tipo

Descrição

domain_id

Não

String

ID da conta à qual o usuário do IAM pertence.

name

Não

String

Novo nome de usuário do IAM, que consiste de 1 a 32 caracteres. Pode conter letras, dígitos, espaços, hifens (-), sublinhados (_) e pontos (.) e não pode começar com um dígito ou espaço.

password

Não

String

Nova senha, que deve atender aos seguintes requisitos:

  • Pode conter de 6 a 32 caracteres. O comprimento mínimo de senha padrão é de 6 caracteres.
  • Deve conter pelo menos dois dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.
  • Não pode conter o número de celular ou endereço de e-mail do usuário.
  • Deve atender aos requisitos de senha definidos na política de senhas.
  • Deve ser diferente da senha anterior.

enabled

Não

Boolean

Status de ativação do usuário do IAM. true (valor padrão) indica que o usuário está ativado. false indica que o usuário está desativado.

description

Não

String

Descrição do usuário do IAM.

pwd_status

Não

Boolean

Status da senha. true significa que a senha precisa ser alterada e false significa que a senha é normal.

Parâmetros de resposta

Tabela 5 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

user

Object

Informações do usuário do IAM.

Tabela 6 user

Parâmetro

Tipo

Descrição

name

String

Nome de usuário do IAM.

domain_id

String

ID da conta à qual o usuário do IAM pertence.

enabled

Boolean

Status de ativação do usuário do IAM. true (valor padrão) indica que o usuário está ativado. false indica que o usuário está desativado.

id

String

ID do usuário do IAM.

password_expires_at

String

Tempo de expiração da senha. Se esse parâmetro for definido como null, a senha nunca expirará.

NOTA:

O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601.

description

String

Descrição do usuário do IAM.

pwd_status

Boolean

Status da senha. true significa que a senha precisa ser alterada e false significa que a senha é normal.

last_project_id

String

ID do projeto que o usuário do IAM acessou pela última vez antes de sair do sistema.

extra

Object

Outras informações sobre o usuário do IAM.

links

Object

Informações do link de recursos do usuário de IAM.

Tabela 7 user.extra

Parâmetro

Tipo

Descrição

description

String

Descrição do usuário do IAM.

pwd_status

Boolean

Status da senha. true significa que a senha precisa ser alterada e false significa que a senha é normal.

last_project_id

String

ID do projeto que o usuário do IAM acessou pela última vez antes de sair do sistema.

Tabela 8 user.links

Parâmetro

Tipo

Descrição

self

String

Link de recursos.

Exemplo de solicitação

Solicitação para que um administrador altere a senha do usuário do IAM chamado IAMUser para IAMPassword@

PATCH https://iam.myhuaweicloud.com/v3/users/{user_id}
{
    "user": {
        "domain_id": "d78cbac186b744899480f25bd02...",
        "name": "IAMUser",
        "password": "IAMPassword@",
        "enabled": true,
        "pwd_status": false,
        "description": "IAMDescription"
    }
}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "user": {
        "pwd_status": false,
        "description": "IAMDescription",
        "name": "IAMUser",
        "extra": {
            "pwd_status": false,
            "description": "IAMDescription",
        },
        "enabled": true,
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc003751c7..."
        },
        "id": "07609fb9358010e21f7bc003751c7...",
        "domain_id": "d78cbac186b744899480f25bd02..."
    }
}

Códigos de status

Código de status

Descrição

200

A solicitação foi bem-sucedida.

400

Parâmetros inválidos.

401

Falha na autenticação.

403

Acesso negado.

404

O recurso solicitado não pode ser encontrado.

405

O método especificado na solicitação não é permitido para o recurso solicitado.

409

Ocorre um conflito de recursos.

413

A entidade de solicitação é muito grande.

500

Erro de servidor interno.

503

Serviço indisponível.

Códigos de erro

Para obter detalhes, consulte Códigos de erro.