Create floating IP#

フローティングIPを作成します。また、ポート情報を指定した場合は、そのフローティングIPを内部ポートに関連付けます。

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/floatingips

HTTPステータスコード#

正常時：201

エラー時：400, 401, 404, 409

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

名前	In	Type	デフォルト値 /必須指定	Description
floatingip	body	object	必須	フローティングIPのオブジェクト
tenant_id	body	string	必須	プロジェクトのID
project_id	body	string	必須	プロジェクトのID
floating_network_id	body	string	必須	フローティングIPに関連付けられているネットワークのID
fixed_ip_address	body	string	任意	フローティングIPに関連付けられる固定IPアドレスポートに複数のIPアドレスが存在する場合に、割り当てたいIPアドレスを指定します。指定しない場合は、最低のIPアドレスが選択されます。
port_id	body	string	任意	フローティングIPに関連付けられているポートのID フローティングIP作成時に固定IPに関連付けたい場合に指定します。 ※仮想ルータにはグローバルIPアドレスを指定できません。
description	body	string	null 任意	リソースの説明
dns_domain	body	string	任意	有効なDNSのドメイン
dns_name	body	string	任意	有効なDNSネーム

レスポンスボディ（正常系）の説明#

名前	Type	Description
floatingip	object	フローティングIPのオブジェクト
router_id	string	仮想ルータのID
status	string	フローティングIPのステータス「ACTIVE」、「DOWN」、「ERROR」のどれかが表示されます。
description	string	リソースの説明
dns_domain	string	有効なDNSのドメイン
dns_name	string	有効なDNSネーム
tenant_id	string	プロジェクトのID
created_at	string	リソースの作成日時(UTC ISO8601形式)
updated_at	string	リソースの最終更新日(UTC ISO8601形式)
revision_number	integer	リソースの改訂番号
project_id	string	プロジェクトのID
floating_network_id	string	フローティングIPに関連付けられているネットワークのID
fixed_ip_address	string	フローティングIPに関連付けられている固定IPアドレスID
floating_ip_address	string	フローティングIPアドレス
port_id	string	フローティングIPに関連付けられているポートのID
id	string	フローティングIPのID

リクエスト例#

{
    "floatingip": {
        "floating_network_id": "376da547-b977-4cfe-9cba-275c80debf57",
        "port_id": "ce705c24-c1ef-408a-bda3-7bbd946164ab",
        "fixed_ip_address": "10.0.0.3",
        "description": "floating ip for testing",
        "dns_domain": "my-domain.org.",
        "dns_name": "myfip"
    }
}

レスポンス例#

{
    "floatingip": {
        "fixed_ip_address": "10.0.0.3",
        "floating_ip_address": "172.24.4.228",
        "floating_network_id": "376da547-b977-4cfe-9cba-275c80debf57",
        "id": "2f245a7b-796b-4f26-9cf9-9e82d248fda7",
        "port_id": "ce705c24-c1ef-408a-bda3-7bbd946164ab",
        "router_id": "d23abc8d-2991-4a55-ba98-2aaea84cc72f",
        "status": "ACTIVE",
        "project_id": "4969c491a3c74ee4af974e6d800c62de",
        "tenant_id": "4969c491a3c74ee4af974e6d800c62de",
        "description": "floating ip for testing",
        "dns_domain": "my-domain.org.",
        "dns_name": "myfip",
        "created_at": "2016-12-21T01:36:04Z",
        "updated_at": "2016-12-21T01:36:04Z",
        "revision_number": 1
    }
}