SetFilteringRuleList

API情報

API種別 Action 対象 名称 実行
設定 SetFilteringRuleList FW/LB フィルタリングルール一括設定  

リクエストパラメータ

パラメータ 必須 意味
GpServiceCode 対象FW+LBオプションを含むgpサービスコード
GlServiceCode 対象FW+LBオプションのglサービスコード
Direction

設定するフィルタリングルールの通信方向

値: IN, OUT

IpVersion

設定するフィルタリングルールのIPバージョン

値: 4, 6

SourceIpAddress.# ※1 送信元IPアドレス/ネットマスク
DestinationIpAddress.# ※1 送信先IPアドレス/ネットマスク
DestinationProtocol.# ※1

送信先プロトコル

値: UDP, TCP

DestinationPort.# ※1 送信先ポート番号
Target.# ※1

動作

値: ACCEPT, DROP, REJECT

レスポンス

フィールド タイプ 意味
SetFilteringRuleListResponse.GlServiceCode Stinrg 対象FW+LBオプションのglサービスコード
SetFilteringRuleListResponse.Direction Stinrg

設定したフィルタリングルールの通信方向

値: IN, OUT

SetFilteringRuleListResponse.IpVersion Stinrg

設定したフィルタリングルールのIPバージョン

値: 4, 6

SetFilteringRuleListResponse.FilteringRuleList Array フィルタリングルールのリスト
SetFilteringRuleListResponse.FilteringRuleList.Source.IpAddress Stinrg 送信元IPアドレス/ネットマスク
SetFilteringRuleListResponse.FilteringRuleList.Destination.IpAddress Stinrg 送信先IPアドレス/ネットマスク
SetFilteringRuleListResponse.FilteringRuleList.Destination.Protocol Stinrg

送信先プロトコル

値: UDP, TCP

SetFilteringRuleListResponse.FilteringRuleList.Destination.Port Stinrg 送信先ポート番号
SetFilteringRuleListResponse.FilteringRuleList.Target Stinrg

動作

値: ACCEPT, DROP, REJECT

エラーコード

フィールド タイプ 意味
ErrorResponse.Errortype String

エラー種別

ErrorResponse.GlServiceCode Stinrg 対象FW+LBオプションのglサービスコード
ErrorResponse.Direction Stinrg

設定したフィルタリングルールの通信方向

値: IN, OUT

ErrorResponse.IpVersion Stinrg

設定したフィルタリングルールのIPバージョン

値: 4, 6

ErrorResponse.ErrorFilteringRuleList Array エラーとなったフィルタリングルールのリスト
ErrorResponse.ErrorFilteringRuleList.Source.IpAddress Stinrg 送信元IPアドレス/ネットマスク
ErrorResponse.ErrorFilteringRuleList.Destination.IpAddress Stinrg 送信先IPアドレス/ネットマスク
ErrorResponse.ErrorFilteringRuleList.Destination.Protocol Stinrg

送信先プロトコル

値: UDP, TCP

ErrorResponse.ErrorFilteringRuleList.Destination.Port Stinrg 送信先ポート番号
ErrorResponse.ErrorFilteringRuleList.Target Stinrg

動作

値: ACCEPT, DROP, REJECT

ErrorResponse.FilteringRuleList Array 現在有効なフィルタリングルールのリスト
ErrorResponse.FilteringRuleList.Source.IpAddress Stinrg 送信元IPアドレス/ネットマスク
ErrorResponse.FilteringRuleList.Destination.IpAddress Stinrg 送信先IPアドレス/ネットマスク
ErrorResponse.FilteringRuleList.Destination.Protocol Stinrg

送信先プロトコル

値: UDP, TCP

ErrorResponse.FilteringRuleList.Destination.Port Stinrg 送信先ポート番号
ErrorResponse.FilteringRuleList.Target Stinrg

動作

値: ACCEPT, DROP, REJECT

制限

サンプル

リクエスト

※実際には一行で現します
https://gp.api.iij.jp/json
    ?APIVersion=20130901
    &AccessKeyId=XXXXXXXXXXXXXXXXXXXX
    &Action=SetFilteringRuleList
    &DestinationIpAddress.1=203.0.113.10%2F32
    &DestinationIpAddress.2=203.0.113.10%2F32
    &DestinationPort.1=ANY
    &DestinationPort.2=80
    &DestinationProtocol.1=TCP
    &DestinationProtocol.2=TCP
    &Direction=IN
    &Expire=2013-09-01T10%3A10%3A30Z
    &GlServiceCode=gl########
    &GpServiceCode=gp########
    &IpVersion=4
    &SignatureMethod=HmacSHA256
    &SignatureVersion=2
    &SourceIpAddress.1=198.51.100.0%2F24
    &SourceIpAddress.2=198.51.100.0%2F28
    &Target.1=DROP
    &Target.2=ACCEPT
    &Signature=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

レスポンス (JSON)

Json
{
    "SetFilteringRuleListResponse": {
        "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
        "GlServiceCode": "gl########",
        "Direction": "IN",
        "IpVersion": "4",
        "FilteringRuleList": [
            {
                "Source": {
                    "IpAddress": "198.51.100.0/24"
                },
                "Destination": {
                    "IpAddress": "203.0.113.10/32",
                    "Protocol": "TCP",
                    "Port": "ANY"
                },
                "Target": "DROP"
            },
            {
                "Source": {
                    "IpAddress": "198.51.100.0/28"
                },
                "Destination": {
                    "IpAddress": "203.0.113.10/32",
                    "Protocol": "TCP",
                    "Port": "80"
                },
                "Target": "ACCEPT"
            }
        ]
    }
}

レスポンス (XML)

XML
<?xml version="1.0" encoding="UTF-8"?>
<SetFilteringRuleListResponse>
  <RequestId>xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx</RequestId>
  <GlServiceCode>gl########</GlServiceCode>
  <Direction>IN</Direction>
  <IpVersion>4</IpVersion>
  <FilteringRuleList>
    <FilteringRule>
      <Source>
        <IpAddress>198.51.100.0/24</IpAddress>
      </Source>
      <Destination>
        <IpAddress>203.0.113.10/32</IpAddress>
        <Protocol>TCP</Protocol>
        <Port>ANY</Port>
      </Destination>
      <Target>DROP</Target>
    </FilteringRule>
    <FilteringRule>
      <Source>
        <IpAddress>198.51.100.0/28</IpAddress>
      </Source>
      <Destination>
        <IpAddress>203.0.113.10/32</IpAddress>
        <Protocol>TCP</Protocol>
        <Port>80</Port>
      </Destination>
      <Target>ACCEPT</Target>
    </FilteringRule>
  </FilteringRuleList>
</SetFilteringRuleListResponse>