Skip to main content
Element Software
이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

GetAsyncResult 를 참조하십시오

기여자
PDF

를 사용하여 비동기 메서드 호출의 결과를 검색할 수 GetAsyncResult 있습니다. 일부 메서드 호출은 실행하는 데 약간의 시간이 필요하며 시스템이 초기 응답을 보낼 때 완료되지 않을 수 있습니다. 메서드 호출의 상태 또는 결과를 가져오려면 을 사용하여 GetAsyncResult 메서드에서 반환된 asyncHandle 값을 폴링합니다.

GetAsyncResult 작업의 전체 상태(진행 중, 완료 또는 오류)를 표준 방식으로 반환합니다. 그러나 작업에 대해 반환되는 실제 데이터는 원래 메서드 호출에 따라 달라지며 반환 데이터는 각 메서드와 함께 문서화됩니다.

keepResult 매개 변수가 없거나 false 이면 결과가 반환될 때 asyncHandle 이 비활성화되고 나중에 asyncHandle 에서 오류를 반환하도록 쿼리를 시도합니다. keepResult 매개 변수를 true 로 설정하여 이후의 쿼리에 대해 asyncHandle 을 활성 상태로 유지할 수 있습니다.

매개 변수

이 메서드에는 다음과 같은 입력 매개 변수가 있습니다.

이름 설명 유형 기본값 필수 요소입니다

asyncHandle

원래 비동기 메서드 호출에서 반환된 값입니다.

정수

없음

예

keepResult(keepResult)

true 인 경우 GetAsyncResult 는 반환 시 비동기 결과를 제거하지 않으므로 나중에 해당 asyncHandle 에 쿼리를 실행할 수 있습니다.

부울

거짓

아니요

반환 값

이 메서드의 반환 값은 다음과 같습니다.

이름 설명 유형

상태

비동기 메서드 호출의 상태입니다. 가능한 값:

  • 실행 중: 메소드가 여전히 실행 중입니다.

  • 완료: 메서드가 완료되고 결과 또는 오류를 사용할 수 있습니다.

문자열

결과

비동기 메서드가 성공적으로 완료되면 비동기 작업의 결과입니다. 비동기 작업이 실패한 경우 이 멤버는 존재하지 않습니다.

문자열

오류

상태가 완료이고 비동기 메서드가 실패한 경우 이 멤버는 오류 세부 정보를 포함합니다. 비동기 작업이 성공하면 이 멤버가 없습니다.

문자열

결과 유형

비동기 메서드 호출이 수행 중이거나 수행 중인 작업의 유형입니다.

문자열

세부 정보

상태가 Running 인 경우 이 멤버는 메서드의 현재 작업과 관련된 정보를 포함합니다. 비동기 메서드가 실행되고 있지 않으면 이 멤버가 없습니다.

JSON 개체

createTime(createTime)

비동기 메서드가 호출된 시간(UTC + 0 형식).

ISO 8601 날짜 문자열

마지막 업데이트 시간

비동기 메서드의 상태가 마지막으로 업데이트된 시간(UTC + 0 형식)

ISO 8601 날짜 문자열

  • 참고: * GetAsyncResult 의 반환 값은 기본적으로 추가 상태 필드가 있는 표준 JSON 응답의 중첩 버전입니다.

요청 예

이 메서드에 대한 요청은 다음 예제와 비슷합니다.

{
  "method": "GetAsyncResult",
  "params": {
      "asyncHandle" : 389
},
"id" : 1
}

응답 예: 메서드 오류

이 메서드는 다음 예제와 유사한 응답을 반환합니다.

{
   "error": {
      "code": 500,
      "message": "DBClient operation requested on a non-existent path at [/asyncresults/1]",
      "name": "xDBNoSuchPath"
   },
   "id": 1
}

"response"가 GetAsyncResult 호출의 JSON 응답 개체인 경우 "response.error"는 GetAsyncResult 메서드 자체의 오류(예: 존재하지 않는 asyncHandle 쿼리)에 해당합니다.

응답 예: 비동기 작업 오류

이 메서드는 다음 예제와 유사한 응답을 반환합니다.

{
   "id": 1,
   "result": {
     "createTime": "2016-01-01T02:05:53Z",
     "error": {
       "bvID": 1,
       "message": "Bulk volume job failed",
       "name": "xBulkVolumeScriptFailure",
       "volumeID": 34
     },
     "lastUpdateTime": "2016-01-21T02:06:56Z",
     "resultType": "BulkVolume",
     "status": "complete"
   }
}

"respongse.result.error" 는 원래 메서드 호출의 오류 결과에 해당합니다.

응답 예: 비동기 작업 성공

이 메서드는 다음 예제와 유사한 응답을 반환합니다.

{
   "id": 1,
   "result": {
     "createTime": "2016-01-01T22:29:18Z",
     "lastUpdateTime": "2016-01-01T22:45:51Z",
     "result": {
       "cloneID": 25,
       "message": "Clone complete.",
       "volumeID": 47
     },
     "resultType": "Clone",
     "status": "complete"
   }
}

"respongse.result.result" 는 호출이 성공적으로 완료된 경우 원래 메서드 호출에 대한 반환 값입니다.

버전 이후 새로운 기능

9.6