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
Compartilhar

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.

Códigos de erro

Nenhum