Instanzen bearbeiten

Auf dieser Seite erfahren Sie, wie Sie eine Filestore-Instanz mit derGoogle Cloud -Console oder der gcloud CLI bearbeiten.

Nachdem Sie eine Filestore-Instanz erstellt haben, können Sie sie so ändern:

  • Kapazität erhöhen
  • Verringern Sie die Kapazität für die folgenden Dienststufen:
    • Zonal
    • Regional
    • Unternehmen
  • Leistung konfigurieren
  • Beschreibung ändern
  • IP-basierte Zugriffssteuerungsregeln verwalten
  • Labels verwalten

Weitere Informationen zum Skalieren der Kapazität finden Sie unter Kapazität skalieren.

Bestimmte Spezifikationen wie die IP-Adresse der Instanz sind unveränderlich.

Anleitung zum Bearbeiten einer Instanz

Google Cloud console

Wenn Sie Filestore-Instanzen mit der Google Cloud Console bearbeiten möchten, rufen Sie die Seite Instanz bearbeiten auf. Dort können Sie die Instanzbeschreibung bearbeiten, IP-basierte Zugriffssteuerungsregeln verwalten und die Leistung der Dateifreigabe skalieren:

  1. Rufen Sie in der Google Cloud Console die Seite „Filestore-Instanzen“ auf.

    Zur Seite mit den Filestore-Instanzen

  2. Klicken Sie auf die ID der Instanz, die Sie bearbeiten möchten.

  3. Klicken Sie auf der Seite Instanzdetails auf Bearbeiten, um die Seite Instanz bearbeiten aufzurufen.

  4. Ändern Sie bei Bedarf die Instanzbeschreibung, die IP-basierten Zugriffssteuerungsregeln und die Kapazität. Weitere Informationen finden Sie unter Instanzen erstellen.

  5. Klicken Sie auf Speichern.

gcloud

Hinweise

Wenn Sie die gcloud CLI verwenden möchten, müssen Sie entweder die gcloud CLI installieren oder die in die Google Cloud -Console integrierte Cloud Shell verwenden:

Google Cloud Console aufrufen

gcloud-Befehl zum Bearbeiten einer Instanz

Sie können eine Filestore-Instanz mit dem Befehl instances update bearbeiten. Wenn Sie die Konfigurationsregeln für die IP-basierte Zugriffssteuerung aktualisieren müssen, müssen Sie das Flag --flags-file verwenden und eine JSON-Konfigurationsdatei angeben. Wenn Sie diese Methode auswählen, müssen Sie das Flag --file-share nicht verwenden, da es bereits in der JSON-Konfigurationsdatei enthalten ist.

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]

