安全组

列举安全组

功能介绍

列举网络安全组。

URI

GET /v2.0/security-groups

请求消息

参数	参数类型	是否必选	描述
security-group	object	是	安全组对象。
description	String	否	用户描述。
name	String	是	安全组的名称。
tenant_id	String	是	所属租户ID。

请求示例

示例：创建安全组
GET /v2.0/security-groups

响应消息

参数	参数类型	描述
security-group	oarrayect	列表组对象。
created_at	String	安全组的创建时间 (UTC ISO8601 格式)。
description	String	用户描述
id	String	安全组的ID。
name	satring	安全组的名称。
project_id	String	安全组所属的project id。
revision_number		安全组的版本号。
security_group_rules	array	安全组包含的规则列表。
tenant_id	String	安全组所属的tenant id。
updated_at	String	安全组最近更新的时间(UTC ISO8601格式)。

响应示例

{
    "security_grsoup[
      ": {
        "created_at": "2021-02-24T09:06:32Z",
        "description": "",.
        "id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
        "name": "test",
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "revision_number": 1,
        "security_group_rules": [
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv4",
                "id": "231354cc-c516-47fd-9cc5-c20aab9b0e6c",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            },
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv6",
                "id": "2455c213-22ec-4d8d-b668-483cf8f831b3",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            }
        ],
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T09:06:32Z"
    
    ]  }
}

正常响应代码

200

错误码

400，401，403，404，409，413

创建安全组

功能介绍

创建网络安全组。

URI

POST /v2.0/security-groups

请求消息

参数	参数类型	是否必选	描述
security-group	object	是	安全组对象。
description	String	否	用户描述。
name	String	否	安全组的名称。
tenant_id	String	否	所属租户ID。

请求示例

示例：创建安全组

POST /v2.0/security-groups
{
    "security_group": {
        "name": "test",
        "tenant_id":"8dac1bf1c3a24be18809f82e1f9a845d"
}

响应消息

参数	参数类型	描述
security-group	object	安全组对象。
created_at	String	安全组的创建时间 (UTC ISO8601 格式)。
description	String	用户描述。
id	String	安全组的ID。
name	satring	安全组的名称。
project_id	String	安全组所属的project id。
revision_number		安全组的版本号。
security_group_rules	array	安全组包含的规则列表。
tenant_id	String	安全组所属的tenant id。
updated_at	String	安全组最近更新的时间(UTC ISO8601格式)。

响应示例

{
    "security_group": {
        "created_at": "2021-02-24T09:06:32Z",
        "description": "",
        "id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
        "name": "test",
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "revision_number": 1,
        "security_group_rules": [
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv4",
                "id": "231354cc-c516-47fd-9cc5-c20aab9b0e6c",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            },
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv6",
                "id": "2455c213-22ec-4d8d-b668-483cf8f831b3",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            }
        ],
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T09:06:32Z"
    }
}

正常响应代码

201

错误码

400，401，403，404，409，413

显示安全组详情

功能介绍

显示指定安全组详情。

URI

GET /v2.0/security-groups/{security-group-id}

参数	是否必选	描述
security-group-id	是	安全组ID

请求示例

示例：显示安全组详情

GET /v2.0/security-groups/de80111e-4ddb-4b58-a295-0b32e9a4f963
{
    "security_group": {
        "name": "test",
        "tenant_id":"8dac1bf1c3a24be18809f82e1f9a845d"
    }
}

响应消息

参数	参数类型	描述
security-group	object	安全组对象。
created_at	String	安全组的创建时间 (UTC ISO8601 格式)。
description	String	用户描述。
id	String	安全组的ID。
name	satring	安全组的名称。
project_id	String	安全组所属的project id。
revision_number		安全组的版本号。
security_group_rules	array	安全组包含的规则列表。
tenant_id	String	安全组所属的tenant id。
updated_at	String	安全组最近更新的时间(UTC ISO8601 格式)。

响应示例

{
    "security_group": {
        "created_at": "2021-02-24T09:06:32Z",
        "description": "",
        "id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
        "name": "test",
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "revision_number": 1,
        "security_group_rules": [
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv4",
                "id": "231354cc-c516-47fd-9cc5-c20aab9b0e6c",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            },
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv6",
                "id": "2455c213-22ec-4d8d-b668-483cf8f831b3",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            }
        ],
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T09:06:32Z"
    }
}

正常响应代码

200

错误码

400，401，403，404，409，413

更新安全组

功能介绍

更新指定安全组。

URI

PUT /v2.0/security-groups/{security-group-id}

参数	是否必选	描述
security-group-id	是	安全组ID

请求消息

参数	参数类型	是否必选	描述
security-group	object	是	安全组对象。
description	String	否	用户描述。
name	String	否	安全组的名称。

请求示例

示例：更新安全组名称
PUT /v2.0/security-groups/de80111e-4ddb-4b58-a295-0b32e9a4f963

