3 상태 서비스

상태 서비스를 통해 사용자는 드라이브 및 볼륨 상태를 가져올 수 있습니다. 예를 들어, 상태 서비스를 사용하여 모든 볼륨 정보, 볼륨 상태 또는 드라이브의 온라인 또는 오프라인 상태를 가져올 수 있습니다. 이 서비스는 데이터베이스를 질의하여 거의 즉시 서비스 결과를 얻을 수 있으므로 상태 서비스는 동기 호출로 구현됩니다. 작업이 완료되면 작업 결과가 반환됩니다.

일반 상태 서비스

다음 두 웹 서비스는 각 비동기 관리 서비스 실행의 작업 결과 및 작업 상태를 검색하는 일반 상태 웹 서비스입니다.

  • getJobResult(int jobId)

  • getJobStatus(int jobId)

getjobstatusgetJobResult 웹 서비스는 비동기(관리) 서비스와 동기(상태) 서비스를 결합하여 실행 결과를 가져오는 예입니다.

getJobResult

이 비동기 호출은 입력된 작업 ID의 작업 결과를 검색합니다.

형식

getJobResult(int jobId)

호출할 LTFS-LE 웹 서비스:

getJobResult(jobId)

매개변수

jobId

관리 및 파일 웹 서비스 호출에서 반환된 작업 ID로, 실행 중인 웹 서비스 작업을 나타냅니다.

역할

Admin, Monitor 또는 Service

발생되는 예외

ResultNotFoundException

다음은 예외 발생의 예를 보여 줍니다.

  • jobId1234에 대한 JobResult를 찾을 수 없습니다.

권장되는 시간 초과

600초

SOAP 요청

<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" >
xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
   <env:Header>
      <ns1:Security>
         <ns1:UsernameToken>
            <ns1:Username>username</ns1:Username>
            <ns1:Password>password</ns1:Password>
         </ns1:UsernameToken>
      </ns1:Security>
   </env:Header>
   <env:Body>
      <      ns1:getJobResult>
         <arg0>1212</arg0>
      </ns2:getJobResult>
   </env:Body>
</env:Envelope>

SOAP 응답

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <ns2:getJobResultResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
         <return>
            <callerIp>127.0.0.1</callerIp>
            <jobCompletedOn>1399190120</jobCompletedOn>
            <jobId>607</jobId>
            <jobStatus>Success</jobStatus>
            <jobUser>Admin</jobUser>
            <serviceCalled>enterVolume</serviceCalled>
         </return>
      </ns2:getJobResultResponse>
   </S:Body>
</S:Envelope>

SOAP 결함

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <S:Fault xmlns:ns4="http://schemas.xmlsoap.org/soap/envelope/"
         <S:Code>
            <S:Value>S:Receiver</S:Value>
         <S:Code>
         <S:Reason>
            <S:Text>The JobResult cannot be found with the jobId 607</S:Text>
         <S:Reason>
         <S:Detail>
            <ns2:ResultNotFoundException xmlns:ns2="http://wsb.ejb.ws.mds.ltfsle.oracle/">
               <message>The JobResult cannot be found with the jobId 607</message>
            </ns2:ResultNotFoundException>
         <S:Detail>
      <S:Fault>
   </S:Body>
</S:Envelope>

getJobStatus

이 비동기 호출은 주어진 작업 ID의 작업 상태를 검색합니다. 반환 코드는 다음과 같습니다.

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

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

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

형식

getJobStatus(int jobId)

호출할 LTFS-LE 웹 서비스 체인:

getJobStatus(jobId)

매개변수

jobId

웹 서비스 호출에서 반환된 작업 ID로, 실행 중인 웹 서비스 작업을 나타냅니다.

역할

Admin, Monitor 또는 Service

발생되는 예외

없음

권장되는 시간 초과

600초

SOAP 요청

<?xml version = '1.0' encoding = 'UTF-8'?
<env:Envelope  xmlns:env="http://www.w3.org/2003/05/soap-envelope" 
xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-sece
xt-1.0.xsd" xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
   <env:Header>
      <ns1:Security>
         <ns1:UsernameToken>
            <ns1:Username>username</ns1:Username>
            <ns1:Password>password</ns1:Password>
         </ns1:UsernameToken>
      </ns1:Security>
   </env:Header>
   <env:Body>
      <ns2:getJobStatus>
         <arg0>1212</arg0>
      </ns2:getJobStatus>
   </env:Body>
