Anywhere Cache-Caches erstellen und verwalten

Auf dieser Seite erfahren Sie, wie Sie Anywhere Cache-Cache-Instanzen erstellen und verwalten.

Informationen zur Verwendung und Verwaltung von Vorgängen mit langer Ausführungszeit, die von asynchronen Cache-Vorgängen in Anywhere Cache initiiert werden, finden Sie unter Vorgänge mit langer Ausführungszeit verwenden.

Lesen Sie sich die Einschränkungen durch, bevor Sie Anywhere Cache verwenden.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Storage Admin (roles/storage.admin) für den Bucket zuzuweisen, für den Sie Caches erstellen möchten, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Anywhere Cache-Caches benötigen.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen und Verwalten von Anywhere Cache-Caches erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Anywhere Cache-Caches zu erstellen und zu verwalten:

  • storage.anywhereCaches.disable (erforderlich zum Deaktivieren von Caches)
  • storage.anywhereCaches.get (erforderlich zum Abrufen von Caches)
  • storage.anywhereCaches.create (erforderlich zum Erstellen von Caches)
  • storage.anywhereCaches.list (erforderlich für die Auflistung von Caches)
  • storage.anywhereCaches.pause (erforderlich zum Pausieren von Caches)
  • storage.anywhereCaches.resume (erforderlich, um Caches fortzusetzen)
  • storage.anywhereCaches.update (erforderlich zum Aktualisieren von Caches)

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen erhalten.

Informationen zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.

Um lang andauernde Vorgänge zu verwalten, die über Anywhere Cache-Methoden initiiert werden, benötigen Sie möglicherweise zusätzliche Rollen und Berechtigungen. Weitere Informationen finden Sie unter Erforderliche Rollen für lang andauernde Vorgänge.

Cache erstellen

Informationen zum Erstellen und Verwalten von Anywhere Cache mit Terraform finden Sie in der Terraform-Dokumentation unter google_storage_anywhere_cache.

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Bucket-Liste auf den Namen des Buckets, für den Sie Daten im Cache speichern möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Bereich Anywhere Cache auf Cache konfigurieren.

    Die Seite Konfiguration für <your_bucket_name> bearbeiten wird für Ihren Bucket angezeigt.

  5. Klicken Sie im Bereich Cache-Regionen auf die Region, die die Zonen enthält, in denen Sie einen Cache erstellen möchten.

  6. Wählen Sie im Bereich Cachezonen die Zonen aus, in denen Sie einen Cache erstellen möchten. Geben Sie für jede ausgewählte Zone eine Gültigkeitsdauer und eine Aufnahmeoption für den Cache an.

  7. Klicken Sie auf Save configuration (Konfiguration speichern).

  8. Klicken Sie im angezeigten Dialogfeld auf Zulassen.

    Der Tab Vorgänge auf der Seite Bucket-Details wird geöffnet. Dort sehen Sie den Jobstatus des Vorgangs zum Erstellen des Caches.

Sie können den Status des Caches eines Buckets auch direkt auf der Seite Bucket-Liste aufrufen. Gehen Sie dazu so vor:

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie auf das Symbol Spalte ansehen (), wählen Sie Cache aus und klicken Sie dann auf OK.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches create aus:

gcloud storage buckets anywhere-caches create gs://BUCKET_NAME ZONE

Ersetzen Sie:

  • BUCKET_NAME durch den Namen des Buckets, für den Sie Daten im Cache speichern möchten. Beispiel: my-bucket.

  • ZONE durch die Zone, in der der Cache ausgeführt wird. Beispiel: us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig erstellen möchten, können Sie mehrere Zonen angeben. Beispiel: us-east1-b us-east1-c us-east1-d

Mit den folgenden optionalen Flags können Sie das Erstellen des Caches noch genauer steuern:

  • --ttl: Gibt die Gültigkeitsdauer (TTL) der Daten im Cache in Sekunden an. Wenn nicht angegeben, lautet die Standardeinstellung 86400s (24 Stunden).

  • --admission-policy: Legen Sie fest, wann Daten in den Cache aufgenommen werden. Werte können ADMIT_ON_FIRST_MISS oder ADMIT_ON_SECOND_MISS sein. Wenn nicht angegeben, lautet die Standardeinstellung ADMIT_ON_FIRST_MISS.

