使用 Cloudflare 的每个客户或团队都应该有自己的账户。这可以确保适当的资源安全性和访问权限。每个账户都作为一个区域 (zones) 和其他资源的容器。根据您的需求,您甚至可以为单个客户或团队配置多个账户。
当您使用 Tenant API 创建账户时,您的 Cloudflare 用户从创建、后续管理直至最终删除都拥有该账户。
使用 Cloudflare 的每个客户或团队都应该有自己的账户。这可以确保适当的资源安全性和访问权限。每个账户都作为一个区域 (zones) 和其他资源的容器。根据您的需求,您甚至可以为单个客户或团队配置多个账户。
当您使用 Tenant API 创建账户时,您的 Cloudflare 用户从创建、后续管理直至最终删除都拥有该账户。
若要使用仪表板在您的租户下创建账户:
- 登录到 Cloudflare 仪表板 ↗。
- 前往 Tenants(租户) > Managed Accounts(托管账户)。
- 选择 Create Account(创建账户)。
- 输入 Account Name(账户名称)、Account Description(账户描述) 和 Tenant Unit(租户单元)。
- 选择合适的账户订阅。
- 选择 Add Account(添加账户)。
要使用 API 创建账户,请向 /accounts 端点发送 POST 请求,并包含以下值:
-
name字符串- 在 Cloudflare 仪表板中显示的账户名称。
-
type枚举- 有效值包括
standard(默认)和enterprise。对于自服务客户,请使用standard。对于 enterprise 客户,请使用enterprise。
- 有效值包括
-
unit对象-
与租户单元 (tenant unit) 相关的信息。
-
id字符串- (可选)创建此账户所在的单元的 ID。如果用户管理多个租户,则需要指定此项。单元 ID 即是您的租户详情中的
unit_tag。
- (可选)创建此账户所在的单元的 ID。如果用户管理多个租户,则需要指定此项。单元 ID 即是您的租户详情中的
-
所有 KYC 参数均为文本字段,有 120 个字符的限制,除非租户强制执行,否则均为可选。
-
business_name字符串- (可选)与此账户关联的业务名称。
-
business_address字符串- (可选)与此账户关联的业务地址。
-
business_email字符串- (可选)与此账户关联的业务电子邮件。
-
business_phone字符串- (可选)与此账户关联的业务电话号码。
-
external_metadata字符串- (可选)此账户的外部元数据。
curl "https://api.cloudflare.com/client/v4/accounts" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
"name": "<ACCOUNT_NAME>",
"type": "standard"
}'请求成功将返回 HTTP 状态 200 以及以下响应体:
{
"result": {
"id": "2bab6ace8c72ed3f09b9eca6db1396bb",
"name": "<ACCOUNT_NAME>",
"type": "standard",
"settings": {
"enforce_twofactor": false
}
},
"success": true,
"errors": [],
"messages": []
}包含单元 ID (unit ID) 的请求:
curl "https://api.cloudflare.com/client/v4/accounts" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
"name": "<ACCOUNT_NAME>",
"type": "standard",
"unit": {
"id": "1a2b3c4d5e6f7g8h"
}
}'包含单元 ID 和 KYC 的请求:
curl "https://api.cloudflare.com/client/v4/accounts" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
"name": "<ACCOUNT_NAME>",
"type": "standard",
"business_name": "Cloudflare",
"business_email": "[email protected]",
"business_address": "San Francisco",
"business_phone": "1234567890",
"external_metadata": "{'\''testKey'\'': '\''testValue'\''}",
"unit": {
"id": "1a2b3c4d5e6f7g8h"
}
}'当您使用 Tenant API 创建账户时,您的 Cloudflare 用户从创建、后续管理直至最终删除都拥有该账户。
若要使用仪表板查看您的租户所拥有的任何账户:
- 登录到 Cloudflare 仪表板 ↗。
- 前往 Tenants(租户) > Managed Accounts(托管账户)。
要使用 API 获取租户拥有的任何账户,请向 /accounts 端点发送一个 GET 请求。
您将收到您创建的所有账户的列表,以及您的用户已经有权访问的任何账户。
curl https://api.cloudflare.com/client/v4/accounts \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"{
"result": [
{
"id": "a34bd6cc645a31486aa2ef71f1b9afb6",
"name": "My Personal Account",
"settings": {
"enforce_twofactor": false
}
},
{
"id": "1b16db169c9cb7853009857198fae1b9",
"name": "Created Account",
"settings": {
"enforce_twofactor": false
}
}
],
"result_info": {
"page": 1,
"per_page": 20,
"total_pages": 1,
"count": 2,
"total_count": 2
},
"success": true,
"errors": [],
"messages": []
}要更新账户,请向 /accounts/{account_id} 端点发送一个 PUT 请求。
要删除您创建的账户,请向 /accounts/{account_id} 端点发送一个 DELETE 请求。
账户删除是永久性的,且将删除该账户下的任何区域 (zones) 或其他资源。
curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id} \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"请求成功将返回 ID 以确认该操作:
{
"result": {
"id": "1b16db169c9cb7853009857198fae1b9"
},
"success": true,
"errors": [],
"messages": []
}