Menggunakan operasi yang berjalan lama di Cloud Storage

Halaman ini menjelaskan cara menggunakan operasi yang berjalan lama yang dimulai dari penggunaan panggilan metode di Cloud Storage. Untuk informasi mendetail tentang semantik operasi yang berjalan lama, termasuk permintaan mana yang dapat dilakukan pada operasi yang berjalan lama, baca dokumentasi khusus fitur.

Untuk informasi umum tentang cara mengelola operasi yang berjalan lama, lihat dokumentasi gcloud storage operations.

Mendapatkan detail operasi yang berjalan lama

Untuk mendapatkan detail atau memeriksa status operasi yang berjalan lama, gunakan perintah gcloud storage operations describe:

gcloud storage operations describe projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Ganti:

  • BUCKET_NAME dengan nama bucket yang berisi operasi yang berjalan lama. Contoh, my-bucket.

  • OPERATION_ID dengan ID operasi yang berjalan lama, yang ditampilkan sebagai respons metode yang Anda panggil. Misalnya, respons berikut ditampilkan dari panggilan gcloud storage restore dan ID operasi yang berjalan lama adalah BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP:

    Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP

Mencantumkan operasi yang berjalan lama dalam bucket

Untuk menampilkan daftar operasi yang berjalan lama di bucket, gunakan perintah gcloud storage operations list:

gcloud storage operations list gs://BUCKET_NAME

Ganti:

  • BUCKET_NAME dengan nama bucket yang berisi operasi yang berjalan lama. Contoh, my-bucket.

Membatalkan operasi yang berjalan lama

Untuk membatalkan operasi yang berjalan lama, gunakan perintah gcloud storage operations cancel:

gcloud storage operations cancel projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Ganti:

  • BUCKET_NAME dengan nama bucket yang berisi operasi yang berjalan lama. Contoh, my-bucket.

  • OPERATION_ID dengan ID operasi yang berjalan lama, yang ditampilkan sebagai respons metode yang Anda panggil. Misalnya, respons berikut ditampilkan dari panggilan gcloud storage restore dan ID operasi yang berjalan lama adalah BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP:

    Created: projects/_/buckets/my-bucket/operations/BcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_lvnSocj_-jP

Penanganan error

Operasi yang berjalan lama dimulai dari API asinkron dan memerlukan praktik penanganan error yang berbeda dengan API sinkron. Tidak seperti API sinkron, respons terhadap panggilan API asinkron dapat menunjukkan keberhasilan meskipun operasi yang berjalan lama pada akhirnya gagal. Daripada mengandalkan kode status yang ditampilkan di header respons, Anda harus mengurai metadata operasi yang berjalan lama dalam isi respons untuk menentukan apakah panggilan API berhasil.

Misalnya, jika Anda mengajukan permintaan pemulihan massal penghapusan sementara, permintaan tersebut akan menampilkan kode status HTTP yang berhasil (200 OK) meskipun terjadi error selama operasi tersebut. Untuk memeriksa apakah operasi pemulihan massal berhasil, dapatkan status operasi yang berjalan lama.

Perlu diperhatikan bahwa API operasi yang berjalan lama (Get, List, Cancel) bersifat sinkron dan menampilkan error normal.