Bei Erfolg gibt der Befehl die ID des Vorgangs mit langer Ausführungszeit zurück, der dem AnywhereCache Create-Vorgang zugeordnet ist. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen oder den Vorgang mit langer Ausführungszeit abbrechen, um den Vorgang „AnywhereCaches Create“ zu beenden, bevor er abgeschlossen ist.

REST APIs

JSON API

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

  2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

    {
       "zone": "ZONE",
       "ttl": "TIME_TO_LIVE",
       "admissionPolicy": "ADMISSION_POLICY"
    }

    Ersetzen Sie:

    • ZONE durch die Zone, in der der Cache ausgeführt wird. Beispiel: us-east1-b.

    • TIME_TO_LIVE mit der Gültigkeitsdauer (TTL) der Daten im Cache. Der Wert kann zwischen 1 Stunde und 7 Tagen liegen und muss in Sekunden angegeben werden. Wenn nicht angegeben, lautet die Standardeinstellung 86400s (24 Stunden).

    • ADMISSION_POLICY mit der Zulassungsrichtlinie des Cache, die angibt, wann Daten aufgenommen werden. Mögliche Werte sind admit-on-first-miss und admit-on-second-miss. Wenn nicht angegeben, lautet die Standardeinstellung admit-on-first-miss.

  3. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Erstellen eines Caches aufzurufen:

    curl -X POST --data-binary @JSON_FILE_NAME \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"

    Ersetzen Sie:

    • JSON_FILE_NAME durch den Namen der JSON-Datei, die Sie in Schritt 2 erstellt haben.

    • BUCKET_NAME durch den Namen des Buckets, für den Sie Daten im Cache speichern möchten. Beispiel: my-bucket.

Bei Erfolg gibt der Vorgang eine google.longrunning.Operation zurück. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen oder den Vorgang mit langer Ausführungszeit abbrechen, um den Vorgang „AnywhereCaches erstellen“ zu beenden, bevor er abgeschlossen ist.

Cache ansehen

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie aufrufen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Bereich Anywhere Cache neben dem Feld Cache auf Bearbeiten.

  5. Wählen Sie auf der Seite Konfiguration bearbeiten eine Region aus, um alle Caches in den Zonen der Region aufzurufen.

    Im Bereich Cachezonen können Sie dann Details zu jedem verfügbaren Cache aufrufen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches describe aus:

gcloud storage buckets anywhere-caches describe ID

Ersetzen Sie:

  • ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. Beispiel: my-bucket/us-east1-b.

Verwenden Sie das optionale Flag raw, um eine rohe API-Antwort anstelle einer standardisierten API-Antwort auszugeben.

Bei Erfolg gibt der Befehl eine AnywhereCache-Ressource zurück.

REST APIs

JSON API

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

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Abrufen eines Caches aufzurufen:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie abrufen möchten. Beispiel: my-bucket

    • ANYWHERE_CACHE_ID mit der Zone, in der sich der Cache befindet. Beispiel: us-east1-b.

Bei Erfolg gibt dieser Vorgang eine AnywhereCache-Ressource zurück.

Caches auflisten

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit den Caches verknüpft ist, die Sie aufrufen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Bereich Anywhere Cache neben dem Feld Cache auf Bearbeiten.

  5. Wählen Sie auf der Seite Konfiguration bearbeiten eine Region aus, um alle Caches in den Zonen dieser Region aufzurufen.

    Alle verfügbaren Caches für Zonen innerhalb der Region werden im Bereich Cachezonen angezeigt.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches list aus:

gcloud storage buckets anywhere-caches list gs://BUCKET_NAME

Ersetzen Sie:

  • BUCKET_NAME durch den Namen des Buckets, der mit den Caches verknüpft ist, die Sie auflisten möchten. Beispiel: my-bucket.

Bei Erfolg gibt der Befehl eine Liste der AnywhereCache-Ressourcen zurück.

