更新安全组信息(废弃)
URI
PUT /v2.1/{project_id}/os-security-groups/{security_group_id}
请求消息
请求参数如表2所示。
响应消息
响应参数如表4所示。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
description |
是 |
String |
安全组描述信息。 长度不超过255个字符。 |
id |
是 |
String |
安全组ID,UUID格式。 |
name |
是 |
String |
安全组名称。 长度不超过255个字符。 |
rules |
是 |
Array of objects |
安全组规则列表,请参见表6。 |
tenant_id |
是 |
String |
租户ID或项目ID。 长度不超过255个字符。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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格式。 |
请求示例
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" } }
返回值
请参考通用请求返回值。