Go to main content

Oracle® ZFS Storage Appliance RESTful API 설명서, 릴리스 OS8.8.x

인쇄 보기 종료

업데이트 날짜: 2021년 8월
 
 

사용자정의 경보

사용자정의 경보는 사용자정의 이벤트에 대한 경보 조치입니다. category의 값에 대해 custom을 지정합니다.

사용자정의 이벤트는 워크플로우에서 정의됩니다. 미리 정의된 이벤트 중에서 선택하는 대신, 워크플로우에서 정의된 이벤트를 기술하는 다음 등록 정보를 지정합니다.

표 10  사용자정의 경보 등록 정보
등록 정보
유형
설명
severity
String
선택사항입니다. 경보가 발생하게 만든 이벤트의 심각도입니다. 유효한 값은 Minor, Major 또는 Critical입니다.
description
String
필수입니다. 경보를 발생시킨 이벤트에 대한 설명입니다.
response
String
선택사항입니다. 시스템이 이 이벤트의 영향을 줄이기 위해 수행할 조치에 대한 설명입니다.
impact
String
선택사항입니다. 이 이벤트가 어플라이언스에 끼치는 영향에 대한 설명입니다.
recommended_action
String
선택사항입니다. 관리자가 이 이벤트의 영향을 줄이기 위해 수행해야 할 조치에 대한 설명입니다.

사용자정의 경보 생성 및 게시에 필요한 권한 부여 구성

사용자정의 경보를 만들려면 사용자에게 alert 범위의 allow_configure 권한 부여가 있어야 합니다. 사용자정의 경보를 게시하려면 사용자에게 alert 범위의 allow_post 권한 부여가 있어야 합니다. Authorizations Required to Use Custom Alerts in Oracle ZFS Storage Appliance Administration Guide, Release OS8.8.x를 참조하십시오.

사용자정의 경보 만들기

category의 값에 대해 custom을 지정하고, 표 10, 사용자정의 경보 등록 정보에서 최소한 description 등록 정보에 대해 값을 설정합니다.

요청 예:

POST /api/alert/v1/actions
Accept: application/json
Content-Type: application/json

{"category": "custom", "severity": "Minor", "description": "Custom alert description",
"response": "What the system will do", "impact": "What happened to the appliance", 
"recommended_action": "What the administrator should do"}

결과 예:

출력에서 경보의 uuid를 기록해 둡니다. 이 정보는 경보 게시에 필요합니다.

{
    "actions": {
        "href": "/api/alert/v1/actions/actions-004",
        "category": "custom",
        "severity": "Minor",
        "description": "Custom alert description",
        "response": "What the system will do",
        "impact": "What happened to the appliance",
        "recommended_action": "What the administrator should do",
        "uuid": "custom-alert-uuid"
    }
}

경보 조치 수정에 설명된 대로 다른 경보를 수정하는 것과 동일한 방식으로 이 사용자정의 경보를 수정합니다. severity, description, response, impact 또는 recommended_action 등록 정보의 값을 추가 또는 변경하면 됩니다.

이벤트에 대한 응답 지정이벤트에 대한 응답 수정에 설명된 대로 다른 경보에 대한 응답을 지정하는 것과 동일한 방식으로 이 사용자정의 경보에 대한 응답을 지정합니다.

이벤트에 대한 응답 삭제경보 조치 삭제에 설명된 대로 다른 경보에 대한 것과 동일한 방식으로 경보 응답 또는 사용자정의 경보를 삭제합니다.

사용자정의 경보 게시

게시할 사용자정의 경보의 UUID를 제공해야 합니다. UUID는 경보를 만들 때와 경보를 나열할 때 표시됩니다. 사용자정의 경보 만들기단일 경보 조치 나열을 참조하십시오.

category 값이 custom인 경보만 게시할 수 있습니다.

경보의 UUID와 함께 경보에서 지정되지 않은 등록 정보(표 10, 사용자정의 경보 등록 정보에 나열됨)를 지정해야 합니다. 경보가 게시될 때 경보에서 지정된 등록 정보에 새 값이 제공될 수 있습니다.

요청 예:

POST /api/alert/v1/postalert
Accept: application/json
Content-Type: application/json

{"uuid": "custom-alert-uuid"}

결과 예:

{
    "uuid": "posted-alert-uuid"
}