PUT acls_setting

API情報

HTTPメソッドAPI名目的
PUTacls_settingACL設定情報変更
  • ACL情報を設定します。

個別パラメータ

URL
フィールドタイプ意味
UrlSchemeString

URLスキーム

値: http, https

HTTPリクエストボディ
  • Aclsに、[]をセットするとACLの設定がクリアされます。
フィールドタイプ意味
AclsArray

ACL設定

  • 最大100個
Acls.AclTypeString

設定: 許可又は拒否

値: allow, deny

Acls.AddressString

対象IPアドレス

値:

  • IPアドレス(IPv4, IPv6)
  • CIDR (例: 192.0.2.0/24)
  • 文字列 'all'

レスポンス

フィールドタイプ意味
Result.UrlSchemeString

URLスキーム

値: http, https

Result.AclsArray

ACL設定

  • 最大100個
Result.Acls.AclPriorityint

優先順位

Result.Acls.AclTypeString

設定: 許可又は拒否

値: allow, deny

Result.Acls.AddressString

対象IPアドレス

値:

  • IPアドレス(IPv4, IPv6)
  • CIDR (例:192.0.2.0/24)
  • 文字列 'all'

エラーコード

  • このAPIに関する個別エラーはありません。
  • 共通エラーコードはエラーレスポンスを参照してください。

制限

  • ACLの設定は最大で100までです。

サンプル 

 リクエスト

PUT /r/(APIVersion)/(ServiceCode)/(UrlScheme)/acls_setting.json
Host: cac.api.iij.jp
Content-Type: application/json
Date: Mon, 20 Jan 2014 12:34:56 GMT
x-iijapi-Expire: (Expire)
x-iijapi-SignatureMethod: (SignatureMethod)
x-iijapi-SignatureVersion: (SignatureVersion)
Authorization: IIJAPI (AccessKeyId):(Signature)

{
    "Acls": [
        {
            "AclType": "allow",
            "Address": "192.0.2.1"
        },
        { 
            "AclType": "deny",
            "Address": "fe80::a00:27ff:fe88:9e61"
        },
        {
            "AclType": "allow",
            "Address": "192.0.2.0/24"
        },
        {
            "AclType": "allow",
            "Address": "all"
        }
    ]
}

レスポンスボディ

{
    "Result": {
        "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
        "ServiceCode": "cac########",
        "UrlScheme": "http",
        "Acls": [
            {
                "AclPriority": 1,
                "AclType": "allow",
                "Address": "192.0.2.1"
            },
            {
                "AclPriority": 2,
                "AclType": "deny",
                "Address": "fe80::a00:27ff:fe88:9e61"
            },
            {
                "AclPriority": 3,
                "AclType": "allow",
                "Address": "192.0.2.0/24"
            },
            {
                "AclPriority": 4,
                "AclType": "allow",
                "Address": "all"
            }
        ]
    }
}