Update subnet#

指定したサブネットを更新します。

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/subnets/{subnet_id}

HTTPステータスコード#

正常時：200

エラー時：400, 401, 403, 404, 412

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

名前 In Type デフォルト値
/必須指定		 Description
subnet_id path string 必須 サブネットのID
name body string 任意 リソース名
enable_dhcp body boolean true
任意		 DHCPの有効／無効
dns_nameservers body array []
任意		 サブネット用DNSネームサーバの一覧
例： ["8.8.8.7", "8.8.8.8"]
指定したIPアドレスは昇順にソートされた状態で表示されます。最後に表示されているIPアドレスがプライマリDNSアドレスです。
allocation_pools body array 任意 割り当てプールの開始アドレスと終了アドレス
省略する場合は、CIDR内のすべてのIPアドレスが自動的に割り当てられます。(サブネットゲートウェイ用のIPアドレスを除きます)
host_routes body array 任意 サブネット用のホストルート情報
📒注: ロードバランサー (lbaas)を配備するサブネットのホストルートを更新する場合、更新後に作成されたロードバランサーにはこのホストルートの情報が反映されます。なお、ホストルートにデフォルトルートを設定しないでください。ロードバランサーと同一サブネット内にあるバックエンドの仮想サーバと通信できなくなります。また、更新前に作成されたロードバランサーに更新後のホストルートを反映することはできません。ロードバランサーを再作成してください。
destination body string 必須 宛先のCIDR
nexthop body string 必須 宛先に到達するために次に転送すべき隣接するIPアドレス
仮想ルータが接続しているサブネットに存在する必要があります。
gateway_ip body string 任意 ゲートウェイのIPアドレス
「null」の場合は、ゲートウェイが関連付けられていません。省略する場合は、CIDR内の任意のIPアドレスが割り当てられます。
description body string null
任意		 リソースの説明

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

名前 Type Description
subnet string サブネットのオブジェクト
id string サブネットのID
tenant_id string プロジェクトのID
project_id string プロジェクトのID
name string リソース名
enable_dhcp boolean DHCPの有効／無効
network_id string リソースが所属するネットワークのID
dns_nameservers array サブネット用DNSネームサーバの一覧
例： ["8.8.8.7", "8.8.8.8"]
指定したIPアドレスは昇順にソートされた状態で表示されます。最後に表示されているIPアドレスがプライマリDNSアドレスです。
allocation_pools array 割り当てプールの開始アドレスと終了アドレス
host_routes array サブネット用のホストルート情報
destination string 宛先のCIDR
nexthop string 宛先に到達するために次に転送すべき隣接するIPアドレス
仮想ルータが接続しているサブネットに存在する必要があります。
ip_version integer IPバージョン
4が表示されます。
gateway_ip string ゲートウェイのIPアドレス
「null」の場合は、ゲートウェイが関連付けられていません。
cidr string サブネットのCIDR
created_at string サブネットの作成日時
description string リソースの説明
ipv6_address_mode string IPv6のアドレスの割り当て方法
ipv6_ra_mode string IPv6パケットを転送するかどうかを決定する基準
revision_number integer リソースの改訂番号
segment_id string 関連付けられているセグメントのID
service_types array 関連付けられているサービスのタイプ
subnetpool_id string 関連付けられているサブネットプールのID
updated_at string サブネットの更新日時

リクエスト例#

{
    "subnet": {
        "name": "my_subnet"
    }
}

レスポンス例#

{
    "subnet": {
        "name": "my_subnet",
        "enable_dhcp": true,
        "network_id": "db193ab3-96e3-4cb3-8fc5-05f4296d0324",
        "revision_number": 1,
        "segment_id": null,
        "project_id": "26a7980765d0414dbc1fc1f88cdb7e6e",
        "tenant_id": "26a7980765d0414dbc1fc1f88cdb7e6e",
        "dns_nameservers": [],
        "service_types": [],
        "allocation_pools": [
            {
                "start": "10.0.0.2",
                "end": "10.0.0.254"
            }
        ],
        "host_routes": [],
        "ip_version": 4,
        "gateway_ip": "10.0.0.1",
        "cidr": "10.0.0.0/24",
        "id": "08eae331-0402-425a-923c-34f7cfe39c1b",
        "description": ""
    }
}