Menetapkan lokasi penyimpanan default menggunakan setelan snapshot

Saat Anda membuat snapshot, Google Cloud akan menggunakan nilai default bawaan untuk opsi konfigurasi, kecuali jika Anda secara eksplisit memberikan nilai berbeda. Setelan snapshot adalah parameter konfigurasi terpusat pada level project yang memungkinkan Anda menyesuaikan lokasi default tempat Google Cloud menyimpan snapshot Anda. Dengan menggunakan setelan snapshot untuk menentukan default kustom Anda sendiri, Anda tidak perlu menentukan lokasi secara manual selama setiap pembuatan snapshot.

Dokumen ini memberikan informasi tentang setelan snapshot dan cara menggunakannya untuk menyesuaikan lokasi penyimpanan default untuk snapshot project Anda.

Sebelum memulai

  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init
    2. Menetapkan region dan zona default.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init

Batasan

  • Anda dapat melihat dan memperbarui setelan snapshot hanya dengan menggunakan gcloud CLI atau REST.
  • Anda tidak dapat menyesuaikan lokasi penyimpanan default instant snapshot. Anda hanya dapat melakukannya untuk snapshot arsip dan standar.
  • Mengubah kebijakan lokasi di setelan snapshot project Anda hanya memengaruhi snapshot yang dibuat setelah modifikasi tersebut. Mengupdate setelan snapshot project Anda tidak akan mengubah lokasi snapshot yang ada.
  • Jika Anda menentukan lokasi secara manual selama pembuatan snapshot, Google Cloud akan mengganti setelan snapshot dan membuat snapshot Anda di lokasi yang baru ditentukan tersebut. Namun, kebijakan lokasi penyimpanan di setelan snapshot Anda tidak berubah.

Cara kerja setelan snapshot

Kebijakan lokasi penyimpanan setelan snapshot project menentukan tempat Google Cloud menyimpan snapshot project tersebut secara otomatis. Google Cloud mempertahankan nilai bbawaan untuk kebijakan lokasi penyimpanan ini hingga Anda mengupdate setelan snapshot dan mengonfigurasi default baru. Setelah Anda mengupdate setelan snapshot dan menetapkan lokasi penyimpanan default baru, Google Cloud menggunakan lokasi ini untuk menyimpan setiap snapshot baru yang dibuat dalam project tersebut.

Anda dapat mengupdate setelan snapshot untuk mengubah kebijakan lokasi penyimpanan berapa kali. Namun, mengubah setelan snapshot project Anda hanya memengaruhi lokasi snapshot yang dibuat setelah modifikasi tersebut. Mengupdate setelan snapshot project Anda tidak akan mengubah lokasi snapshot yang ada.

Untuk memastikan Google Cloud menggunakan lokasi penyimpanan yang ditentukan oleh setelan snapshot Anda, jangan tentukan lokasi secara manual selama pembuatan snapshot. Jika Anda menentukan lokasi secara manual selama pembuatan snapshot, Google Cloud akan mengganti setelan snapshot dan membuat snapshot Anda di lokasi yang baru ditentukan tersebut. Namun, kebijakan lokasi penyimpanan di setelan snapshot Anda tidak berubah.

Anda dapat menggunakan setelan snapshot untuk menyesuaikan lokasi penyimpanan default snapshot arsip dan standar. Anda tidak dapat menyesuaikan lokasi penyimpanan default instant snapshot.

Opsi lokasi penyimpanan

Saat mengonfigurasi setelan snapshot project dan menentukan lokasi penyimpanan default baru, Anda dapat memilih region tertentu atau menggunakan setelan lokasi berbasis disk. Lebih khususnya, Anda dapat memilih salah satu opsi lokasi berikut untuk kebijakan lokasi penyimpanan Anda:

  • Multi-region terdekat dengan disk sumber
  • Region lokal yang sama dengan disk sumber
  • Region tertentu pilihan Anda

Kebijakan lokasi penyimpanan yang telah ditetapkan Google Cloud

Sampai Anda mengupdate setelan snapshot untuk pertama kalinya, Google Cloud akan mempertahankan nilai bawaan untuk kebijakan lokasi penyimpanan. Kebijakan bawaan ini berisi lokasi penyimpanan default untuk snapshot hingga Anda mengonfigurasi lokasi penyimpanan default Anda sendiri dengan mengupdate setelan snapshot project Anda. Kebijakan lokasi penyimpanan bawaan disetel ke multi-region yang secara geografis paling dekat dengan lokasi disk sumber Anda.

  • Jika disk sumber Anda berada di lokasi yang merupakan bagian dari multi-region, maka kebijakan lokasi penyimpanan setelan snapshot Anda akan ditetapkan ke multi-region tersebut. Misalnya, jika disk Anda berada di lokasi seperti us-central1, maka lokasi penyimpanan defaultnya adalah us multi-region.
  • Untuk lokas yang berada di luar multi-region, lokasi penyimpanan default adalah multi-region yang terdekat secara geografis di luar region tersebut. Untuk lokasi seperti australia-southeast1, lokasi default menjadi multi-region asia.

Implikasi harga

Anda tidak perlu membayar biaya tambahan untuk menggunakan setelan snapshot pada project Anda. Namun, nilai lokasi yang Anda tentukan menggunakan setelan snapshot memengaruhi operasi lain, yang dapat memengaruhi biaya operasional tersebut.

Menetapkan lokasi penyimpanan default untuk project menggunakan setelan snapshot

Anda dapat memperbarui setelan snapshot project dan menetapkan lokasi penyimpanan default baru menggunakan REST dan gcloud CLI.

