2 API 사용

이 문서에 설명된 웹 서비스는 LTFS-LE 1.0.4.01 소프트웨어 릴리스에서만 사용할 수 있습니다.

WSDL(Web Services Description Language) 파일 액세스

프로그래머는 설치된 LTFS-LE 소프트웨어 버전에서 지원되는 웹 서비스의 서명을 WSDL(Web Services Description Language) 1.1 파일에서 찾아볼 수 있습니다. 이 파일은 다음 위치에서 액세스할 수 있습니다.

https://server.mydomain.com:7002/LTFS/LTFSLEWS?WSDL

위 예에서 server.mydomain.com은 호스트 이름 및 도메인 이름입니다.

일부 프로그래밍 인스턴스에서는 다음 포트 이름이 필요할 수 있습니다.

port name="LTFSLEWSSoap12HttpPort"

API 함수

LTFS LE 웹 서비스의 백엔드 실행 시간은 다양합니다. 볼륨 또는 작업 상태와 관련된 웹 서비스는 빠르게 반환될 수 있습니다. 하지만 일부 웹 서비스의 실행 시간은 소프트웨어가 제어할 수 없는 몇 가지 요인에 따라 달라집니다. 사용자 동작과 같은 물리적 요인은 소프트웨어에서 예측할 수 없습니다. 예를 들어, 볼륨 지정 서비스와 같은 일부 웹 서비스는 볼륨에 파일에 많이 들어 있는 경우 더 오래 걸릴 수 있습니다. 다른 예를 들어 보면, 꺼내기 작업 완료는 작업자가 라이브러리로 걸어가 CAP에서 볼륨을 꺼내는 시간에 달려있습니다.

이러한 불일치를 염두에 두고 모든 웹 서비스 호출에서 일관된 프로그래밍 인터페이스를 제공하기 위해 API 서비스 호출은 즉시 반환됩니다. 반환된 결과는 서비스 유형에 따라 다릅니다. LTFS LE에는 다음과 같은 두 가지 범주의 웹 서비스가 있습니다.

  • 상태 서비스

    상태 서비스는 사용자가 볼륨 및 드라이브 상태를 가져올 수 있게 해 주는 서비스입니다. 자세한 내용은 "상태 서비스"를 참조하십시오.

  • 관리 서비스

    관리 서비스는 하드웨어 리소스를 관리하는 서비스입니다. 예를 들어, 관리 서비스를 사용하여 볼륨을 넣고, 볼륨을 꺼내고, 볼륨을 온라인 또는 오프라인으로 전환할 수 있습니다. 자세한 내용은 "관리 서비스"를 참조하십시오.

API 함수 호출

관리 서비스는 2단계 프로세스를 사용하여 API 함수를 호출하고 결과를 반환합니다.

  1. 함수를 호출합니다. 고유한 요청 작업 ID가 즉시 반환됩니다.

  2. 1단계에서 반환된 작업 ID를 지정하여 getJobStatus 함수를 호출합니다.

    다음 작업 상태 중 하나가 반환됩니다.

    • 0(작업 ID와 연관된 웹 서비스 호출이 완료됨)

    • 1(작업 ID와 연관된 웹 서비스 호출이 아직 진행 중)

    • -1(작업 ID를 가진 웹 서비스 호출을 시스템에서 찾을 수 없음)

서명

LTFS-LE 웹 서비스 서명에는 각 SOAP 요청 메시지 형식, SOAP 응답 메시지 형식 및 SOAP 결함 메시지 형식이 포함되어 있습니다. 모든 LTFS LE 웹 서비스는 SOAP 메시지만 지원합니다. SOAP 메시지 형식은 SOAP 1.2 사양을 구현합니다. 각 함수의 유효한 SOAP 서명에 대한 자세한 내용은 "상태 서비스""관리 서비스"를 참조하십시오.

일반 정보

  • 이 문서에 간략하게 설명된 웹 서비스는 LTFS-LE 1.0.4.01 소프트웨어 릴리스에서만 사용할 수 있습니다.

  • 모든 웹 서비스 API는 HTTPS를 통해서만 액세스할 수 있습니다.

  • WS-Security를 사용하는 모든 웹 서비스 API SOAP 요청 메시지는 SOAP 헤더에 사용자 이름 및 암호가 모두 일반 텍스트로 되어 있는 사용자 이름 토큰을 포함합니다.

  • usernamepassword는 사용자 이름 토큰에서 하나의 예로 사용되었을 뿐이므로 유효한 사용자 이름 및 암호로 바꿔야 합니다.

  • SOAP 요청 및 응답 메시지에 사용된 모든 데이터는 SOAP 요청 및 응답 메시지 데이터 구조를 보여주는 용도로만 사용된 예제 데이터입니다.