검색

6.75. 이벤트

download PDF

시스템에서 이벤트를 관리하는 서비스입니다.

표 6.220. 메서드 요약
이름요약

add

내부 감사 로그에 외부 이벤트를 추가합니다.

list

이벤트 목록을 가져옵니다.

삭제 취소

 

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 속성(제공되는 경우)은 무시됩니다.

표 6.221. 매개변수 요약
이름유형방향요약

event

이벤트

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
표 6.222. 매개변수 요약
이름유형방향요약

case_sensitive

부울

in

검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다.

events

Event[]

Out

 

팔로우

문자열

in

따라야 할 내부 링크를 나타냅니다.

from

정수

in

이벤트를 반환해야 하는 후 이벤트 인덱스를 나타냅니다.Indicates the event index after which events should be returned.

max

정수

in

반환할 최대 이벤트 수를 설정합니다.

search

문자열

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.3. 삭제 취소 POST

표 6.223. 매개변수 요약
이름유형방향요약

async

부울

in

삭제 취소를 비동기적으로 수행해야 하는지 여부를 나타냅니다.Indicates if the un-delete should be performed asynchronously.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.