管理重要联系人

本页面介绍了可用于查看、添加、修改或移除重要联系人以及为其配置通知类别的方法。

如果您是组织管理员,可以使用 Trusted Cloud 控制台、Google Cloud CLI 或 REST API 管理您的必要联系人。遵循最佳实践来管理紧急情况联系人。

如果您是重要联系人,请让管理员向您发送测试电子邮件,以验证您是否能收到特定通知类别的电子邮件。如果您未收到通知,请验证以下事项:

  • 查看您的电子邮件“垃圾邮件”或“垃圾信息”文件夹。
  • 验证注册为联系人的电子邮件地址是否正确,以及是否可以接收外部电子邮件。
  • 确保您的联系信息已分配给相关的通知类别。

准备工作

如需接收通知,联系人必须能够接收 Google 发送的电子邮件。

如果您想使用 gcloud CLI 或 REST API 管理联系人,请启用 Essential Contacts API。如果您只想使用 Trusted Cloud 控制台管理联系人,则无需启用该 API。

Enable the API

所需的角色

如需获得管理联系人所需的权限,请让管理员向您授予联系人所分配到的项目、文件夹或组织的以下 IAM 角色:

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

这些预定义角色包含管理联系人所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

管理联系人需要以下权限:

  • 查看联系人:
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • 如需修改、删除和创建联系人,请执行以下操作:
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontacts.contacts.update

您也可以使用自定义角色或其他预定义角色来获取这些权限。

查看联系人

子资源(指文件夹和项目)会从其祖先实体(可以是组织和其他文件夹)继承联系人。查看子资源的联系人时,如果您拥有相应祖先实体的权限,还可以查看从该祖先实体继承的联系人。如需获得此功能,请获取祖先资源上的角色,该角色包含查看联系人所需的权限。当您查看组织或顶级文件夹中的联系人时,不会看到其子资源中的联系人。

如需查看项目、文件夹或组织中所有重要联系人的列表,请执行以下操作:

控制台

  1. 在 Trusted Cloud 控制台中,前往重要联系人页面。

    前往“重要联系人”页面

  2. 确保您的项目、文件夹或组织的名称显示在该页面的资源选择器中。您可以使用资源选择器选择要查看其重要联系人的项目、文件夹或组织。

  3. 查看方式旁边,您可以选择以下选项之一:

    • 如需按类别查看联系人列表,请选择类别
    • 如需按字母顺序列出联系人,请选择联系人

gcloud

  1. In the Trusted Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Trusted 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.

  2. 您可以使用 Google Cloud CLI 列出在资源中定义的联系人,也可以列出资源的所有联系人和继承的联系人。

    列出在资源中定义的联系人

    如需查看已在特定项目、文件夹或组织中定义的重要联系人,请使用 gcloud essential-contacts list 命令:

    gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"

    替换以下内容:

    • RESOURCE_TYPE:要从中列出联系人的资源类型。使用值 projectfolderorganization
    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012

    或者,如果您未指定资源类型或 ID,则 gcloud CLI 会列出当前项目的联系人。

    响应类似于以下示例:

    ---
    email: my-contact-1@example.com
    languageTag: en-US
    name: projects/my-projects/contacts/1
    notificationCategorySubscriptions:
    - ALL
    ---
    email: my-contact-2@example.com
    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_CATEGORY:您要查看联系人的通知类别的英文逗号分隔列表。列表可以包含以下任一值:

      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified

      如需了解详情,请参阅通知类别

    • RESOURCE_TYPE:您要查看联系人的资源类型。使用值 projectfolderorganization

    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012

    如果您未指定资源类型和 ID,则 gcloud CLI 会列出当前项目的联系人。

    响应类似于以下示例:

    ---
    email: my-contact-1@example.com
    languageTag: en-US
    name: projects/my-projects/contacts/1
    notificationCategorySubscriptions:
    - ALL
    ---
    email: my-contact-2@example.com
    languageTag: en-US
    name: projects/my-projects/contacts/2
    notificationCategorySubscriptions:
    - BILLING
    ---
    email: my-organization-contact@example.com
    languageTag: en-US
    name: organizations/my-organization/contacts/1
    notificationCategorySubscriptions:
    - ALL
    ---
    
  3. REST

    您可以使用 Essential Contacts REST API 列出在资源中定义的联系人,也可以列出资源的所有联系人和继承的联系人。

    列出在资源中定义的联系人

    如需查看已在特定项目、文件夹或组织中定义的联系人,请使用 Essential Contacts API 的 contacts.list 方法。

    Request 读取电子邮件的数据:

    GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
    

    替换以下内容:

    • RESOURCE_TYPE:要从中列出联系人的资源类型。使用值 projectsfoldersorganizations
    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012
    • PAGE_SIZE:可选。响应中包含的联系人数量。默认值为 50,最大值为 100。如果联系人数量超过页面大小,则响应将包含可用于检索下一页结果的分页令牌。
    • NEXT_PAGE_TOKEN:可选。此方法之前的响应中返回的分页令牌。如果已指定,则联系人列表将从上一个响应结束的位置开始。

    如需发送您的请求,请展开以下选项之一:

    curl(Linux、macOS 或 Cloud Shell)

    GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务账号私钥路径。然后,发出请求:

    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)

    GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务账号私钥路径。然后,发出请求:

    $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": "my-contact-1@example.com",
          "notificationCategorySubscriptions": [
            "ALL"
          ],
          "languageTag": "en-US"
        },
        {
          "name": "projects/my-projects/contacts/2",
          "email": "my-contact-2@example.com",
          "notificationCategorySubscriptions": [
            "BILLING"
          ],
          "languageTag": "en-US"
        }
      ]
    }
    

    列出联系人和继承的联系人

    如果您想列出资源的所有联系人及其从祖先实体继承的联系人,您必须拥有祖先实体的角色,该角色包含查看联系人的必需权限。然后,使用 Essential Contacts API 的 contacts.compute 方法。

    Request 读取电子邮件的数据:

    GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
    

    替换以下内容:

    • RESOURCE_TYPE:您要查看联系人的资源类型。使用值 projectsfoldersorganizations
    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012
    • NOTIFICATION_CATEGORY:您要查看联系人的通知类别。您可以重复此字段以列出多个通知类别的联系人。它可以采用以下任一值:

      • BILLING
      • LEGAL
      • PRODUCT_UPDATES
      • SECURITY
      • SUSPENSION
      • TECHNICAL
      • ALL
      • NOTIFICATION_CATEGORY_UNSPECIFIED

      如需了解详情,请参阅通知类别

    • PAGE_SIZE:可选。响应中包含的联系人数量。默认值为 50,最大值为 100。如果联系人数量超过页面大小,则响应将包含可用于检索下一页结果的分页令牌。

    • NEXT_PAGE_TOKEN:可选。此方法之前的响应中返回的分页令牌。如果已指定,则联系人列表将从上一个响应结束的位置开始。

    如需发送您的请求,请展开以下选项之一:

    curl(Linux、macOS 或 Cloud Shell)

    GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务账号私钥路径。然后,发出请求:

    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)

    GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为您的服务账号私钥路径。然后,发出请求:

    $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_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
    

    发送请求后,您会收到类似于以下示例的 JSON 响应:

    {
      "contacts": [
        {
          "name": "projects/my-projects/contacts/1",
          "email": "my-project-contact-1@example.com",
          "notificationCategorySubscriptions": [
            "ALL"
          ],
          "languageTag": "en-US"
        },
        {
          "name": "projects/my-projects/contacts/2",
          "email": "my-project-contact-2@example.com",
          "notificationCategorySubscriptions": [
            "BILLING"
          ],
          "languageTag": "en-US"
        },
        {
          "name": "organizations/my-organization/contacts/1",
          "email": "my-organization-contact@example.com",
          "notificationCategorySubscriptions": [
            "ALL"
          ],
          "languageTag": "en-US"
        }
      ]
    }
    

添加联系人

如需添加联系人,请执行以下操作:

控制台

  1. 在 Trusted Cloud 控制台中,前往重要联系人页面。

    前往“重要联系人”页面

  2. 确保您的项目、文件夹或组织的名称显示在该页面的资源选择器中。您可以使用资源选择器选择要从中添加重要联系人的项目、文件夹或组织。

  3. 点击 添加联系人

    一张屏幕截图,突出显示了用于在“重要联系人”页面中添加联系人的选项。

  4. 电子邮件确认电子邮件字段中,输入要添加的联系人的电子邮件地址。

  5. 通知类别下拉菜单中,选择您希望联系人接收相关通知的类别。

    如需查看通知类别和建议的联系人的列表,请参阅通知类别

  6. 点击保存

