관리 서비스는 스토리지 리소스를 관리하는 서비스입니다. 예를 들어, 관리 서비스를 사용하여 볼륨을 넣고, 볼륨을 꺼내고, 볼륨을 온라인 또는 오프라인으로 전환할 수 있습니다.
이 서비스는 솔루션의 물리적 구성 요소와 통신해야 하며 응답 시간은 작업 유형 및 물리적 대기 시간에 따라 다릅니다. 관리 서비스는 비동기 호출로 구현됩니다. 관리 서비스는 작업이 실행되기 전에 반환되므로 비동기입니다.
작업이 완료되면 호출 서비스가 결과를 얻기 위한(결과가 나오면) 호출을 수행할 때 필요한 프로그램 또는 작업 ID가 반환됩니다.
비동기 서비스가 반환될 때 작업 ID는 응답의 일부로 제공됩니다. 반환 코드는 다음과 같습니다.
0(이 작업 ID와 연관된 웹 서비스 호출이 완료됨)
1(이 작업 ID와 연관된 웹 서비스 호출이 아직 진행 중)
-1(이 작업 ID를 가진 웹 서비스 호출을 시스템에서 찾을 수 없음)
웹 서비스 클라이언트를 구현하는 프로그래머는 작업 상태를 얻기 위해 작업 ID를 전달하여 getJobStatus 웹 서비스를 주기적으로 호출해야 합니다.
getJobStatus가 “0”을 반환하면 서비스 결과를 얻기 위해 getJobResult 웹 서비스를 호출합니다.
각 비동기 웹 서비스는 완료되는 데 걸리는 시간이 서로 다를 수 있습니다. 백엔드는 물리적 측면에서 오류가 발생하면 시간 초과됩니다. 이 설명서에서는 타사 웹 서비스 클라이언트가 시간 초과되기 전에 대기하는 최대 시간에 대한 권장 사항을 제공합니다.
getJobStatus 및 getJobResult에 대한 자세한 내용은 "상태 서비스"를 참조하십시오.
LTFS-LE를 사용하여 볼륨을 관리하려면 LTFS-LE 응용 프로그램에 볼륨을 지정해야 합니다.
LTFS-LE에 볼륨을 지정하면 볼륨이 자동으로 온라인 상태가 되고 기본 볼륨 풀에 추가됩니다. 포맷되지 않은 볼륨을 지정하면 LTFS-LE와 함께 사용할 수 있도록 볼륨이 자동으로 포맷됩니다.
assignVolume(String[] volsers)
사전 조건:
볼륨을 지정하기 전에 호환되는 드라이브를 사용할 수 있는지와 볼륨이 오프라인이고, 지정되지 않았으며, 풀에 속하지 않고, 사용 가능한지 확인합니다. 볼륨은 라이브러리에 존재해야 합니다.
이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨이 요구되는 상태 중 하나에 속하는지 확인하고 필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스:
assignVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 LTFS-LE 소프트웨어에 지정됩니다. 볼륨이 LTFS로 포맷되지 않은 경우 자동으로 LTFS로 포맷됩니다.
volser는 지정할 볼륨의 볼륨 일련 번호입니다. 입력 매개변수는 문자열 배열이므로 볼륨을 여러 개 지정할 수 있습니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨이 오프라인이 아니거나, 지정되어 있지 않거나, 풀에서 제거된 경우 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Assigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 SL0010의 inuseStatus가 In use입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:assignVolume>
<arg0>F50233</arg0>
<arg0>F50234</arg0>
</ns1:assignVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body>
<ns2:assignVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1220</return>
</ns2:assignVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume SL0010’s assignedStatus is Assigned</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s assignedStatus is Assigned</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 API 함수는 하나 이상의 LTFS-LE 볼륨을 라이브러리에서 꺼냅니다.
메시지 크기를 고려하여 LTFS LE는 메일슬롯(CAP)을 통해 최대 30개의 볼륨만 꺼낼 수 있도록 지원합니다. 꺼내기는 모든 볼륨을 완전히 꺼낼 때까지 4개 단위로 수행됩니다. 시간 초과는 발생하지 않습니다. 비동기 호출입니다.
ejectVolume(String[] volsers,String acs,String lsm,String cap)
사전 조건:
볼륨을 꺼내기 전에 볼륨이 마무리되고 오프라인 상태인지, CAP를 사용할 수 있는지, ACS가 구성된 라이브러리와 동일한지 확인합니다. 이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨이 온라인 상태이고 사용되지 않는 경우 다음과 같이 볼륨을 마무리합니다.
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
볼륨이 온라인 상태이면 꺼내기 API 호출을 실행하기 전에 다음과 같이 볼륨을 오프라인으로 전환합니다.
offlineVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
호출할 LTFS-LE 웹 서비스 체인:
ejectVolume([volser1,volser2,...],acs,lsm,cap) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 라이브러리에서 꺼내집니다. 사용자는 라이브러리로 걸어가서 CAP 도어를 연 후 볼륨을 가져와야 합니다.
volser는 꺼낼 볼륨의 볼륨 일련 번호입니다.
acs는 라이브러리 ACS 식별자입니다.
lsm은 라이브러리 LSM 식별자입니다.
cap는 볼륨을 꺼내는 데 사용할 라이브러리 CAP(메일슬롯) ID입니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 배열의 한 volser가 비어 있거나, CAP 식별자(acs,lsm,cap_id) 일부가 누락되었거나 사용 중인 경우 널 매개변수가 반환됩니다.
볼륨이 오프라인이 아니거나, 지정되어 있지 않거나, 풀에서 제거된 경우 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Assigned입니다.
볼륨 SL0010의 availableStatus가 Available입니다.
볼륨 SL0010의 inuseStatus가 In use입니다.
ACS 0이 라이브러리 acs 7과 일치하지 않습니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:ejectVolume>
<arg0>F50234</arg0>
<arg0>F50233</arg0>
<arg1>3</arg1>
<arg2>0</arg2>
<arg3>1</arg3>
</ns1:ejectVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401 -wss-wssecurity-secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:ejectVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1213</return>
</ns2:ejectVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume SL0010’s onlineStatus is Online</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s onlineStatus is Online</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
CAP(메일슬롯)를 사용하여 라이브러리에 하나 이상의 볼륨을 넣는 비동기 호출입니다.
enterVolume(String acs,String lsm,String cap)
사전 조건:
CAP에 볼륨을 넣기 위한 특정 사전 조건은 없습니다. 하지만 이 명령을 실행하기 전에 관리자 또는 서비스는 CAP 식별자(acs, lsm 및 cap_id)를 수집하고 CAP가 사용 가능하며 작업 중(보류 중, 꺼내기, 넣기 또는 감사)이 아님을 확인해야 합니다.
호출할 LTFS-LE 웹 서비스 체인:
enterVolume(acs,lsm,cap) getJobStatus(jobId) <poll each 10s until status is complete> getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 라이브러리에 넣어집니다.
acs는 라이브러리 ACS 식별자입니다.
lsm은 라이브러리 LSM 식별자입니다.
cap는 볼륨을 넣는 데 사용할 라이브러리 CAP(메일슬롯) ID입니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException.
매개변수가 하나라도 비어 있으면 널 예외가 발생합니다. 다음은 예외 발생의 예를 보여 줍니다.
ACS 4가 라이브러리 acs 7과 일치하지 않습니다.
잘못된 ACS 번호입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:enterVolume>
<arg0>3</arg0>
<arg1>0</arg1>
<arg2>1</arg2>
</ns1:enterVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/
oasis-200401-wss-wssecurity-secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:enterVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1212</return>
</ns2:enterVolumeResponse>
</S:Body>
</S:Envelope>
<?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> Invalid ACS number </ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>Invalid ACS number</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
finalizeVolume 명령을 사용하여 볼륨에 대한 모든 변경 사항을 커밋할 수 있습니다. 대개 이 작업은 라이브러리에서 꺼낼 볼륨을 오프라인으로 전환하기 전에 수행됩니다. 볼륨을 마무리하면 기록되지 않은 모든 메타 데이터 또는 적용되지 않은 파일 삭제가 볼륨에 적용됩니다. 이 작업을 수행하면 전역 이름 공간의 작업이 물리적 볼륨에 반영됩니다. 오프라인으로 전환하기 전에 볼륨을 마무리하지 못하면 볼륨의 오프라인 전환이 지연될 수 있습니다.
finalizeVolume(String volser)
사전 조건:
볼륨을 마무리하기 전에 호환되는 드라이브를 사용할 수 있는지와 해당 볼륨이 온라인이고, 풀에 속해 있고, 유휴 상태이며, 사용 가능한지 확인합니다. 이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨이 요구되는 모든 상태에 속하는지 확인하고 필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스:
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨에 적용되어야 하는 모든 보류 중 작업이 볼륨에 적용됩니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨이 오프라인이 아니거나, 지정되어 있지 않거나, 풀에서 제거된 경우 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Offline입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 SL0010의 inuseStatus가 In use입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:finalizeVolume>
<arg0>F50233</arg0>
</ns1:finalizeVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:finalizeVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1219</return>
</ns2:finalizeVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume SL0010’s onlineStatus is Offline</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s onlineStatus is Offline</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
볼륨을 LTFS 형식 볼륨으로 포맷하는 비동기 호출입니다. LTFS-LE 웹 서비스에는 확인이 필요하지 않으며 이 웹 서비스는 어떠한 볼륨 검증도 수행하지 않습니다. 사용자는 포맷 중인 볼륨을 인지하여 올바른 볼륨이 포맷되도록 해야 합니다.
볼륨이 포맷되면 해당 볼륨의 모든 이전 데이터는 삭제됩니다.
formatVolume(String volser)
사전 조건:
볼륨을 포맷하기 전에 해당 볼륨이 오프라인이고, 지정되어 있으며, 풀에 속해 있고, 사용 가능한지 확인합니다. 호환되는 드라이브를 사용할 수 있는지 확인합니다.
이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨이 사전 조건에서 요구하는 상태에 있는지 확인합니다.
필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스 체인:
formatVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 LTFS-LE로 포맷됩니다.
ValidationFailedException
다음은 예외 발생의 예를 보여 줍니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 EL0010의 onlineStatus가 Online입니다.
볼륨 EL0010의 assignedStatus가 Unassigned입니다.
볼륨 EL0010의 availableStatus가 Unavailable입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:formatVolume>
<arg0>F50234</arg0>
</ns1:formatVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:formatVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1215</return>
</ns2:formatVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume EL0010's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 비동기 호출은 볼륨을 LTFS 형식으로 포맷하며 특정 드라이브에서 볼륨을 포맷해야 하는 경우에 사용됩니다. 볼륨과 드라이브는 호환되어야 합니다.
formatVolumeWithDrive (String volser, String drivesn)
사전 조건:
볼륨을 포맷하기 전에 해당 볼륨이 오프라인이고, 지정되어 있으며, 풀에 속해 있고, 사용 가능한지 확인합니다. 볼륨 및 드라이브가 라이브러리에 존재해야 하고 볼륨과 드라이브가 호환되어야 합니다. 드라이브는 유휴 또는 사용 가능 상태여야 합니다.
이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1,volser2,...])
볼륨이 사전 조건에서 요구하는 상태에 있는지 확인합니다.
필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스 체인:
formatVolumeWithDrive(volser,drivesn) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 LTFS-LE로 포맷됩니다.
volser는 볼륨 일련 번호입니다.
drivesn은 볼륨을 포맷하는 드라이브의 드라이브 일련 번호입니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException
다음은 예외 발생의 예를 보여 줍니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 EL0010의 assignedStatus가 Unassigned입니다.
볼륨 EL0010의 onlineStatus가 Online입니다.
볼륨 EL0010의 availableStatus가 Unavailable입니다.
드라이브 123456를 LTFS 라이브러리에서 찾을 수 없습니다.
드라이브 123456의 availableStatus가 In use입니다.
드라이브 123456의 onlineStatus가 Offline입니다.
드라이브 123456의 assignedStatus가 Unassigned입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:formatVolumeWithDrive>
<arg0>F50234</arg0>
<arg1>576001000421</arg1>
</ns1:formatVolumeWithDrive>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:formatVolumeWithDriveResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1215</return>
</ns2:formatVolumeWithDriveResponse>
</S:Body>
</S:Envelope>
<?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>The Volume F50377's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The Volume F50377's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 비동기 호출은 전역 이름 공간에서 볼륨 경로를 찾습니다.
ValidationFailedException
볼륨이 라이브러리에 존재해야 하며 볼륨이 지정되어 있고 사용 가능해야 합니다.
다음은 예외 발생의 예를 보여 줍니다.
볼륨 EL0020의 assignedStatus가 Unassigned입니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 EL0010의 availableStatus가 Unavailable입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:getVolumePath>
<arg0>F50233</arg0>
</ns1:getVolumePath>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2: getVolumePath xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1225</return>
</ns2: getVolumePath >
</S:Body>
</S:Envelope>
<?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>The volume EL0010’s availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010’s availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
볼륨을 오프라인 상태로 전환하여 하나 이상 볼륨의 꺼내기, 원격 보관, 포맷, 지정 및 지정 해제를 사용 가능하게 하는 비동기 호출입니다.
offlineVolume(String[] volser)
사전 조건:
볼륨을 오프라인으로 설정하기 전에 해당 볼륨이 라이브러리에 존재하고, 온라인 상태이며, 지정되어 있고, 사용 가능하며, 마무리되어 있는지 확인합니다. 호환되는 드라이브를 사용할 수 있는지 확인합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨이 온라인이고 지정된 상태이면 볼륨을 마무리합니다.
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
호출할 LTFS-LE 웹 서비스 체인:
offlineVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 오프라인 상태가 됩니다.
volser는 오프라인으로 전환할 볼륨의 볼륨 일련 번호입니다. 입력 매개변수는 문자열 배열이므로 이 호출에서는 여러 볼륨을 오프라인으로 전환할 수 있습니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨을 오프라인으로 설정하기 전에 해당 볼륨이 라이브러리에 존재하지 않거나, 온라인 상태이거나, 지정되어 있거나, 사용할 수 있거나, 마무리되어 있으면 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Offline입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:offlineVolume>
<arg0>F50234</arg0>
<arg0>F50233</arg0>
</ns1:offlineVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:offlineVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1218</return>
</ns2:offlineVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume EL0010's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
볼륨을 읽거나, 쓰거나, 마무리할 수 있도록 온라인 상태로 전환하는 비동기 호출입니다.
onlineVolume(String[] volsers)
사전 조건:
볼륨을 온라인으로 설정하기 전에 해당 볼륨이 라이브러리에 존재하고, 오프라인이며, 지정되어 있고, 풀에 속해 있으며, 사용 가능한지 확인합니다. 호환되는 드라이브를 사용할 수 있는지 확인합니다.
getVolumeInfoByVolser([volser1, volser2, ...])
호출할 LTFS-LE 웹 서비스:
onlineVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 온라인 상태가 됩니다.
volser는 온라인으로 전환할 볼륨의 볼륨 일련 번호입니다. 입력 매개변수는 문자열 배열이므로 이 호출에서는 여러 볼륨을 온라인으로 전환할 수 있습니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨을 온라인으로 설정하기 전에 해당 볼륨이 라이브러리에 존재하지 않거나, 온라인 상태이거나, 지정되지 않았거나, 풀에 속하지 않거나, 사용할 수 없으면 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 EL0010의 inuseStatus가 In use입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="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:onlineVolume>
<arg0>F40244</arg0>
<arg0>F43022</arg0>
</ns1:onlineVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:onlineVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1217</return>
</ns2:onlineVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume SL0010’s availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume SL0010’s availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 비동기 호출은 볼륨 폴더를 /LTFSLE/LOST+FOUND+VOLUMES/에서 /LTFSLE/ 폴더로 이동합니다.
prepareVolume(volser)
사전 조건:
볼륨을 준비하기 전에 볼륨 폴더가 /LTFSLE/LOST+FOUND+VOLUMES에 있는지와 볼륨이 라이브러리에 존재하고, 오프라인이고, 지정되어 있으며, 사용 가능한지 확인합니다. 이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨의 위치를 가져옵니다.
getVolumePath(volser)
볼륨이 요구되는 모든 상태에 속하는지 확인하고 필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스:
prepareVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨 폴더를 /LTFSLE 폴더에서 액세스할 수 있습니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨을 준비하기 전에 해당 볼륨이 라이브러리에 존재하지 않거나, 온라인 상태이거나, 지정되지 않았거나, 사용할 수 없으면 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 EL0010의 inuseStatus가 In use입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:prepareVolume>
<arg0>F50233</arg0>
</ns1:prepareVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:prepareVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1221</return>
</ns2:prepareVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume EL0010's availableStatus is Unavailable</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's availableStatus is Unavailable</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 명령은 LTFS-LE로부터 볼륨을 지정 해제합니다.
unassignVolume(String[] volsers)
사전 조건:
볼륨을 지정 해제하기 전에 해당 볼륨이 라이브러리에 존재하고, 오프라인이며, 지정되어 있고, 풀에 속해 있으며, 사용 가능한지 확인합니다. 이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨이 요구되는 모든 상태에 속하는지 확인하고 필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스:
unassignVolume([volser1, volser2, ...]) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 LTFS-LE로부터 볼륨이 지정 해제됩니다.
volser는 지정 해제할 볼륨의 볼륨 일련 번호입니다. 입력 매개변수는 문자열 배열이므로 볼륨을 여러 개 지정 해제할 수 있습니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨을 지정 해제하기 전에 해당 볼륨이 라이브러리에 존재하지 않거나, 온라인 상태이거나, 지정되지 않았거나, 풀에 속하지 않거나, 사용할 수 없으면 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 EL0010의 inuseStatus가 In use입니다.
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:unassignVolume>
<arg0>F50233</arg0>
<arg0>F50234</arg0>
</ns1:unassignVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:unassignVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1221</return>
</ns2:unassignVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume EL0010's inuseStatus is In use</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's inuseStatus is In use</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 비동기 unformatVolume 호출은 볼륨에서 LTFS 포맷을 제거합니다. LTFS 볼륨을 포맷 취소하면 LTFS 포맷 헤더(메타 데이터 및 데이터 파티션)가 볼륨에서 제거되고 볼륨이 표준, 비LTFS 볼륨이 됩니다.
LTFS-LE 웹 서비스에는 확인이 필요하지 않으며 이 웹 서비스는 어떠한 볼륨 검증도 수행하지 않습니다. 하지만 볼륨이 포맷 취소되면 해당 볼륨의 모든 이전 데이터는 삭제됩니다. 사용자는 포맷 취소 중인 볼륨을 인지하여 올바른 볼륨이 포맷 취소되도록 해야 합니다.
사전 조건:
볼륨을 포맷 취소하기 전에 해당 볼륨이 오프라인이고, 지정되어 있지 않은지 확인합니다. 호환되는 드라이브를 사용할 수 있는지 확인합니다.
이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1, volser2, ...])
볼륨이 사전 조건에서 요구하는 상태에 있는지 확인합니다.
필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스 체인:
unformatVolume(volser)
getJobStatus(jobId) < poll each 10s until status is complete >
getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 더 이상 LTFS-LE 형식이 아니며 LTFS-LE 형식이 볼륨에서 제거됩니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨을 포맷 취소하기 전에 해당 볼륨이 라이브러리에 존재하지 않거나, 온라인 상태이거나, 지정되지 않았거나, 사용할 수 없으면 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 EL0010의 inuseStatus가 In use입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="http://sb.ejb.ws.mds.ltfsle.oracle/">
<env:Header>
<ns1:Security>
<ns1:UsernameToken>
<ns1:Username>username</ns1:Username>
<ns1:Password>password</ns1:Password>
</ns1:Security>
</env:Header>
<env:Body>
<ns1:unformatVolume>
<arg0>F50344</arg0>
</ns1:unformatVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:unformatVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1216</return>
</ns2:unformatVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume EL0010's inuseStatus is In use</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's inuseStatus is In use</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 비동기 호출은 볼륨에서 LTFS 형식을 제거합니다. LTFS 볼륨을 포맷 취소하면 LTFS 포맷 헤더(메타 데이터 및 데이터 파티션)가 볼륨에서 제거되고 볼륨이 표준, 비LTFS 볼륨이 됩니다.
unformatVolumeWithDrive (String volser, String drivesn)
사전 조건:
볼륨 및 드라이브가 라이브러리에 존재해야 합니다. 볼륨과 드라이브는 호환되어야 합니다. 볼륨이 지정되지 않았고, 오프라인 상태이며, 사용 가능해야 합니다. 드라이브는 유휴, 온라인 또는 사용 가능 상태여야 합니다.
이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1,volser2,...])
볼륨이 사전 조건에서 요구하는 상태에 있는지 확인합니다.
필요한 경우 진행하기 전에 수정 조치를 취합니다.
호출할 LTFS-LE 웹 서비스 체인:
unformatVolumeWithDrive(volser,drivesn) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 LTFS-LE로 포맷됩니다.
volser는 포맷 취소할 볼륨의 일련 번호입니다.
drivesn은 문자열 또는 숫자인 드라이브 일련 번호입니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨이 라이브러리에 존재하지 않거나, 오프라인이거나, 지정되지 않았거나, 사용 중이거나, 사용할 수 없는 경우 또는 드라이브가 볼륨과 호환되지 않거나 라이브러리에 있는 경우 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 EL0010의 inuseStatus가 In use입니다.
볼륨의 유형 LTO-5가 드라이브의 유형 T1C과 호환되지 않습니다.
드라이브 HP23112를 LTFS 라이브러리에서 찾을 수 없습니다.
드라이브 123456의 availableStatus가 In use입니다.
드라이브 123456의 onlineStatus가 Offline입니다.
드라이브 123456의 assignedStatus가 Unassigned입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:unformatVolumeWithDrive>
<arg0>F50344</arg0>
<arg1>576001000421</arg1>
</ns1:unformatVolumeWithDrive>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:unformatVolumeWithDriveResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1216</return>
</ns2:unformatVolumeWithDriveResponse>
</S:Body>
</S:Envelope>
<?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>The volume's type LTO-5 is not compatible with drive's type T1C</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume's type LTO-5 is not compatible with drive's type T1C</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>
이 API 함수는 LTFS-LE 기본 볼륨 풀에 있는 하나 이상의 LTFS-LE 볼륨을 원격 보관합니다. 한 번에 하나의 볼륨만 원격 보관할 수 있습니다.
이 비동기 호출은 CAP(메일슬롯)를 사용하여 최대 30개의 볼륨을 원격 보관합니다. 메일슬롯에는 4개의 볼륨을 위한 공간이 있습니다. 사용자가 30개의 볼륨을 원격 보관하는 경우 볼륨은 꺼내기가 모두 완료될 때까지 한 번에 4개씩 메일슬롯으로 보내집니다.
vaultVolume(String[] volsers,String acs,String lsm,String cap)
사전 조건:
원격 보관하기 전에 CAP를 사용할 수 있으며 볼륨이 마무리되었고 오프라인 상태인지 확인합니다. 총 볼륨 수는 30개보다 적거나 같아야 합니다. 볼륨은 구성된 라이브러리와 동일한 라이브러리에 있어야 합니다. 이를 위해 다음을 수행합니다.
다음과 같이 볼륨 상태를 얻습니다.
getVolumeInfoByVolser([volser1,volser2,...])
볼륨이 온라인이고 지정된 상태이면 다음과 같이 볼륨을 마무리합니다.
finalizeVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
볼륨이 온라인 상태이면 vaultVolume API 호출을 실행하기 전에 다음과 같이 볼륨을 오프라인으로 전환합니다.
offlineVolume(volser) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
호출할 LTFS-LE 웹 서비스 체인:
vaultVolume([volser1,volser2,...],acs,lsm,cap) getJobStatus(jobId) < poll each 10s until status is complete > getJobResult(jobId)
사후 조건:
일련의 웹 서비스 호출이 실행되면 결과가 XML 문서로 만들어집니다. 이 XML 문서를 적절한 반환 코드로 변환해야 합니다. 이 API 호출이 성공하면 볼륨이 라이브러리에 넣어집니다. 사용자는 라이브러리로 걸어가서 CAP 도어를 연 후 볼륨을 가져와야 합니다.
volser는 원격 보관할 볼륨의 볼륨 일련 번호입니다.
acs는 라이브러리 ACS 식별자입니다.
lsm은 라이브러리 LSM 식별자입니다.
cap는 볼륨을 꺼내는 데 사용할 라이브러리 CAP(메일슬롯) ID입니다.
jobId는 작업 상태 및 결과를 검색하는 데 사용할 작업 ID입니다.
ValidationFailedException
예외는 다음과 같은 경우 발생할 수 있습니다.
volser 일련 번호가 입력되지 않은 경우 "The parameter volsers is null" 예외가 발생합니다.
볼륨을 원격 보관하기 전에 해당 볼륨이 라이브러리에 존재하지 않거나, 온라인 상태이거나, 지정되지 않았거나, 풀에 속하지 않거나, 사용할 수 없으면 사용 가능한 상태에서 "volume [volume sn] status is []"라는 검증 실패 예외가 발생합니다.
예를 들어 다음과 같습니다.
볼륨 EL0010을 LTFS 라이브러리에서 찾을 수 없습니다.
볼륨 SL0010의 onlineStatus가 Online입니다.
볼륨 SL0010의 assignedStatus가 Unassigned입니다.
볼륨 SL0010의 availableStatus가 Unavailable입니다.
볼륨 EL0010의 inuseStatus가 In use입니다.
<?xml version = '1.0' encoding = 'UTF-8'?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1
="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:vaultVolume>
<arg0>F50234</arg0>
<arg0>F50233</arg0>
<arg1>3</arg1>
<arg2>0</arg2>
<arg3>1</arg3>
</ns1:vaultVolume>
</env:Body>
</env:Envelope>
<?xml version = '1.0' encoding = 'UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
-secext-1.0.xsd" S:mustUnderstand="true">
<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<wsu:Created>2014-06-17T14:36:36Z</wsu:Created>
<wsu:Expires>2014-06-17T14:37:36Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</S:Header>
<S:Body>
<ns2:vaultVolumeResponse xmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<return>1214</return>
</ns2:vaultVolumeResponse>
</S:Body>
</S:Envelope>
<?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>The volume EL0010's inuseStatus is In use</ns3:Text>
</ns3:Reason>
<ns3:Detail>
<ns2:ValidationFailedExceptionxmlns:ns2="http://sb.ejb.ws.mds.ltfsle.oracle/">
<message>The volume EL0010's inuseStatus is In use</message>
</ns2:ValidationFailedException>
</ns3:Detail>
</ns3:Fault>
</S:Body>
</S:Envelope>