</env:Envelope>

SOAP 응답

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <ns2:getJobStatusResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
         <return>0</return>
      </ns2:getJobStatusResponse>
   </S:Body>
</S:Envelope>

SOAP 결함

없음

볼륨 및 드라이브 상태 서비스

다음 서비스 서명으로 볼륨 및 드라이브 상태를 검색할 수 있습니다.

  • getAllDriveInfo()

  • getAllVolumeInfo()

  • getVolumeInfoByStatus(String status)

  • getVolumeInfoByVolser(String[] volsers)

getAllDriveInfo

모든 라이브러리 테이프 드라이브 정보를 검색하는 동기 호출입니다.

형식

getAllDriveInfo()

입력 유형

없음

응답

유효한 드라이브 응답은 SOAP 응답 예에 나와 있습니다. 용어집에서 정의를 참조하십시오.

역할

Admin, Monitor 또는 Service

발생되는 예외

없습니다. 모든 드라이브 정보를 가져오는 중 오류가 발생하는 경우 반환 값은 빈 드라이브 배열입니다.

권장되는 시간 초과

600초

SOAP 요청

<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1=
"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
   <env:Header>
      <ns1:Security>
         <ns1:UsernameToken>
            <ns1:Username>username</ns1:Username>
            <ns1:Password>password</ns1:Password>
         </ns1:UsernameToken>
      </ns1:Security>
   </env:Header>
   <env:Body>
      <ns1:getAllDriveInfo/>
   </env:Body>
</env:Envelope>

SOAP 응답

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <ns2:getAllDriveInfoResponse xmlns:ns2="http://ws.ltfsle.oracle/">
         <return>
            <acslsPath>0    ,0    ,12     ,5</acslsPath>
            <availableStatus>Available</availableStatus>
            <driveCompress>Compression Enabled</driveCompress>
            <driveEncry>Encryption NO</driveEncry>
            <driveFwRev>RF53</driveFwRev>
            <driveGenDev>/dev/sg10</driveGenDev>
            <driveLtfsCap>LTFS Capable</driveLtfsCap>
            <drivePoolName>Default Drive Pool</drivePoolName>
            <driveProdId>T10000C</driveProdId>
            <driveSn>576001000421</driveSn>
            <driveStatus>Assigned</driveStatus>
            <driveStdDev>/dev/st3</driveStdDev>
            <driveType>T1C</driveType>
            <driveVendor>STK</driveVendor>
            <onlineStatus>Online</onlineStatus>
         </return>
      </ns2:getAllDriveInfoResponse>
   </S:Body>
</S:Envelope>

SOAP 결함

없습니다. 이 웹 서비스 호출 중 어떤 오류라도 발생하는 경우 응답은 빈 드라이브를 반환합니다.

getAllVolumeInfo

이 요청 함수는 LTFS-LE의 모든 볼륨 정보를 검색하는 동기 호출입니다.

형식

getAllVolumeInfo()

응답

유효한 응답은 SOAP 응답 예에 나와 있습니다. 용어집에서 정의를 참조하십시오.

역할

Admin, Monitor 또는 Service

발생되는 예외

없습니다. 모든 볼륨 정보를 가져오는 중 오류가 발생하는 경우 반환 값은 빈 볼륨 배열입니다.

권장되는 시간 초과

600초

SOAP 요청

<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
  <env:Header>
    <ns1:Security>
         <ns1:UsernameToken>
            <ns1:Username>username</ns1:Username>
            <ns1:Password>password</ns1:Password>
         </ns1:UsernameToken>
      </ns1:Security>
   </env:Header>
   <env:Body>
      <ns2:getAllVolumeInfo/>
   </env:Body>
</env:Envelope>

