すべてのプロダクト
Search
ドキュメントセンター

Cloud Firewall:DescribeUserIPSWhitelist

最終更新日:Jan 07, 2026

インターネット境界の侵入防止システム (IPS) ホワイトリストを照会します。

操作説明

QPS 制限

この API の 1 秒あたりのクエリ数 (QPS) 制限は、ユーザーごとに 1 秒あたり 10 回です。 この制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。 適切なレートでこの API を呼び出すことを推奨します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

SourceIp

string

任意

ビジターの送信元 IP アドレス。

47.100.XX.XX

Lang

string

任意

言語。

列挙値:

  • en :

    英語

  • zh :

    中国語 (デフォルト)

zh

Lang

string

任意

言語。

列挙値:

  • en :

    英語

  • zh :

    中国語 (デフォルト)

zh

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

04F788A5-6A47-5EA9-AC30-CA4DB98AD520

Whitelists

array<object>

インターネット境界上の IPS の IPv4 ホワイトリストのリスト。

object

インターネット境界上の IPS の IPv4 ホワイトリスト。

Direction

integer

インターネット境界上の IPv4 トラフィックの方向。

列挙値:

  • 1 :

    インバウンド

  • 2 :

    アウトバウンド

1

WhiteType

integer

インターネット境界上の IPv4 ホワイトリストが有効になる送信元または宛先のタイプ。

列挙値:

  • 1 :

    宛先 IP アドレスのホワイトリスト

  • 2 :

    送信元 IP アドレスのホワイトリスト

1

ListValue

string

インターネット境界上の IPv4 ホワイトリストの値。

  • ホワイトリストのタイプが custom input の場合:アドレス帳の名前。

  • ホワイトリストのタイプが address book reference の場合:IPv4 アドレス。

10.10.200.4/32,10.10.200.25/32

ListType

integer

インターネットの IPv4 ホワイトリスト内のアドレスのタイプ。

列挙値:

  • 0 :

    未設定

  • 1 :

    カスタム入力

  • 2 :

    アドレス帳の参照

1

WhiteListValue

array

インターネットの IPv4 ホワイトリストのリスト。

string

インターネットの IPv4 ホワイトリスト。

  • ホワイトリストのタイプが custom input の場合:アドレス帳の名前。

  • ホワイトリストのタイプが address book reference の場合:IPv4 アドレス。

10.10.200.4/32

Ipv6Whitelists

array<object>

インターネット境界上の IPS の IPv6 ホワイトリストのリスト。

object

インターネット境界上の IPS の IPv6 ホワイトリスト。

Direction

integer

インターネット境界上の IPv6 トラフィックの方向。

列挙値:

  • 1 :

    インバウンド

  • 2 :

    アウトバウンド

1

WhiteType

integer

インターネット境界上の IPv6 ホワイトリストが有効になる送信元または宛先のタイプ。

列挙値:

  • 1 :

    宛先 IP アドレスのホワイトリスト

  • 2 :

    送信元 IP アドレスのホワイトリスト

2

ListValue

string

インターネット境界上の IPv6 ホワイトリストの値。

  • ホワイトリストのタイプが custom input の場合:アドレス帳の名前。

  • ホワイトリストのタイプが address book reference の場合:IPv6 アドレス。

2408:400a:81a:7900:a77d:ea36:fcbf:de40/128

ListType

integer

インターネットの IPv6 ホワイトリスト内のアドレスのタイプ。

列挙値:

  • 0 :

    未設定

  • 1 :

    カスタム入力

  • 2 :

    アドレス帳の参照

0

WhiteListValue

array

インターネットの IPv6 ホワイトリストのリスト。

string

インターネットの IPv6 ホワイトリスト。

  • ホワイトリストのタイプが custom input の場合:アドレス帳の名前。

  • ホワイトリストのタイプが address book reference の場合:IPv6 アドレス。

2408:400a:81a:7900:a77d:ea36:fcbf:de40/128

成功レスポンス

JSONJSON

{
  "RequestId": "04F788A5-6A47-5EA9-AC30-CA4DB98AD520",
  "Whitelists": [
    {
      "Direction": 1,
      "WhiteType": 1,
      "ListValue": "10.10.200.4/32,10.10.200.25/32",
      "ListType": 1,
      "WhiteListValue": [
        "10.10.200.4/32"
      ]
    }
  ],
  "Ipv6Whitelists": [
    {
      "Direction": 1,
      "WhiteType": 2,
      "ListValue": "2408:400a:81a:7900:a77d:ea36:fcbf:de40/128",
      "ListType": 0,
      "WhiteListValue": [
        "2408:400a:81a:7900:a77d:ea36:fcbf:de40/128\n"
      ]
    }
  ]
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 ErrorParametersUid invalid aliUid.
400 ErrorDBSelect An error occurred while querying database.
400 ErrorMarshalJSON internal error: marshal json.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。