Jika Anda tidak menetapkan kebijakan lokasi penyimpanan di setelan snapshot, maka snapshot Anda akan dibuat menggunakan kebijakan lokasi penyimpanan bawaan Google Cloud.

gcloud

Untuk menambahkan setelan snapshot atau memperbarui setelan snapshot yang ada untuk project Anda, gunakan perintah gcloud compute snapshot-settings update:

  gcloud compute snapshot-settings update \
      --project=PROJECT_ID \
      --storage-location-policy=STORAGE_LOCATION \
      --storage-location-names=REGION_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project.

  • STORAGE_LOCATION: Kebijakan lokasi penyimpanan snapshot untuk project Anda. Nilainya bisa berupa salah satu dari berikut:

    • nearest-multi-region: Menentukan kebijakan lokasi sebagai multi-region Cloud Storage terdekat dengan lokasi disk Anda.
    • local-region: Menentukan kebijakan lokasi sebagai region Cloud Storage yang sama dengan tempat disk Anda berada.
    • specific-locations: Menentukan kebijakan lokasi sebagai lokasi region Cloud Storage kustom pilihan Anda. Jika menentukan opsi ini, Anda juga harus menentukan lokasi yang diinginkan dengan menggunakan tanda --storage-location-names.

  • REGION_NAME: Opsional: Jika Anda menyertakan flag --storage-location-policy dengan nilai specific-locations, Anda harus menentukan region Cloud Storage. Anda hanya dapat menentukan satu wilayah. Tetapkan nilai ini ke nama region yang ingin ditetapkan sebagai kebijakan lokasi penyimpanan Anda.

Contoh untuk menetapkan kebijakan lokasi penyimpanan menggunakan setelan snapshot

Pertimbangkan contoh project my-project di region us-central1.

  • Untuk mengonfigurasi kebijakan lokasi penyimpanan setelan snapshot project Anda sebagai multi-region Cloud Storage yang terdekat dengan disk Anda, jalankan perintah berikut:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=nearest-multi-region
  • Untuk mengonfigurasi kebijakan lokasi penyimpanan setelan snapshot project Anda sebagai region Cloud Storage yang sama dengan disk Anda, jalankan perintah berikut:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=local-region
  • Untuk mengonfigurasi sebagai kebijakan lokasi penyimpanan setelan snapshot project Anda sebagai lokasi spesifik pilihan Anda (seperti us-central1), gunakan flag --storage-location-names dan jalankan perintah berikut:
  gcloud compute snapshot-settings update \
      --project=my-project \
      --storage-location-policy=specific-locations \
      --storage-location-names=us-central1

REST

Untuk menambahkan setelan snapshot atau mengupdate setelan snapshot yang ada untuk project Anda, buat permintaan PATCH ke metode snapshotSettings.update:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

  {
    "storageLocation": {
      "policy": "STORAGE_LOCATION",
      "locations": {
            "REGION_NAME": { "name": "REGION_NAME" }
      }
    }
  }

Ganti kode berikut:

  • PROJECT_ID: ID project.

  • STORAGE_LOCATION: Kebijakan lokasi penyimpanan snapshot untuk project Anda. Nilainya bisa berupa salah satu dari berikut:

    • NEAREST_MULTI_REGION: Menentukan kebijakan lokasi sebagai multi-region Cloud Storage terdekat dengan lokasi disk Anda.
    • LOCAL_REGION: Menentukan kebijakan lokasi sebagai region Cloud Storage yang sama dengan tempat disk Anda berada.
    • SPECIFIC_LOCATIONS: Menentukan kebijakan lokasi sebagai lokasi region Cloud Storage kustom pilihan Anda. Jika menentukan opsi ini, Anda juga harus menentukan lokasi yang Anda inginkan dengan menggunakan parameter locations dalam permintaan Anda.

  • REGION_NAME: Opsional: Jika Anda menyertakan parameter policy dengan nilai SPECIFIC_LOCATIONS, Anda harus menentukan region Cloud Storage. Anda hanya dapat menentukan satu wilayah. Tetapkan nilai ini ke nama region yang ingin ditetapkan sebagai kebijakan lokasi penyimpanan Anda.

Contoh untuk menetapkan kebijakan lokasi penyimpanan menggunakan setelan snapshot

Pertimbangkan contoh project my-project di region us-central1.

  • Untuk mengonfigurasi kebijakan lokasi penyimpanan di setelan snapshot project Anda sebagai multi-region Cloud Storage yang terdekat dengan disk Anda, buat permintaan PATCH berikut:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "NEAREST_MULTI_REGION"
      }
    }
  • Untuk mengonfigurasi kebijakan lokasi penyimpanan setelan snapshot project Anda sebagai region Cloud Storage yang sama dengan disk Anda, buat permintaan PATCH berikut:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Untuk mengonfigurasi setelan snapshot project Anda sebagai lokasi spesifik (seperti us-central1) sebagai kebijakan lokasi penyimpanan, buat permintaan PATCH berikut:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "SPECIFIC_LOCATIONS",
        "locations": {
          "us-central1": { "name": "us-central1"}
        }
      }
    }

Melihat lokasi penyimpanan default yang ditentukan oleh setelan snapshot project

Anda dapat melihat setelan snapshot project dengan menggunakan Compute Engine API dan gcloud CLI.

gcloud

Untuk melihat setelan snapshot project Anda, gunakan perintah gcloud compute snapshot-settings describe:

  gcloud compute snapshot-settings describe \
      --project=PROJECT_ID

Ganti PROJECT_ID dengan ID project.

REST

Untuk melihat setelan snapshot project Anda, buat permintaan GET ke metode snapshotSettings.get:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

Ganti PROJECT_ID dengan ID project.

Langkah selanjutnya