Créer et gérer des caches Anywhere Cache

Cette page explique comment créer et gérer des instances de cache Anywhere Cache.

Pour savoir comment utiliser et gérer les opérations de longue durée lancées à partir des opérations de cache asynchrones Anywhere Cache, consultez la section Utiliser des opérations de longue durée.

Avant d'utiliser Anywhere Cache, consultez les limites et restrictions.

Avant de commencer

Pour obtenir les autorisations nécessaires pour créer et gérer des caches Anywhere Cache, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de l'espace de stockage (roles/storage.admin) sur le bucket pour lequel vous souhaitez créer des caches.

Ce rôle prédéfini contient les autorisations requises pour créer et gérer des caches Anywhere Cache. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer et gérer des caches Anywhere Cache:

  • storage.anywhereCaches.disable (obligatoire pour désactiver les caches)
  • storage.anywhereCaches.get (obligatoire pour obtenir des caches)
  • storage.anywhereCaches.create (obligatoire pour créer des caches)
  • storage.anywhereCaches.list (obligatoire pour la liste des caches)
  • storage.anywhereCaches.pause (obligatoire pour mettre en pause les caches)
  • storage.anywhereCaches.resume (obligatoire pour reprendre les caches)
  • storage.anywhereCaches.update (requis pour mettre à jour les caches)

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés.

Pour en savoir plus sur l'attribution de rôles dans des buckets, consultez la page Utiliser IAM avec des buckets.

Pour gérer les opérations de longue durée lancées à partir de méthodes Anywhere Cache, vous aurez peut-être besoin de rôles et d'autorisations supplémentaires. Pour en savoir plus, consultez la section Rôles requis pour les opérations de longue durée.

Créer un cache

Pour savoir comment créer et gérer Anywhere Cache à l'aide de Terraform, consultez la ressource google_storage_anywhere_cache dans la documentation Terraform.

Console

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket pour lequel vous souhaitez mettre en cache les données.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.

  4. Dans la section Cache Anywhere, cliquez sur Configurer le cache.

    La page Modifier la configuration pour <your_bucket_name> s'affiche pour votre bucket.

  5. Dans la section Régions de cache, cliquez sur la région contenant les zones dans lesquelles vous souhaitez créer un cache.

  6. Dans la section Zones de cache, sélectionnez les zones dans lesquelles vous souhaitez créer un cache. Pour chaque zone que vous sélectionnez, spécifiez une option Durée de vie et une option Ingestion pour le cache.

  7. Cliquez sur Enregistrer la configuration.

  8. Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.

    L'onglet Operations (Opérations) de la page Bucket details (Détails du bucket) s'ouvre. Il affiche l'état de la tâche de votre opération de création de cache.

Vous pouvez également afficher l'état du cache d'un bucket directement depuis la page Liste des buckets. Pour ce faire, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Cliquez sur l'icône Afficher la colonne (), sélectionnez Cacher, puis cliquez sur OK.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches create :

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

Remplacez :

  • BUCKET_NAME avec le nom du bucket pour lequel vous souhaitez mettre en cache les données. Exemple :my-bucket

  • ZONE par la zone dans laquelle le cache s'exécutera. Exemple :us-east1-b

    Pour créer plusieurs caches à la fois, vous pouvez spécifier plusieurs zones. (par exemple, us-east1-b us-east1-c us-east1-d)

Définissez les options facultatives suivantes pour mieux contrôler la création du cache:

  • --ttl: spécifie la valeur TTL (Time To Live) des données dans le cache, en secondes. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de 86400s (24 heures).

  • --admission-policy: spécifie à quel moment les données sont ingérées dans le cache. Les valeurs peuvent être ADMIT_ON_FIRST_MISS ou ADMIT_ON_SECOND_MISS. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de ADMIT_ON_FIRST_MISS.

