功能介绍

更新安全组。

当前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"
  }
}

返回值

请参考通用请求返回值。

父主题： 安全组管理（OpenStack Nova API）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家