SOAP 응답

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
  <S:Body>
   <ns2:getAllVolumeInfoResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
    <return>
     <acslsPath>0,   ,0    ,12     ,24   ,4</acslsPath>
     <assignedStatus>Assigned</assignedStatus>
     <availableStatus>Available</availableStatus>
     <capacityAvailable>1453410222080</capacityAvailable>
     <capacityUsed>24117248</capacityUsed>
     <currentLocation>home</currentLocation>
     <inuseStatus>In use</inuseStatus>
     <ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
     <onlineStatus>Online</onlineStatus>
     <volser>F50191</volser>
     <volumeCreatedOn>1403014692</volumeCreatedOn>
     <volumePoolName>Default Volume Pool</volumePoolName>
     <volumeType>LTO-1.5T</volumeType>
    </return>
    <return>
     <acslsPath>0,   ,0    ,12     ,23    ,5</acslsPath>
     <assignedStatus>Assigned</assignedStatus>
     <availableStatus>Available</availableStatus>
     <capacityAvailable>1453410222080</capacityAvailable>
     <capacityUsed>24117248</capacityUsed>
     <currentLocation>home</currentLocation>
     <inuseStatus>In use</inuseStatus>
     <ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
     <onlineStatus>Online</onlineStatus>
     <volser>F50192</volser>
     <volumeCreatedOn>1403014692</volumeCreatedOn>
     <volumePoolName>Default Volume Pool</volumePoolName>
     <volumeType>LTO-1.5T</volumeType>
    </return>
    <return>
   </ns2:getAllVolumeInfoResponse>
  </S:Body>
</S:Envelope>

SOAP 결함

없습니다. 이 웹 서비스 호출 중 어떤 오류라도 발생하는 경우 응답은 빈 볼륨을 반환합니다.

getVolumeInfoByStatus

볼륨 상태로 볼륨 정보를 검색하는 동기 호출입니다.

형식

getVolumeInfoByStatus(String status)

호출할 LTFS-LE 웹 서비스 체인:

getVolumeInfoByStatus(status)

입력 유형

유효한 볼륨 상태는 Online, Offline, Assigned, Unassigned, In Use, Idle, Available 또는 Unavailable입니다.

상태를 여러 개 입력할 수 없으며 보류 중 상태는 지원되지 않습니다.

응답

유효한 응답은 SOAP 응답 예에 나와 있습니다. 용어집에서 정의를 참조하십시오.

역할

Admin, Monitor 또는 Service

발생되는 예외

StatusNotFoundException

권장되는 시간 초과

600초

SOAP 요청

<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1
="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns2
="http://sb.ejb.ws.mds..ltfsle.oracle/">
   <env:Header>
      <ns1:Security>
         <ns1:UsernameToken>
            <ns1:Username>username</ns1:Username>
            <ns1:Password>password</ns1:Password>
         </ns1:UsernameToken>
      </ns1:Security>
   </env:Header>
   <env:Body>
      <ns2:getVolumeInfoByStatus>
         <arg0>online</arg0>
      </ns2:getVolumeInfoByStatus>
   </env:Body>
</env:Envelope>

SOAP 응답

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <ns2:getVolumeInfoByStatusResponse xmlns:ns2="http://ws.ltfsle.oracle/">
         <return>
            <acslsPath>3  ,0  ,12   ,38 ,1</acslsPath>
            <assignedStatus>Assigned</assignedStatus>
            <availableStatus>Available</availableStatus>
            <capacityAvailable>1453410222080</capacityAvailable>
            <capacityUsed>24117248</capacityUsed>
            <currentLocation>home</currentLocation>
            <inuseStatus>In use</inuseStatus>
            <ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
            <onlineStatus>Online</onlineStatus>
            <volser>O50191</volser>
            <volumeCreatedOn>1402933089</volumeCreatedOn>
            <volumePoolName>Default Volume Pool</volumePoolName>
            <volumeType>LTO-1.5T</volumeType>
         </return>
         <return>
            <acslsPath>3  ,0  ,12   ,41 ,2</acslsPath>
            <assignedStatus>Assigned</assignedStatus>
            <availableStatus>Available</availableStatus>
            <capacityAvailable>1453410222080</capacityAvailable>
            <capacityUsed>24117248</capacityUsed>
            <currentLocation>home</currentLocation>
            <inuseStatus>In use</inuseStatus>
            <ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
            <onlineStatus>Online</onlineStatus>
            <volser>O50191</volser>
            <volumeCreatedOn>1402933089</volumeCreatedOn>
            <volumePoolName>Default Volume Pool</volumePoolName>
            <volumeType>LTO-1.5T</volumeType>
         </return>
      </ns2:getVolumeInfoByStatusResponse>
   </S:Body>
</S:Envelope>

