ルールセットの削除

APIを使用して、ルールセットのすべてのバージョンを削除するか、特定のバージョンのルールセットを削除できます。

• ルールセットを削除する（すべてのバージョン）
• ルールセットバージョンを削除する

ルールセットを削除する

アカウントまたはゾーンレベルで既存のルールセットのすべてのバージョンを削除します。

次のAPIエンドポイントのいずれかを使用します：

操作	メソッド + エンドポイント
アカウントルールセットを削除する	DELETE /accounts/{account_id}/rulesets/{ruleset_id}
ゾーンルールセットを削除する	DELETE /zones/{zone_id}/rulesets/{ruleset_id}

削除操作が成功すると、APIメソッド呼び出しは204 No Content HTTPステータスコードを返します。

重要

他のルールで参照されているルールセットを削除することはできません。たとえば、executeアクションを持つルールで展開されているカスタムルールセットを削除することはできません。

ルールセットを削除するには、ルールセットを参照しているルールを更新または削除し、再試行してください。

例

以下の例リクエストは、既存のルールセットを削除します。

リクエスト

curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id}/rulesets/{ruleset_id} \
--header "Authorization: Bearer <API_TOKEN>"

ルールセットバージョンを削除する

特定のルールセットのバージョンを削除します。

次のAPIエンドポイントのいずれかを使用します：

操作	メソッド + エンドポイント
アカウントルールセットバージョンを削除する	DELETE /accounts/{account_id}/rulesets/{ruleset_id}/versions/{version_number}
ゾーンルールセットバージョンを削除する	DELETE /zones/{zone_id}/rulesets/{ruleset_id}/versions/{version_number}

削除操作が成功すると、メソッド呼び出しは204 No Content HTTPステータスコードを返します。

ルールセットの後の更新は、削除されたルールセットバージョンのバージョン番号を再利用しません。

重要

最新のルールセットバージョンであり、そのルールセットを展開しているexecuteアクションを持つルールがある場合、ルールセットバージョンを削除することはできません。

ルールセットバージョンを削除するには、ルールセットを参照しているルールを更新または削除し、再試行してください。

例

以下の例リクエストは、既存のルールセットのバージョンを削除します。

リクエスト

curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id}/rulesets/{ruleset_id}/versions/{version_number} \
--header "Authorization: Bearer <API_TOKEN>"