배포 목록 구독 취소

배포 목록을 구독 취소하려면 배포 목록에서 전송된 이메일의 바닥글에 있는 링크를 사용하십시오.

알림 이벤트

다음 표에는 알림 서비스가 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 인스턴스를 추가한 후에는 이를 테스트하여 알림 서비스에서 생성된 이벤트가 해당 인스턴스로 전달되는지 확인할 수 있습니다.

다음 단계를 완료하여 Event Notifications 인스턴스로 테스트 알림을 보내세요:

1. IBM Cloud 콘솔에서 관리 > 계정 > 알림 배포 목록으로 이동합니다.
2. 테스트 알림을 보내려는 Event Notifications 인스턴스를 선택하고 작업 아이콘 > 테스트를 클릭합니다.
3. 테스트할 알림 이벤트 유형을 선택한 다음 테스트 보내기를 클릭합니다.
   1. 테스트 알림을 다시 보내려면 테스트 다시 전송을 클릭하십시오.

알림 페이로드 세부사항

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 서비스 인스턴스를 선택하고 작업 아이콘 클릭합니다.
2. 삭제를 클릭하십시오.

헤더

웹훅을 추가할 때 UI에서 구성한 헤더와 시맨틱 버전 번호가 있는 추가 버전 헤더가 포함된 페이로드를 받습니다. 이 버전 헤더는 웹훅 페이로드의 예상 형식을 판별하는 데 사용할 수 있습니다.

현재 버전 헤더는 "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.

요청 페이로드의 심각도 속성은 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: 제목 필드는 알림 내용을 알려줍니다. 이 필드는 현재 영어만 지원되지만 더 많은 언어를 지원하도록 구성되어 있습니다.

startTime, endTime: 이벤트 시작 시간과 종료 시간을 확인할 수 있습니다.

startTime 및 endTime 필드는 이벤트의 시작 시간과 종료 시간을 Unix 협정 세계시(UTC) 시간소인으로 표시합니다.

페이로드 내에서 전송되는 필드는 필수 또는 선택적일 수 있습니다. 예를 들어, startTime과 같은 선택적 필드는 알림에 이러한 유형의 정보가 있으면 전달되고 알림에 정보가 없으면 전달되지 않습니다. 예를 들어, category와 같은 필수 필드는 모든 케이스에 전달됩니다. 다음 표에는 필수 필드와 선택사항 필드가 나열되어 있습니다.

향후 주요 버전 변경 없이 추가 필드가 추가될 수 있습니다. 즉, 알림을 처리하는 모든 코드는 인식하지 못하는 필드를 무시하도록 준비해야 합니다.

웹훅으로 테스트 알림 보내기

이전 단계를 완료했으며 구성된 웹훅이 있는 경우 쉽게 테스트할 수 있습니다. 웹훅에 테스트 알림을 전송하고 웹훅 통합이 올바르게 작동하고 알림을 수신하는지 확인하십시오.

웹훅에 테스트 알림을 전송하려면 다음 단계를 완료하십시오.

1. IBM Cloud 콘솔에서 관리 > 계정 > 알림 배포 목록으로 이동하십시오.
2. 테스트 알림을 전송할 웹후크를 선택하고 조치 아이콘 를 클릭하십시오.
3. 테스트 > 테스트 전송을 클릭하십시오.
4. 테스트 알림을 다시 보내려면 테스트 다시 전송을 클릭하십시오.