{
    "security_group": {
        "name": "test2"
    }

响应消息

参数	参数类型	描述
security-group	object	安全组对象。
created_at	String	安全组的创建时间 (UTC ISO8601 格式)。
description	String	用户描述。
id	String	安全组的ID。
name	satring	安全组的名称。
project_id	String	安全组所属的project id。
revision_number		安全组的版本号。
security_group_rules	array	安全组包含的规则列表。
tenant_id	String	安全组所属的tenant id。
updated_at	String	安全组最近更新的时间(UTC ISO8601格式)。

响应示例

{
    "security_group": {
        "created_at": "2021-02-24T09:06:32Z",
        "description": "",
        "id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
        "name": "test2",
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "revision_number": 1,
        "security_group_rules": [
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv4",
                "id": "231354cc-c516-47fd-9cc5-c20aab9b0e6c",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            },
            {
                "created_at": "2021-02-24T09:06:32Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv6",
                "id": "2455c213-22ec-4d8d-b668-483cf8f831b3",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
                "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
                "updated_at": "2021-02-24T09:06:32Z"
            }
        ],
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T10:06:32Z"
    }
}

正常响应代码

201

错误码

400，401，403，404，409，413

删除安全组

功能介绍

删除指定网络安全组。

URI

DELETE /v2.0/security-groups/{security-group-id}

参数	是否必选	描述
security-group-id	是	安全组ID

请求消息

无

请求示例

示例：删除安全组
DELETE /v2.0/security-groups/de80111e-4ddb-4b58-a295-0b32e9a4f963

响应消息

无

响应示例

无

正常响应代码

204

错误码

400，401，403，404，409，413

列举安全组规则

功能介绍

列举网络安全组规则。

URI

GET /v2.0/security-group-rules

请求消息

无

请求示例

示例：列举安全组规则
GET /v2.0/security-group-rules

响应消息

参数	参数类型	描述
security-group-rules	array	安全组规则列表。
created_at	String	安全组规则的创建时间 (UTC ISO8601格式)。
description	String	用户描述。
direction	String	安全组规则作用的方向，ingress或egress
ethertype	String	匹配的以太网协议，必需是IPv4或IPv6。
id	String	安全组规则的ID。
project_id	String	安全组规则所。属的project id。
protocol	String	匹配的IP协议类型，比如ICMP type。
port_range_max	integer	匹配的协议端口号最大值,如果协议是ICMP，则表示ICMP code。
port_range_min	integer	匹配的协议端口号最小值,如果协议是ICMP，则表示ICMP code。
remote_ip_prefix	String	匹配的远端ip前缀。
remote_group_id	String	匹配的远端安全组的ID，可以指定remote_group_id或者remote_ip_prefix。
revision_number	integer	安全组规则的版本号。
security_group_id	String	关联的安全组ID。
tenant_id	String	安全组规则所属的tenant id。
updated_at	String	安全组规则最近更新的时间(UTC ISO8601格式)。

响应示例

{
"security_group_rules": [
  {
    "created_at": "2021-02-22T03:23:55Z",
    "description": null,
    "direction": "egress",
    "ethertype": "IPv4",
    "id": "00c1068e-0110-4cf2-8856-0e20268562fd",
    "port_range_max": null,
    "port_range_min": null,
    "project_id": "6e3cf7a9d62a4faf8162cacfc94126a9",
    "protocol": null,
    "remote_group_id": null,
    "remote_ip_prefix": null,
    "revision_number": 1,
    "security_group_id": "61884e28-ca98-4e76-b0f3-6d5b3536bd7b",
    "tenant_id": "6e3cf7a9d62a4faf8162cacfc94126a9",
    "updated_at": "2021-02-22T03:23:55Z"
  },
  {
   "created_at": "2021-02-25T03:07:27Z",
    "description": "",
    "direction": "ingress",
    "ethertype": "IPv4",
    "id": "0184bfe7-f838-476f-ad19-6891215583f5",
    "port_range_max": 65535,
    "port_range_min": 1,
    "project_id": "e9f2f863c96841e49ba4e9946ebe9087",
    "protocol": "tcp",
    "remote_group_id": null,
    "remote_ip_prefix": "0.0.0.0/0",
    "revision_number": 1,
    "security_group_id": "a12e08af-9e8d-461c-952d-3c6fbc1bebcb",
    "tenant_id": "e9f2f863c96841e49ba4e9946ebe9087",
    "updated_at": "2021-02-25T03:07:27Z"
   }
  ]
}

正常响应代码

200

错误码

400，401，403，404，409，413

创建安全组规则

功能介绍

创建网络安全组规则。

URI

POST /v2.0/security-group-rules

请求消息

参数	参数类型	是否必选	描述
security-group-rule	object	是	安全组规则对象。
description	String	否	用户描述。
direction	String	是	安全组规则作用的方向，ingress或egress。
ethertype	String	否	匹配的以太网协议类型，必需是IPv4或IPv6。
port_range_max	integer	否	匹配的协议端口号最大值,如果协议是ICMP，则表示ICMP code。
port_range_min	integer	否	匹配的协议端口号最小值,如果协议是ICMP，则表示ICMP code。
protocol	String	否	匹配的IP协议类型，比如ICMP type。
remote_ip_prefix	String	否	匹配的远端ip前缀。
remote_group_id	String	否	匹配的远端安全组ID，可以指定remote_group_id或者remote_ip_prefix。
security_group_id	String	是	关联的安全组ID。
tenant_id	String	否	所属租户ID。

