Edit instance

Halaman ini menunjukkan cara mengedit instance Filestore menggunakan konsolGoogle Cloud atau gcloud CLI.

Setelah dibuat, Anda dapat mengubah instance Filestore dengan cara berikut:

Untuk mengetahui detail tentang penskalaan kapasitas, lihat Menskalakan kapasitas.

Spesifikasi tertentu, seperti alamat IP instance, tidak dapat diubah.

Petunjuk untuk mengedit instance

Konsol Google Cloud

Untuk mengedit instance Filestore menggunakan konsol Google Cloud , buka halaman Edit instance, tempat Anda dapat mengedit deskripsi instance, mengelola aturan kontrol akses berbasis IP, dan menskalakan performa berbagi file:

  1. Di konsol Google Cloud , buka halaman Filestore Instances.

    Buka halaman instance Filestore

  2. Klik ID instance dari instance yang ingin Anda edit.

  3. Di halaman Instance details, klik Edit untuk membuka halaman Edit instance.

  4. Ubah deskripsi instance, aturan kontrol akses berbasis IP, dan kapasitas sesuai kebutuhan. Untuk mengetahui detailnya, lihat Membuat instance.

  5. Klik Simpan.

gcloud

Sebelum memulai

Untuk menggunakan gcloud CLI, Anda harus menginstal gcloud CLI atau menggunakan Cloud Shell yang sudah ada di konsol Google Cloud :

Buka Google Cloud konsol

Perintah gcloud untuk mengedit instance

Anda dapat mengedit instance Filestore dengan menjalankan perintah instances update. Jika Anda perlu memperbarui aturan konfigurasi untuk kontrol akses berbasis IP, Anda harus menggunakan flag --flags-file dan menentukan file konfigurasi JSON. Jika Anda memilih metode ini, Anda tidak perlu menggunakan tanda --file-share karena tanda tersebut sudah disertakan dalam file konfigurasi JSON.

gcloud filestore instances update INSTANCE_ID
    --[project="PROJECT_ID"]
    --[location=LOCATION]
    --[performance=PERFORMANCE] \
    --[file-share=name="FILE_SHARE_NAME",CAPACITY=FILE_SHARE_SIZE]
    --[description="DESCRIPTION"]
    --[flags-file=FILE_NAME.json]

dengan:

  • INSTANCE_ID adalah ID instance Filestore yang ingin Anda edit.

  • PROJECT_ID adalah project ID dari project Google Cloud yang berisi instance Filestore. Anda dapat melewati flag ini jika instance Filestore berada di project default gcloud. Anda dapat menetapkan project default dengan menjalankan:

    gcloud config set project project-id

  • LOCATION adalah lokasi tempat instance Filestore berada. Untuk instance regional dan enterprise, tentukan region. Untuk semua instance lainnya, tentukan zona. Jalankan perintah gcloud filestore zones list untuk mendapatkan daftar zona yang didukung. Anda dapat melewati tanda ini jika instance Filestore berada di zona default gcloud. Anda dapat menetapkan zona default dengan menjalankan:

    gcloud config set filestore/zone zone

  • PERFORMANCE adalah konfigurasi performa yang digunakan untuk menentukan setelan performa kustom secara terpisah dari kapasitas yang dipilih.

    Anda hanya dapat menggunakan salah satu opsi berikut:

    • max-iops-per-tb menentukan rasio IOPS per TiB yang diskalakan secara linear dengan kapasitas instance.

    • max-iops menentukan kecepatan IOPS tetap yang tidak diskalakan dengan kapasitas instance.

      Formatnya terlihat seperti berikut:

      --performance=max-iops-per-tb=17000

  • FILE_SHARE_NAME adalah nama berbagi file yang ditayangkan dari instance Filestore. Nama berbagi file tidak dapat diubah setelah pembuatan instance.

  • FILE_SHARE_SIZE adalah ukuran baru yang Anda inginkan untuk berbagi file. Anda dapat menentukan ukuran berbagi file dalam bilangan bulat menggunakan GiB (default) atau TiB.

    Untuk melihat kuota yang tersedia, buka halaman Quotas di konsol Google Cloud :

    Buka halaman Quotas

  • DESCRIPTION adalah deskripsi instance Filestore opsional.

  • FILE_NAME adalah nama file konfigurasi json untuk kontrol akses berbasis IP.

    Contoh file konfigurasi json:

     {
"--file-share":
  {
    "capacity": "4096",
    "name": "my_vol",
    "nfs-export-options": [
      {
        "access-mode": "READ_WRITE",
        "ip-ranges": [
          "10.0.0.0",
          "10.2.0.0"
        ],
        "squash-mode": "ROOT_SQUASH",
        "anon_uid": 1003,
        "anon_gid": 1003
      },
       {
        "access-mode": "READ_ONLY",
        "ip-ranges": [
          "10.0.1.0/28"
        ],
        "squash-mode": "NO_ROOT_SQUASH"
      }
    ],
  }
}

    dengan:

    • ip-ranges adalah alamat atau rentang IP yang akan diberi akses. Anda dapat menentukan beberapa alamat atau rentang IP dengan memisahkannya menggunakan koma. Hanya tingkat layanan berikut yang mendukung setelan konfigurasi untuk rentang alamat IP yang tumpang-tindih:
      • Zonal
      • Regional
      • Enterprise
    • access-mode adalah tingkat akses yang akan diberikan kepada klien yang alamat IP-nya berada dalam ip-range. Class dapat memiliki nilai READ_WRITE atau READ_ONLY. Nilai defaultnya adalah READ_WRITE.
    • squash-mode dapat memiliki nilai ROOT_SQUASH atau NO_ROOT_SQUASH. ROOT_SQUASH menghapus akses tingkat root ke klien yang alamat IP-nya berada dalam ip-range, sementara NO_ROOT_SQUASH mengaktifkan akses root. Nilai defaultnya adalah NO_ROOT_SQUASH.
    • anon_uid adalah nilai ID pengguna yang ingin Anda petakan ke anon_uid. Nilai defaultnya adalah 65534.
    • anon_gid adalah nilai ID grup yang ingin Anda petakan ke anon_gid. Nilai defaultnya adalah 65534.
