Operasi yang berjalan lama

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.