Actualización de un grupo de seguridad
Función
Esta API se utiliza para actualizar un grupo de seguridad.
URI
PUT /v2.0/security-groups/{security_group_id}
Mensaje de solicitud
Parámetro |
Tipo |
Obligatorio |
Descripción |
---|---|---|---|
security_group |
security_group object |
Sí |
Especifica el grupo de seguridad. Para más detalles, consulte Tabla 2. Debe especificar al menos un atributo al actualizar un grupo de seguridad. |
Ejemplo de solicitud
PUT https://{Endpoint}/v2.0/security-groups/d29ae17d-f355-4992-8747-1fb66cc9afd2 { "security_group": { "name": "sg-test02" } }
Mensaje de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
security_group |
Objeto de security_group |
Especifica los objetos del grupo de seguridad. Para más detalles, consulte Tabla 4. |
Atributo |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del grupo de seguridad. Este parámetro no es obligatorio cuando consulta grupos de seguridad. |
tenant_id |
String |
Especifica el ID del proyecto. |
name |
String |
Especifica el nombre del grupo de seguridad. |
description |
String |
Proporciona información adicional sobre el grupo de seguridad. |
security_group_rules |
Array of Security Group Rule objects |
Especifica la lista de reglas del grupo de seguridad. Para más detalles, consulte Tabla 5. |
project_id |
String |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto. |
created_at |
String |
Especifica la hora (UTC) en la que se crea el grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
updated_at |
String |
Especifica la hora (UTC) cuando se actualiza el grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
Atributo |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el identificador de la regla del grupo de seguridad. Este parámetro no es obligatorio cuando consulta las reglas del grupo de seguridad. |
description |
String |
Proporciona la información adicional acerca de la regla del grupo de seguridad. |
security_group_id |
String |
Especifica el ID del grupo de seguridad perteneciente. |
remote_group_id |
String |
Especifica el identificador del par del grupo de seguridad perteneciente. |
direction |
String |
Especifica la dirección del tráfico para el que tiene efecto la regla de grupo de seguridad. |
remote_ip_prefix |
String |
Especifica el segmento de dirección IP del mismo nivel. |
protocol |
String |
Especifica el tipo de protocolo o el número de protocolo IP. |
port_range_max |
Integer |
Especifica el número máximo de puerto. Cuando se utiliza ICMP, el valor es el código de ICMP. |
port_range_min |
Integer |
Especifica el número de puerto mínimo. Si se utiliza el protocolo ICMP, este parámetro indica el tipo de ICMP. Cuando se utiliza el protocolo TCP o UDP, deben especificarse tanto port_range_max como port_range_min, y el valor port_range_max debe ser mayor que el valor port_range_min. Cuando se utiliza el protocolo ICMP, si especifica el código ICMP (port_range_max), también debe especificar el tipo de ICMP (port_range_min). |
ethertype |
String |
Especifica el tipo de red. Se admiten IPv4 e IPv6. |
tenant_id |
String |
Especifica el ID del proyecto. |
remote_address_group_id |
String |
|
project_id |
String |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto. |
created_at |
String |
Especifica la hora (UTC) en la que se crea la regla de grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
updated_at |
String |
Especifica la hora (UTC) en la que se actualiza la regla del grupo de seguridad. Formato: aaaa-MM-ddTHH:mm:ss |
Ejemplo de respuesta
{ "security_group": { "id": "d29ae17d-f355-4992-8747-1fb66cc9afd2", "name": "sg-test02", "description": "", "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "security_group_rules": [ { "id": "6332de3e-98fb-4f8c-b44a-fcb8ff09881e", "direction": "egress", "protocol": null, "ethertype": "IPv6", "description": null, "remote_group_id": null, "remote_ip_prefix": null, "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "port_range_max": null, "port_range_min": null, "security_group_id": "d29ae17d-f355-4992-8747-1fb66cc9afd2", "remote_address_group_id": "0150a3a7-82ca-4569-865c-04e46e5e9249" }, { "id": "3f51e52c-0e85-40f7-a137-85927392e436", "direction": "egress", "protocol": null, "ethertype": "IPv4", "description": null, "remote_group_id": null, "remote_ip_prefix": null, "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "port_range_max": null, "port_range_min": null, "security_group_id": "d29ae17d-f355-4992-8747-1fb66cc9afd2", "remote_address_group_id": null } ], "created_at": "2018-09-20T02:15:34", "updated_at": "2018-09-20T02:16:31" } }
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.