Dabei gilt:

  • INSTANCE_ID ist die Instanz-ID der Filestore-Instanz, die Sie bearbeiten möchten.

  • PROJECT_ID ist die Projekt-ID des Google Cloud Projekts, das die Filestore-Instanz enthält. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz im Standardprojekt gcloud befindet. Sie können das Standardprojekt folgendermaßen festlegen:

    gcloud config set project project-id

  • LOCATION ist der Standort, an dem sich die Filestore-Instanz befindet. Geben Sie bei regionalen und Enterprise-Instanzen eine Region an. Geben Sie für alle anderen Instanzen eine Zone an. Führen Sie den Befehl gcloud filestore zones list aus, um eine Liste der unterstützten Zonen abzurufen. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz in der Standardzone gcloud befindet. Sie können das Standardprojekt folgendermaßen festlegen:

    gcloud config set filestore/zone zone

  • PERFORMANCE ist die Leistungskonfiguration, mit der unabhängig von der ausgewählten Kapazität benutzerdefinierte Leistungseinstellungen angegeben werden.

    Sie können nur eine der folgenden Optionen verwenden:

    • Mit max-iops-per-tb wird eine IOPS-pro-TiB-Rate angegeben, die linear mit der Instanzkapazität skaliert.

    • max-iops gibt eine feste IOPS-Rate an, die nicht mit der Instanzkapazität skaliert wird.

      Das Format sieht so aus:

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

  • FILE_SHARE_NAME der Name der Dateifreigabe ist, die von der Filestore-Instanz bereitgestellt wird. Dateifreigabenamen können nach dem Erstellen der Instanz nicht mehr geändert werden.

  • FILE_SHARE_SIZE ist die neue gewünschte Dateifreigabegröße. Sie können die Größe der Dateifreigabe mit GiB (Standard) oder TiB in ganzen Zahlen angeben.

    Rufen Sie zum Anzeigen Ihres verfügbaren Kontingents die Seite „Kontingente“ in der Google Cloud Console auf:

    Zur Seite „Kontingente“

  • DESCRIPTION ist die optionale Filestore-Instanzbeschreibung.

  • FILE_NAME ist der Name der JSON-Konfigurationsdatei für die IP-basierte Zugriffssteuerung.

    Beispiel für eine JSON-Konfigurationsdatei:

     {
"--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"
      }
    ],
  }
}

    wobei

    • ip-ranges ist die IP-Adresse oder der Bereich, auf die bzw. den Zugriff gewährt werden soll. Sie können mehrere IP-Adressen oder Bereiche angeben, indem Sie sie durch ein Komma trennen. Nur die folgenden Dienststufen unterstützen Konfigurationseinstellungen für überlappende IP-Adressbereiche:
      • Zonal
      • Regional
      • Unternehmen
    • access-mode ist die Zugriffsebene, die Clients zugewiesen werden soll, deren IP-Adresse in den ip-range fällt. Sie kann die Werte READ_WRITE oder READ_ONLY haben. Der Standardwert ist READ_WRITE.
    • squash-mode kann die Werte ROOT_SQUASH oder NO_ROOT_SQUASH haben. ROOT_SQUASH entfernt Root-Zugriff auf die Clients, deren IP-Adresse in ip-range fällt, während NO_ROOT_SQUASH Root-Zugriff ermöglicht. Der Standardwert ist NO_ROOT_SQUASH.
    • anon_uid ist der Nutzer-ID-Wert, den Sie anon_uid zuordnen möchten. Der Standardwert ist 65534.
    • anon_gid ist der Gruppen-ID-Wert, den Sie anon_gid zuordnen möchten. Der Standardwert ist 65534.
Beispiel

Im folgenden Beispiel wird die nfs-server-Instanz aktualisiert, indem die Dateifreigabegröße auf 3 TiB erhöht wird.

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

REST API

  1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

  2. Verwenden Sie cURL, um die Filestore API aufzurufen:

    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

    Wobei:

    • PROJECT ist der Name des Projekts, in dem sich die Instanz befindet. Beispiel: my-genomics-project.
    • LOCATION ist der Speicherort der Instanz. Beispiel: us-east1oder us-central1-a
    • NAME ist der Name der Instanz, die Sie erstellen möchten. Beispiel: my-genomics-instance.

    • PERFORMANCE ist die Leistungskonfiguration, mit der benutzerdefinierte Leistungseinstellungen angegeben werden.

      Sie können nur eine der angegebenen Optionen verwenden.

      • iopsPerTB ermöglicht eine benutzerdefinierte Leistung mit einer benutzerdefinierten IOPS-Rate, die mit der Instanzkapazität skaliert. Verwenden Sie das Feld maxIopsPerTb, um IOPS pro TiB zu definieren.

      • fixedIops ermöglicht eine benutzerdefinierte Leistung mit einer festen IOPS-Rate, die nicht mit der Instanzkapazität skaliert wird. Verwenden Sie das Feld maxIops, um einen festen IOPS-Wert zu definieren.

        Das Format dafür ist:

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

    • CAPACITY ist die Größe in GiB, die Sie der Instanz zuweisen möchten. Beispiel: 1024.

    • SHARE_NAME ist der Name der Dateifreigabe. Beispiel: vol1

    • PROTECTION_REASON Wenn Sie das Flag deletionProtectionEnabled verwenden, können Sie einen Hinweis zur Einstellung hinzufügen. Verwenden Sie zum Hinzufügen der Notiz das optionale Flag deletionProtectionReason und geben Sie eine Beschreibung der Begründung für die ausgewählte Einstellung an. Beispiel: „Alle Genomdaten müssen den aktuellen Richtlinien der Organisation entsprechen.“ Weitere Informationen finden Sie unter Schutz vor dem Löschen.

    Beispiel

    Im folgenden Beispiel wird die nfs-server-Instanz aktualisiert, indem das Verhältnis der IOPS pro TiB auf 12000 verringert wird.

    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

Nächste Schritte