Optional kannst du das Flag --raw verwenden, um eine rohe API-Antwort anstelle einer standardisierten Antwort zurückzugeben. Weitere Informationen zum Steuern des Listenverhaltens, z. B. zur Paginierung von Ergebnissen, finden Sie in der gcloud storage ls-Dokumentation.

REST APIs

JSON API

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

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Auflisten von Caches aufzurufen:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit den Caches verknüpft ist, die Sie abrufen möchten. Beispiel: my-bucket

    Wenn Sie mehrere Caches auflisten, können Sie die Ergebnisse auf mehrere Seiten aufteilen.

Bei Erfolg gibt dieser Vorgang eine Liste von AnywhereCache-Ressourcen zurück. Weitere Informationen zur Struktur dieser Antwort finden Sie in der Dokumentation zur AnywhereCaches-Liste.

Cache aktualisieren

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie aktualisieren möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit und dann im Navigationsmenü auf Cache.

  4. Klicken Sie auf Konfiguration bearbeiten.

  5. Aktualisieren Sie auf der Seite Konfiguration bearbeiten die Eigenschaften des Caches und klicken Sie dann auf Speichern.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches update aus:

gcloud storage buckets anywhere-caches update ID

Ersetzen Sie:

  • ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. Beispiel: my-bucket/us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig aktualisieren möchten, können Sie mehrere IDs angeben. Beispiel: my-bucket/us-east1-b my-bucket/us-east1-c.

Mit den folgenden Flags können Sie die Konfiguration des Caches aktualisieren. Wenn kein Flag angegeben ist, bleibt der Wert unverändert.

  • --ttl: Gibt die Gültigkeitsdauer (TTL) der Daten im Cache in Sekunden an.

  • --admission-policy: Legen Sie fest, wann Daten in den Cache aufgenommen werden. Werte können ADMIT_ON_FIRST_MISS oder ADMIT_ON_SECOND_MISS sein.

Bei Erfolg gibt der Befehl die ID des ursprünglichen Vorgangs mit langer Ausführungszeit zurück, der dem AnywhereCache-Aktualisierungsvorgang zugeordnet ist. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen.

REST APIs

JSON API

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

  2. Erstellen Sie eine JSON-Datei, die Änderungen an den Cache-Attributen enthält, die Sie aktualisieren möchten.

    {
       "ttl": "TIME_TO_LIVE",
       "admissionPolicy": "ADMISSION_POLICY"
    }

    Ersetzen Sie:

    • TIME_TO_LIVE mit der TTL der Daten im Cache. Der Wert kann zwischen 1 Stunde und 7 Tagen liegen und muss in Sekunden angegeben werden. Wenn keine Angabe erfolgt, wird der aktuelle Wert verwendet.

    • ADMISSION_POLICY mit der Zulassungsrichtlinie des Cache, die angibt, wann Daten aufgenommen werden. Mögliche Werte sind admit-on-first-miss und admit-on-second-miss. Wenn Sie nichts angeben, wird der aktuelle Wert verwendet.

    Im folgenden Beispiel wird die TTL des Cache auf 2 Tage aktualisiert und die Zulassungsrichtlinie so festgelegt, dass bei der zweiten Fehlsuche Daten aufgenommen werden:

    {
       "ttl": "172800s",
       "admissionPolicy": "admit-on-second-miss"
    }
  3. Um die neuen Properties anzuwenden, rufen Sie mit cURL die JSON API mit einer Anfrage zum Aktualisieren des Caches auf:

    curl -X PATCH --data-binary @JSON_FILE_NAME \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"

    Ersetzen Sie:

    • JSON_FILE_NAME durch den Namen der JSON-Datei, die Sie in Schritt 2 erstellt haben.

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie aktualisieren möchten. Beispiel: my-bucket

    • ANYWHERE_CACHE_ID durch die Kennung des Caches. Beispiel: us-east1-b.

Bei Erfolg gibt der Vorgang eine google.longrunning.Operation zurück. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen.

