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 grupos de usuários/ Criação de um grupo de usuários

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

Ver PDF

Criação de um grupo de usuários

Função

Esta API é fornecida para o administrador criar um grupo de usuários.

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.

URI

POST /v3/groups

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
group	Sim	Object	Informações do grupo de usuários.

**Tabela 3** group
Parâmetro	Obrigatório	Tipo	Descrição
description	Não	String	Descrição do grupo de usuários, que deve conter menos ou igual a 255 caracteres.
domain_id	Não	String	ID da conta. Para obter detalhes sobre como obter o ID da conta, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.
name	Sim	String	Nome do grupo de usuários, que contém de 1 a 128 caracteres.

Parâmetros de resposta

**Tabela 4** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
group	Object	Informações do grupo de usuários.

**Tabela 5** group
Parâmetro	Tipo	Descrição
description	String	Descrição do grupo de usuários.
id	String	ID do grupo de usuários.
domain_id	String	ID da conta à qual o grupo de usuários pertence.
name	String	Nome do grupo de usuários.
links	Object	Link de recurso do grupo de usuários.
create_time	Long	Hora em que o grupo de usuários foi criado.

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

Exemplo de solicitação

Solicitação para que um administrador crie um grupo de usuários chamado IAMGroup

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

{
    "group": {
        "description": "IAMDescription",
        "domain_id": "d78cbac186b744899480f25bd0...",
        "name": "IAMGroup"
    }
}

Exemplo de resposta

Código de status: 201

O grupo de usuários foi criado com sucesso.

{
    "group": {
        "description": "IAMDescription",
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/groups/077a4c7bcd8010d53fb7c003e9d966c2"
        },
        "id": "077a4c7bcd8010d53fb7c003e9d966c2",
        "create_time": 1578969208707,
        "domain_id": "d78cbac186b744899480f25bd0...",
        "name": "IAMGroup"
    }
}

Códigos de status

Código de status	Descrição
201	O grupo de usuários foi criado com sucesso.
400	Parâmetros inválidos.
401	Falha na autenticação.
403	Acesso negado.
409	Ocorre um conflito de recursos.