Si l'opération réussit, la commande renvoie l'ID de l'opération de longue durée associée à l'opération de création AnywhereCache. Vous pouvez obtenir des détails sur l'opération de longue durée ou bien l'annuler, afin d'interrompre l'opération de création d'AnywhereCaches avant qu'elle n'arrive à son terme.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Créez un fichier JSON contenant les informations suivantes :

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

    Remplacez :

    • ZONE par la zone dans laquelle le cache s'exécutera. Exemple :us-east1-b

    • TIME_TO_LIVE avec la valeur TTL (Time To Live) des données dans le cache. Cette valeur peut être comprise entre 1 heure et 7 jours, spécifiée en secondes. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de 86400s (24 heures).

    • ADMISSION_POLICY avec la stratégie d'admission du cache, qui spécifie quand les données sont ingérées. Les valeurs peuvent être admit-on-first-miss ou admit-on-second-miss. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de admit-on-first-miss.

  3. Utilisez cURL pour appeler l'API JSON avec une requête permettant de créer un cache:

    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"

    Remplacez :

    • JSON_FILE_NAME avec le nom du fichier JSON que vous avez créé à l'étape 2.

    • BUCKET_NAME avec le nom du bucket pour lequel vous souhaitez mettre en cache les données. Exemple :my-bucket

Si l'opération réussit, elle renvoie un google.longrunning.Operation. Vous pouvez obtenir des détails sur l'opération de longue durée ou bien l'annuler, afin d'interrompre l'opération de création d'AnywhereCaches avant qu'elle n'arrive à son terme.

Afficher un cache

Console

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez afficher.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.

  4. Dans la section Cache Anywhere, cliquez sur Modifier à côté du champ Cache.

  5. Sur la page Modifier la configuration qui s'affiche, sélectionnez une région pour afficher tous les caches des zones de la région.

    Dans le volet Zones de cache, vous pouvez ensuite afficher des informations détaillées sur chaque cache disponible.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches describe :

gcloud storage buckets anywhere-caches describe ID

Remplacez :

  • ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

Utilisez l'indicateur raw facultatif pour générer une réponse API brute au lieu d'une réponse API normalisée.

Si l'opération réussit, la commande renvoie une ressource AnywhereCache.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête permettant d'obtenir un cache:

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

    Remplacez :

    • BUCKET_NAME par le nom du bucket associé au cache que vous souhaitez récupérer. Exemple : my-bucket.

    • ANYWHERE_CACHE_ID par la zone dans laquelle se trouve le cache. Exemple :us-east1-b

Si l'opération réussit, elle renvoie une ressource AnywhereCache.

Répertorier les caches

Console

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket associé aux caches que vous souhaitez afficher.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.

  4. Dans la section Cache Anywhere, cliquez sur Modifier à côté du champ Cache.

  5. Sur la page Modifier la configuration qui s'affiche, sélectionnez une région pour afficher tous les caches dans les zones de cette région.

    Tous les caches disponibles pour les zones de la région s'affichent dans le volet Zones de cache.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches list :

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

Remplacez :

  • BUCKET_NAME par le nom du bucket associé aux caches que vous souhaitez répertorier. Exemple :my-bucket

Si l'opération réussit, la commande renvoie une liste de ressources AnywhereCache.

Vous pouvez éventuellement utiliser l'indicateur --raw pour renvoyer une réponse API brute au lieu d'une réponse standardisée. Pour en savoir plus sur le contrôle des comportements des fiches, comme la pagination des résultats, consultez la documentation sur gcloud storage ls.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête permettant de lister les caches:

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

    Remplacez :

    • BUCKET_NAME avec le nom du bucket associé aux caches que vous souhaitez récupérer. Exemple : my-bucket.

    Lorsque vous listez plusieurs caches, vous pouvez paginar les résultats.

Si l'opération réussit, elle renvoie une liste de ressources AnywhereCache. Pour en savoir plus sur la structure de cette réponse, consultez la réponse dans la documentation de la liste AnywhereCaches.

Mettre à jour un cache

Console

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez mettre à jour.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Cache dans le menu de navigation.

  4. Cliquez sur Modifier la configuration.

  5. Sur la page Modifier la configuration qui s'affiche, mettez à jour les propriétés du cache, puis cliquez sur Enregistrer.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches update :

