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

비동기 메서드

기여자

일부 API 메서드는 비동기식이므로 메서드가 반환될 때 수행하는 작업이 완료되지 않을 수 있습니다. 비동기 메서드는 작업의 상태를 확인하기 위해 쿼리할 수 있는 핸들을 반환합니다. 일부 작업의 상태 정보에는 완료율이 포함될 수 있습니다.

비동기 작업을 쿼리할 때 그 결과는 다음 형식 중 하나일 수 있습니다.

  • DriveAdd: 시스템이 클러스터에 드라이브를 추가하고 있습니다.

  • BulkVolume: 시스템이 백업 또는 복구와 같은 볼륨 간 복제 작업을 수행하고 있습니다.

  • Clone: 시스템이 볼륨을 복제하는 중입니다.

  • DriveRemoval: 시스템이 클러스터에서 드라이브를 제거하기 위해 드라이브에서 데이터를 복사하는 중입니다.

  • RtfiPendingNode: 시스템이 클러스터에 추가하기 전에 호환되는 소프트웨어를 노드에 설치하고 있습니다.

참고 비동기 메서드를 사용하거나 실행 중인 비동기 작업의 상태를 가져올 때는 다음 사항을 유의하십시오.

  • 비동기 메서드는 개별 메서드 설명서에 나와 있습니다.

  • 비동기 메서드는 "asyncHandle"을 반환합니다. 이 핸들은 발급하는 API 메서드에서 알려진 핸들입니다. 핸들을 사용하여 비동기 작업의 상태 또는 결과를 폴링할 수 있습니다.

  • GetAsyncResult 메서드를 사용하여 개별 비동기 메서드의 결과를 얻을 수 있습니다. GetAsyncResult 를 사용하여 완료된 작업을 쿼리하면 시스템에서 결과를 반환하고 자동으로 시스템에서 결과를 제거합니다. GetAsyncResult 를 사용하여 완료되지 않은 작업을 쿼리하면 시스템에서 결과를 반환하지만 제거하지는 않습니다.

  • ListAsyncResults 메서드를 사용하여 실행 중이거나 완료된 모든 비동기 메서드의 상태와 결과를 얻을 수 있습니다. 이 경우 시스템은 완료된 작업에 대한 결과를 제거하지 않습니다.