GMOクラウド Public APIリファレンス

サポートトップ » GMOクラウド Public トップ » APIリファレンス

listNetworkInterfaces

機能の処理概要

ネットワークインターフェース一覧の取得

指定した仮想サーバーに割り当てられたネットワークインターフェースの一覧を返します。
指定した仮想サーバーのIDが無効であるか、あるいは存在しない場合は、エラーを返します。

リクエストパラメーター

この機能の実行時には以下のパラメーターを指定してください。

パラメーター 説明 必須
Identifier VM識別子

仮想サーバーの識別子を指定します
仮想サーバーの識別子は4.1. listNodes APIで取得できます
4.1. listNodesのレスポンスオブジェクトのうち、identifier が該当します

レスポンスオブジェクト

以下の形式で応答します。

フィールド 説明
created_at ネットワークインターフェースの設定がされた日時を返します
日時は下記のフォーマットで表されます

YYYY-MM-DDThh:mm:ssZ
default_firewall_rule 当該ネットワークインターフェースのファイアーウォールの設定において指定されているデフォルトファイアーウォールルールを返します

ACCEPT
DROP
id 当該ネットワークインターフェースのIDを返します
identifier 当該ネットワークインターフェースの識別子を返します
label 当該ネットワークインターフェースに設定されているラベルを返します
mac_address 当該ネットワークインターフェースに割り当てられているMAC Address を返します
network_id 当該ネットワークインターフェースが接続するネットワークIDを返します
ネットワークIDは 8.1. listNetworks API で取得できます
8.1. listNetworks API のレスポンスオブジェクトのうち id が該当します
network_join_id 当該ネットワークインターフェースにハイパーバイザーから割り当てられたIDを返します
primary 当該ネットワークインターフェースがプライマリインターフェースとして設定されているかを返します

true : プライマリインターフェースとして設定されている状態
false : 上記以外の状態
rate_limit 当該ネットワークインターフェースで設定されているポートスピードを返します
単位はMbpsです
updated_at 当該ネットワークインターフェースの設定が最後にアップデートされた日時を返します
日時は下記のフォーマットで表されます

YYYY-MM-DDThh:mm:ssZ
usage 当該ネットワークインターフェースの設定が最初に作成された日時を返します
日時は下記のフォーマットで表されます

YYYY-MM-DDThh:mm:ssZ
virtual_machine_id 当該ネットワークインターフェースが接続されている仮想サーバーのIDを返します

リクエストサンプル

https://api.gmocloud.com/Cloud-Zone-ID/?Action=listNetworkInterfaces&AccessKeyId=AccessKeyId&Version=1.0&Identifier=Identifier_of_VM&Signature=Signature

レスポンスサンプル

{
  "Id_of_NetworkInterface ": {
    "label": "eth0",
    "created_at": "2012-07-19T12:32:33+09:00",
    "usage": null,
    "updated_at": "2012-07-25T20:26:06+09:00",
    "primary": true,
    "id": Id_of_NetworkInterface,
    "usage_month_rolled_at": null,
    "mac_address": "00:00:00:00:00:00",
    "default_firewall_rule": "DROP",
    "usage_last_reset_at": null,
    "rate_limit": 1,
    "identifier": "Identifier_of_NetworkInterface ",
    "network_join_id": Id_of_Network_Join,
    "virtual_machine_id": Id_of_VM,
    "network_id": Id_of_Network
  }
}

このガイドで問題は解決しましたか?

ご回答ありがとうございました。

引き続きGMOクラウド サポートサイトをご利用ください。

ご回答ありがとうございました。

GMOクラウド Public サポートまでお問い合わせください。

お問い合わせ