Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ API fuera de fecha/ Gestión de grupos de seguridad (API de OpenStack Nova)/ Actualización de un grupo de seguridad (descartada)

Actualización más reciente 2022-11-08 GMT+08:00

Actualización de un grupo de seguridad (descartada)

Función

Esta API se utiliza para actualizar un grupo de seguridad.

Esta API ha sido descartada. Utilice la API descrita en Actualización de un grupo de seguridad.

URI

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

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.
security_group_id	Sí	Especifica el ID del grupo de seguridad, que se especifica en el URI.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
security_group	Sí	Object	Especifica el grupo de seguridad en el cuerpo del mensaje. Para más detalles, consulte Tabla 3.

**Tabla 3** Objetos del parámetro de solicitud **security_group**
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Especifica el nombre del grupo de seguridad. El valor no puede exceder de 255 caracteres.
description	Sí	String	Especifica información acerca de un grupo de seguridad. El valor no puede exceder de 255 caracteres.

Respuesta

Tabla 4 describe los parámetros de respuesta.

**Tabla 4** Parámetros de respuesta
Parámetro	Obligatorio	Tipo	Descripción
security_group	Sí	Object	Especifica el grupo de seguridad. Para más detalles, consulte Tabla 5.

**Tabla 5** Objetos del parámetro de respuesta **security_group**
Parámetro	Obligatorio	Tipo	Descripción
description	Sí	String	Especifica información acerca de un grupo de seguridad. El valor no puede exceder de 255 caracteres.
id	Sí	String	Especifica el ID del grupo de seguridad en formato UUID.
name	Sí	String	Especifica el nombre del grupo de seguridad. El valor no puede exceder de 255 caracteres.
rules	Sí	Array of objects	Especifica la lista de reglas del grupo de seguridad. Para más detalles, consulte Tabla 6.
tenant_id	Sí	String	Especifica el ID del tenant o del proyecto. El valor no puede exceder de 255 caracteres.

**Tabla 6** Objetos **security_group_rule**
Parámetro	Obligatorio	Tipo	Descripción
parent_group_id	Sí	String	Especifica el ID de grupo de seguridad asociado en formato UUID.
ip_protocol	Sí	String	Especifica el tipo de protocolo o el número de protocolo IP. El valor puede ser icmp, tcp, udp o el número de protocolo IP.
from_port	Sí	Integer	Especifica el puerto de inicio. El valor oscila entre 1 y 65,535 y no puede ser mayor que to_port. Cuando ip_protocol es icmp, este parámetro especifica un tipo de puerto con una longitud de 0 a 255 caracteres.
to_port	Sí	Integer	Especifica el puerto final. El valor oscila entre 1 y 65,535 y no puede ser menor que from_port. Cuando ip_protocol es icmp, especifica el código. El valor varía de 0 a 255. Si ambos from_port y to_port son -1, se puede transmitir cualquier paquete ICMP.
ip_range	Sí	Object	Especifica el segmento IP del mismo nivel en formato CIDR. Para más detalles, consulte Tabla 7. El valor de ip_range o group debe estar vacío.
group	Sí	Object	Especifica el nombre del grupo de seguridad del mismo nivel y el ID del inquilino en el grupo de seguridad del mismo nivel. Para más detalles, consulte Tabla 8. El valor de ip_range o group debe estar vacío.
id	Sí	String	Especifica el ID de regla del grupo de seguridad en formato UUID.

**Tabla 7** Objetos ip_range
Parámetro	Obligatorio	Tipo	Descripción
cidr	Sí	String	Especifica el segmento IP del mismo nivel en formato CIDR. El valor no puede exceder de 255 caracteres.

**Tabla 8** Objetos **group**
Parámetro	Obligatorio	Tipo	Descripción
tenant_id	Sí	String	Especifica el ID del tenant del grupo de seguridad del mismo nivel.
name	Sí	String	Especifica el nombre del grupo de seguridad del mismo nivel.

Ejemplo de la solicitud

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

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

Ejemplo de la respuesta

{
  "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"
  }
}