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/ Criação de um usuário do IAM

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Criação de um usuário do IAM

Função

Essa API é fornecida para o administrador criar um usuário do IAM. Um usuário do IAM precisa alterar sua senha no primeiro logon.

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

Quando você usa essa API para criar um usuário do IAM, não é possível especificar um número de celular ou endereço de e-mail para o usuário do IAM. Para especificar um número de celular e um endereço de e-mail, use a API descrita em Criação de um usuário do IAM (recomendado).

URI

POST /v3/users

Parâmetros de solicitação

**Tabela 1** 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 2** Parâmetros no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
user	Sim	Object	Informações do usuário.

**Tabela 3** user
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	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.
domain_id	Não	String	ID da conta à qual o usuário do IAM pertence.
password	Não	String	Senha do usuário. A senha 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. Deve atender aos requisitos de senha definidos na política de senhas.
enabled	Não	Boolean	Status de ativação do usuário de 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.

Parâmetros de resposta

**Tabela 4** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
user	Object	Informações do usuário do IAM.

**Tabela 5** user
Parâmetro	Tipo	Descrição
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.
domain_id	String	ID da conta à qual o usuário do IAM pertence.
name	String	Nome de usuário do IAM.
links	Object	Informações do link de recursos do usuário de 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.

**Tabela 6** user.links
Parâmetro	Tipo	Descrição
self	String	Link de recursos.

Exemplo de solicitação

Solicitação para que um administrador crie um usuário do IAM chamado IAMUser

POST https://iam.myhuaweicloud.com/v3/users

{
    "user": {
        "name": "IAMUser",
        "domain_id": "d78cbac186b744899480f25bd02...",
        "enabled": true,
        "password": "IAMPassword@",
        "description": "IAMDescription"
    }
}

Exemplo de resposta

Código de status: 201

O usuário do IAM foi criado com sucesso.

{
    "user": {
        "description": "IAMDescription",
        "name": "IAMUser",
        "enabled": true,
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/users/076598a17b0010e21fdec003f3a2aa45"
        },
        "domain_id": "d78cbac186b744899480f25b...",
        "id": "076598a17b0010e21fdec003f3a2a..."
    }
}

Códigos de status

Código de status	Descrição
201	O usuário do IAM foi criado com sucesso.
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.