许多 Google Cloud 产品(如 Cloud Billing)都会向 与 Google Cloud 用户分享重要信息。默认情况下,这些通知将发送给具有某些 Identity and Access Management (IAM) 角色的成员。借助“重要联系人”,您可以通过提供自己的联系人列表来自定义接收通知的人员。
准备工作
Enable the Essential Contacts API.
所需的角色
要获得管理联系人所需的权限, 请让管理员授予您 的以下 IAM 角色 联系人被分配到的项目、文件夹或组织 :
-
要查看联系人,请执行以下操作:
重要联系人查看器 (
roles/essentialcontacts.viewer
) -
要查看、修改、删除和创建联系人,请执行以下操作:
重要联系人管理员 (
roles/essentialcontacts.admin
)
如需详细了解如何授予角色,请参阅管理访问权限。
这些预定义角色包含 管理联系人所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
要管理联系人,需要具备以下权限:
-
要查看联系人,请执行以下操作:
-
essentialcontacts.contacts.get
-
essentialcontacts.contacts.list
-
-
要修改、删除和创建联系人,请执行以下操作:
-
essentialcontacts.contacts.create
-
essentialcontacts.contacts.delete
-
essentialcontcts.contacts.update
-
通知类别
您可以将联系人分配给多个通知类别。如果您没有向类别添加联系人,则该类别中的通知会发送到根据您的成员的 IAM 角色选择的后备联系人。建议添加自定义联系人,而不要依赖于后备联系人,从而帮助确保合适的人员能够收到您的项目、文件夹或组织的通知。
您可以将个人和群组添加为联系人。为降低人员变动造成的影响,我们建议将群组添加为联系人,然后管理这些群组的成员资格,以确定哪些人会收到通知。这种做法有助于确保通知始终发送给在职员工。
查看下表以了解通知类别、后备联系人和推荐的联系人。如果您未向给定类别分配联系人,则通知将发送给后备联系人。
类别 | 说明 | 示例 | 后备联系人 | 推荐的联系人 |
---|---|---|---|---|
全部 | 来自所有其他类别的所有通知 | 不适用 | 不适用 | 负责路由或记录可能存在的大量通知的人员或自动化系统 |
结算 | 结算和付款通知 | 价格更新、错误和赠金 | Billing Account Administrator (roles/billing.admin ) |
财务部门员工和负责管理您与 Google 之间财务关系的人员,包括管理预算、规划以及与 Google Cloud 使用相关的账号的人员 |
法律 | 法规遵从通知 | 强制措施、法规遵从、政府通知 | Billing Account Administrator (roles/billing.admin ) |
法律顾问、合规性管理人员、政府关系专家以及其他相关专业人员 |
产品最新动态 | 对 Google 产品的更改 | 新版本、产品条款更新和弃用情况 | Project Owner (roles/owner ) |
能够通过及时了解 Google 产品和服务的变化而从中受益的产品经理、架构师和工程师。 |
安全 | 安全性/隐私权问题通知 | 漏洞、数据突发事件和攻击 | Organization Administrator (roles/resourcemanager.organizationAdmin ) |
IT 安全、运营安全以及负责保护公司和客户数据并确保业务连续性的其他人 |
暂停 | 与立即暂停账号和项目相关的通知 | Apigee 评估合规性、版权侵犯和虚拟货币挖矿 | Project Owner (roles/owner ) |
立即负责维护 IT 基础架构和业务应用启动和正常运行的人员 |
技术 | 技术事件和其他运维问题 | 记录配置错误、数据泄露防护更新和 Actions on Google 状态 | Project Owner (roles/owner ) |
IT 专业人员、可靠性工程师、管理员、值班人员名单,以及需要知道当前和即将发生的技术事件和问题以更好地管理 IT 资产并避免服务中断的其他人员 |
支持的语言
在“重要联系人”中,每位联系人都有首选语言设置。通知创建者可以在发送通知时参考此设置。
当您在 Google Cloud 控制台中添加联系人后,Google Cloud 控制台 根据联系人自动配置联系人的首选语言 创建者的 首选语言设置。 使用 API 添加联系人时,您需要使用语言代码手动配置联系人的首选语言。该语言代码可以引用“重要联系人”支持的任何语言。
分配联系人的最佳实践
您可以在项目、文件夹或单位级别分配联系人。
联系人通过 Google Cloud 资源层次结构继承。因此,如果您在组织级层添加联系人,他们会收到组织的通知以及组织中所有文件夹和项目的通知。同样,如果您在文件夹级层添加联系人,则他们将会收到文件夹的通知以及文件夹中所有文件夹和项目的通知。
您决定分配联系人的位置取决于您的组织结构。但是,我们通常建议根据联系人的通知类别在下列级层指定联系人:
推荐级层 | 通知类别 |
---|---|
组织级层 |
|
文件夹/项目级层 |
|
1 分配安全联系人的级别取决于组织的具体安全做法。例如,如果各个项目所有者负责其项目的安全性,则您可以在项目级层分配安全联系人。但是,如果组织范围的群组管理所有项目的安全性,则您可以在组织级层分配安全联系人。
2 技术类别联系人会收到大量电子邮件通知。在文件夹或项目级层分配这些联系人,使其能够处理传入通知流程。
限制联系人可以拥有的网域
如需限制新联系人可以拥有的电子邮件地址网域,请设置组织政策限制条件 constraints/essentialcontacts.allowedContactDomains
。现有联系人不受此限制条件影响。
如需了解如何设置组织政策限制条件,请参阅组织政策限制条件。
列出联系人
要列出项目、文件夹或组织中的所有联系人,请执行以下操作:
控制台
在 Google Cloud 控制台中,前往重要联系人页面。
确保您的项目、文件夹或组织的名称显示在该页面顶部的资源选择器中。资源选择器会显示您当前要管理哪个项目、文件夹或组织的联系人。
要按类别列出联系人,请选择类别。要按字母顺序列出联系人,请选择联系人。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
借助 Google Cloud CLI,您可以列出
资源,或列出资源的所有联系人和继承的联系人。
列出在资源中定义的联系人
如需查看已在特定项目、文件夹或组织中定义的联系人,请使用
gcloud essential-contacts list
命令:gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"
替换以下值:
RESOURCE_TYPE
:要为其列出联系人的资源类型。使用值project
、folder
或organization
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。
或者,如果您没有指定资源类型或 ID, gcloud CLI 会列出当前项目的联系人。
响应类似于以下示例:
--- email: [email protected] languageTag: en-US name: projects/my-projects/contacts/1 notificationCategorySubscriptions: - ALL --- email: [email protected] languageTag: en-US name: projects/my-projects/contacts/2 notificationCategorySubscriptions: - BILLING ---
列出联系人和继承的联系人
子资源(文件夹和项目)会从其祖先实体(组织和其他文件夹)继承联系人。如需列出资源的所有联系人和继承的联系人,请使用
gcloud essential-contacts compute
命令:gcloud essential-contacts compute --notification-categories="NOTIFICATION_CATEGORY" \ --RESOURCE_TYPE="RESOURCE_ID"
替换以下值:
在使用下面的请求数据之前,请先进行以下替换:
NOTIFICATION_CATEGORIES
:您要为其计算联系人的以英文逗号分隔的通知类别列表。列表 可以包含以下任意值:all
、billing
、legal
、product-updates
、security
、suspension
、technical
、 和notification-category-unspecified
。正在选择all
个列表的值 所有类别的联系人。RESOURCE_TYPE
:要为其计算联系人的资源类型。使用值project
、folder
或organization
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。
如果您不指定资源类型和 ID,则 gcloud CLI 列出当前项目的联系人。
响应列出了资源的所有联系人和继承的联系人:
--- email: [email protected] languageTag: en-US name: projects/my-projects/contacts/1 notificationCategorySubscriptions: - ALL --- email: [email protected] languageTag: en-US name: projects/my-projects/contacts/2 notificationCategorySubscriptions: - BILLING --- email: [email protected] languageTag: en-US name: organizations/my-organization/contacts/1 notificationCategorySubscriptions: - ALL ---
REST
您可以使用 Essential Contacts REST API 列出在资源中定义的联系人,也可以列出资源的所有联系人和继承的联系人。
列出在资源中定义的联系人
如需查看已在特定项目、文件夹或组织中定义的联系人,请使用 Essentials Contacts API 的 contacts.list
方法。
在使用下面的请求数据之前,请先进行以下替换:
RESOURCE_TYPE
:要为其列出联系人的资源类型。使用值projects
、folders
或organizations
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。PAGE_SIZE
:可选。响应中包含的联系人数量。默认值为 50,最大值为 100。如果联系人数量超过页面大小,则响应将包含可用于检索下一页结果的分页令牌。NEXT_PAGE_TOKEN
:可选。此方法之前的响应中返回的分页令牌。如果已指定,则联系人列表将从上一个响应结束的位置开始。
请求:
GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
根据您发送的请求,请展开以下选项之一:
curl(Linux、macOS 或 Cloud Shell)
执行以下命令:
curl -X GET \ -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \ https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
PowerShell (Windows)
执行以下命令:
$cred = gcloud auth application-default print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
发送请求后,您会收到类似于以下内容的 JSON 响应:
{ "contacts": [ { "name": "projects/my-projects/contacts/1", "email": "[email protected]", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en-US" }, { "name": "projects/my-projects/contacts/2", "email": "[email protected]", "notificationCategorySubscriptions": [ "BILLING" ], "languageTag": "en-US" } ] }
列出联系人和继承的联系人
子资源(文件夹和项目)会从其祖先实体(组织和其他文件夹)继承联系人。要列出资源的所有联系人和继承的联系人,请使用 Essential Contacts API 的 contacts.compute
方法。
在使用下面的请求数据之前,请先进行以下替换:
RESOURCE_TYPE
:要为其计算联系人的资源类型。使用值projects
、folders
或organizations
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。NOTIFICATION_CATEGORY
:您要计算联系人的通知类别。您可以重复此字段以列出多个通知类别的联系人。通过NOTIFICATION_CATEGORY
可以是下列任一项 值:ALL
、BILLING
、LEGAL
、PRODUCT_UPDATES
、SECURITY
SUSPENSION
、TECHNICAL
和NOTIFICATION_CATEGORY_UNSPECIFIED
。选择ALL
值可列出所有类别的联系人。PAGE_SIZE
:可选。响应中包含的联系人数量。默认值为 50,最大值为 100。如果联系人数量超过页面大小,则响应将包含可用于检索下一页结果的分页令牌。NEXT_PAGE_TOKEN
:可选。此方法之前的响应中返回的分页令牌。如果已指定,则联系人列表将从上一个响应结束的位置开始。
请求:
GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
根据您发送的请求,请展开以下选项之一:
curl(Linux、macOS 或 Cloud Shell)
执行以下命令:
curl -X GET \ -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \ https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
PowerShell (Windows)
执行以下命令:
$cred = gcloud auth application-default print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORIES&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
响应列出了资源的所有联系人和继承的联系人:
{ "contacts": [ { "name": "projects/my-projects/contacts/1", "email": "[email protected]", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en-US" }, { "name": "projects/my-projects/contacts/2", "email": "[email protected]", "notificationCategorySubscriptions": [ "BILLING" ], "languageTag": "en-US" }, { "name": "organizations/my-organization/contacts/1", "email": "[email protected]", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en-US" } ] }
管理个别重要联系人
您可以添加或移除联系人,也可以为他们指定通知类别 (在 Google Cloud 控制台的重要联系人页面上),或使用 REST API
添加联系人
如需添加联系人,请执行以下操作:
控制台
在 Google Cloud 控制台中,前往重要联系人页面。
确保您的项目、文件夹或组织的名称显示在该页面顶部的资源选择器中。资源选择器会显示您当前要管理哪个项目、文件夹或组织的联系人。
点击
添加联系人。在电子邮件和确认电子邮件字段中,输入联系人的电子邮件地址。
从通知类别下拉菜单中,选择您希望联系人接收相关信息的通知类别。如需查看通知类别和建议的联系人的列表,请参阅本页面上的识别联系人。
点击保存。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
要添加新的联系人,请使用 gcloud essential-contacts create 命令:
gcloud essential-contacts create --email="EMAIL" \ --notification-categories="NOTIFICATION_CATEGORIES" \ --language="LANGUAGE" \ --RESOURCE_TYPE="RESOURCE_ID"
替换以下值:
EMAIL
:您的联系人的电子邮件地址。您不能 更改此字段。NOTIFICATION_CATEGORIES
:以英文逗号分隔的 您希望联系人接收的通知类别 的通信。该列表可以包含以下任一值:all
、billing
、legal
、product-updates
、security
、suspension
、technical
、 技术突发事件 和notification-category-unspecified
。正在选择all
个列表的值 所有类别的联系人。有关每个类别的推荐联系人列表,请参阅 在此页面上识别联系人。
LANGUAGE
:联系人的语言代码 首选通知语言。您可以添加任何一种语言代码 支持的语言。RESOURCE_TYPE
:您要 创建联系人使用值project
、folder
或organization
。RESOURCE_ID
:您的 Google Cloud 项目。 组织或文件夹 ID。项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。
如果您不指定资源类型和 ID,则 gcloud CLI 在当前项目中创建一个联系人。
如果命令成功,则系统不会返回任何响应。
REST
要添加新联系人,请使用 Essentials Contacts API 的 contacts.create
方法。
在使用下面的请求数据之前,请先进行以下替换:
RESOURCE_TYPE
:要为其创建联系人的资源类型。使用值projects
、folders
或organizations
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。EMAIL
:您的联系人的电子邮件地址。创建联系人后,您便无法更改此字段。NOTIFICATION_CATEGORY_1
和NOTIFICATION_CATEGORY_2
:您希望联系人接收相关信息的通知类别。此值可以是以下任一值:ALL
、BILLING
、LEGAL
、PRODUCT_UPDATES
、SECURITY
、SUSPENSION
、TECHNICAL
。如需查看每个类别的建议联系人列表,请参阅本页中的识别联系人。
LANGUAGE
:联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。
请求:
POST essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts
请求正文:
{ "email": "EMAIL", "notificationCategorySubscriptions": [ "NOTIFICATION_CATEGORY_1", "NOTIFICATION_CATEGORY_2" ], "languageTag": "LANGUAGE" }
根据您发送的请求,请展开以下选项之一:
发送请求后,您会收到类似于以下内容的 JSON 响应:
{ "name": "projects/my-project/contacts/3", "email": "[email protected]", "notificationCategorySubscriptions": [ "SUSPENSION", "TECHNICAL" ], "languageTag": "en" }
更改联系人
如需更改将联系人分配到哪个类别,请执行以下操作:
控制台
在 Google Cloud 控制台中,前往重要联系人页面。
确保您的项目、文件夹或组织的名称显示在该页面顶部的资源选择器中。资源选择器会显示您当前要管理哪个项目、文件夹或组织的联系人。
在查看方式旁边,选择联系人。
点击您要更改其类别的联系人旁边的
。从通知类别下拉菜单中选择所需的通知类别,然后点击保存。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
要更新现有联系人,请使用 gcloud essential-contacts update 命令:
gcloud essential-contacts update CONTACT_ID \ --notification-categories="NOTIFICATION_CATEGORIES" \ --language="LANGUAGE" --RESOURCE_TYPE="RESOURCE_ID"
替换以下值:
CONTACT_ID
:您要访问的联系人的数字 ID 更新。查看项目、文件夹或中所有联系人的 ID 组织,请列出您的联系人。数字 ID 是contacts
。NOTIFICATION_CATEGORIES
:以英文逗号分隔的 您希望联系人接收的新通知类别 的通信。此列表将替换现有的通知列表 类别。该列表可以包含以下任一值:
all
、billing
、legal
、product-updates
、security
、suspension
、technical
、 技术突发事件 和notification-category-unspecified
。正在选择all
个列表的值 所有类别的联系人。有关每个类别的推荐联系人列表,请参阅 在此页面上识别联系人。
LANGUAGE
:联系人的语言代码 首选通知语言。您可以添加任何一种语言代码 支持的语言。RESOURCE_TYPE
:联系人所属的资源类型 。使用值project
、folder
或organization
。RESOURCE_ID
:Google Cloud 项目的 ID。 组织或文件夹中定义的联系人。项目 ID 为 字母数字字符串,如my-project
。文件夹和组织 ID 为 数字,如123456789012
。
如果您不指定资源类型和 ID,则 gcloud CLI 更新当前项目中具有指定 ID 的联系人。如果没有联系人 具有指定 ID 的实体,则 gcloud CLI 会返回错误。
如果命令成功,则系统不会返回任何响应。
REST
如需更改现有联系人的通知订阅或首选语言,请使用 Essential Contacts API 的 contacts.patch
方法。
在使用下面的请求数据之前,请先进行以下替换:
RESOURCE_TYPE
:要为其列出联系人的资源类型。使用值projects
、folders
或organizations
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。CONTACT_ID
:您要更新的联系人的数字 ID。如需查看项目、文件夹或组织中所有联系人的 ID,请列出联系人。数字 ID 是联系人名称中contacts
之后的所有内容。UPDATE_MASK
:可选。描述您更改了联系人的哪个字段的掩码。掩码的格式是以英文逗号分隔的完全限定字段名称列表,例如:notificationCategorySubscriptions,languageTag
。EMAIL
:您的联系人的电子邮件地址。此字段必须与您在请求中添加的 CONTACT_ID 关联的电子邮件地址一致。NOTIFICATION_CATEGORY_1
和NOTIFICATION_CATEGORY_2
:可选。您希望联系人接收相关信息的已更新通知类别。此值可以是以下任一值:ALL
、BILLING
、LEGAL
、PRODUCT_UPDATES
、SECURITY
、SUSPENSION
、TECHNICAL
。如需查看每个类别的建议联系人列表,请参阅本页中的识别联系人。
LANGUAGE
:联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。
请求:
PATCH essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"
请求正文:
{ "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID", "email": "EMAIL", "notificationCategorySubscriptions": [ "NOTIFICATION_CATEGORY_1", "NOTIFICATION_CATEGORY_2" ], "languageTag": "LANGUAGE" }
根据您发送的请求,请展开以下选项之一:
发送请求后,您会收到类似于以下内容的 JSON 响应:
{ "name": "projects/my-project/contacts/2", "email": "[email protected]", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en" }
删除联系人
如需删除联系人,请执行以下操作:
控制台
在 Google Cloud 控制台中,前往重要联系人页面。
确保您的项目、文件夹或组织的名称显示在该页面顶部的资源选择器中。资源选择器会显示您当前要管理哪个项目、文件夹或组织的联系人。
在查看方式旁边,选择联系人。
点击您要删除的联系人的电子邮件地址旁边的
。然后在对话框中确认您要删除联系人。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
要删除现有联系人,请使用 gcloud essential-contacts delete 命令:
gcloud essential-contacts delete CONTACT_ID \ --RESOURCE_TYPE="RESOURCE_ID"
替换以下值:
CONTACT_ID
:您要访问的联系人的数字 ID 删除。查看项目、文件夹或中所有联系人的 ID 组织,请列出您的联系人。数字 ID 是contacts
。RESOURCE_TYPE
:联系人所属的资源类型 。使用值project
、folder
或organization
。RESOURCE_ID
:Google Cloud 项目的 ID。 组织或文件夹中定义的联系人。项目 ID 为 字母数字字符串,如my-project
。文件夹和组织 ID 为 数字,如123456789012
。
如果您不指定资源类型和 ID,则 gcloud CLI 删除当前项目中具有指定 ID 的联系人。如果没有联系人 具有指定 ID 的实体,则 gcloud CLI 会返回错误。
如果命令成功,则系统不会返回任何响应。
REST
要删除联系人,请使用 Essentials Contacts API 的 contacts.delete
方法。
在使用下面的请求数据之前,请先进行以下替换:
RESOURCE_TYPE
:要为其列出联系人的资源类型。使用值projects
、folders
或organizations
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。CONTACT_ID
:联系人的数字 ID。要查看项目、文件夹或组织中所有联系人的 ID,请列出联系人。
请求:
DELETE essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID
根据您发送的请求,请展开以下选项之一:
如果请求成功,则响应正文将为空。
按类别管理联系人
在 Google Cloud 控制台中,您还可以按类别管理联系人: 前往重要联系人页面的类别标签页。
如需添加、更改或删除分配给单个类别的联系人,请执行以下操作:
在 Google Cloud 控制台中,前往重要联系人页面。
确保您的项目、文件夹或组织的名称显示在该页面顶部的资源选择器中。资源选择器会显示您当前要管理哪个项目、文件夹或组织的联系人。
在查看方式旁边,选择类别。
点击您要管理其联系人的类别所在的行中的
。管理分配给该类别的联系人:
- 如需添加新联系人,请点击添加联系人,然后按照本页中所述的相关步骤添加联系人。
如需更改将联系人分配到哪个类别,请点击要更改其类别的联系人旁边的
。然后,从通知类别下拉菜单中选择所需的通知类别,然后点击保存。要删除联系人,请点击该联系人的电子邮件地址旁边的
。
验证电子邮件传送
您可以向每个类别中的联系人发送测试电子邮件,以验证电子邮件账号是否能够收到来自 Google Cloud 的电子邮件。
如需向特定类别中的联系人发送测试电子邮件,请执行以下操作:
在 Google Cloud 控制台中,前往重要联系人页面。
确保您的项目、文件夹或组织的名称显示在该页面顶部的资源选择器中。资源选择器会显示您当前要管理其联系人的项目、文件夹或组织。
在查看方式旁边,选择类别。
点击您要向其联系人发送测试电子邮件的类别所在行中的
。选中您要向其发送电子邮件的联系人旁边的复选框。
点击发送。系统会向所选联系人发送测试电子邮件。
与每位联系人沟通,确保他们收到来自 [email protected] 的测试电子邮件。
使用 Terraform 管理联系人
您可以使用 Terraform 管理通知联系人。联系人在 Terraform 语言中具有以下格式:
resource "google_essential_contacts_contact" "contact" { parent = "RESOURCE_TYPE/RESOURCE_ID" email = "EMAIL" language_tag = "LANGUAGE" notification_category_subscriptions = NOTIFICATION_CATEGORIES }
创建联系人时,请替换以下值:
RESOURCE_TYPE
:要为其列出联系人的资源类型。使用值projects
、folders
或organizations
。RESOURCE_ID
:您的 Google Cloud 项目、组织或文件夹 ID。 项目 ID 是字母数字字符串,例如my-project
。文件夹和组织 ID 是数字,例如123456789012
。EMAIL
:您的联系人的电子邮件地址。创建联系人后,您便无法更改此字段。LANGUAGE
:可选。联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。NOTIFICATION_CATEGORIES
:您希望联系人接收其相关信息的一组通知类别。例如["BILLING", "LEGAL"]
。此数组可以包含以下任意值:
ALL
、BILLING
、LEGAL
、PRODUCT_UPDATES
、SECURITY
、SUSPENSION
、TECHNICAL
。如需查看每个类别的建议联系人列表,请参阅本页中的识别联系人。
如需添加、修改或移除联系人,请在 Terraform 配置文件中添加、修改或移除联系人资源。
如需了解详情,请参阅 Terraform 重要联系人文档。