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/ Elastic Cloud Server/ Referência de API/ As API desatualizadas/ Gerenciamento de grupo de segurança (as API de Nova do OpenStack)/ Atualização de um grupo de segurança (Descartado)

Atualizado em 2022-11-08 GMT+08:00

Atualização de um grupo de segurança (Descartado)

Função

Essa API é usada para atualizar um grupo de segurança.

Esta API foi descartada. Use a API descrita em Atualização de um grupo de segurança.

URI

PUT /v2.1/{project_id}/os-security-groups/{security_group_id}

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.
security_group_id	Sim	Especifica o ID do grupo de segurança, que é especificado no URI.

Solicitação

Tabela 2 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
security_group	Sim	Object	Especifica o grupo de segurança no corpo da mensagem. Para mais detalhes, consulte Tabela 3.

**Tabela 3** Objetos do parâmetro de solicitação **security_group**
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Especifica o nome do grupo de segurança. O valor não pode exceder 255 caracteres.
description	Sim	String	Especifica informações sobre um grupo de segurança. O valor não pode exceder 255 caracteres.

Resposta

Tabela 4 descreve os parâmetros de resposta.

**Tabela 4** Parâmetros de resposta
Parâmetro	Obrigatório	Tipo	Descrição
security_group	Sim	Object	Especifica o grupo de segurança. Para mais detalhes, consulte Tabela 5.

**Tabela 5** Objetos do parâmetro de resposta **security_group**
Parâmetro	Obrigatório	Tipo	Descrição
description	Sim	String	Especifica informações sobre um grupo de segurança. O valor não pode exceder 255 caracteres.
id	Sim	String	Especifica o ID do grupo de segurança no formato UUID.
name	Sim	String	Especifica o nome do grupo de segurança. O valor não pode exceder 255 caracteres.
rules	Sim	Array of objects	Especifica a lista de regras do grupo de segurança. Para mais detalhes, consulte Tabela 6.
tenant_id	Sim	String	Especifica o inquilino ou ID do projeto. O valor não pode exceder 255 caracteres.

**Tabela 6** objetos **security_group_rule**
Parâmetro	Obrigatório	Tipo	Descrição
parent_group_id	Sim	String	Especifica o ID do grupo de segurança associado no formato UUID.
ip_protocol	Sim	String	Especifica o tipo de protocolo ou o número do protocolo IP. O valor pode ser icmp, tcp, udp ou o número do protocolo IP.
from_port	Sim	Integer	Especifica a porta inicial. O valor varia de 1 a 65 535 e não pode ser maior que to_port. Quando ip_protocol é icmp, este parâmetro especifica um tipo de porta com um comprimento de 0 a 255 caracteres.
to_port	Sim	Integer	Especifica a porta final. O valor varia de 1 a 65 535 e não pode ser menor que from_port. Quando ip_protocol é icmp, ele especifica o código. O valor varia de 0 a 255. Se ambos from_port e to_port são -1, qualquer pacote ICMP pode ser transmitido.
ip_range	Sim	Object	Especifica o segmento IP de peer no formato CIDR. Para mais detalhes, consulte Tabela 7. O valor de ip_range ou group deve estar vazio.
group	Sim	Object	Especifica o nome do grupo de segurança de pares e o ID do locatário no grupo de segurança de pares. Para mais detalhes, consulte Tabela 8. O valor de ip_range ou group deve estar vazio.
id	Sim	String	Especifica a ID da regra do grupo de segurança no formato UUID.

**Tabela 7** Objetos **ip_range**
Parâmetro	Obrigatório	Tipo	Descrição
cidr	Sim	String	Especifica o segmento IP de peer no formato CIDR. O valor não pode exceder 255 caracteres.

**Tabela 8** objetos de **group**
Parâmetro	Obrigatório	Tipo	Descrição
tenant_id	Sim	String	Especifica a ID do locatário do grupo de segurança de pares.
name	Sim	String	Especifica o nome do grupo de segurança peer.

Exemplo de solicitação

PUT https://{endpoint}/v2.1/bb1118612ba64af3a6ea63a1bdcaa5ae/os-security-groups/3d02312d-0764-49c9-8244-2368ddce0045

{
    "security_group": {
        "name": "test",
        "description": "description"
    }
}

Exemplo de resposta

{
  "security_group": {
    "rules": [
      {
        "from_port": null,
        "group": {
          "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
          "name": "test"
        },
        "ip_protocol": null,
        "to_port": null,
        "parent_group_id": "3d02312d-0764-49c9-8244-2368ddce0045",
        "ip_range": {},
        "id": "00dec0b6-8e96-4906-aadf-46cfe54cf5ef"
      }
    ],
    "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae",
    "id": "3d02312d-0764-49c9-8244-2368ddce0045",
    "name": "test",
    "description": "description"
  }
}