Cache pausieren

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie pausieren möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit und dann im Navigationsmenü auf Cache.

  4. Klicken Sie auf Cache anhalten/fortsetzen.

  5. Klicken Sie im angezeigten Bereich auf die Ein/Aus-Schaltfläche Cache pausieren.

  6. Klicken Sie auf Pausieren/Fortsetzen.

  7. Klicken Sie im angezeigten Dialogfeld auf Zulassen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches pause aus:

gcloud storage buckets anywhere-caches pause ID

Ersetzen Sie:

  • ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. Beispiel: my-bucket/us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig pausieren möchten, können Sie mehrere IDs angeben. Beispiel: my-bucket/us-east1-b my-bucket/us-east1-c.

Wenn der Vorgang erfolgreich war, gibt der Befehl eine Erfolgsmeldung zurück.

REST APIs

JSON API

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

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Pausieren eines Caches aufzurufen:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/pause"

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie pausieren möchten. Beispiel: my-bucket

    • ANYWHERE_CACHE_ID durch die Kennung des Caches. Beispiel: us-east1-b.

Bei Erfolg gibt der Vorgang eine formatierte AnywhereCache-Ressource zurück.

Cache fortsetzen

Console

So setzen Sie einen pausierten Cache fort:

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie fortsetzen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit und dann im Navigationsmenü auf Cache.

  4. Klicken Sie auf Cache anhalten/fortsetzen.

  5. Klicken Sie im angezeigten Bereich auf die Ein/Aus-Schaltfläche Cache pausieren.

  6. Klicken Sie auf Pausieren/Fortsetzen.

  7. Klicken Sie im angezeigten Dialogfeld auf Zulassen.

So nehmen Sie einen deaktivierten Cache wieder auf:

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie fortsetzen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit und dann im Navigationsmenü auf Cache.

  4. Klicken Sie auf Cache deaktivieren/fortsetzen.

  5. Klicken Sie im angezeigten Bereich auf die Ein/Aus-Schaltfläche Cache deaktivieren.

  6. Klicken Sie auf Deaktivieren/Fortsetzen.

  7. Klicken Sie im angezeigten Dialogfeld auf Zulassen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches resume aus:

gcloud storage buckets anywhere-caches resume ID

Ersetzen Sie:

  • ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. Beispiel: my-bucket/us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig fortsetzen möchten, können Sie mehrere IDs angeben. Beispiel: my-bucket/us-east1-b my-bucket/us-east1-c.

Wenn der Vorgang erfolgreich war, gibt der Befehl eine formatierte AnywhereCache-Ressource zurück.

REST APIs

JSON API

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

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Fortsetzen eines Caches aufzurufen:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/resume"

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie fortsetzen möchten. Beispiel: my-bucket

    • ANYWHERE_CACHE_ID durch die Kennung des Caches. Beispiel: us-east1-b.

Bei Erfolg gibt der Vorgang eine formatierte AnywhereCache-Ressource zurück.

Cache deaktivieren

Console

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie deaktivieren möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit und dann im Navigationsmenü auf Cache.

  4. Klicken Sie auf Cache deaktivieren/fortsetzen.

  5. Klicken Sie im angezeigten Bereich auf die Ein/Aus-Schaltfläche Cache deaktivieren.

  6. Klicken Sie auf Deaktivieren/Fortsetzen.

  7. Klicken Sie im angezeigten Dialogfeld auf Zulassen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches disable aus:

gcloud storage buckets anywhere-caches disable ID

Ersetzen Sie:

  • ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. Beispiel: my-bucket/us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig deaktivieren möchten, können Sie mehrere IDs angeben. Beispiel: my-bucket/us-east1-b my-bucket/us-east1-c.

Bei Erfolg gibt der Befehl eine formatierte AnywhereCache-Ressource zurück.

REST APIs

JSON API

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

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Deaktivieren eines Caches aufzurufen:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/disable"

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie deaktivieren möchten. Beispiel: my-bucket

    • ANYWHERE_CACHE_ID durch die Kennung des Caches. Beispiel: us-east1-b.