gcloud storage buckets anywhere-caches update ID

Remplacez :

  • ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

    Pour mettre à jour plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Utilisez les indicateurs suivants pour mettre à jour la configuration du cache. Si aucun indicateur n'est spécifié, la valeur reste inchangée.

  • --ttl: spécifie la valeur TTL (Time To Live) des données dans le cache, en secondes.

  • --admission-policy: spécifie à quel moment les données sont ingérées dans le cache. Les valeurs peuvent être ADMIT_ON_FIRST_MISS ou ADMIT_ON_SECOND_MISS.

Si l'opération réussit, la commande renvoie l'ID de l'opération de longue durée brute associée à l'opération de mise à jour AnywhereCache. Vous pouvez obtenir des détails sur l'opération de longue durée.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Créez un fichier JSON incluant les modifications apportées aux propriétés de cache que vous souhaitez mettre à jour.

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

    Remplacez :

    • TIME_TO_LIVE avec la valeur TTL des données dans le cache. Cette valeur peut être comprise entre 1 heure et 7 jours, spécifiée en secondes. Si elle n'est pas spécifiée, la valeur actuelle continue d'être utilisée.

    • ADMISSION_POLICY avec la stratégie d'admission du cache, qui spécifie quand les données sont ingérées. Les valeurs peuvent être admit-on-first-miss ou admit-on-second-miss. Si aucune valeur n'est spécifiée, la valeur actuelle continue d'être utilisée.

    L'exemple suivant met à jour la valeur TTL du cache sur deux jours et sa stratégie d'admission pour ingérer des données lors de la deuxième erreur:

    {
   "ttl": "172800s",
   "admissionPolicy": "admit-on-second-miss"
}

  3. Pour appliquer les nouvelles propriétés, utilisez cURL pour appeler l'API JSON avec une requête permettant de mettre à jour le cache:

    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"

    Remplacez :

    • JSON_FILE_NAME avec le nom du fichier JSON que vous avez créé à l'étape 2.

    • BUCKET_NAME par le nom du bucket associé au cache que vous souhaitez mettre à jour. Exemple : my-bucket.

    • ANYWHERE_CACHE_ID par l'identifiant du cache. Exemple :us-east1-b

Si l'opération réussit, elle renvoie un google.longrunning.Operation. Vous pouvez obtenir des détails sur l'opération de longue durée.

Suspendre un cache

Console

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez suspendre.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Cache dans le menu de navigation.

  4. Cliquez sur Mettre en pause/Réactiver un cache.

  5. Dans le volet qui s'affiche, cliquez sur le bouton bascule Suspendre le cache.

  6. Cliquez sur Suspendre/Réactiver.

  7. Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches pause :

gcloud storage buckets anywhere-caches pause ID

Remplacez :

  • ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

    Pour suspendre plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Si l'opération réussit, la commande renvoie un message de confirmation.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête pour suspendre un cache:

    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"

    Remplacez :

    • BUCKET_NAME par le nom du bucket associé au cache que vous souhaitez suspendre. Exemple : my-bucket.

    • ANYWHERE_CACHE_ID par l'identifiant du cache. Exemple :us-east1-b

Si l'opération aboutit, elle renvoie une ressource AnywhereCache formatée.

Réactiver un cache

Console

Pour reprendre un cache suspendu, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez reprendre.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Cache dans le menu de navigation.

  4. Cliquez sur Mettre en pause/Réactiver un cache.

  5. Dans le volet qui s'affiche, cliquez sur le bouton bascule Suspendre le cache.

  6. Cliquez sur Suspendre/Réactiver.

  7. Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.

Pour réactiver un cache qui a été désactivé, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez reprendre.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Cache dans le menu de navigation.

  4. Cliquez sur Désactiver/Réactiver un cache.

  5. Dans le volet qui s'affiche, cliquez sur le bouton bascule Désactiver le cache.

  6. Cliquez sur Désactiver/Réactiver.

  7. Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches resume :

