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 panggilangcloud storage restore
dan ID operasi yang berjalan lama adalahBcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_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 panggilangcloud storage restore
dan ID operasi yang berjalan lama adalahBcazhBlHv2uZwnlh1UdamOfKbpVpb67drEwVoI2hlkE1e0eaXqw7fPBWP0802TJry4pInGC4h3wxtOi31RmpCC_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.