Bei Erfolg gibt der Befehl eine formatierte AnywhereCache-Ressource zurück.

Cache-Leistung überwachen

Der Bereich „Cloud Storage“ der Google Cloud Console bietet Monitoring-Diagramme, mit denen Sie die Leistung Ihrer Caches anhand von Messwerten im Blick behalten können. Diese Monitoring-Diagramme können auch mit Cloud Monitoring aufgerufen werden.

Verfügbare Diagramme

Diagramm Ebene der Ressourcenhierarchie Beschreibung
Entfernungsrate der Bytes Bucket Die Rate der aus dem Cache entfernten Bytes, stündlich erfasst. Diese Daten werden mehrmals pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Entfernungsrate der Bytes Projekt Die Rate der aus allen Caches eines Buckets entfernten Bytes, stündlich erfasst. Diese Daten werden mehrmals pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Byte im Cache Bucket Die Rate der Bytes im Cache, stündlich erfasst. Diese Daten werden mehrmals pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Byte im Cache Projekt Diese Rate der Bytes in allen Caches eines Buckets, stündlich erfasst. Diese Daten werden mehrmals pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Vorteil durch Cache-Durchsatz Projekt Die Rate des Kontingents für die Datenübertragungsbandbreite für die Region, die Nutzung des Kontingents und der vom Cache bereitgestellte zusätzliche Durchsatz. Letzterer wird nicht auf das Kontingent angerechnet. Projekte können also durch Nutzung des Cache den durch das Kontingent zulässigen Durchsatz überschreiten.
Trefferquote – Vorgänge Bucket Der Prozentsatz der Cache-Vorgänge, die die angeforderten Daten aus dem Cache bereitstellen, im Verhältnis zu den insgesamt cache-fähigen Vorgängen, alle 60 Sekunden. Wenn ein Lesevorgang vollständig aus dem Cache zurückgegeben wird, gilt der Vorgang als Treffer. Wenn der Lesevorgang nicht oder nur teilweise aus dem Cache zurückgegeben wird, gilt der Vorgang als Fehler.
Trefferquote – Vorgänge Projekt Der Prozentsatz der Cache-Vorgänge, die die angeforderten Daten aus allen Caches für einen Bucket bereitstellen, im Verhältnis zu den gesamten cache-fähigen Vorgängen, alle 60 Sekunden. Wenn ein Lesevorgang vollständig aus dem Cache zurückgegeben wird, gilt der Vorgang als Treffer. Wenn der Lesevorgang nicht oder nur teilweise aus dem Cache zurückgegeben wird, gilt der Vorgang als Fehler.
Bytes der Trefferquote Bucket Der Prozentsatz der Bytes, die aus dem Cache bereitgestellt werden, im Verhältnis zu den gesamten Cache-fähigen Bytes. Alle 60 Sekunden wird eine Stichprobe erstellt.
Bytes der Trefferquote Projekt Der Prozentsatz der Bytes, die aus allen Caches für einen Bucket bereitgestellt wurden, im Verhältnis zu den gesamten Cache-fähigen Bytes, alle 60 Sekunden erfasst.
Aufnahmerate (Rohbytes) Bucket Die Rate der in jeden Cache aufgenommenen Rohbytes, alle 60 Sekunden erfasst. Alle aufgenommenen Byte, einschließlich nicht abrechenbarer Byte, werden zur Berechnung des Werts dieses Messwerts verwendet. Dieser Messwert wird in Echtzeit erfasst.
Aufnahmerate (Rohbytes) Projekt Die Rate der Rohbytes, die in alle Caches eines Buckets aufgenommen wurden. Alle 60 Sekunden wird eine Stichprobe erstellt. Alle aufgenommenen Byte, einschließlich nicht abrechenbarer Byte, werden zur Berechnung des Werts dieses Messwerts verwendet. Dieser Messwert wird in Echtzeit erfasst.
Durchsatz – Cache-Treffer Bucket Der vom Cache bereitgestellte Durchsatz, alle 60 Sekunden erfasst.
Durchsatz – Cache-Treffer Projekt Der Durchsatz, der von allen Caches für einen Bucket bereitgestellt wurde, wird alle 60 Sekunden erfasst.
Durchsatz – Cache-Fehler Bucket Der Durchsatz, der nicht aus dem Cache bereitgestellt wird. Die Stichprobenerhebung erfolgt alle 60 Sekunden.
Durchsatz – Cache-Fehler Projekt Der Durchsatz, der nicht aus einem der Caches eines Buckets bereitgestellt wird. Alle 60 Sekunden wird eine Stichprobe erstellt.

