Update floating 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#

PUT

/v2.0/floatingips/{floatingip_id}

HTTPステータスコード#

正常時：200

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

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

名前	In	Type	デフォルト値 /必須指定	Description
floatingip	body	object	必須	フローティングIPのオブジェクト
floatingip_id	path	string	必須	フローティングIPのID
port_id	body	string	必須	フローティングIPに関連付けられているポートのID 固定IPに関連付ける場合は、指定します。関連付けを解除する場合は、「null」を指定します。 ※仮想ルータにはグローバルIPアドレスを指定できません。
fixed_ip_address	body	string	任意	フローティングIPに関連付けられている固定IPアドレス省略する場合かつポートに複数のIPアドレスが関連付けられている場合は、最低のIPアドレスが選択されます。
description	body	string	null 任意	リソースの説明

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

名前	Type	Description
floatingip	object	フローティングIPのオブジェクト
router_id	string	仮想ルータのID
status	string	フローティングIPのステータス「ACTIVE」、「DOWN」、「ERROR」のどれかが表示されます。
tenant_id	string	プロジェクトのID
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
created_at	string	リソースの作成日時(UTC ISO8601形式)
updated_at	string	リソースの最終更新日(UTC ISO8601形式)
revision_number	integer	リソースの改訂番号
description	string	リソースの説明
dns_domain	string	有効なDNSのドメイン
dns_name	string	有効なDNSネーム

リクエスト例#

{
    "floatingip": {
        "port_id": "fc861431-0e6c-4842-a0ed-e2363f9bc3a8"
    }
}

レスポンス例#

{
    "floatingip": {
        "created_at": "2016-12-21T10:55:50Z",
        "description": "floating ip for testing",
        "dns_domain": "my-domain.org.",
        "dns_name": "myfip",
        "fixed_ip_address": "10.0.0.4",
        "floating_ip_address": "172.24.4.228",
        "floating_network_id": "376da547-b977-4cfe-9cba-275c80debf57",
        "id": "2f245a7b-796b-4f26-9cf9-9e82d248fda7",
        "port_id": "fc861431-0e6c-4842-a0ed-e2363f9bc3a8",
        "project_id": "4969c491a3c74ee4af974e6d800c62de",
        "revision_number": 3,
        "router_id": "d23abc8d-2991-4a55-ba98-2aaea84cc72f",
        "status": "ACTIVE",
        "tenant_id": "4969c491a3c74ee4af974e6d800c62de",
        "updated_at": "2016-12-22T03:13:49Z"
    }
}

📒注:

HTTPステータスコード：500が返却された場合、リクエストパラメータ：descriptionに" "を指定して一度本APIを実行した後に、再試行してください。

既にアタッチ済のフローティングIPは、デタッチ実施後に再アタッチしてください。