Create security group#

セキュリティグループを作成します。

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://networking.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://networking.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

POST

/v2.0/security-groups

HTTPステータスコード#

正常時:201

エラー時:400, 401, 409

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
security_group body object 必須 セキュリティグループオブジェクト
tenant_id body string 任意 プロジェクトID
project_id body string 任意 プロジェクトID
description body string null
任意
リソースの説明
stateful body boolean true
任意
stateful状態
- 仮想サーバの場合:「true」または「false」を指定します。
トランザクション性能を求める場合は、「false」を指定してください。具体的な指標は、機能説明書の「セキュリティグループ機能」を参照してください。
- ベアメタルサーバの場合:「false」を指定します。
ベアメタルのセキュリティグループでは、ポート範囲(開始ポート番号~終了ポート番号)を指定できません。
name body string 必須 リソース名

レスポンスボディ(正常系)の説明#

名前 Type Description
security_group object セキュリティグループオブジェクト
id string セキュリティグループID
tenant_id string プロジェクトID
project_id string プロジェクトID
revision_number integer リソースの改訂番号
name string リソース名
description string リソースの説明
security_group_rules array セキュリティグループルールのオブジェクト
stateful boolean セキュリティグループのstateful状態
created_at string セキュリティグループの生成時間
updated_at string セキュリティグループの更新時間

リクエスト例#

{
    "security_group": {
        "name": "new-webservers",
        "description": "security group for webservers",
        "stateful":false
    }
}

レスポンス例#

{
    "security_group": {
        "created_at": "2018-09-07T05:33:30Z",
        "description": "security group for webservers",
        "id": "cb4fd462-67c4-4ab4-a8a7-f43fac14d9ae",
        "name": "new-webservers",
        "project_id": "bc268f48c71f4684bb2f562adaad4313",
        "revision_number": 1,
        "security_group_rules": [
            {
                "created_at": "2018-09-07T05:33:30Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv4",
                "id": "b2487d22-95fd-46bf-ba02-65086e739f4e",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "bc268f48c71f4684bb2f562adaad4313",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "cb4fd462-67c4-4ab4-a8a7-f43fac14d9ae",
                "tenant_id": "bc268f48c71f4684bb2f562adaad4313",
                "updated_at": "2018-09-07T05:33:30Z"
            },
            {
                "created_at": "2018-09-07T05:33:30Z",
                "description": null,
                "direction": "egress",
                "ethertype": "IPv6",
                "id": "e12937ea-0d8d-492e-9422-ffe4adbbe939",
                "port_range_max": null,
                "port_range_min": null,
                "project_id": "bc268f48c71f4684bb2f562adaad4313",
                "protocol": null,
                "remote_group_id": null,
                "remote_ip_prefix": null,
                "revision_number": 1,
                "security_group_id": "cb4fd462-67c4-4ab4-a8a7-f43fac14d9ae",
                "tenant_id": "bc268f48c71f4684bb2f562adaad4313",
                "updated_at": "2018-09-07T05:33:30Z"
            }
        ],
        "stateful": false,
        "tenant_id": "bc268f48c71f4684bb2f562adaad4313",
        "updated_at": "2018-09-07T05:33:30Z"
    }
}