配布リストからのアンサブスクライブ

配布リストからアンサブスクライブするには、配布リストから送信された任意の E メールのフッターにあるリンクを使用してください。

通知用イベント

次の表は、Notification サービスが Event Notifications に送信するイベントタイプの一覧です：

通知配信リストへの Event Notifications インスタンスの追加

通知配布リストに Event Notifications インスタンスを追加する前に、配布リストと同じアカウント Event Notifications サービスインスタンスが既にあることを確認してください。 Event Notifications サービス・インスタンスを持っていない場合は、 Event Notifications を使い始めるを 参照してください。 既存の Event Notifications サービスインスタンスを通知配信リストに追加するには、以下の手順を実行します：

1. IBM Cloud コンソールで、「管理」>「アカウント」 > **「通知配布リスト」**と移動します。
2. 追加 > をクリックする。 Event Notifications.
3. Event Notifications インスタンスリストから Event Notifications サービスインスタンスを選択する。 アカウント接続できる Event Notifications サービス・インスタンスがない場合は、 IBM Cloud カタログで作成できます。
4. 追加 をクリックします。

すでに構成されている通知配信リストに、 Event Notifications サービスインスタンスを追加することはできません。

Event Notifications インスタンスへのテスト通知の送信

通知配信リストに Event Notifications インスタンスを追加したら、Notifications サービスによって生成されたイベントがそのインスタンスに転送されていることを確認するために、テストすることができます。

Event Notifications インスタンスにテスト通知を送信するには、以下の手順を実行します：

1. IBM Cloud コンソールで、 管理 > アカウント > 通知配信リスト にアクセスする。
2. テスト通知を送信したい Event Notifications インスタンスを選択し、 Actions アイコン Actions > Test をクリックします。
3. テストしたい通知イベントタイプを選択し、 Send testをクリックします。
   1. テスト通知を再送するには、**「テストの再送 (Resend test)」**をクリックします。

通知ペイロードの詳細

Event Notifications インスタンスがアカウント配信リストに追加され、 アカウント通知を受信すると、通知ペイロードがその Event Notifications インスタンスに送信されます。 ペイロードオブジェクトのプロパティは、すべてのイベントタイプで同じです。 テスト通知を送信するためのメンテナンス・イベントに関する詳細情報を含む、以下のペイロード例を参照してください：

{
   "instanceId": "12345678-abcd-1234-efgh-1234567890ab",
   "id": "CHG1234567",
   "source": "crn:v1:bluemix:public:notificationapi::a/<scope>:12345678-abcd-1234-efgh-1234567890ab::",
   "ibmenseverity": "high_impact",
   "severity": "high_impact",
   "ibmensourceid": "crn:v1:bluemix:public:notificationapi::a/<scope>:12345678-abcd-1234-efgh-1234567890ab::",
   "type": "com.ibm.cloud.notificationapi.maintenance",
   "time": "2025-10-08T18:31:09.363Z",
   "ibmendefaultshort": "Maintenance - High Impact: this is a maintenance test notif",
   "ibmendefaultlong": "this is a maintenance test notif \n \nSource ID: CHG1234567 \nType: Maintenance \nSeverity: High Impact \nStart Time: 23 Oct 2025, 7:09 PM UTC \nEnd Time: 24 Oct 2025, 7:09 PM UTC \nUpdate Time: 21 Oct 2025, 2:52 AM UTC \n\nthis is the body text and sev = 1\n\nThis is a test email, please disregard\n\n\n",
   "ibmensmstext": "Maintenance - High Impact: this is a maintenance test notif \nSource ID: CHG2755299 \nCategory: Maintenance \nSeverity: High Impact \n",
   "ibmensubject": "Maintenance - High Impact: this is a maintenance test notif",
   "ibmenhtmlbody": "<div> this is a maintenance test notif</div></br><div><div><b>Source ID:</b> CHG2755299</div><div><b>Type:</b> Maintenance</div><div><b>Severity:</b> High Impact</div><div><b>Start Time:</b> 23 Oct 2025, 7:09 PM UTC</div><div><b>End Time:</b> 24 Oct 2025, 7:09 PM UTC</div><div><b>Update Time:</b> 21 Oct 2025, 2:52 AM UTC</div></br>this is the body text and sev = 1</br></div><div></br><b>This is a test email, please disregard</b></br><div>",
   "specversion": "1.0",
   "datacontenttype": "application/json",
   "data": {
       "sourceID": "CHG1234567",
       "category": "maintenance",
       "severity": 1,
       "crnMasks": [],
       "startTime": "1761246551",
       "endTime": "1761332951",
       "title": [
           {
               "language": "en",
               "text": "this is a maintenance test notif"
           }
       ],
       "body": [
           {
               "content-type": "text/html",
               "language": "en",
               "text": "this is the body text and sev = 1"
           }
       ]
   }
}