请求示例

示例：创建安全组

POST /v2.0/security-group-rules
{
  "security_group_rule": {
    "direction": "ingress",
    "ethertype": "IPv4",
    "port_range_max": "88",
    "port_range_min": "22",
    "protocol": "tcp",
    "remote_ip_prefix": "0.0.0.0/24",
    "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963"
  }
}

响应消息

参数	参数类型	描述
security-group-rule	object	安全组规则。
created_at	String	安全组规则的创建时间 (UTC ISO8601格式)。
description	String	用户描述。
direction	String	安全组规则作用的方向，ingress或egress。
ethertype	String	匹配的以太网协议，必需是IPv4或IPv6。
id	String	安全组规则的ID。
project_id	String	安全组规则所属的project id。
protocol	String	匹配的IP协议类型，比如ICMP type。
port_range_max	integer	匹配的协议端口号最大值,如果协议是ICMP，则表示ICMP code。
port_range_min	integer	匹配的协议端口号最小值,如果协议是ICMP，则表示ICMP code。
remote_ip_prefix	String	匹配的远端ip前缀。
remote_group_id	String	匹配的远端安全组的ID，可以指定remote_group_id或者remote_ip_prefix。
revision_number	integer	安全组规则的版本号。
security_group_id	String	关联的安全组ID。
tenant_id	String	安全组规则所属的tenant id。
updated_at	String	安全组规则最近更新的时间(UTC ISO8601格式)。

响应示例

{
  "security_group_rule": {
    "created_at": "2021-02-25T06:19:33Z",
    "description": "",
    "direction": "ingress",
    "ethertype": "IPv4",
    "id": "5dc48c92-e097-4aa4-ae9b-88550dd0170d",
    "port_range_max": 88,
    "port_range_min": 22,
    "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
    "protocol": "tcp",
    "remote_group_id": null,
    "remote_ip_prefix": "0.0.0.0/24",
    "revision_number": 1,
    "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
    "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
    "updated_at": "2021-02-25T06:19:33Z"
  }
}

正常响应代码

201

错误码

400，401，403，404，409，413

显示安全组规则详情

功能介绍

显示网络安全组规则详情。

URI

GET /v2.0/security-group-rules/{security-group-rule-id}

参数	是否必选	描述
security-group-rule-id	是	安全组规则ID

请求消息

无

请求示例

示例：显示安全组规则
GET /v2.0/security-group-rules/ 5dc48c92-e097-4aa4-ae9b-88550dd0170d

响应消息

参数	参数类型	描述
security-group-rule	object	安全组规则对象。
created_at	String	安全组规则的创建时间 (UTC ISO8601 form)。
description	String	用户描述。
direction	String	安全组规则作用的方向，ingress或egress
ethertype	String	匹配的以太网协议，必需是IPv4或IPv6
id	String	安全组规则的ID。
project_id	String	安全组规则所属的project id。
protocol	String	匹配的IP协议类型，比如ICMP type。
port_range_max	integer	匹配的协议端口号最大值,如果协议是ICMP，则表示ICMP code。
port_range_min	integer	匹配的协议端口号最小值,如果协议是ICMP，则表示ICMP code。
remote_ip_prefix	String	匹配的远端ip前缀。
remote_group_id	String	匹配的远端安全组的ID，可以指定remote_group_id或者remote_ip_prefix。
revision_number	integer	安全组规则的版本号。
security_group_id	String	关联的安全组ID。
tenant_id	String	安全组规则所属的tenant id。
updated_at	String	安全组规则最近更新的时间(UTC ISO8601格式)。

响应示例

{
  "security_group_rule": {
    "created_at": "2021-02-25T06:19:33Z",
    "description": "",
    "direction": "ingress",
    "ethertype": "IPv4",
    "id": "5dc48c92-e097-4aa4-ae9b-88550dd0170d",
    "port_range_max": 88,
    "port_range_min": 22,
    "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
    "protocol": "tcp",
    "remote_group_id": null,
    "remote_ip_prefix": "0.0.0.0/24",
    "revision_number": 1,
    "security_group_id": "de80111e-4ddb-4b58-a295-0b32e9a4f963",
    "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
    "updated_at": "2021-02-25T06:19:33Z"
  }
} 

正常响应代码

200

错误码

400，401，403，404，409，413

删除安全组规则

功能介绍

删除指定网络安全组规则。

URI

DELETE /v2.0/security-group-rules/{security-group-rule-id}

参数	是否必选	描述
security-group-rule-id	是	安全组规则ID

请求消息

无

请求示例

示例：删除指定安全组规则
DELETE /v2.0/security-group-rules/ 5dc48c92-e097-4aa4-ae9b-88550dd0170d

响应消息

无

响应示例

无

正常响应代码

204

错误码

400，401，403，404，409，413