NetWorker REST API 분류 가이드

YouTube 시청

시작

NetWorker에 연결:

• Content-Type: application/json
• 수락: application/json
• Authorization: Base 64로 인코딩된 기본 사용자 이름 및 암호

단일 NetWorker AUTHC 서버를 통해 인증하는 여러 NetWorker 데이터 영역이 있는 환경에서는 추가 헤더가 필요합니다.

• X-NW-인증 베이스 URL:AUTHC_HOSTNAME_OR_IP:AUTHC_PORT

NetWorker REST API는 다음 기본 URI로 노출됩니다.

https://[nw-server-hostname]:9090/nwrestapi/

https://[nw-server-hostname]:9090/nwrestapi/v1
https://[nw-server-hostname]:9090/nwrestapi/v2
https://[nw-server-hostname]:9090/nwrestapi/v3

전체 json 스키마는 다음에서 사용할 수 있습니다.

https://[nw-server-hostname]:9090/nwrestapi/v3/schemas/swagger.json

REST API 기능

몇 가지 예:

GET

모든 클라이언트를 나열합니다.                                            

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients

하나의 클라이언트만, 3개의 필드(hostname, saveSets 및 protectionGroups)만 표시      

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?fl=hostname,saveSets,protectionGroups&q=hostname:nwserver121

하나의 클라이언트가 속한 보호 그룹을 나열합니다.     

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?fl=protectionGroups&q=hostname:nwserver121

현재 알림을 표시합니다.                                     

https://[nw-server-hostname]:9090/nwrestapi/v3/global/alerts

최근에 실패한 작업을 표시합니다.                               

https://[nw-server-hostname]:9090/nwrestapi/v3/global/jobs?q=completionStatus:"Failed"&fl=clientHostname,startTime,name,message

하나의 정책(이 예에서는 WinFS )에 워크플로를 나열합니다.                   

https://[nw-server-hostname]:9090/nwrestapi/v3/global/protectionpolicies/WinFS/workflows

클라이언트 호스트 이름 및 세이브 세트에 정의된 대로 한 세이브 세트 인스턴스의 속성만 나열합니다.      

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?q=hostname:vm-lego-231 and saveSets:"/etc"

올리기:

워크플로우 작업을 시작합니다.                                 

https://[nw-server-hostname]:9090/nwrestapi/v3/global/protectionpolicies/Angela/workflows/WinFS/op/backup
                                                      JSON Body: 
                                                      {
                                                       }

새 클라이언트 인스턴스를 생성합니다(나열된 4개를 제외한 모든 속성에 기본값 사용).           

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients  
                                                     JSON Body 
                                                     {    
            "hostname": "vm-lego-231",
            "backupType": "Filesystem",
            "saveSets": [ "/etc" ],
            "protectionGroups" : [ "LinuxFS" ]
                                                          

지원에 필요한 정보

환경:

• NetWorker Server 이름
• NetWorker 버전 및 빌드 번호
• NetWorker Server 호스트 운영 체제 유형 및 버전

Linux:

hostname
strings /usr/sbin/nsrd | grep -i "(#)"
cat /etc/*release
uname -a

Windows:

nsrwatch

• 수행 중인 REST API 작업(GET, POST, PUT, DELETE), 사용된 URI, JSON 본문 내용(해당하는 경우)을 설명합니다. 
• REST API 응답 코드 및 제공된 모든 오류 메시지
• REST API 클라이언트와 NetWorker 간의 초기 연결 및 권한 부여가 성공했습니까?

• NetWorker Server에서 렌더링된 daemon.raw 로그 파일:
  • Linux: /nsr/logs/daemon.raw
  • Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
  • NetWorker: nsr_render_log 사용 방법
• NetWorker Server의 REST API 로그:  /nsr/logs/restapi (Linux) 또는 EMC NetWorker\nsr\logs\restapi (Windows)
• 인증 문제는 /nsr/authc/logs (linux) 또는 .에서 표준 NetWorker 인증 로깅을 참조하십시오. \EMC NetWorker\nsr\authc-server\tomcat\logs (Windows)

top -b | awk '/nsrtomc+/ {print strftime("%Y-%m-%d-%H:%M:%S", systime()), $0}'

이 출력은 표준 상위 출력을 표시하지만 사람이 읽을 수 있는 타임스탬프가 있습니다. 이는 프로세스의 CPU 및 메모리 사용량과 REST 호출이 수행되었을 때 특정 상태에 머무른 시간을 검토하는 데 사용할 수 있습니다. 이 정보를 restapi.log 및 AUTHC 로그와 비교하여 어떤 통화가 얼마나 자주 이루어졌는지 확인할 수 있습니다.
 

Windows: Windows 서버의 경우 "성능 모니터:

1. Performance Monitor를 Administrator 권한으로 엽니다.
2. 왼쪽 창에서 모니터링 툴을 확장하고 성능 모니터를 선택합니다.
3. 오른쪽 창 내부를 마우스 오른쪽 버튼으로 클릭하고 Remove all Counters를 선택합니다.
4. 오른쪽 창 내부를 마우스 오른쪽 버튼으로 클릭하고 카운터 추가를 선택합니다.
5. Available Counters(사용 가능한 카운터)에서 Memory(메모리)를 확장하고 % Commit Bytes(% 커밋 바이트)를 선택한 다음 Add(추가)를 클릭합니다.
6. 메모리에서 사용 가능한 바이트를 선택하고 추가를 클릭합니다.
7. Available Counters에서 Process를 확장하고 % Processor Time을 선택한 다음 Instances of Selected object에서 첫 번째 Java 항목을 선택하고 Add를 클릭합니다.
8. 사용 가능한 카운터에서프로세서 정보를 확장하고 % 프로세서 유틸리티를 선택한 다음 추가를 클릭합니다.
9. 오른쪽 창의 Added counters에 다음이 표시되어야 합니다.

10. 확인을 클릭합니다. 성능 모니터를 마우스 오른쪽 단추로 클릭하고 새> 데이터 수집기 집합을 클릭합니다.
11. 이름을 입력합니다. 예: RESTAPI_MON.
12. 위치 화면에서 대체 출력 위치를 지정하도록 선택하지 않은 경우 다음을  클릭합니다.
13. 저장 및 닫기를 선택하고 마침을 클릭합니다.
14. 왼쪽 창의 Data Collector Sets-User> Defined에서 RESTAPI_MON 속성을 열고 로그 형식으로 쉼표로 구분됨을 선택하고 Ok를 클릭합니다.

15. 왼쪽 창의 데이터 수집기 집합->사용자 정의 아래에서 RESTAPI_MON 데이터 수집기 집합을 선택하고 시작(재생 단추)을 클릭합니다.
16. 기본 출력 위치를 사용한 경우 .csv 파일은 C:\PerfLogs\Admin\RESTAPI_MON 아래에 나타납니다.
17. 문제가 관찰되고 출력 파일에 기록되면 Data Collector Sets-User Defined에서 Stop을 클릭하여 모니터링을 중지할 수 있습니다.

추가 리소스

지원되는 모든 REST API 엔드포인트 및 사용 예는 다음에서 제공됩니다. NetWorker REST API 참조 가이드