Contoh

Contoh berikut mengupdate instance nfs-server dengan meningkatkan ukuran berbagi file menjadi 3 TiB.

    gcloud filestore instances update nfs-server --zone=us-central1-c --file-share=name="vol1",capacity=3TiB
  ```

REST API

  1. Instal dan lakukan inisialisasigcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil Filestore API:

    curl --request PATCH \
    'https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances?instanceId=NAME?updateMask=performanceConfig%2CdeletionProtectionReason%2CdeletionProtectionEnabled&key=YOUR_API_KEY' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{
            "tier":"TIER",
            "networks":[
                {
                "network":"NETWORK"
                }
              ],
            "performanceConfig": {"PERFORMANCE"}
            "fileShares":[
              {"capacityGb":CAPACITY,"name":"SHARE_NAME"}
              ],
            "deletionProtectionEnabled": true,
            "deletionProtectionReason": "PROTECTION_REASON"}' \
    --compressed

    Dengan:

    • PROJECT adalah nama project tempat instance Anda akan berada. Contoh, my-genomics-project.
    • LOCATION adalah lokasi tempat instance akan berada. Misalnya us-east1 atau us-central1-a.
    • NAME adalah nama instance yang ingin Anda buat. Contoh, my-genomics-instance.

    • PERFORMANCE adalah konfigurasi performa yang digunakan untuk menentukan setelan performa kustom.

      Anda hanya dapat menggunakan salah satu opsi yang diberikan.

      • iopsPerTB memungkinkan performa kustom dengan kecepatan IOPS yang ditentukan pengguna yang diskalakan dengan kapasitas instance. Untuk menentukan IOPS per TiB, gunakan kolom maxIopsPerTb.

      • fixedIops memungkinkan performa dengan kecepatan IOPS tetap yang tidak diskalakan dengan kapasitas instance. Untuk menentukan nilai IOPS tetap, gunakan kolom maxIops.

        Formatnya adalah sebagai berikut:

        "performanceConfig": {
    "iopsPerTb" : {
        "maxIopsPerTb":17000
    }
  }

    • CAPACITY adalah ukuran, dalam GiB, yang ingin Anda alokasikan untuk instance. Contoh, 1024.

    • SHARE_NAME adalah nama berbagi file. Contoh, vol1.

    • PROTECTION_REASON jika Anda memilih untuk menggunakan flag deletionProtectionEnabled, Anda dapat menambahkan catatan mengenai setelan tersebut. Untuk menambahkan catatan, gunakan tanda deletionProtectionReason opsional dan sertakan deskripsi pembenaran untuk setelan yang Anda pilih. Misalnya, "Semua data genomik harus mematuhi kebijakan organisasi saat ini". Untuk mengetahui informasi selengkapnya, lihat Perlindungan penghapusan.

    Contoh

    Contoh berikut mengupdate instance nfs-server dengan mengurangi rasio IOPS per TiB menjadi 12000.

    curl --request PATCH \
    'https://file.googleapis.com/v1/projects/my-project/locations/us-central1/instances?instanceId=nfs-server?updateMask=performanceConfig%2CdeletionProtectionReason&key=12334fr232' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{
              "performanceConfig":
                {
                  "iopsPerTb":
                    {
                      "maxIopsPerTb":12000
                    }
                },
              "deletionProtectionReason":"Deletion+not+allowed"}' \
    --compressed

Langkah berikutnya