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

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.