Modifica istanze

Google Cloud console

Per modificare le istanze Filestore utilizzando la Google Cloud console, vai alla pagina Modifica istanza, dove puoi modificare la descrizione dell'istanza, gestire le regole di controllo dell'accesso in base all'IP e scalare le prestazioni della condivisione file:

1. Nella Google Cloud console, vai alla pagina Istanze Filestore.

   Vai alla pagina delle istanze Filestore

2. Fai clic sull'ID istanza che vuoi modificare.

3. Nella pagina Dettagli istanza, fai clic su Modifica per andare alla pagina Modifica istanza.

4. Modifica la descrizione dell'istanza, le regole di controllo dell'accesso basato su IP e la capacità in base alle esigenze. Per maggiori dettagli, consulta Creare istanze.

5. Fai clic su Salva.

gcloud

Prima di iniziare

Per utilizzare gcloud CLI, devi installare gcloud CLI o utilizzare Cloud Shell integrato nella Google Cloud console:

Vai alla Google Cloud console

Comando gcloud per la modifica di un'istanza

Puoi modificare un'istanza Filestore eseguendo il comando instances update. Se devi aggiornare le regole di configurazione per controllo dell'accesso in base all'IP, devi utilizzare il flag --flags-file e specificare un file di configurazione JSON. Se scegli questo metodo, non devi utilizzare il flag --file-share perché è già incluso nel file di configurazione 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]

dove:

• INSTANCE_ID è l'ID dell'istanza Filestore da modificare.

• PROJECT_ID è l'ID del progetto Google Cloud che contiene l'istanza Filestore. Puoi saltare questo flag se l'istanza Filestore si trova nel progetto predefinito gcloud. Per impostare il progetto predefinito, esegui:

  gcloud config set project project-id
  

• LOCATION è la posizione in cui risiede l'istanza Filestore. Per le istanze a livello di regione e aziendali, specifica una regione. Per tutte le altre istanze, specifica una zona. Esegui il comando gcloud filestore zones list per ottenere un elenco delle zone supportate. Puoi saltare questo flag se l'istanza Filestore si trova nella zona predefinita gcloud. Per impostare la zona predefinita, esegui:

  gcloud config set filestore/zone zone
  

• PERFORMANCE è la configurazione delle prestazioni utilizzata per specificare impostazioni di prestazioni personalizzate indipendentemente dalla capacità scelta.

  Puoi utilizzare una sola delle seguenti opzioni:

  • max-iops-per-tb specifica una frequenza di IOPS per TiB che si scala linearmente con la capacità dell'istanza.

  • max-iops specifica una frequenza di IOPS fissa che non si basa sulla capacità dell'istanza.

    Il formato è il seguente:

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

• FILE_SHARE_NAME è il nome della condivisione file pubblicata dall'istanza Filestore. I nomi delle condivisioni file non possono essere modificati dopo la creazione dell'istanza.

• FILE_SHARE_SIZE è la nuova dimensione che vuoi per la condivisione dei file. Puoi specificare la dimensione della condivisione file in numeri interi utilizzando GiB (valore predefinito) o TiB.

  Per visualizzare la quota disponibile, vai alla pagina Quote nella Google Cloud console:

  Vai alla pagina Quote

• DESCRIPTION è la descrizione facoltativa dell'istanza Filestore.

• FILE_NAME è il nome del file di configurazione JSON per controllo dell'accesso basato su IP.

  Esempio di file di configurazione 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"
        }
      ],
    }
  }
  

  dove:

  • ip-ranges è l'indirizzo o l'intervallo IP a cui concedere l'accesso. Puoi specificare più indirizzi IP o intervalli separandoli con una virgola. Solo i seguenti livelli di servizio supportano le impostazioni di configurazione per intervalli di indirizzi IP sovrapposti:
    • A livello di zona
    • Regionale
    • Aziende
  • access-mode è il livello di accesso da concedere ai client il cui indirizzo IP rientra in ip-range. Può avere i valori READ_WRITE o READ_ONLY. Il valore predefinito è READ_WRITE.
  • squash-mode può avere i valori ROOT_SQUASH o NO_ROOT_SQUASH. ROOT_SQUASH rimuove l'accesso a livello di root ai client il cui indirizzo IP rientra nell'intervallo IP, mentre NO_ROOT_SQUASH abilita l'accesso come utente root. Il valore predefinito è NO_ROOT_SQUASH.
  • anon_uid è il valore dell'ID utente che vuoi mappare a anon_uid. Il valore predefinito è 65534.
  • anon_gid è il valore dell'ID gruppo che vuoi mappare a anon_gid. Il valore predefinito è 65534.

Esempio

L'esempio seguente aggiorna l'istanza nfs-server aumentando la dimensione della condivisione file a 3 TiB.

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

API REST

1. Avere installato e inizializzatogcloud CLI, che consente di generare un token di accesso per l'intestazione Authorization.

2. Utilizza cURL per chiamare l'API Filestore:

   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
   
   

   Dove:

   • PROJECT è il nome del progetto in cui risiederà l'istanza. Ad esempio, my-genomics-project.
   • LOCATION è la posizione in cui risiederà l'istanza. Ad esempio, us-east1 o us-central1-a.
   • NAME è il nome dell'istanza che vuoi creare. Ad esempio, my-genomics-instance.

   • PERFORMANCE è la configurazione delle prestazioni utilizzata per specificare le impostazioni di prestazioni personalizzate.

     Puoi utilizzare una sola delle opzioni fornite.

     • iopsPerTB consente prestazioni personalizzate con una frequenza di IOPS definita dall'utente che si adatta alla capacità dell'istanza. Per definire le IOPS per TiB, utilizza il campo maxIopsPerTb.

     • fixedIops consente prestazioni personalizzate con una frequenza di IOPS fissa che non si basa sulla capacità dell'istanza. Per definire un valore IOPS fisso, utilizza il campo maxIops.

       Il formato è il seguente:

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

   • CAPACITY è la dimensione in GiB da allocare per l'istanza. Ad esempio, 1024.

   • SHARE_NAME è il nome della condivisione file. Ad esempio, vol1.

   • PROTECTION_REASON Se scegli di utilizzare il flag deletionProtectionEnabled, hai la possibilità di aggiungere una nota relativa all'impostazione. Per aggiungere la nota, utilizza il flag facoltativo deletionProtectionReason e includi una descrizione della motivazione dell'impostazione scelta. Ad esempio, "Tutti i dati di genomica devono rispettare i criteri attuali dell'organizzazione". Per ulteriori informazioni, consulta la sezione Protezione eliminazione.

   Esempio

   L'esempio seguente aggiorna l'istanza nfs-server diminuendo il rapporto IOPS per TiB a 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