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

  • Jika Anda belum melakukannya, siapkan autentikasi. Authentication adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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 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 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 proyek, 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: Lokasi penyimpanan snapshot untuk proyek 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 kustom Region Cloud Storage lokasi pilihan Anda. Jika Anda menentukan opsi ini, Anda juga harus menentukan lokasi yang Anda inginkan menggunakan --storage-location-names penanda.

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

Contoh untuk menetapkan kebijakan lokasi penyimpanan menggunakan setelan snapshot

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

  • Untuk mengonfigurasi kebijakan lokasi penyimpanan snapshot project Anda setelan 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 snapshot project Anda setelan 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 snapshot project Anda setelan 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 kustom Region Cloud Storage lokasi pilihan Anda. Jika Anda menentukan opsi ini, Anda juga harus tentukan lokasi yang Anda inginkan menggunakan parameter locations dalam permintaan Anda.

  • REGION_NAME: Opsional: Jika Anda menyertakan policy dengan nilai SPECIFIC_LOCATIONS, maka Anda harus menentukan region Cloud Storage. Anda hanya dapat menentukan satu region dan tidak boleh berupa Cloud Storage multi-region. Tetapkan nilai ini ke nama wilayah yang ingin Anda sebagai kebijakan lokasi penyimpanan.

Contoh untuk menetapkan kebijakan lokasi penyimpanan menggunakan setelan snapshot

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

  • Untuk mengonfigurasi kebijakan lokasi penyimpanan pada setelan snapshot project Anda sebagai multi-region Cloud Storage yang terdekat dengan disk Anda, pastikan 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 pada setelan snapshot project Anda sebagai region Cloud Storage yang sama dengan disk Anda, pastikan Permintaan PATCH:
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshotSettings

    {
      "storageLocation": {
        "policy": "LOCAL_REGION"
      }
    }
  • Untuk mengonfigurasi sebagai kebijakan lokasi penyimpanan snapshot project Anda sebagai lokasi spesifik (seperti us-central1), buat hal berikut Permintaan PATCH:
    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