Go to main content

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

인쇄 보기 종료

업데이트 날짜: 2021년 8월
 
 

로그 항목 가져오기

지정된 어플라이언스 로그에서 로그 항목을 반환할 수 있습니다. 각 로그 항목은 로그별 내용 등록 정보와 함께 항목의 날짜/시간을 반환합니다.


주 -  로그 수에 따라 메모리 제약 조건으로 인해 이제 이전 로그 항목을 사용할 수 없게 될 수도 있습니다. 이 동일한 제한은 BUI 및 CLI에서도 적용됩니다. 시스템 로그를 모두 가져오려면 로그 관리 명령에 설명된 collect 함수를 사용하십시오.
매개변수
설명
start=index
지정된 인덱스/시간에서 로그 반환을 시작합니다.
limit=number
반환된 로그 항목 수를 제한합니다.

시작 인덱스는 생성된 첫번째 로그를 반환하는 값 0으로 기본 설정됩니다. 음수 값 및 로그 크기보다 크거나 같은 값은 허용되지 않습니다. 또한 시작 인덱스는 시간 문자열일 수 있습니다(예: 20130724T03:21:55).


주 -  REST에서는 UTC 시간만 허용됩니다. 현재 시간에서 1개월보다 오래된 시간 값은 허용되지 않습니다. 이전 로그 검색은 시작 값에 대한 인덱스 번호를 사용해야 합니다. 제한 값은 지정된 요청에 대해 반환되는 로그 수를 제한합니다. 지정된 제한 값을 초과하지 않는 값이 반환됩니다.

요청 예:

GET /api/log/v1/logs/audit?limit=4&start=1000 HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

결과 예:

HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
X-Zfssa-Api: development
Transfer-Encoding: chunked

{
    "logs": [
        {
            "address": "192.0.2.0",
            "annotation": "",
            "summary": "User logged in",
            "timestamp": "20131022T22:54:19",
            "user": "root"
        }, {
            "address": "192.0.2.0",
            "annotation": "",
            "summary": "Destroyed share \"zfs-storage-1:tst.volumes.py.34111.project/tst.volumes.py.34111.lun.7\"",
            "timestamp": "20131022T22:52:34",
            "user": "root"
        }, {
            "summary": "Joined workgroup \"RESTTESTWG\"",
            "timestamp": "20131022T22:54:23",
            "user": "<system>"
        }, {
            "address": "192.0.2.0",
            "annotation": "",
            "summary": "User logged in",
            "timestamp": "20131022T22:54:19",
            "user": "root"
        }
    ]
}