Mengelola operasi yang berjalan lama

Halaman ini menjelaskan cara memeriksa dan mengelola operasi yang berjalan lama di Certificate Manager.

Jika permintaan mutasi di Certificate Manager, seperti membuat, memperbarui, atau menghapus resource, tidak langsung gagal, API akan menampilkan operasi yang berjalan lama (LRO). Operasi ini melacak status tugas pemrosesan yang memerlukan waktu lebih lama untuk diselesaikan. Secara default, perintah mutasi gcloud menunggu operasi selesai, kecuali jika Anda menentukan flag --async.

Anda dapat menggunakan koleksi projects.locations.operations untuk memeriksa status operasi.

Izin yang diperlukan

Untuk mengelola operasi yang berjalan lama di project target, Anda harus memiliki izin yang sesuai dengan tugas yang ingin Anda lakukan:

  • certificatemanager.operations.get: mengambil detail operasi tertentu.
  • certificatemanager.operations.list: mencantumkan semua operasi di lokasi tertentu.
  • certificatemanager.operations.delete: menghapus resource operasi yang telah selesai (khusus API).

Untuk mengetahui informasi selengkapnya tentang peran dan izin, lihat Peran dan izin.

Mendapatkan detail tentang operasi yang berjalan lama

Saat Anda melakukan panggilan yang memulai operasi, seperti membuat sertifikat, responsnya akan berisi nama operasi dalam format: projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID.

Untuk memeriksa apakah operasi telah selesai, minta detail tentang operasi target. Jika respons berisi "done": false atau tidak menyertakan kolom "done", operasi masih berlangsung. Periksa kembali statusnya hingga respons menampilkan "done": true.

gcloud

Untuk mendeskripsikan operasi yang berjalan lama, gunakan perintah certificate-manager operations describe:

gcloud certificate-manager operations describe OPERATION_ID \
    --location="LOCATION"

Ganti kode berikut:

  • OPERATION_ID: ID operasi.
  • LOCATION: lokasi Google Cloud target. Lokasi defaultnya adalah global.

API

Untuk mendapatkan detail tentang operasi yang berjalan lama, kirim permintaan GET ke metode projects.locations.operations.get:

GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: lokasi Google Cloud target. Lokasi defaultnya adalah global.
  • OPERATION_ID: ID operasi.

Membuat daftar operasi yang berjalan lama

Anda dapat mencantumkan operasi untuk menemukan ID operasi dan memantau modifikasi aktif dalam project Anda.

gcloud

Untuk mencantumkan operasi di lokasi tertentu, gunakan perintah certificate-manager operations list:

gcloud certificate-manager operations list \
    --location="LOCATION"

Ganti kode berikut:

  • LOCATION: lokasi Google Cloud target. Lokasi defaultnya adalah global.

API

Untuk mencantumkan operasi di suatu lokasi, buat permintaan GET ke metode projects.locations.operations.list:

GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: lokasi Google Cloud target. Lokasi defaultnya adalah global.

Menghapus operasi yang berjalan lama dan telah selesai

Anda dapat menghapus resource operasi yang telah selesai jika tidak lagi memerlukan hasilnya. Menghapus operasi yang telah selesai hanya akan menghapus data operasi dan tidak membatalkan atau mengurungkan perubahan yang dibuat oleh operasi tersebut.

Anda tidak dapat menghapus operasi menggunakan perintah gcloud. Sebagai gantinya, gunakan REST API.

API

Untuk menghapus operasi yang telah selesai, kirim permintaan DELETE ke metode projects.locations.operations.delete:

DELETE https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: lokasi Google Cloud target. Lokasi defaultnya adalah global.
  • OPERATION_ID: ID operasi.

Kebijakan retensi

Certificate Manager otomatis mempertahankan dan menghapus LRO yang telah selesai sesuai dengan aturan berikut, berdasarkan urutan prioritas:

  1. Kurang dari 1 jam: jika operasi selesai kurang dari 1 jam yang lalu, Certificate Manager akan mempertahankan operasi tersebut.
  2. Lebih dari 1 minggu: jika operasi selesai lebih dari 1 minggu yang lalu, Certificate Manager akan menghapus operasi tersebut.
  3. Batas maksimum: jika operasi selesai antara 1 jam dan 1 minggu yang lalu, Certificate Manager akan mempertahankan hingga 5.000 operasi terbaru yang telah selesai di setiap project dan menghapus operasi lama yang telah selesai.

Contoh berikut menunjukkan cara penerapan aturan ini:

  • Jika project Anda memiliki 10.000 operasi yang telah selesai dan semuanya berusia kurang dari 1 jam, Certificate Manager akan mempertahankan 10.000 operasi tersebut.
  • Jika project Anda memiliki 1.000 operasi yang telah selesai dan semuanya berusia lebih dari 1 minggu, Certificate Manager akan menghapus 1.000 operasi tersebut.
  • Jika project Anda memiliki 10.000 operasi yang telah selesai dan semuanya berusia antara 1 jam hingga 1 minggu, Certificate Manager hanya akan mempertahankan 5.000 operasi terbaru.