通知の連絡先の管理

Cloud Billing などの多くの Google Cloud サービスは、Google Cloud ユーザーと重要な情報を共有するために通知を送信します。デフォルトでは、これらの通知は特定の Identity and Access Management(IAM)のロールを持つメンバーに送信されます。重要な連絡先を使用する場合、独自の連絡先リストを指定することで、通知を受け取るユーザーをカスタマイズできます。

始める前に

Essential Contacts API を有効にします。

API を有効にする

必要な権限

重要な連絡先の使用に必要な権限は、実行する操作によって異なります。

連絡先の閲覧権限

連絡先を閲覧するには、次の権限を含むロールが必要です。

  • essentialcontacts.contacts.get
  • essentialcontacts.contacts.list

最小権限の原則に従ってこれらの権限を取得するには、管理者に重要な連絡先の閲覧者ロール(roles/essentialContacts.viewer)を付与するよう依頼してください。

あるいは、必要な権限を含む別のロールを管理者に付与してもらうこともできます。たとえば、カスタムロールや、許容範囲がより広い事前定義ロールなどです。

連絡先が割り当てられているプロジェクト、フォルダ、組織にこれらのロールを必ず付与してください。

連絡先を管理する権限

連絡先を編集、削除、作成するには、次の権限を含むロールが必要です。

  • essentialcontacts.contacts.get
  • essentialcontacts.contacts.list
  • essentialcontacts.contacts.create
  • essentialcontacts.contacts.delete
  • essentialcontacts.contacts.update

最小権限の原則に従ってこれらの権限を取得するには、管理者に重要な連絡先の管理者ロール(roles/essentialContacts.admin)を付与するよう依頼してください。

あるいは、必要な権限を含む別のロールを管理者に付与してもらうこともできます。たとえば、カスタムロールや、許容範囲がより広い事前定義ロールなどです。

連絡先が割り当てられているプロジェクト、フォルダ、組織にこれらのロールを必ず付与してください。

通知のカテゴリ

連絡先を割り当てることができる、複数の異なる通知カテゴリがあります。カテゴリに連絡先を追加しない場合、そのカテゴリの通知はメンバーの IAM ロールに基づいて選択される、デフォルトの連絡先に送信されます。適切な担当者がプロジェクト、フォルダ、組織への通知を受け取れるように、デフォルトの連絡先を使用せずに、カスタムの連絡先を追加することをおすすめします。

個人と Google グループの両方を連絡先として追加できます。人事異動の影響を減らすため、Google グループを連絡先として追加し、それらのグループのメンバーを管理して、通知を受け取る従業員を決定することをおすすめします。この方法によって、常にアクティブな従業員に通知が送られるようになります。

通知のカテゴリ、デフォルトの連絡先、推奨される連絡先については、次の表をご確認ください。この情報を使用して、各カテゴリの適切な連絡先を選択します。

