Memulai ulang resource persisten

Anda dapat memulai ulang resource persisten yang memiliki status RUNNING atau ERROR. Dengan memulai ulang resource persisten, Anda dapat pulih dari error yang tidak dapat dipulihkan oleh resource persisten. Anda juga dapat memulai ulang resource persisten untuk mendapatkan cluster terbaru secara manual. Halaman ini menunjukkan cara memulai ulang resource persisten menggunakan Konsol Google Cloud dan REST API.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk memulai ulang resource persisten, minta administrator untuk memberi Anda peran IAM Vertex AI Administrator (roles/aiplatform.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditentukan ini berisi izin aiplatform.persistentResources.update, yang diperlukan untuk memulai ulang resource persisten.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Memulai ulang resource persisten

Pilih salah satu tab berikut untuk mendapatkan petunjuk tentang cara memulai ulang resource persisten. Pastikan tidak ada tugas pelatihan yang berjalan pada resource persisten.

Konsol

Untuk memulai ulang resource persisten di Konsol Google Cloud, lakukan langkah berikut:

1. Di konsol Google Cloud, buka halaman Persistent resources.

   Buka Resource persisten

2. Di samping nama resource persisten yang ingin Anda mulai ulang, klik elips vertikal ().

3. Klik Reboot.

4. Klik Confirm.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID resource persisten yang ingin Anda mulai ulang.
• LOCATION: Region dari resource persisten yang ingin Anda mulai ulang.
• PERSISTENT_RESOURCE_ID: ID resource persisten yang ingin Anda mulai ulang.

Metode HTTP dan URL:

POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID:reboot

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID:reboot"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID:reboot" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

response: 
  {
    "name": "projects/123456789012/locations/us-central1/persistentResources/test-persistent-resource/operations/1234567890123456789",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.RebootPersistentResourceOperationMetadata",
      "genericMetadata": {
        "createTime": "2024-03-18T17:31:54.955004Z",
        "updateTime": "2024-03-18T17:31:55.204817Z",
        "state": "RUNNING",
        "worksOn": [
          "projects/123456789012/locations/us-central1/persistentResources/test-persistent-resource"
        ]
      },
      "progressMessage": "Waiting for persistent resource shut down."
    }
  }

Memulai ulang resource persisten merupakan operasi yang berjalan lama, dan resource persisten tidak dapat dihapus. Operasi tersebut berisi kolom progressMessage yang akan diisi dengan status error jika terjadi. Setelah operasi menunjukkan "done: true", periksa status resource persisten. Jika resource persisten berada dalam status RUNNING, mulai ulang akan berhasil dan resource tersebut siap menjalankan tugas pelatihan.

Batasan

Berikut adalah batasan untuk memulai ulang resource persisten:

• Dalam beberapa kasus, Anda dapat kehilangan kapasitas resource yang langka saat memulai ulang resource persisten. Retensi resource penuh tidak dijamin.
• Mulai ulang tidak tersedia di Ray di Vertex AI.
• Resource persisten yang berisi kumpulan pekerja yang diskalakan otomatis akan dimulai ulang dengan jumlah replika minimum.

Langkah selanjutnya

• Mempelajari resource persisten.
• Membuat dan menggunakan resource persisten.
• Menjalankan tugas pelatihan pada resource persisten.
• Mendapatkan informasi tentang resource persisten.
• Menghapus resource persisten.