跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

管理抑制

最后更新 查看 MarkdownAgent 设置

管理 Email Service 不得联系的收件人。有关抑制范围、触发条件和过期规则,请参阅抑制列表。

每条抑制都有范围。account 抑制应用于账户中的每个发送域名及其子域名。sending_domain 抑制仅应用于一个发送域名。详细信息请参阅抑制范围。

查看抑制

  1. 在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Sending(电子邮件发送)。

    前往 Email Sending ↗
  2. 选择 Suppressions(抑制)。

表格会显示每个收件人、原因、范围、创建时间和过期时间。Never(永不) 表示该条目没有计划过期时间。

添加抑制

  1. 在 Suppressions(抑制) 中,输入收件人电子邮件地址。
  2. 选择过期预设、自定义的未来时间,或 Never(永不)。
  3. 在 Scope(范围) 中,选择 Account(账户) 或 Sending domain(发送域名)。对于 Sending domain(发送域名),选择你的某个发送域名或输入一个域名。
  4. 选择 Add(添加)。

在仪表板中创建的条目其原因为 manual。你无法更改现有条目的范围。要更改范围,请删除该条目并添加新条目。

导入抑制

你可以粘贴地址,或上传 .csv、.json 或 .txt 文件。支持的文件内容为:

  • .csv 或 .txt:每行一条条目,格式为 <EMAIL_ADDRESS>、<EMAIL_ADDRESS>,<EXPIRATION_TIMESTAMP>,或 <EMAIL_ADDRESS>,<EXPIRATION_TIMESTAMP>,<SCOPE>。使用 RFC 3339 ↗ 时间戳,并省略表头行。<SCOPE> 为 account 或一个发送域名。
  • .json:使用地址字符串数组或对象数组。每个对象必须包含 email,并可包含 RFC 3339 格式的 expires_at 时间戳和 scope。scope 可以是 account、一个发送域名,或范围对象,例如 { "type": "sending_domain", "value": "mail.myappexample.com" }。
  1. 在 Suppressions(抑制) 中,选择 Import(导入)。
  2. 上传支持的文件或粘贴地址。
  3. 在 Defaults(默认值) 中,为未自行设置的条目选择过期时间和范围。
  4. 选择 Import(导入)。较大的导入会按批次运行,请保持对话框打开,直到每一批都完成。

移除抑制

要移除可修改的条目,请为该收件人选择 Delete(删除)。只读条目不提供删除操作。

删除条目会允许后续投递尝试。在删除自动抑制之前,请确认该收件人应当接收邮件。

使用 API

账户 Email Sending 抑制管理 REST API 支持列出、添加、导入、更新和删除条目。请求需要具有 Email Sending: Edit 权限的 API 令牌。

API 客户端必须使用 read_only 判断条目是否可修改。不要从 reason 值推断可修改性。

API 响应中的每条条目都包含一个 scope 对象:

{ "type": "account" }
{ "type": "sending_domain", "value": "mail.myappexample.com" }

为单个发送域名添加抑制

要为单个发送域名添加条目,请在请求正文中包含 scope。如果省略 scope,API 会创建 account 条目。

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/email/sending/suppressions \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "email": "[email protected]",
    "scope": { "type": "sending_domain", "value": "mail.myappexample.com" }
  }'

API 会将 value 转为小写并移除尾随点。该值最多 253 个字符,可包含字母、数字、.、- 和 _。对于国际化域名,请使用其 ASCII(xn--)形式。其他值会返回 400,错误代码为 invalid_scope_value。

API 不会检查你的账户是否从该域名发送。针对你并未用来发送的域名的条目永远不会拦截邮件。

批量导入接受每个项目上相同的可选 scope。API 会移除具有相同地址和范围的重复项目。

按范围列出抑制

列表会先返回 sending_domain 条目,然后返回 account 条目。每个范围内的条目按最新优先排序。要只列出一个范围,请使用以下查询参数:

参数 说明
scope_type account 或 sending_domain。
scope_value 一个发送域名。需要 scope_type=sending_domain。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/email/sending/suppressions?scope_type=sending_domain&scope_value=mail.myappexample.com" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

没有 scope_type=sending_domain 的 scope_value 会返回 400,错误代码为 scope_value_requires_type。

要查找某个地址的所有抑制,请使用 email 参数。结果可以包含一条 account 抑制,以及每个发送域名各一条 sending_domain 抑制。

更改条目的范围

你无法更改现有条目的范围。包含 scope 的 PATCH 请求会返回 400,错误代码为 scope_immutable。要更改范围,请删除该条目并创建新条目。

限制

每个地址可以有一条有效的 account 抑制,以及每个发送域名各一条有效的 sending_domain 抑制。有关页面大小、导入和速率限制,请参阅抑制列表限制。

这篇文档对您有帮助吗?