コンテンツにスキップ

APIを介して設定する

Cloud Connectorルールは、Cloudflare APIを使用して設定できます。

必要な権限

Cloud Connectorルールを管理するためのAPIリクエストで使用されるAPIトークンは、少なくとも以下の権限を持っている必要があります。

  • Zone > Cloud Connector > Write

エンドポイント

完全なエンドポイントを取得するには、以下に示すCloud ConnectorエンドポイントをCloudflare APIのベースURLに追加します。

https://api.cloudflare.com/client/v4

{zone_id}引数は、ゾーンID（16進数の文字列）です。この値はCloudflareダッシュボードで見つけることができます。

以下の表は、利用可能な操作をまとめたものです。

操作動詞 + エンドポイント
Cloud Connectorルールの一覧GET zones/{zone_id}/cloud_connector/rules
Cloud Connectorルールの作成/更新/削除PUT /zones/{zone_id}/cloud_connector/rules

API呼び出しの例

Cloud Connectorルールの一覧

以下の例は、既存のCloud Connectorルールの一覧を返します。

Terminal window
curl https://api.cloudflare.com/client/v4/zones/{zone_id}/cloud_connector/rules \
--header "Authorization: Bearer <API_TOKEN>"
例のレスポンス
{
  "result": [
    {
      "id": "<RULE_1_ID>",
      "provider": "aws_s3",
      "expression": "http.request.uri.path wildcard \"/images/*\"",
      "description": "画像を含むS3バケットに接続",
      "enabled": true,
      "parameters": {
        "host": "examplebucketwithimages.s3.north-eu.amazonaws.com"
      }
    }
  ],
  "success": true,
  "errors": [],
  "messages": []
}

Cloud Connectorルールの作成/更新/削除

以下の例のリクエストは、すべての既存のCloud Connectorルールを単一のルールで置き換えます。

Terminal window
curl --request PUT \
"https://api.cloudflare.com/client/v4/zones/{zone_id}/cloud_connector/rules" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '[
  {
    "expression": "http.request.uri.path wildcard \"/images/*\"",
    "provider": "aws_s3",
    "description": "画像を含むS3バケットに接続",
    "parameters": {
      "host": "examplebucketwithimages.s3.north-eu.amazonaws.com"
    }
  }
]'

各ルールに必要なボディパラメータは、expression、provider、およびparameters.hostです。

providerの値は、次のいずれかでなければなりません：aws_s3、azure_storage、およびgcp_storage。

Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings