管理 Email Service 不得联系的收件人。有关抑制范围、触发条件和过期规则,请参阅抑制列表。
每条抑制都有范围。account 抑制应用于账户中的每个发送域名及其子域名。sending_domain 抑制仅应用于一个发送域名。详细信息请参阅抑制范围。
-
在 Cloudflare 仪表板中,前往 Compute(计算) > Email Service(电子邮件服务) > Email Sending(电子邮件发送)。
前往 Email Sending ↗ -
选择 Suppressions(抑制)。
表格会显示每个收件人、原因、范围、创建时间和过期时间。Never(永不) 表示该条目没有计划过期时间。
- 在 Suppressions(抑制) 中,输入收件人电子邮件地址。
- 选择过期预设、自定义的未来时间,或 Never(永不)。
- 在 Scope(范围) 中,选择 Account(账户) 或 Sending domain(发送域名)。对于 Sending domain(发送域名),选择你的某个发送域名或输入一个域名。
- 选择 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" }。
- 在 Suppressions(抑制) 中,选择 Import(导入)。
- 上传支持的文件或粘贴地址。
- 在 Defaults(默认值) 中,为未自行设置的条目选择过期时间和范围。
- 选择 Import(导入)。较大的导入会按批次运行,请保持对话框打开,直到每一批都完成。
要移除可修改的条目,请为该收件人选择 Delete(删除)。只读条目不提供删除操作。
删除条目会允许后续投递尝试。在删除自动抑制之前,请确认该收件人应当接收邮件。
账户 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 抑制。有关页面大小、导入和速率限制,请参阅抑制列表限制。