Event Notifications の通知のペイロードプロパティの詳細については、以下の表を見てください。

Event Notifications インスタンスの削除

以下の手順を実行することで、通知配信リストに追加した Event Notifications インスタンスを削除できます：

1. 通知配信リストから削除したい Event Notifications サービスインスタンスを選択し、 Actions アイコン Actions をクリックします。
2. **「削除」**をクリックします。

headers

あなたは、ウェブフックを追加したときにUIで設定したヘッダーと、セマンティックバージョン番号を持つ追加のバージョンヘッダーを持つペイロードを受け取ります。 このバージョン・ヘッダーを使用して、予期される Webhook ペイロードの形式を判別できます。

現行のバージョン・ヘッダーは "IBM-Notifications-API-Version": "v2.0.0" です。

フィールドの値

以下の説明では、ペイロードに入れて送信されるフィールドの値についての情報を記載します。

body: このフィールドには、プラットフォームで発生している、注意すべきイベントが記述されます。 このフィールドには、人間が読める形式で通知の詳しい説明が含まれます (複数の段落にわたる場合もあります)。 HTML 形式が含まれることもあります。 このフィールドは多くの言語に対応できるように構成されていますが、現在サポートされているのは英語のみです。

category: イベントのタイプ。 インシデント、メンテナンス、発表、またはセキュリティー情報となります。

componentNames: サービスが影響を受ける場合、このフィールドはそのサービスを表します。 これは、特定のサービスだけでなく、 Component: IBM Cloud のようなグローバルな値でも構わない。 IBM Cloud カタログページのサービスをご覧ください。

regions: このフィールドには、イベントの場所が示されます。

severity: このフィールドは、イベントの重大度を表します。 インシデントの場合は重大度 1、2、3、または 4、保守の場合は高、中、または低、発表の場合は大または小になります。 重大度のレベルについて以下に詳しく説明します。

* **Incidents**
  * `Severity 1`: Business-critical functionality is inoperable or critical interference failed. This severity usually applies to the production environment and the inability to access services is causing a critical impact on operations.
  * `Severity 2`: Core functionality is impacted. Service is operational but causing major impact on usage.
  * `Severity 3`: Partial or noncritical disruption to functionality with minimal or isolated impact.
  * `Severity 4`: A minor issue that requires action, but does not impact functionality or usage.
* **Maintenance**
  * `High impact`: Maintenance will, or is likely to cause service outages and disruptions.
  * `Medium impact`: Maintenance will, or is likely to cause measurable service degradation but not an actual outage.
  * `Low impact`: Maintenance will cause no service disruption during or after the maintenance window.
* **Announcements**
  * `Major`: Important incidents such as legal notices, service deprecation, or security patches.
  * `Minor`: Informative announcements such as product enhancements.

リクエストペイロードの[severity]属性は0、1、2、3、4の値を取ることができる。 以下の表は、重大度の値とそれに対応する分類を示したものである：

state: このフィールドは、保守と通知にのみ使用されます。 次の値を取ります。

* Values for *Maintenance* states: Planned, In progress, Completed, Canceled, Failed
* Values for *Incident* states: New issue, Investigating, Resolved

title: title フィールドには、何についての通知であるかが表示されます。 このフィールドは多くの言語に対応できるように構成されていますが、現在サポートされているのは英語のみです。

startTime、endTime: イベントの開始時刻と終了時刻を確認できます。

startTime と endTime のフィールドには、イベントの開始時刻と終了時刻が Unix 協定世界時タイム・スタンプ形式で表示されます。

ペイロードに入れて送信されるフィールドには、必須のものとオプションのものとがあります。 オプションのフィールド (startTime など) は、そのタイプの情報が通知に含まれる場合に渡され、含まれない場合は渡されません。 必須のフィールド (category など) は、すべての場合に渡されます。 以下の表に、必須のフィールドとオプションのフィールドを区別してリストします。

大きなバージョン変更をしなくても、将来的にフィールドが追加されるかもしれない。 つまり、通知を処理するコードは、認識できないフィールドを無視するように作成する必要があります。

テスト通知をウェブフックに送信する

前のステップでの準備ができており、構成済みの Webhook があれば、そのテストは簡単です。 テスト通知を Webhook に送信することにより、Webhook 統合が正しく機能していて通知を受信することを確認します。

テスト通知を Webhook に送信するには、以下のステップを実行します。

1. IBM Cloud コンソールで管理 > アカウント > 通知配布リストに移動します。
2. テスト通知の送信先となる Webhook を選択し、アクション・アイコンをクリックします。
3. 「テスト」 > **「テストの送信 (Send test)」**をクリックします。
4. テスト通知を再送するには、**「テストの再送 (Resend test)」**をクリックします。