gcloud storage buckets anywhere-caches resume ID

Remplacez :

  • ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

    Pour reprendre plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Si l'opération réussit, la commande renvoie une ressource AnywhereCache formatée.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête pour reprendre un cache:

    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"

    Remplacez :

    • BUCKET_NAME avec le nom du bucket associé au cache que vous souhaitez reprendre. Exemple : my-bucket.

    • ANYWHERE_CACHE_ID par l'identifiant du cache. Exemple :us-east1-b

Si l'opération aboutit, elle renvoie une ressource AnywhereCache formatée.

Désactiver un cache

Console

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez désactiver.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Cache dans le menu de navigation.

  4. Cliquez sur Désactiver/Réactiver un cache.

  5. Dans le volet qui s'affiche, cliquez sur le bouton bascule Désactiver le cache.

  6. Cliquez sur Désactiver/Réactiver.

  7. Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches disable :

gcloud storage buckets anywhere-caches disable ID

Remplacez :

  • ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

    Pour désactiver plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Si l'opération réussit, la commande renvoie une ressource AnywhereCache formatée.

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête visant à désactiver un cache:

    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"

    Remplacez :

    • BUCKET_NAME par le nom du bucket associé au cache que vous souhaitez désactiver. Exemple : my-bucket.

    • ANYWHERE_CACHE_ID par l'identifiant du cache. Exemple :us-east1-b

Si l'opération réussit, la commande renvoie une ressource AnywhereCache formatée.

Surveiller les performances des caches

La partie Cloud Storage de la console Google Cloud fournit des graphiques de surveillance qui vous permettent de suivre les performances de vos caches à l'aide de métriques. Vous pouvez également consulter ces graphiques de surveillance à l'aide de Cloud Monitoring.

Graphiques disponibles

Graphique Niveau de la hiérarchie des ressources Description
Taux d'éviction des octets Bucket Taux d'octets évincés du cache, échantillonné toutes les heures. Ces données sont actualisées plus d'une fois par heure pour laisser le temps nécessaire au post-traitement des données.
Taux d'éviction des octets Projet Taux d'octets évincés de tous les caches d'un bucket, échantillonné toutes les heures. Ces données sont actualisées plus d'une fois par heure pour laisser le temps nécessaire au post-traitement des données.
Octets dans le cache Bucket Taux d'octets dans le cache, échantillonné toutes les heures. Ces données sont actualisées plus d'une fois par heure pour laisser le temps nécessaire au post-traitement des données.
Octets dans le cache Projet Taux d'octets dans tous les caches d'un bucket, échantillonné toutes les heures. Ces données sont actualisées plus d'une fois par heure pour laisser le temps nécessaire au post-traitement des données.
Avantages du débit de cache Projet Taux du quota de bande passante de transfert de données pour la région, utilisation du quota et débit supplémentaire fourni par le cache. Le débit supplémentaire fourni par le cache n'est pas comptabilisé dans le quota. L'utilisation du cache permet donc aux projets de dépasser le débit autorisé par le quota.
Opérations de taux de réussite Bucket Pourcentage d'opérations de cache qui diffusent les données demandées à partir du cache par rapport au nombre total d'opérations éligibles à la mise en cache, échantillonné toutes les 60 secondes. Si une lecture est entièrement renvoyée à partir du cache, l'opération est considérée comme un succès. Si la lecture n'est pas renvoyée par le cache ou si elle n'est renvoyée que partiellement, l'opération est considérée comme un échec.
Opérations de taux de réussite Projet Pourcentage d'opérations de cache qui diffusent les données demandées à partir de tous les caches d'un bucket par rapport au nombre total d'opérations éligibles à la mise en cache, échantillonné toutes les 60 secondes. Si une lecture est entièrement renvoyée à partir du cache, l'opération est considérée comme un succès. Si la lecture n'est pas renvoyée par le cache ou si elle n'est renvoyée que partiellement, l'opération est considérée comme un échec.
Octets du taux de succès Bucket Pourcentage d'octets diffusés à partir du cache par rapport au nombre total d'octets éligibles à la mise en cache, échantillonné toutes les 60 secondes.
Octets de taux de succès Projet Pourcentage d'octets diffusés à partir de tous les caches d'un bucket par rapport au nombre total d'octets éligibles à la mise en cache, échantillonné toutes les 60 secondes.
Taux d'ingestion en octets bruts Bucket Taux d'octets bruts ingérés dans chaque cache, échantillonné toutes les 60 secondes. Tous les octets ingérés, y compris les octets non facturables, sont utilisés pour calculer la valeur de cette métrique. Cette métrique est enregistrée en temps réel.
Taux d'ingestion en octets bruts Projet Taux d'octets bruts ingérés dans tous les caches d'un bucket, échantillonné toutes les 60 secondes. Tous les octets ingérés, y compris les octets non facturables, sont utilisés pour calculer la valeur de cette métrique. Cette métrique est enregistrée en temps réel.
Débit - Succès de cache Bucket Débit fourni par le cache, échantillonné toutes les 60 secondes.
Débit - Succès de cache Projet Débit fourni par tous les caches d'un bucket, échantillonné toutes les 60 secondes.
Débit - Défaut de cache (miss) Bucket Débit qui n'est pas fourni par le cache, échantillonné toutes les 60 secondes.
Débit - Défaut de cache (miss) Projet Débit qui n'est pas fourni par l'un des caches d'un bucket, échantillonné toutes les 60 secondes.

