Edit instance

Google Cloud console

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

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

   Buka halaman instance Filestore

2. Klik ID instance instance yang ingin diedit.

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 terintegrasi dengan 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 memilih metode ini, Anda tidak perlu menggunakan flag --file-share karena 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 instance Filestore yang ingin Anda edit.

• PROJECT_ID adalah project ID untuk project Google Cloud yang berisi instance Filestore. Anda dapat melewati flag ini jika instance Filestore berada dalam 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 independen dari kapasitas yang dipilih.

  Anda hanya dapat menggunakan salah satu opsi berikut:

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

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

    Formatnya terlihat seperti berikut:

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

• FILE_SHARE_NAME adalah nama file share 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 Kuota 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, sedangkan 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 memperbarui 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. Menginstal dan melakukan inisialisasi gcloud 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 keterangan:

   • 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 disediakan.

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

     • fixedIops mengaktifkan custo, 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 memiliki opsi untuk menambahkan catatan terkait setelan. Untuk menambahkan catatan, gunakan flag deletionProtectionReason opsional dan sertakan deskripsi justifikasi 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 memperbarui instance nfs-server dengan menurunkan 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