文档首页/弹性云服务器 ECS/API参考/历史API/安全组管理（OpenStack Nova API）/更新安全组信息（废弃）
更新时间：2025-08-20 GMT+08:00
查看PDF
分享

更新安全组信息（废弃）

功能介绍

更新安全组。

当前API已废弃，请使用“更新安全组”。

URI

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

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。

security_group_id

是

安全组ID，在URI中指定。

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

security_group

是

Object

security_group对象，在消息体中指定，参见表3。

表3 请求参数security_group对象

参数

是否必选

参数类型

描述

name

是

String

安全组名称。

长度不超过255个字符。

description

是

String

安全组描述。

长度不超过255个字符。

响应消息

响应参数如表4所示。

表4 响应参数

参数

是否必选

参数类型

描述

security_group

是

Object

security_group对象，请参见表5。

表5 响应参数security_group对象

参数

是否必选

参数类型

描述

description

是

String

安全组描述信息。

长度不超过255个字符。

id

是

String

安全组ID，UUID格式。

name

是

String

安全组名称。

长度不超过255个字符。

rules

是

Array of objects

安全组规则列表，请参见表6。

tenant_id

是

String

租户ID或项目ID。

长度不超过255个字符。

表6 security_group_rule对象

参数

是否必选

参数类型

描述

parent_group_id

是

String

相关联的安全组ID，UUID格式。

ip_protocol

是

String

协议类型或直接指定IP协议号，取值可为icmp，tcp，udp或IP协议号。

from_port

是

Integer

起始端口，范围1-65535，且不大于to_port(icmp时，表示type，范围是0-255)。

to_port

是

Integer

终止端口，范围1-65535，且不小于from_port(icmp时，表示code，范围是0-255，且如果from_port为-1，to_port为-1表示任意ICMP报文)。

ip_range

是

Object

包含对端ip网段，cidr格式，参见表7。ip_range或者group参数的值为空。

group

是

Object

包括对端安全组的名称和对端安全组所属租户的租户ID，参见表8，ip_range或者group参数的值为空。

id

是

String

安全组规则ID，UUID格式。

表7 ip_range对象

参数

是否必选

参数类型

描述

cidr

是

String

对端IP网段，cidr格式。

长度不超过255个字符。

表8 group对象

参数

是否必选

参数类型

描述

tenant_id

是

String

对端安全组所属租户的租户ID。

name

是

String

对端安全组的名称。

请求示例

PUT https://{endpoint}/v2.1/bb1118612ba64af3a6ea63a1bdcaa5ae/os-security-groups/3d02312d-0764-49c9-8244-2368ddce0045
{
    "security_group": {
        "name": "test",
        "description": "description"
    }
}

响应示例

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

返回值

请参考通用请求返回值。