Zugriffsdiagramme

In Monitoring-Diagrammen werden Daten entweder für einzelne Buckets oder für alle Buckets in einem Projekt erfasst. Die Ebene der Ressourcenhierarchie, die in einem Diagramm erfasst wird, bestimmt, wo Sie auf das Diagramm zugreifen können.

Auf Diagramme auf Bucket-Ebene zugreifen

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie Überwachungsdiagramme aufrufen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit.

  4. Wählen Sie im Navigationsmenü Anywhere Cache aus.

    Monitoring-Diagramme werden angezeigt.

Auf Diagramme auf Projektebene zugreifen

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie im Navigationsbereich Cloud Storage auf Monitoring.

  3. Klicken Sie in der Menüleiste auf Anywhere Cache.

    Monitoring-Diagramme werden angezeigt.

Lang andauernde Vorgänge verwenden

Wenn die Vorgänge AnywhereCaches Create und Update erfolgreich ausgeführt werden, wird ein Vorgang mit langer Ausführungszeit gestartet. Sie können Vorgänge mit langer Ausführungszeit abrufen und auflisten, um Details und Status des zugrunde liegenden AnywhereCaches-Vorgangs anzusehen, oder einen Vorgang mit langer Ausführungszeit abbrechen, um den zugrunde liegenden AnywhereCaches-Vorgang während der Ausführung abzubrechen.

Eine Anleitung zur Verwendung von Vorgängen mit langer Ausführungszeit für Anywhere Cache finden Sie unter Vorgänge mit langer Ausführungszeit verwenden.

Das folgende Beispiel zeigt einen langwierigen Vorgang, der von einem AnywhereCaches Create-Vorgang gestartet wird:

done: false
kind: storage#operation
metadata:
  '@type': type.googleapis.com/google.storage.control.v2.CreateAnywhereCacheMetadata
  anywhereCacheId: us-central1-c
  zone: us-central1-c
  ttl: 172800s
  admissionPolicy: admit-on-first-miss
  commonMetadata:
    createTime: '2023-12-14T20:52:00.032Z'
    progressPercent: -1
    requestedCancellation: false
    type: create-anywhere-cache
    updateTime: '2023-12-14T20:52:00.032Z'
name: projects/_/buckets/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig
selfLink: https://www.googleapis.com/storage/v1/b/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig

Neuversuche

Asynchrone AnywhereCaches APIs sind standardmäßig idempotent. Das bedeutet, dass Sie asynchrone AnywhereCaches API-Aufrufe sicher wiederholen können, ohne sich Gedanken über unbeabsichtigte Änderungen zu machen.

Angenommen, Sie führen einen AnywhereCaches Create-Vorgang aus, um einen Cache in us-central1-a zu erstellen. Der Vorgang ist erfolgreich. Wenn Sie einen nachfolgenden Vorgang zum Erstellen von AnywhereCaches mit derselben Zone ausführen, der erfolgreich ist, gibt die Anfrage denselben langwierigen Vorgang wie die vorherige Anfrage zurück. Dieses Verhalten tritt nur auf, wenn Sie in Ihrer Anfrage zum Erstellen des Caches ein request_id angeben. Wenn kein request_id enthalten ist, wird beim Versuch, einen Cache zu erstellen, der bereits vorhanden ist, ein ANYWHERE_CACHE_ALREADY_EXISTS-Fehler ausgegeben. Informationen zum Einfügen eines request_id finden Sie unter Duplizierung von Anfragen anfordern.

Nächste Schritte

Empfehlungen dazu erhalten, für welche Buckets und Zonen ein Cache erstellt werden soll