gcloud

  1. In the Trusted Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Trusted 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.

  2. 使用 gcloud essential-contacts create 命令添加新联系人:

    gcloud essential-contacts create --email="EMAIL" \
        --notification-categories="NOTIFICATION_CATEGORY" \
        --language="LANGUAGE" \
        --RESOURCE_TYPE="RESOURCE_ID"

    替换以下内容:

    • EMAIL:要添加的联系人的电子邮件地址。创建联系人后,您便无法更改此字段。
    • NOTIFICATION_CATEGORY:您希望联系人接收其相关通知的类别(以英文逗号分隔的列表)。该列表可以包含以下任意值:
      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      如需查看通知类别和建议的联系人的列表,请参阅通知类别
    • LANGUAGE:联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。
    • RESOURCE_TYPE:要为其创建联系人的资源类型。使用值 projectfolderorganization
    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012

    如果您未指定资源类型和 ID,则 gcloud CLI 会在当前项目中创建联系人。

    如果命令成功,您不会收到任何响应。

  3. REST

    要添加新联系人,请使用 Essentials Contacts API 的 contacts.create 方法。

    Request 读取电子邮件的数据:

    POST essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts
    

    请求正文

    {
      "email": "EMAIL",
      "notificationCategorySubscriptions": [
        "NOTIFICATION_CATEGORY_1",
        "NOTIFICATION_CATEGORY_2"
      ],
      "languageTag": "LANGUAGE"
    }
    

    替换以下内容:

    • RESOURCE_TYPE:要为其创建联系人的资源类型。使用值 projectsfoldersorganizations
    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012
    • EMAIL:您的联系人的电子邮件地址。创建联系人后,您便无法更改此字段。
    • NOTIFICATION_CATEGORY_1NOTIFICATION_CATEGORY_2:您希望联系人接收通知的类别。您可以添加更多此类值,以添加更多通知类别。该列表可以采用以下一个或多个值:

      • BILLING
      • LEGAL
      • PRODUCT_UPDATES
      • SECURITY
      • SUSPENSION
      • TECHNICAL
      • ALL

      如需查看通知类别和建议的联系人的列表,请参阅通知类别

    • LANGUAGE:联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。

    如需发送您的请求,请展开以下选项之一:

    发送请求后,您会收到类似于以下示例的 JSON 响应:

    {
      "name": "projects/my-project/contacts/3",
      "email": "my-new-contact@example.com",
      "notificationCategorySubscriptions": [
        "SUSPENSION",
        "TECHNICAL"
      ],
      "languageTag": "en"
    }
    

修改联系信息

您可以更改联系人的通知类别首选语言,但无法更改联系人的电子邮件地址。如果联系人的电子邮件地址发生变化,请添加具有更新后的电子邮件地址的新联系人,然后删除旧联系人

如需更改分配给联系人的通知类别或其首选语言,请执行以下操作:

控制台

  1. 在 Trusted Cloud 控制台中,前往重要联系人页面。

    前往“重要联系人”页面

  2. 确保您的项目、文件夹或组织的名称显示在该页面的资源选择器中。借助资源选择器,您可以选择要从中管理重要联系人的项目、文件夹或组织。

  3. 查看方式旁边,选择联系人

    屏幕截图:突出显示了“重要联系人”页面上的“联系”选项。

  4. 点击您要更改其通知类别的联系人旁边的修改图标

    一张屏幕截图,突出显示了用于在“重要联系人”页面中修改联系人的选项。

  5. 通知类别下拉菜单中选择要修改的通知类别,然后点击保存

当您通过 Trusted Cloud 控制台管理联系人时, Trusted Cloud 控制台会根据联系人创建者的首选语言设置自动配置联系人的首选语言。如需了解详情,请参阅支持的语言

