Instanzen bearbeiten

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

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

  • Erhöhen Sie die Kapazität.
  • Verringern Sie die Kapazität für die folgenden Dienststufen:
    • Zonal
    • Regional
    • Unternehmen
  • Leistung konfigurieren
  • Ändern Sie die Beschreibung.
  • 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 Instanz beschreibung bearbeiten, IP-basierte Zugriffssteuerungsregeln verwalten und die Leistung der Dateifreigabe skalieren:

  1. Wechseln Sie in der Google Cloud Console zur Seite „Filestore-Instanzen“.

    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

Hinweis

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:

Rufen Sie die Google Cloud Console auf.

gcloud-Befehl zum Bearbeiten einer Instanz

Sie können eine Filestore-Instanz mit dem instances update Befehl 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]

wobei

  • 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 von 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 gcloud filestore zones list Befehl aus, um eine Liste der unterstützten Zonen abzurufen. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz in der Standardzone von gcloud befindet. Sie können das Standardprojekt folgendermaßen festlegen:

    gcloud config set filestore/zone zone

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

    Sie können nur eine der folgenden Optionen verwenden:

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

    • 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 ist der Name der Dateifreigabe, 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 Instanz nfs-server 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. Installieren und initialisieren Sie die gcloud CLI installiert und initialisiert, um ein Zugriffstoken für den Authorization Header zu generieren.

  2. Rufen Sie die Filestore API mit cURL auf:

    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 Standort, an dem sich die Instanz befindet. Beispiel: us-east1 oder 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 aktiviert die benutzerdefinierte Leistung mit einer nutzerdefinierten IOPS-Rate, die mit der Instanzkapazität skaliert wird. Verwenden Sie das Feld maxIopsPerTb, um IOPS pro TiB zu definieren.

      • fixedIops aktiviert die 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 für die 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 eine Notiz zur Einstellung hinzufügen. Verwenden Sie dazu das optionale Flag deletionProtectionReason und fügen Sie eine Beschreibung der Begründung für die von Ihnen gewählte Einstellung hinzu. Beispiel: „Alle Genomics-Daten müssen den aktuellen Richtlinien der Organisation entsprechen.“ Weitere Informationen finden Sie unter Löschschutz.

    Beispiel

    Im folgenden Beispiel wird die Instanz nfs-server aktualisiert, indem das Verhältnis von 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