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
| 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. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Sim | Object | Informações do usuário. |
| 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:
|
| 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
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Object | Informações do usuário do IAM. |
| 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. |
| 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. |
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. |
Códigos de erro
Para obter detalhes, consulte Códigos de erro.
