이 페이지에서는 Cloud Storage에서 메서드 호출을 사용하여 시작되는 장기 실행 작업을 사용하는 방법을 설명합니다. 장기 실행 작업에서 수행할 수 있는 요청을 포함하여 장기 실행 작업의 시맨틱스에 대한 자세한 내용은 기능별 문서를 참조하세요.
장기 실행 작업을 관리하는 방법에 대한 일반적인 정보는 gcloud storage operations 문서를 참조하세요.
장기 실행 작업 세부정보 가져오기
장기 실행 작업의 세부정보를 가져오거나 상태를 확인하려면 gcloud storage operations describe 명령어를 사용합니다.
gcloud storage operations describe projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID
다음과 같이 바꿉니다.
BUCKET_NAME: 장기 실행 작업이 포함된 버킷의 이름입니다. 예를 들면my-bucket입니다.OPERATION_ID: 호출하는 메서드에 대한 응답으로 반환되는 장기 실행 작업의 ID입니다. 예를 들어gcloud storage restore를 호출하면 다음과 같은 응답이 반환되고 장기 실행 작업 ID는BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP입니다.Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
버킷의 장기 실행 작업 나열
버킷의 장기 실행 작업을 나열하려면 gcloud storage operations list 명령어를 사용합니다.
gcloud storage operations list gs://BUCKET_NAME
다음과 같이 바꿉니다.
BUCKET_NAME: 장기 실행 작업이 포함된 버킷의 이름입니다. 예를 들면my-bucket입니다.
장기 실행 작업 취소
장기 실행 작업을 취소하려면 gcloud storage operations cancel 명령어를 사용합니다.
gcloud storage operations cancel projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID
다음과 같이 바꿉니다.
BUCKET_NAME: 장기 실행 작업이 포함된 버킷의 이름입니다. 예를 들면my-bucket입니다.OPERATION_ID: 호출하는 메서드에 대한 응답으로 반환되는 장기 실행 작업의 ID입니다. 예를 들어gcloud storage restore를 호출하면 다음과 같은 응답이 반환되고 장기 실행 작업 ID는BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP입니다.Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP
오류 처리
장기 실행 작업은 비동기식 API에서 시작되며 동기식 API와 다른 오류 처리 방법이 필요합니다. 동기식 API와 달리 비동기 API 호출에 대한 응답은 장기 실행 작업이 결국 실패하더라도 성공을 나타낼 수 있습니다. 응답 헤더에 반환되는 상태 코드에 의존하는 대신 응답 본문의 장기 실행 작업 메타데이터를 파싱하여 API 호출이 성공했는지를 확인합니다.
예를 들어 소프트 삭제 일괄 복원 요청을 수행하면 작업 진행 중 오류가 발생하더라도 성공한 HTTP 상태 코드(200 OK)가 반환됩니다. 일괄 복원 작업이 성공했는지 확인하려면 장기 실행 작업의 상태를 가져옵니다.
장기 실행 작업 API(Get, List, Cancel)는 동기식이며 일반적인 오류를 반환합니다.