gcloud

  1. In the Trusted Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Trusted 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.

  2. 使用 gcloud essential-contacts update 命令更新现有联系人:

    gcloud essential-contacts update CONTACT_ID \
        --notification-categories="NOTIFICATION_CATEGORY" \
        --language="LANGUAGE"
        --RESOURCE_TYPE="RESOURCE_ID"

    替换以下内容:

    • CONTACT_ID:您要更新的联系人的数字 ID。如需查看项目、文件夹或组织中所有联系人的 ID,请查看联系人。 数字 ID 是联系人名称中 contacts 之后的所有完整值。
    • NOTIFICATION_CATEGORY:您希望联系人接收通知的新类别的英文逗号分隔列表。此列表将替换现有的通知类别列表。

      该列表可以包含以下任何值:

      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      如需查看通知类别和建议的联系人的列表,请参阅通知类别
    • LANGUAGE:联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。
    • RESOURCE_TYPE:您要修改联系人信息的资源类型。使用值 projectfolderorganization
    • RESOURCE_ID:在其中定义了联系人的 Trusted Cloud项目、组织或文件夹的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012

    如果您未指定资源类型和 ID,则 gcloud CLI 会使用当前项目中的指定 ID 更新联系人。如果不存在具有指定 ID 的联系人,则 gcloud CLI 将返回错误。

    如果命令成功,您不会收到任何响应。

  3. REST

    如需更改现有联系人的通知类别或首选语言,请使用 Essential Contacts API 的 contacts.patch 方法。

    Request 读取电子邮件的数据:

    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"
    }
    

    替换以下内容:

    • RESOURCE_TYPE:要修改联系人信息的资源类型。使用值 projectsfoldersorganizations
    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012
    • CONTACT_ID:您要更新的联系人的数字 ID。如需查看项目、文件夹或组织中所有联系人的 ID,请查看联系人。数字 ID 是联系人名称中 contacts 之后的所有值。
    • UPDATE_MASK:可选。描述您要更改的联系人的哪个字段的掩码。掩码的格式是以英文逗号分隔的完全限定字段名称列表,例如:notificationCategorySubscriptions,languageTag
    • EMAIL:您的联系人的电子邮件地址。此字段必须与您在请求中添加的 CONTACT_ID 关联的电子邮件地址一致。
    • NOTIFICATION_CATEGORY_1NOTIFICATION_CATEGORY_2:可选。您希望联系人接收通知的已更新类别。您可以添加更多通知类别,只需添加更多这些值即可。该列表可使用以下一个或多个值:

      • BILLING
      • LEGAL
      • PRODUCT_UPDATES
      • SECURITY
      • SUSPENSION
      • TECHNICAL
      • ALL

      如需查看通知类别和建议的联系人的列表,请参阅通知类别

    • LANGUAGE:联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。

    如需发送您的请求,请展开以下选项之一:

    发送请求后,您会收到类似于以下示例的 JSON 响应:

    {
      "name": "projects/my-project/contacts/2",
      "email": "my-new-contact@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en"
    }

删除联系人

如需删除联系人,请执行以下操作:

控制台

  1. 在 Trusted Cloud 控制台中,前往重要联系人页面。

    前往“重要联系人”页面

  2. 确保您的项目、文件夹或组织的名称显示在该页面的资源选择器中。您可以使用资源选择器选择要从中删除重要联系人的项目、文件夹或组织。

  3. 查看方式旁边,选择联系人

    屏幕截图:突出显示了“重要联系人”页面上的“联系”选项。

  4. 点击您要删除的联系人的电子邮件地址旁边的删除图标 。然后在对话框中确认您要删除联系人。

    一张屏幕截图,突出显示了从“重要联系人”页面中删除联系人的选项。

gcloud

  1. In the Trusted Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Trusted 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.

  2. 使用 gcloud essential-contacts delete 命令删除现有联系人:

    gcloud essential-contacts delete CONTACT_ID \
        --RESOURCE_TYPE="RESOURCE_ID"

    替换以下内容:

    • CONTACT_ID:要删除的联系人的数字 ID。如需查看项目、文件夹或组织中所有联系人的 ID,请查看联系人。数字 ID 是联系人名称中 contacts 之后的所有完整值。
    • RESOURCE_TYPE:在其中定义了联系人的资源类型。使用值 projectfolderorganization
    • RESOURCE_ID:在其中定义了联系人的 Trusted Cloud项目、组织或文件夹的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012

    如果您未指定资源类型和 ID,则 gcloud CLI 会删除当前项目中具有指定 ID 的联系人。如果不存在具有指定 ID 的联系人,则 gcloud CLI 将返回错误。

    如果命令成功,您不会收到任何响应。

  3. REST

    要删除联系人,请使用 Essentials Contacts API 的 contacts.delete 方法。

    Request 读取电子邮件的数据:

    DELETE essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID
    

    替换以下内容:

    • RESOURCE_TYPE:在其中定义了联系人的资源类型。使用值 projectsfoldersorganizations
    • RESOURCE_ID:您的 Trusted Cloud 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012
    • CONTACT_ID:要删除的联系人的数字 ID。如需查看项目、文件夹或组织中所有联系人的 ID,请查看联系人。数字 ID 是联系人名称中 contacts 之后的所有值。

    如需发送您的请求,请展开以下选项之一:

    如果请求成功,则响应正文为空。

