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/Atualização de informações do grupo de usuários
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Atualização de informações do grupo de usuários

Função

Essa API é fornecida para que o administrador atualize as informações do 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

PATCH /v3/groups/{group_id}

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

group_id

Sim

String

ID do grupo de usuários. Para obter detalhes sobre como obter um ID de grupo de usuários, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.

Parâmetros de solicitação

Tabela 2 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 3 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 4 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. name ou description deve ser especificado.

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

Não

String

Nome do grupo de usuários, que contém de 1 a 128 caracteres. name ou description deve ser especificado.

Parâmetros de resposta

Tabela 5 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

group

Object

Informações do grupo de usuários.

Tabela 6 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 7 group.links

Parâmetro

Tipo

Descrição

self

String

Link de recurso.

Exemplo de solicitação

Solicitação para alterar o nome do grupo de usuários para IAMGroup e a descrição para IAMDescription

PATCH https://iam.myhuaweicloud.com/v3/groups/{group_id}
{
    "group": {
        "description": "IAMDescription",
        "domain_id": "d78cbac186b744899480f25bd02...",
        "name": "IAMGroup"
    }
}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

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

Códigos de status

Código de status

Descrição

200

A solicitação foi bem-sucedida.

400

Parâmetros inválidos.

401

Falha na autenticação.

403

Acesso negado.

404

O recurso solicitado não pode ser encontrado.

409

Ocorre um conflito de recursos.

501

A API não está disponível.

Códigos de erro

Nenhum