コンテンツにスキップ

リスト

リストを使用して、Cloudflare製品のルール式でアイテムのグループ(IPアドレスなど)を名前でまとめて参照できます。独自のカスタムリストを作成するか、Managed IP ListsのようにCloudflareが管理するリストを使用できます。

リストには以下の利点があります:

  • When creating a rule, using a list is easier and less error-prone than adding a long list of items such as IP addresses to a rule expression.
  • When updating a set of rules that target the same group of IP addresses (or hostnames), using an IP list (or a hostname list) is easier and less error prone than editing multiple rules.
  • Lists are easier to read and more informative, particularly when you use descriptive names for your lists.

When you update the content of a list, any rules that use the list are automatically updated, so you can make a single change to your list rather than modify rules individually.

Cloudflare stores your lists at the account level. You can use the same list in rules of different zones in your Cloudflare account.

サポートされているリスト

Cloudflareは以下のリストをサポートしています:

  • カスタムリスト: カスタムIPリスト、ホスト名リスト、ASNリストを含みます。
  • 管理リスト: Cloudflareが管理および更新するリスト、例えばManaged IP Listsなど。

詳細については各ページを参照してください。

リスト名

リストの名前は以下の要件を満たす必要があります:

  • 名前は小文字のアルファベット、数字、およびアンダースコア(_)文字のみを使用します。有効な名前はこの正規表現を満たします:^[a-z0-9_]+$
  • リスト名の最大長は50文字です。

リストの操作

リストの作成と編集

Cloudflareダッシュボードでリストを作成するか、Lists APIを使用してリストを作成できます。

リストを作成した後、リストからアイテムを追加および削除できますが、リスト名やタイプを変更することはできません。

式でのリストの使用

CloudflareダッシュボードとCloudflare APIの両方がリストをサポートしています:

  • Cloudflareダッシュボードから式でリストを使用するには、式でリストを使用を参照してください。
  • API式でリストを参照するには、ルール言語リファレンスの値:リストを参照してください。

リストアイテムの検索

ダッシュボードまたはAPI経由でリストアイテムを検索できます。

IPリストの場合、Cloudflareは検索クエリで始まるIPアドレス/範囲を返します(プレフィックスで検索)。現在、IPリストのCIDR範囲に含まれるIPアドレスを検索することはできません。

バルクリダイレクトリストの場合、CloudflareはソースURLまたはターゲットURLに検索クエリが含まれるリスト内のURLリダイレクトを返します(部分文字列で検索)。

利用可能性

リストの利用可能性は、リストの種類およびCloudflareプランとサブスクリプションによって異なります。

Free Pro Business Enterprise

Availability

Yes

Yes

Yes

Yes

Number of custom lists

1 10 10 10

Custom lists with IPs (IP lists)

Yes

Yes

Yes

Yes

Other custom lists (ASNs, hostnames)

No

No

No

Yes

Managed IP List: Cloudflare Open Proxies

No

No

No

Yes

All Managed IP Lists

No

No

No

With separate add-on

注意:

  • The number of available custom lists depends on the highest plan in your account. Any account with at least one paid plan will get the highest quota.

  • You can have a maximum number of 10,000 list items across all custom lists.

  • The Cloudflare Enterprise plan provides access to the Cloudflare Open Proxies Managed IP List. Other Managed IP Lists are available as part of Enterprise Security Bundles. For more information, contact your account team.

  • Customers on Enterprise plans may contact their account team if they need more custom lists or a larger maximum number of items across lists. For these customers, the maximum number of custom lists per data type is 40 lists.

  • For details on the availability of Bulk Redirect Lists, refer to the Rules documentation.


ユーザーロールの要件

以下のユーザーロールがリスト管理機能にアクセスできます:

  • スーパ管理者
  • 管理者
  • ファイアウォール

最後の注意事項

リストを削除できるのは、そのリストを参照するルール(有効または無効)がない場合のみです。

Cloudflare will apply the following rules when you add items to an existing list (either manually or via CSV file):

  • Do not remove any existing list items before updating/adding items.
  • Update items that were already in the list.
  • Add items that were not present in the list.

リストの全内容を置き換えるには、データを配列としてフォーマットし、すべてのリストアイテムを更新操作をLists APIで使用します。

CloudflareダッシュボードからリストをCSV形式でダウンロードすることはできません。リストの内容をダウンロードする必要がある場合は、リストアイテムを取得操作を使用してリストアイテムを取得してください。