按类别管理联系人

在 Trusted Cloud 控制台中,您可以前往重要联系人页面上的类别标签页,按通知类别管理联系人。

如需添加、更改或删除分配给单个通知类别的联系人,请执行以下操作:

  1. 在 Trusted Cloud 控制台中,前往重要联系人页面。

    前往“重要联系人”页面

  2. 确保您的项目、文件夹或组织的名称显示在该页面的资源选择器中。借助资源选择器,您可以选择要从中管理重要联系人的项目、文件夹或组织。

  3. 查看方式旁边,选择类别

    一张屏幕截图,突出显示了“重要联系人”页面中用于选择类别的选项。

  4. 点击您要管理其联系人的类别所在的行中的修改图标

    一张屏幕截图,突出显示了用于在“重要联系人”页面中修改联系人的选项。

  5. 管理分配给相应通知类别的联系人:

    • 如需添加新联系人,请点击添加联系人,然后按照相关步骤添加联系人
    • 如需更改分配给联系人的通知类别,请点击要更改其类别的联系人旁边的修改图标 。然后,从通知类别下拉菜单中选择所需的通知类别,然后点击保存
    • 如需删除联系人,请点击相应联系人的电子邮件地址旁边的 删除图标

发送测试电子邮件以验证接收情况

您可以向每个类别中的联系人发送测试电子邮件,以验证电子邮件账号是否能够收到来自 Trusted Cloud by S3NS的电子邮件。每 24 小时针对每个类别和每项资源向每位联系人最多发送一封测试电子邮件。

如需向特定通知类别中的联系人发送测试电子邮件,请执行以下操作:

  1. 在 Trusted Cloud 控制台中,前往重要联系人页面。

    前往“重要联系人”页面

  2. 确保您的项目、文件夹或组织的名称显示在该页面的资源选择器中。借助资源选择器,您可以选择要从中管理重要联系人的项目、文件夹或组织。

  3. 查看方式旁边,选择类别

    一张屏幕截图,突出显示了“重要联系人”页面中用于选择类别的选项。

  4. 点击您要向其联系人发送测试电子邮件的通知类别所在行中的发送图标

  5. 选中您要向其发送电子邮件的联系人旁边的复选框。

  6. 点击发送。系统会向所选联系人发送测试电子邮件。

  7. 与每位联系人沟通,确保他们收到了来自 gcp-essential-contacts-noreply@google.com 的测试电子邮件。

设置高级配置和自动化

本部分介绍了用于进一步管理您的必要联系人的选项,包括限制联系人网域、将基础设施即代码 (IaC) 与 Terraform 搭配使用以实现自动化,以及创建自定义组织政策。

限制联系人可以拥有的网域

如需限制新联系人可以拥有的电子邮件地址网域,请设置组织政策限制条件 constraints/essentialcontacts.allowedContactDomains。现有联系人不受此限制条件影响。

如需了解如何设置组织政策限制条件,请参阅创建和管理组织政策

使用 Terraform 管理联系人

您可以使用 Terraform 管理重要联系人。联系人在 Terraform 语言中具有以下格式:

resource "google_essential_contacts_contact" "contact" {
  parent = "RESOURCE_TYPE/RESOURCE_ID"
  email = "EMAIL"
  language_tag = "LANGUAGE"
  notification_category_subscriptions = [NOTIFICATION_CATEGORY]
}

管理联系人时,请替换以下内容:

  • RESOURCE_TYPE:要管理联系人的资源类型。使用值 projectsfoldersorganizations
  • RESOURCE_ID:您的 Trusted Cloud by S3NS 项目、组织或文件夹 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012
  • EMAIL:您的联系人的电子邮件地址。创建联系人后,您便无法更改此字段。
  • LANGUAGE:可选。联系人首选通知语言的语言代码。您可以添加任何支持的语言的语言代码。
  • NOTIFICATION_CATEGORY:您希望联系人接收通知的类别数组,例如 ["BILLING", "LEGAL"]。此数组可以包含以下任意值:

    • BILLING
    • LEGAL
    • PRODUCT_UPDATES
    • SECURITY
    • SUSPENSION
    • TECHNICAL
    • ALL

    如需查看通知类别和建议的联系人的列表,请参阅通知类别

如需添加、修改或移除联系人,请在 Terraform 配置文件中添加、修改或移除联系人资源。如需了解详情,请参阅 Terraform 重要联系人文档

后续步骤