6.75. 이벤트
시스템에서 이벤트를 관리하는 서비스입니다.
이름 | 요약 |
---|---|
| 내부 감사 로그에 외부 이벤트를 추가합니다. |
| 이벤트 목록을 가져옵니다. |
|
6.75.1. POST추가
내부 감사 로그에 외부 이벤트를 추가합니다.
이는 시스템 관리자와 관련된 이벤트를 감지하거나 생성하는 외부 시스템과 통합하기 위한 것입니다. 예를 들어 외부 모니터링 툴에서 파일 시스템이 가상 머신의 게스트 운영 체제 내부에서 파일 시스템이 가득다는 것을 감지할 수 있습니다. 이 이벤트는 다음과 같이 요청을 보내는 내부 감사 로그에 추가할 수 있습니다.
POST /ovirt-engine/api/events <event> <description>File system /home is full</description> <severity>alert</severity> <origin>mymonitor</origin> <custom_id>1467879754</custom_id> </event>
이벤트는 특정 오브젝트에도 연결할 수 있습니다. 예를 들어 위의 이벤트는 vm
링크를 사용하여 발생한 특정 가상 머신에 연결할 수 있습니다.
POST /ovirt-engine/api/events <event> <description>File system /home is full</description> <severity>alert</severity> <origin>mymonitor</origin> <custom_id>1467879754</custom_id> <vm id="aae98225-5b73-490d-a252-899209af17e9"/> </event>
이전 예에서 vm
와 같은 링크를 사용하는 경우 id
속성만 허용됩니다. name
속성(제공되는 경우)은 무시됩니다.
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in/Out |
6.75.2. GET나열
이벤트 목록을 가져옵니다.
GET /ovirt-engine/api/events
위의 요청에 따라 다음과 같은 응답이 제공됩니다.
<events> <event href="/ovirt-engine/api/events/2" id="2"> <description>User admin@internal-authz logged out.</description> <code>31</code> <correlation_id>1e892ea9</correlation_id> <custom_id>-1</custom_id> <flood_rate>30</flood_rate> <origin>oVirt</origin> <severity>normal</severity> <time>2016-09-14T12:14:34.541+02:00</time> <user href="/ovirt-engine/api/users/57d91d48-00da-0137-0138-000000000244" id="57d91d48-00da-0137-0138-000000000244"/> </event> <event href="/ovirt-engine/api/events/1" id="1"> <description>User admin logged in.</description> <code>30</code> <correlation_id>1fbd81f4</correlation_id> <custom_id>-1</custom_id> <flood_rate>30</flood_rate> <origin>oVirt</origin> <severity>normal</severity> <time>2016-09-14T11:54:35.229+02:00</time> <user href="/ovirt-engine/api/users/57d91d48-00da-0137-0138-000000000244" id="57d91d48-00da-0137-0138-000000000244"/> </event> </events>
다음 이벤트가 발생합니다.
- id="1" - API 로그입니다.
- id="2" - API 로그가 admin 사용자 계정에서 로그아웃합니다.
반환된 이벤트 목록의 순서는 항상 표시됩니다. sortby
절이 search
매개변수에 포함된 경우 이벤트는 해당 절에 따라 정렬됩니다. sortby
절이 포함되지 않은 경우 이벤트는 가장 높은 값부터 시작하여 id
특성의 숫자 값에 따라 정렬됩니다. max
매개변수와 결합하여 최신 이벤트를 쉽게 얻을 수 있습니다.
GET /ovirt-engine/api/events?max=1
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in |
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. | |
| Out | ||
| in | 따라야 할 내부 링크를 나타냅니다. | |
| in | 이벤트를 반환해야 하는 후 이벤트 인덱스를 나타냅니다.Indicates the event index after which events should be returned. | |
| in | 반환할 최대 이벤트 수를 설정합니다. | |
| in | events 서비스는 다른 리소스 서비스와 유사한 검색 쿼리를 제공합니다. |
6.75.2.1. case_sensitive
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. 기본값은
true
입니다. 즉, 해당 케이스가 고려됩니다. 대소문자를 무시하고자 하는 경우 false
로 설정합니다.
6.75.2.2. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.75.2.3. from
이벤트를 반환해야 하는 후 이벤트 인덱스를 나타냅니다.Indicates the event index after which events should be returned. 이벤트 인덱스는 엄격하게 증가하므로 이 매개 변수가 더 큰 인덱스를 갖는 이벤트만 반환됩니다. 예를 들어 다음 요청은 인덱스가 123
보다 큰 이벤트만 반환합니다.
GET /ovirt-engine/api/events?from=123
이 매개변수는 선택 사항이며 지정되지 않은 경우 반환된 첫 번째 이벤트가 가장 최근에 생성됩니다.
6.75.2.4. max
반환할 최대 이벤트 수를 설정합니다. 지정하지 않으면 모든 이벤트가 반환됩니다.
6.75.2.5. search
events 서비스는 다른 리소스 서비스와 유사한 검색 쿼리를 제공합니다.
특정 심각도를 제공하여 검색할 수 있습니다.
GET /ovirt-engine/api/events?search=severity%3Dnormal
위의 요청에 따라 심각도가 정상인
이벤트 목록을 가져옵니다.
<events> <event href="/ovirt-engine/api/events/2" id="2"> <description>User admin@internal-authz logged out.</description> <code>31</code> <correlation_id>1fbd81f4</correlation_id> <custom_id>-1</custom_id> <flood_rate>30</flood_rate> <origin>oVirt</origin> <severity>normal</severity> <time>2016-09-14T11:54:35.229+02:00</time> <user href="/ovirt-engine/api/users/57d91d48-00da-0137-0138-000000000244" id="57d91d48-00da-0137-0138-000000000244"/> </event> <event href="/ovirt-engine/api/events/1" id="1"> <description>Affinity Rules Enforcement Manager started.</description> <code>10780</code> <custom_id>-1</custom_id> <flood_rate>30</flood_rate> <origin>oVirt</origin> <severity>normal</severity> <time>2016-09-14T11:52:18.861+02:00</time> </event> </events>
가상화 환경은 일정 기간 후에 많은 양의 이벤트를 생성합니다. 그러나 API는 하나의 검색 쿼리에 대한 기본 이벤트 수만 표시합니다. API는 기본값을 초과하기 위해 검색 쿼리에서 페이지 명령을 사용하여 페이지로 구분합니다. 다음 검색 쿼리는 API에서 sortby 절과 함께 페이지 값을 사용하여 결과를 페이지화하도록 지시합니다.
sortby time asc page 1
아래 예제에서는 이벤트 리소스 paginatess입니다. URL로 인코딩된 요청은 다음과 같습니다.
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%201
다음 결과 페이지를 보려면 페이지 값을 늘립니다.
GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%202
6.75.3. 삭제 취소 POST
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 삭제 취소를 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the un-delete should be performed asynchronously. |