跳转到内容
搜索文档

管理账户

最后更新 查看 MarkdownAgent 设置

使用 Cloudflare 的每个客户或团队都应该有自己的账户。这可以确保适当的资源安全性和访问权限。每个账户都作为一个区域 (zones) 和其他资源的容器。根据您的需求,您甚至可以为单个客户或团队配置多个账户。

当您使用 Tenant API 创建账户时,您的 Cloudflare 用户从创建、后续管理直至最终删除都拥有该账户。

创建账户

使用 Cloudflare 的每个客户或团队都应该有自己的账户。这可以确保适当的资源安全性和访问权限。每个账户都作为一个区域 (zones) 和其他资源的容器。根据您的需求,您甚至可以为单个客户或团队配置多个账户。

当您使用 Tenant API 创建账户时,您的 Cloudflare 用户从创建、后续管理直至最终删除都拥有该账户。

若要使用仪表板在您的租户下创建账户:

  1. 登录到 Cloudflare 仪表板
  2. 前往 Tenants(租户) > Managed Accounts(托管账户)
  3. 选择 Create Account(创建账户)
  4. 输入 Account Name(账户名称)Account Description(账户描述)Tenant Unit(租户单元)
  5. 选择合适的账户订阅。
  6. 选择 Add Account(添加账户)

要使用 API 创建账户,请向 /accounts 端点发送 POST 请求,并包含以下值:

  • name 字符串

    • 在 Cloudflare 仪表板中显示的账户名称。
  • type 枚举

    • 有效值包括 standard(默认)和 enterprise。对于自服务客户,请使用 standard。对于 enterprise 客户,请使用 enterprise
  • unit 对象

    • 与租户单元 (tenant unit) 相关的信息。

    • id 字符串

      • (可选)创建此账户所在的单元的 ID。如果用户管理多个租户,则需要指定此项。单元 ID 即是您的租户详情中的 unit_tag

Know-Your-Customer(KYC,可选)

所有 KYC 参数均为文本字段,有 120 个字符的限制,除非租户强制执行,否则均为可选。

  • business_name 字符串

    • (可选)与此账户关联的业务名称。
  • business_address 字符串

    • (可选)与此账户关联的业务地址。
  • business_email 字符串

    • (可选)与此账户关联的业务电子邮件。
  • business_phone 字符串

    • (可选)与此账户关联的业务电话号码。
  • external_metadata 字符串

    • (可选)此账户的外部元数据。
Requestbash
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 以及以下响应体:

Responsejson
{
  "result": {
    "id": "2bab6ace8c72ed3f09b9eca6db1396bb",
    "name": "<ACCOUNT_NAME>",
    "type": "standard",
    "settings": {
      "enforce_twofactor": false
    }
  },
  "success": true,
  "errors": [],
  "messages": []
}

包含单元 ID (unit ID) 的请求:

Requestbash
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 的请求:

Requestbash
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@business.com",
  "business_address": "San Francisco",
  "business_phone": "1234567890",
  "external_metadata": "{'\''testKey'\'': '\''testValue'\''}",
  "unit": {
    "id": "1a2b3c4d5e6f7g8h"
  }
}'

查看账户

当您使用 Tenant API 创建账户时,您的 Cloudflare 用户从创建、后续管理直至最终删除都拥有该账户。

若要使用仪表板查看您的租户所拥有的任何账户:

  1. 登录到 Cloudflare 仪表板
  2. 前往 Tenants(租户) > Managed Accounts(托管账户)

要使用 API 获取租户拥有的任何账户,请向 /accounts 端点发送一个 GET 请求。

您将收到您创建的所有账户的列表,以及您的用户已经有权访问的任何账户。

Requestbash
curl https://api.cloudflare.com/client/v4/accounts \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"
Responsejson
{
	"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) 或其他资源。

Requestbash
curl --request DELETE \
https://api.cloudflare.com/client/v4/accounts/{account_id} \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"

请求成功将返回 ID 以确认该操作:

Responsejson
{
	"result": {
		"id": "1b16db169c9cb7853009857198fae1b9"
	},
	"success": true,
	"errors": [],
	"messages": []
}

这篇文档对您有帮助吗?