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

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

editFirewall

機能の処理概要

ファイアーウォールルールの編集

特定の仮想サーバーのネットワークインターフェースに設定されているファイアーウォールルールを編集します

リクエストパラメーター

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

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

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

対象のファイアーウォールルールに設定されている送信元アドレスを変更するために、変更後の新しいIPアドレスを指定します

  • このフィールドの値が空の場合は全てのIPアドレスに対して適用します
  • IPアドレスレンジで指定する場合は、IPアドレスをハイフンで繋ぎます
    (例: 192.168.1.1-192.168.1.10)
  • IPアドレスをCIDRで指定する場合は、スラッシュで区切ります
    (例: 192.168.1.1/24)
command コマンド

対象のファイアーウォールルールで実行するように設定されているコマンドを変更するために、変更後のコマンドを ACCEPT もしくは DROP で指定します
firewall_id ファイアーウォールID

対象のファイアーウォールルールに割り当てられているIDを指定します
ファイアーウォールルールIDは7.1. listNetworkInterfaces API で取得できます
7.1. listNetworkInterfaces APIのレスポンスオブジェクトのうち、idが該当します
network_interface_id ネットワークインターフェースID

対象のファイアーウォールルールを設定するネットワークインターフェースIDを指定します
ネットワークインターフェースIDは7.1. listNetworkInterfaces API で取得できます
7.1. listNetworkInterfaces APIのレスポンスオブジェクトのうち、idが該当します
port ポート

対象のファイアーウォールルールに設定されている送信先ポートを変更するために、変更後の新しい送信先ポートを指定します

  • ・ このパラメーターを指定しない、あるいは値が空の場合は全てのポートに対して適用します
  • ポートレンジで指定する場合は、ポート番号をコロンで繋ぎます
    (例: 1024:1028)
  • 連続しない複数のポートを指定する場合はカンマで区切ります
    (例: 80,443,21)
×
protocol プロトコル

対象のファイアーウォールルールに設定されているプロトコル種類を変更するために、変更後の新しいプロトコル種類を TCP もしくは UDP で指定します
×
network_interface_id ネットワークインターフェースID

ファイアーウォールルールの追加の対象になるネットワークインターフェースIDを指定します
ネットワークインターフェースIDは7.1. listNetworkInterfaces API で取得できます
7.1. listNetworkInterfaces APIのレスポンスオブジェクトのうち、idが該当します

レスポンスオブジェクト

指定したファイアーウォールルールの編集のリクエストに成功した場合は true を返します。
指定したファイアーウォールルールの編集のリクエストに失敗した場合は、内容に応じたエラーメッセージを返します。

リクエストサンプル

https://api.gmocloud.com/Cloud-Zone-ID/?Action=editFirewall&AccessKeyId=AccessKeyId&Version=1.0&Identifier=Identifier_of_VM&address =192.168.0.100%2F32&command=DROP&port=3&protocol=TCP&firewall_id=ID_of_Firewall-rule&Signature=Signature

レスポンスサンプル

true

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

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

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

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

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

お問い合わせ