Untuk beberapa panggilan API, Vertex AI akan menampilkan nama operasi. Panggilan API ini memulai operasi yang memerlukan waktu untuk diselesaikan dan dikenal sebagai operasi yang berjalan lama. Misalnya, membuat set data, menghapus endpoint, atau mengekspor model merupakan operasi yang berjalan lama. Anda dapat menggunakan metode helper bersama dengan nama operasi untuk mendapatkan status atau membatalkan operasi yang berjalan lama, seperti yang dijelaskan di bagian berikut ini.
Mendapatkan status operasi
Untuk mendapatkan status operasi, gunakan nama operasi yang ada dalam respons
saat Anda meminta operasi yang berjalan lama. Misalnya, saat Anda membuat
set data, Vertex AI akan menampilkan nama operasi seperti:
projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID
Anda dapat memeriksa operasi secara berkala agar mengetahui kapan operasi tersebut selesai.
REST
Sebelum menggunakan salah satu data permintaan, buat pengganti berikut ini:
- OPERATION_NAME: Nama operasi yang ditampilkan saat Anda
memulai operasi yang berjalan lama, seperti
projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID
Metode HTTP dan URL:
GET https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content
Dalam output, objek metadata
berisi informasi yang
khusus untuk jenis permintaan tersebut. Kolom done
menunjukkan apakah
operasi tersebut telah selesai. Jika operasi selesai, objek response
akan berisi hasil dari operasi tersebut.
{ "name": "projects/123456789012/locations/us-central1/datasets/1234567890123456789/operations/1223344556677889900", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateDatasetOperationMetadata", "genericMetadata": { "createTime": "2020-10-12T16:00:44.686500Z", "updateTime": "2020-10-12T16:01:06.115081Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.Dataset", "name": "projects/123456789012/locations/us-central1/datasets/1234567890123456789", "displayName": "image_dataset", "metadataSchemaUri": "gs://google-cloud-aiplatform/schema/dataset/metadata/image_1.0.0.yaml", "labels": { "aiplatform.googleapis.com/dataset_metadata_schema": "IMAGE" }, "metadata": { "dataItemSchemaUri": "gs://google-cloud-aiplatform/schema/dataset/dataitem/image_1.0.0.yaml" } } }
Membatalkan Operasi
Anda dapat membatalkan operasi yang berjalan lama agar dapat menghentikannya sebelum
operasi tersebut selesai. Jika Anda berhasil membatalkan operasi, operasi tersebut
tidak akan dihapus; sebagai gantinya, operasi akan berhenti dengan kode error 1
, dan
dengan pesan CANCELLED
. Perlu diketahui bahwa pembatalan tidak dijamin akan
berhasil.
REST
Sebelum menggunakan salah satu data permintaan, buat pengganti berikut ini:
- OPERATION_NAME: Nama operasi yang ditampilkan saat Anda
memulai operasi yang berjalan lama, seperti
projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID
Metode HTTP dan URL:
POST https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME:cancel
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME:cancel"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/OPERATION_NAME:cancel" | Select-Object -Expand Content
Anda akan menerima kode status yang berhasil (2xx), serta respons yang kosong.