最初の Cloudflare アカウントを作成するには:
- Sign up ページ ↗ を開きます。
- Email と Password を入力します。
- Create Account を選択します。
アカウントを作成すると、Cloudflare はそのアドレスへメールを自動送信し、メールアドレスを確認 します。
既存ユーザーは、dashboard または API で追加の Free アカウントを作成できます。
Free アカウントの作成には、次の要件があります。
- Cloudflare ユーザーがアクティブで、作成から少なくとも 7 日経過していること。
- 既存アカウントで Super Administrator ロールを持っていること。
- 追加の Free アカウントは最大 5 件まで作成できます。
-
Cloudflare dashboard ↗ にログインし、Accounts を開きます。
Accounts を開く ↗ -
Create Account を選択します。
-
アカウント名を入力します。
-
Create Account を選択します。
ユーザー所有の API トークンまたは OAuth アクセストークンを使います。アカウント所有の API トークンではアカウントを作成できません。
ユーザー所有の API トークンには User Details Read 権限が必要です。OAuth アクセストークンには user-details.read スコープが必要です。
standalone フィールドを true にし、unit は省略します。すべての Free アカウント作成リクエストには、有効な Idempotency-Key ヘッダーがちょうど 1 つ必要です。同じリクエストを再試行するときは、同じキーを再利用します。
ユーザー所有の API トークンを CLOUDFLARE_API_TOKEN に設定します。このアカウント作成リクエスト用の一意の値を IDEMPOTENCY_KEY に設定します。
curl "https://api.cloudflare.com/client/v4/accounts" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data '{"name":"Example account","type":"standard","standalone":true}'OAuth アクセストークンを CLOUDFLARE_OAUTH_TOKEN に設定します。このアカウント作成リクエスト用の一意の値を IDEMPOTENCY_KEY に設定します。
curl "https://api.cloudflare.com/client/v4/accounts" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_OAUTH_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data '{"name":"Example account","type":"standard","standalone":true}'完全なリクエストスキーマは Create Account を参照してください。
エラーメッセージを使って、よくあるアカウント作成の失敗を解決します。
| エラー | 対処 |
|---|---|
| ユーザーの作成から 7 日未満です。 | ユーザーが少なくとも 7 日経過するまで待ちます。 |
| Super Administrator ではありません。 | 既存アカウントで Super Administrator ロールを持っていることを確認します。 |
| アカウント作成の上限に達しました。 | 既存アカウントを使うか、アカウントチームへ連絡します。 |
| アカウント作成が一時的に利用できません。 | 同じ冪等キーで、あとからリクエストを再試行します。 |
| 冪等キーが別のリクエストに使われました。 | 新しいリクエストには新しいキーを使います。元のキーは、同一内容の再試行にだけ再利用します。 |
| ユーザーが停止されています。 | Cloudflare Support へ連絡します。 |
アカウント名のデフォルトは <<YOUR_EMAIL_ADDRESS>>'s Account です。
用途を明確にするため、または複数アカウントと対応づけるために、このアカウント名をカスタマイズできます。
アカウント名を変更するには:
-
Cloudflare dashboard で Configurations ページを開きます。
Configurations を開く ↗ -
Account Name で Change Name を選択します。
-
新しいアカウント名を入力します。
-
Save を選択します。
チームまたはビジネス向けのアカウントを作成する場合、Email には cloudflare@example.com のようなメールエイリアスまたは配布リストを使うことをおすすめします。
このメールアドレスは、Cloudflare の請求、利用状況の通知、アカウント復旧の主な連絡先になります。
アカウントとドメインを保護する方法の詳細な一覧は、アカウントとドメイン管理の推奨事項 を参照してください。
アカウントをセットアップ したあと、Cloudflare とのやり取りにはいくつかの方法があります。
コードなしで作業したい場合は、Cloudflare dashboard ↗ でアカウントとドメイン設定を管理できます。
プログラムから Cloudflare とやり取りしたい場合は、次の方法を使えます。
| リソース | ドキュメント | 説明 |
|---|---|---|
| Cloudflare API | API ドキュメント | HTTPS リクエストと JSON 応答に基づく RESTful API です。 |
| Terraform ↗ | Terraform ドキュメント | HashiCorp の Infrastructure as Code ツール Terraform で Cloudflare を構成します。 |
| cloudflare-go ↗ | README ↗ | Cloudflare API の公式 Go ライブラリです。 |
| cloudflare-typescript ↗ | README ↗ | Cloudflare API の公式 TypeScript ライブラリです。 |
| cloudflare-python ↗ | README ↗ | Cloudflare API の公式 Python ライブラリです。 |