カテゴリ 説明 デフォルトの連絡先 推奨される連絡先
すべて リソースに関連するすべての通知 なし 通知のルーティングやロギングを担当する従業員または自動システム
課金 請求とお支払いの通知、価格の改定、エラー、クレジット 請求先アカウント管理者(roles/billing.admin 財務部門の従業員と、Google Cloud の使用に関する予算、計画、会計の管理など、Google との財務関係を管理する従業員
法務 適用措置、法令遵守、行政通達 請求先アカウント管理者(roles/billing.admin 顧問弁護士、コンプライアンス管理者、政府関係のスペシャリスト、その他の関連する専門家
プロダクトの更新情報 新しいバージョン、プロダクトの利用条件の更新、サポートの終了 プロジェクト所有者(roles/owner Google のプロダクトおよびサービスの変更に関するタイムリーな情報を活用できるプロダクト マネージャー、アーキテクト、エンジニア
セキュリティ セキュリティ / プライバシーの問題、通知、脆弱性 組織管理者(roles/resourcemanager.organizationAdmin IT セキュリティ、運用上のセキュリティ、企業および顧客データの保護とビジネスの継続性の確保を担当するその他の従業員
停止 即時アカウント停止に関連する通知 プロジェクト所有者(roles/owner IT インフラストラクチャとビジネス アプリケーションの維持および稼働に早急に対応する従業員
技術 停止、エラー、バグなどの技術的な問題 プロジェクト所有者(roles/owner IT プロフェッショナル、信頼性エンジニア、管理者、オンコール リスト、現在および将来の技術的な問題や、IT アセットが正常に機能しない原因となる可能性があるイベントの把握が必要な他の従業員

サポートされている言語

Essential Contacts では、各連絡先に優先言語が設定されています。通知作成者は、通知の送信時にこの設定を参照できます。

Cloud Console で連絡先を追加すると、Cloud Console は連絡先作成者の優先言語設定に基づいて連絡先の設定言語を自動的に構成します。API を使用して連絡先を追加する場合は、言語コードを使用して連絡先の設定言語を手動で構成します。この言語コードは、重要な連絡先でサポートされているすべての言語を参照できます。

連絡先の割り当て先の決定

連絡先は、プロジェクト、フォルダ、または組織レベルで割り当てることができます。

連絡先は Google Cloud リソース階層から継承されます。その結果、組織レベルで連絡先を追加すると、その組織と、組織内のすべてのフォルダとプロジェクトへの通知を受け取ります。同様に、フォルダレベルで連絡先を追加すると、そのフォルダと、フォルダ内のすべてのフォルダとプロジェクトへの通知を受け取ります。

連絡先を割り当てる場所は、組織構造によって異なります。ただし通常は、通知カテゴリに基づいて、次のレベルで連絡先を割り当てることをおすすめします。

推奨レベル 通知のカテゴリ
組織レベル
  • 課金
  • 法務
  • セキュリティ1
フォルダ / プロジェクト レベル
  • すべて
  • プロダクトの更新情報
  • セキュリティ1
  • 停止
  • 技術

1 セキュリティの連絡先を割り当てるレベルは、組織固有のセキュリティ対策によって異なります。たとえば、個々のプロジェクト オーナーがそれぞれのプロジェクトのセキュリティを担当する場合は、プロジェクト レベルでセキュリティの連絡先を割り当てます。ただし、組織全体のグループがすべてのプロジェクトのセキュリティを管理している場合は、セキュリティの連絡先を組織レベルで割り当てます。

連絡先の一覧表示

プロジェクト、フォルダ、組織内のすべての連絡先を一覧表示するには、次のようにします。

Console

  1. Cloud Console で、[重要な連絡先] ページに移動します。

    [重要な連絡先] ページに移動

  2. プロジェクト、フォルダ、または組織の名前がページの上部にあるプロジェクト セレクタに表示されていることを確認します。プロジェクト セレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。

  3. 連絡先をカテゴリ別に一覧表示するには、[カテゴリ] を選択します。連絡先をアルファベット順に一覧表示するには、[連絡先] を選択します。

REST

連絡先の一覧表示

特定のプロジェクト、フォルダ、または組織に設定された連絡先を表示するには、Essential Contacts API の contacts.list メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projectsfolders、または organizations を使用します。
  • RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。
  • PAGE_SIZE: 省略可。レスポンスに含める連絡先の数。デフォルト値は 50、最大値は 100 です。連絡先の数がページサイズより大きい場合、レスポンスにページ設定トークンが含まれます。このトークンを使用して、結果の次のページを取得できます。
  • NEXT_PAGE_TOKEN: 省略可。以前のレスポンスでこのメソッドから返されたページ設定トークン。指定すると、前のレスポンスが終了した時点から連絡先のリストが開始されます。

リクエスト:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

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

連絡先と継承された連絡先の一覧表示

子リソース(フォルダとプロジェクト)は、祖先(組織や他のフォルダ)から連絡先を継承します。リソースのすべての連絡先と継承された連絡先を一覧表示するには、Essential Contacts API の contacts.compute メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • RESOURCE_TYPE: 連絡先を算定するリソースタイプ。値 projectsfolders、または organizations を使用します。
  • RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。
  • NOTIFICATION_CATEGORY: 連絡先を算定する通知のカテゴリ。このフィールドを繰り返し使用することで、複数の通知カテゴリの連絡先を一覧表示できます。NOTIFICATION_CATEGORY は、次のいずれかの値になります: ALLBILLINGLEGALPRODUCT_UPDATESSECURITYSUSPENSIONTECHNICALNOTIFICATION_CATEGORY_UNSPECIFIEDALL を指定すると、すべてのカテゴリの連絡先が一覧表示されます。
  • PAGE_SIZE: 省略可。レスポンスに含める連絡先の数。デフォルト値は 50、最大値は 100 です。連絡先の数がページサイズより大きい場合、レスポンスにページ設定トークンが含まれます。このトークンを使用して、結果の次のページを取得できます。
  • NEXT_PAGE_TOKEN: 省略可。以前のレスポンスでこのメソッドから返されたページ設定トークン。指定すると、前のレスポンスが終了した時点から連絡先のリストが開始されます。

リクエスト:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

レスポンスには、そのリソースのすべての連絡先と継承された連絡先が一覧表示されます。

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

個々の連絡先を管理する

Cloud Console の [重要な連絡先] ページか、REST API を使用して、個々の連絡先を管理できます。

連絡先の追加

連絡先を追加する手順は次のとおりです。

Console

  1. Cloud Console で、[重要な連絡先] ページに移動します。

    [重要な連絡先] ページに移動

  2. プロジェクト、フォルダ、または組織の名前がページの上部にあるプロジェクト セレクタに表示されていることを確認します。プロジェクト セレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。

  3. [連絡先に追加] をクリックします。

  4. [メール] フィールドと [メールの確認] フィールドに、連絡先のメールアドレスを入力します。

  5. [通知のカテゴリ] プルダウン メニューから、通知を受け取る連絡先の通知カテゴリを選択します。通知カテゴリと推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。

  6. [保存] をクリックします。

REST

新しい連絡先を追加するには、Essential Contacts API の contacts.create メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projectsfolders、または organizations を使用します。
  • RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。
  • EMAIL: 連絡先のメールアドレス。連絡先を作成した後にこのフィールドを変更することはできません。
  • NOTIFICATION_CATEGORY_1NOTIFICATION_CATEGORY_2: 通知を受け取る連絡先の通知カテゴリ。この値は、ALLBILLINGLEGALPRODUCT_UPDATESSECURITYSUSPENSIONTECHNICAL のいずれかになります。

    各カテゴリの推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。

  • LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。

リクエスト:

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

リクエストの本文:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

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

連絡先の変更

連絡先が割り当てられるカテゴリを変更するには、以下の手順を行います。

Console

  1. Cloud Console で、[重要な連絡先] ページに移動します。

    [重要な連絡先] ページに移動

  2. プロジェクト、フォルダ、または組織の名前がページの上部にあるプロジェクト セレクタに表示されていることを確認します。プロジェクト セレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。

  3. [表示] の横にある [連絡先] を選択します。

  4. 変更するカテゴリの連絡先の横にある をクリックします。

  5. [通知のカテゴリ] プルダウン メニューで、目的の通知カテゴリを選択し、[保存] をクリックします。

REST

既存の連絡先の通知登録または設定言語を変更するには、Essential Contacts API の contacts.patch メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projectsfolders、または organizations を使用します。
  • RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。
  • CONTACT_ID: 連絡先の数値 ID。プロジェクト、フォルダ、組織内のすべての連絡先の ID を表示するには、連絡先を一覧表示してください。
  • UPDATE_MASK: 省略可。どの連絡先のフィールドを変更したのかを記述するマスク。マスクの形式は、完全修飾されたフィールド名のカンマ区切りリストです(例: notificationCategorySubscriptions,languageTag)。
  • EMAIL: 連絡先のメールアドレス。このフィールドは、リクエストに含める CONTACT_ID に関連付けられたメールアドレスと一致する必要があります。
  • NOTIFICATION_CATEGORY_1NOTIFICATION_CATEGORY_2: 省略可。連絡先に受け取りを希望する更新通知カテゴリ。この値は、ALLBILLINGLEGALPRODUCT_UPDATESSECURITYSUSPENSIONTECHNICAL のいずれかになります。

    各カテゴリの推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。

  • LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。

リクエスト:

PATCH essentialcontacts.googleapis.com/v1alpha1/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": "my-new-contact@my-domain.com",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

連絡先の削除

連絡先を削除するには、次のようにします。

Console

  1. Cloud Console で、[重要な連絡先] ページに移動します。

    [重要な連絡先] ページに移動

  2. プロジェクト、フォルダ、または組織の名前がページの上部にあるプロジェクト セレクタに表示されていることを確認します。プロジェクト セレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。

  3. [表示] の横にある [連絡先] を選択します。

  4. 削除する連絡先のメールアドレスの横にある をクリックします。ダイアログで、連絡先の削除を確定します。

REST

連絡先を削除するには、Essential Contacts API の contacts.delete メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projectsfolders、または organizations を使用します。
  • RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。
  • CONTACT_ID: 連絡先の数値 ID。プロジェクト、フォルダ、組織内のすべての連絡先の ID を表示するには、連絡先を一覧表示してください。

リクエスト:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

リクエストが成功すると、レスポンスの本文は空になります。

カテゴリ別の連絡先の管理

Cloud Console では、[重要な連絡先] ページの [カテゴリ] タブに移動して、カテゴリ別に連絡先を管理することもできます。

単一のカテゴリに割り当てられた連絡先を追加、変更、削除するには、次の操作を行います。

  1. Cloud Console で、[重要な連絡先] ページに移動します。

    [重要な連絡先] ページに移動

  2. プロジェクト、フォルダ、または組織の名前がページの上部にあるプロジェクト セレクタに表示されていることを確認します。プロジェクト セレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。

  3. [表示] の横にある [カテゴリ] を選択します。

  4. 管理する連絡先のカテゴリと同じ行の をクリックします。

  5. カテゴリに割り当てられた連絡先を管理します。

    • 新しい連絡先を追加するには、[連絡先の追加] をクリックし、このページで説明される連絡先を追加するの手順に従います。
    • 連絡先が割り当てられたカテゴリを変更するには、変更するカテゴリの連絡先の横にある をクリックします。次に、[通知のカテゴリ] プルダウン メニューから目的の通知カテゴリを選択し、[保存] をクリックします。

    • 連絡先を削除するには、その連絡先のメールアドレスの横にある をクリックします。

次のステップ