SOAP 결함

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3
="http://www.w3.org/2003/05/soap-envelope">
         <ns3:Code>
            <ns3:Value>ns3:Receiver</ns3:Value>
         </ns3:Code>
         <ns3:Reason>
            <ns3:Text>Status not found: [status]</ns3:Text>
         </ns3:Reason>
         <ns3:Detail>
            <ns2:StatusNotFoundException xmlns:ns2="http://ws.ltfsle.oracle/">
               <message>Status not found: [status]</message>
            </ns2:StatusNotFoundException>
         </ns3:Detail>
      </ns3:Fault>
   </S:Body>
</S:Envelope>

getVolumeInfoByVolser

볼륨 일련 번호로 하나 이상 볼륨의 볼륨 정보를 검색하는 동기 호출입니다.

형식

getVolumeInfoByVolser (String[] volsers)

호출할 LTFS-LE 웹 서비스:

getVolumeInfoByVolser([volser1, volser2, ...])

매개변수

volser는 볼륨 일련 번호입니다.

역할

Admin, Monitor 또는 Service

발생되는 예외

볼륨 일련 번호 중 하나라도 발견되지 않으면 VolumeNotFoundException 예외가 발생합니다.

권장되는 시간 초과

600초

SOAP 요청

<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1
="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns2
="http://1.0.xsd" xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
   <env:Header>
      <ns1:Security>
         <ns1:UsernameToken>
            <ns1:Username>username</ns1:Username>
            <ns1:Password>password</ns1:Password>
         </ns1:UsernameToken>
      </ns1:Security>
   </env:Header>
   <env:Body>
      <ns2:getVolumeInfoByVolser>
         <arg0>F52270</arg0>
         <arg0>EL0010</arg0>
         <arg0>F50331</arg0>
      </ns2:getVolumeInfoByVolser>
   </env:Body>
</env:Envelope>

SOAP 응답

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
      <ns2:getVolumeInfoByVolserResponse xmlns:ns2="http://ws.ltfsle.oracle/">
         <return>
            <acslsPath>3  ,0  ,12   ,38 ,1</acslsPath>
            <assignedStatus>Assigned</assignedStatus>
            <availableStatus>Available</availableStatus>
            <capacityAvailable>1453410222080</capacityAvailable>
            <capacityUsed>24117248</capacityUsed>
            <currentLocation>home</currentLocation>
            <inuseStatus>In use</inuseStatus>
            <ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
            <onlineStatus>Online</onlineStatus>
            <volser>O50191</volser>
            <volumeCreatedOn>1403015625</volumeCreatedOn>
            <volumePoolName>Default Volume Pool</volumePoolName>
            <volumeType>LTO-1.5T</volumeType>
         </return>
         <return>
            <acslsPath>3  ,0  ,12   ,38 ,2</acslsPath>
            <assignedStatus>Assigned</assignedStatus>
            <availableStatus>Available</availableStatus>
            <capacityAvailable>1453410222080</capacityAvailable>
            <capacityUsed>24117248</capacityUsed>
            <currentLocation>home</currentLocation>
            <inuseStatus>In use</inuseStatus>
            <ltfsUUID>e255c63b-54c9-4fc7-a60b-e63d58ed0005</ltfsUUID>
            <onlineStatus>Online</onlineStatus>
            <volser>O50191</volser>
            <volumeCreatedOn>1403015625</volumeCreatedOn>
            <volumePoolName>Default Volume Pool</volumePoolName>
            <volumeType>LTO-1.5T</volumeType>
      </ns2:getVolumeInfoByVolserResponse>
   </S:Body>
</S:Envelope>

SOAP 결함

<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
   <S:Body>
    <ns3:Fault xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns3="http://www.w3.org/2003/05/soap-envelope">
         </ns3:Code>
            <ns3:Value>ns3:Receiver</ns3:Value>
         </ns3:Code>
         <ns3:Reason>
            <ns3:Text>Volume is not found: [volser]</ns3:Text>
         </ns3:Reason>
         <ns3:Detail>
            <ns2:VolumeNotFoundException xmlns:ns2="http://ws.ltfsle.oracle/">
               <message>Volume is not found: [volser]</message>
            </ns2:VolumeNotFoundException>
         </ns3:Detail>
      </ns3:Fault>
   </S:Body>
</S:Envelope>