Create firewall
ファイアーウォールを作成します。
URI
/v2.0/fw/firewalls
HTTPメソッド
POST
リクエストパラメタ
キー | 説明 | 型 | 必須/省略可 |
---|---|---|---|
admin_state_up | ファイアーウォールの管理状態
"false"(停止中)の場合、ファイアーウォールはパケット転送を行わず、ファイアーウォールの内側にある仮想マシンに対する全送受信トラフィックを破棄します。 |
xsd:bool | Optional |
firewall_policy_id | このファイアーウォールに関連付けられているファイアーウォールポリシーID
ここで指定したファイアーウォールポリシーに含まれるルールを実装することになります。 |
csapi:uuid | Required |
router_id | このファイアーウォールが適用される仮想ルータのID 指定しなければ、プロジェクトのすべての仮想ルータにリソースが作成される。 |
xsd:string | Optional |
description | ファイアーウォールの説明 (255文字以内) | xsd:string | Optional |
name | ファイアーウォールの名前 (255文字以内)
一意である必要はありません。 |
xsd:string | Optional |
availability_zone | アベイラビリティゾーン名
指定しなかった場合、リソースはデフォルトのアベイラビリティゾーンに作成されます。 |
xsd:string | Optional |
リクエスト例
{
"firewall": {
"admin_state_up": true,
"firewall_policy_id": "c69933c1-b472-44f9-8226-30dc4ffd454c",
"router_id": "fe00194c-d73c-4b46-b94a-622bf28fc9e2",
"availability_zone": "AZ1"
}
}
レスポンスステータス
ステータスコード | 説明 |
---|---|
201 | Normal response codes |
itemNotFound (404) | Error response codes |
forbidden (403) | Error response codes |
Bad Request (400) | Error response codes |
Unauthorized (401) | Error response codes |
レスポンスボディ(正常系)
{
"firewall": {
"admin_state_up": true,
"description": "",
"firewall_policy_id": "c69933c1-b472-44f9-8226-30dc4ffd454c",
"id": "3b0ef8f4-82c7-44d4-a4fb-6177f9a21977",
"name": "",
"status": "PENDING_CREATE",
"tenant_id": "45977fa2dbd7482098dd68d0d8970117",
"router_id": "fe00194c-d73c-4b46-b94a-622bf28fc9e2",
"availability_zone": "AZ1"
}
}
レスポンスボディ(正常系)の説明
要素名 | 説明 |
---|---|
admin_state_up | ファイアーウォールの管理状態
"false"(停止中)の場合、ファイアーウォールはパケット転送を行わず、ファイアーウォールの内側にある仮想マシンに対する全送受信トラフィックを破棄します。 |
description | ファイアーウォールの説明 (1024文字以内) |
firewall_policy_id | このファイアーウォールに関連付けられているファイアーウォールポリシーID
ここで指定したファイアーウォールポリシーに含まれるルールを実装することになります。 |
id | ファイアーウォールID |
name | ファイアーウォール名 (255文字以内)
一意である必要はありません。 |
status | ファイアーウォールのステータス 値は次のいずれかです: ACTIVE, DOWN, ERROR, PENDING_CREATE, PENDING_UPDATE, or PENDING_DELETE. |
tenant_id | ファイアーウォールの所有者
自分のプロジェクト以外のプロジェクト識別子を指定できるユーザーは管理者だけです。 |
router_id | このファイアーウォールが適用されている仮想ルータのID |
availability_zone | アベイラビリティゾーン名 |