Graphiques d'accès

Les graphiques de surveillance capturent des données pour des buckets individuels ou pour tous les buckets d'un projet. Le niveau de la hiérarchie des ressources capturé par un graphique détermine l'emplacement auquel vous pouvez y accéder.

Accéder aux graphiques au niveau du bucket

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans la liste des buckets, cliquez sur le nom du bucket pour lequel vous souhaitez afficher des graphiques de surveillance.

  3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité.

  4. Dans le menu de navigation, sélectionnez Anywhere Cache.

    Les graphiques de surveillance s'affichent.

Accéder aux graphiques au niveau du projet

  1. Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.

    Accéder à la page "Buckets"

  2. Dans le volet de navigation Cloud Storage, cliquez sur Surveillance.

  3. Dans la barre de menu, cliquez sur Anywhere Cache (Cache Anywhere).

    Les graphiques de surveillance s'affichent.

Utiliser des opérations de longue durée

Une fois exécutées, les opérations AnywhereCaches Create (Création d'un AnywhereCache) et Update (Mise à jour) lancent une opération de longue durée. Vous pouvez obtenir et lister les opérations de longue durée afin d'afficher les détails et l'état de l'opération AnywhereCaches sous-jacente, ou annuler une opération de longue durée pour annuler l'opération AnywhereCaches sous-jacente en cours.

Pour savoir comment utiliser les opérations de longue durée pour Anywhere Cache, consultez la section Utiliser des opérations de longue durée.

L'exemple suivant montre une opération de longue durée lancée à partir d'une opération de création AnywhereCaches:

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

Tentatives

Les API AnywhereCaches asynchrones sont idempotentes par défaut. Cela signifie que vous pouvez relancer en toute sécurité des appels d'API AnywhereCaches asynchrones sans vous soucier d'avoir potentiellement modifié involontairement des ressources.

Par exemple, imaginons que vous effectuiez une opération de création AnywhereCaches pour créer un cache dans us-central1-a, ce qui aboutit. Si vous effectuez une opération de création AnywhereCaches ultérieure à l'aide de la même zone qui aboutit, la requête renvoie la même opération longue durée que la requête précédente. Notez que ce comportement ne se produit que si vous incluez un request_id dans votre requête de création de cache. Si un request_id n'est pas inclus, une erreur ANYWHERE_CACHE_ALREADY_EXISTS s'affiche lorsque vous essayez de créer un cache qui existe déjà. Pour savoir comment inclure un request_id, consultez la section Dupliquer une requête.

Étape suivante

Recevez des recommandations sur les buckets et les zones pour lesquels créer un cache.