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 2023-02-16 GMT+08:00

Ver PDF

Criação de um usuário do IAM

Função

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

A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. 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	Obrigatoriedade	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 neste campo.
X-Auth-Token	Sim	String	Consulte Ações.

**Tabela 2** Parâmetros no corpo da solicitação
Parâmetro	Obrigatoriedade	Tipo	Descrição
user	Sim	Object	Informações do usuário.

**Tabela 3** user
Parâmetro	Obrigatoriedade	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, hífens (-), 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 da política de senha configurada na página de configurações da conta.
enabled	Não	Boolean	Habilitação do status do usuário do IAM. true (valor padrão) indica que o usuário está habilitado. 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	Habilitação do status do usuário do IAM. true (valor padrão) indica que o usuário está habilitado. 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 de link de recurso do usuário do IAM.
password_expires_at	String	Horário UTC quando a senha irá expirar. null indica que a senha tem validade ilimitada.
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

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 êxito.

{
    "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 êxito.
400	Parâmetros inválidos.
401	Autenticação falhou.
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.