Crea y administra cachés de Anywhere Cache

En esta página, se muestra cómo crear y administrar instancias de caché de Anywhere Cache.

Para obtener información sobre cómo usar y administrar operaciones de larga duración que se inician desde las operaciones de caché asíncronas de Anywhere Cache, consulta Usa operaciones de larga duración.

Antes de usar Anywhere Cache, revisa las limitaciones y restricciones.

Antes de comenzar

Para obtener los permisos que necesitas para crear y administrar cachés de Anywhere Cache, pídele a tu administrador que te otorgue el rol de IAM de Administrador de almacenamiento (roles/storage.admin) en el bucket para el que deseas crear cachés.

Este rol predefinido contiene los permisos necesarios para crear y administrar cachés de Anywhere Cache. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear y administrar cachés de Anywhere Cache:

  • storage.anywhereCaches.disable (obligatorio para inhabilitar las cachés)
  • storage.anywhereCaches.get (obligatorio para obtener cachés)
  • storage.anywhereCaches.create (obligatorio para crear cachés)
  • storage.anywhereCaches.list (obligatorio para mostrar la lista de cachés)
  • storage.anywhereCaches.pause (obligatorio para pausar las cachés)
  • storage.anywhereCaches.resume (obligatorio para reanudar las cachés)
  • storage.anywhereCaches.update (obligatorio para actualizar las cachés)

También puedes obtener estos permisos con roles personalizados.

Para obtener más información sobre cómo otorgar roles en los buckets, consulta Usa IAM con buckets.

Para administrar las operaciones de larga duración que se inician desde los métodos de Anywhere Cache, es posible que necesites roles y permisos adicionales. Consulta los roles obligatorios para las operaciones de larga duración para obtener más información.

Crea una caché

Para aprender a crear y administrar Anywhere Cache con Terraform, consulta el recurso google_storage_anywhere_cache en la documentación de Terraform.

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket para el que deseas almacenar en caché los datos.

  3. En la página de detalles del bucket haz clic en la pestaña Configuración.

  4. En la sección Caché en cualquier lugar, haz clic en Configurar la caché.

    Aparecerá la página Editar configuración de <your_bucket_name> para tu bucket.

  5. En la sección Zonas de caché, haz clic en la región que contiene las zonas en las que deseas crear una caché.

  6. En la sección Zonas de caché, selecciona las zonas en las que deseas crear una caché. Para cada zona que selecciones, especifica un tiempo de actividad y una opción de transferencia para la caché.

  7. Haga clic en Guardar configuración.

  8. En el cuadro de diálogo que aparece, haz clic en Permitir.

    Se abrirá la pestaña Operations en la página Bucket details, que muestra el estado del trabajo de tu operación de creación de caché.

También puedes ver el estado de la caché de un bucket directamente desde la página Bucket list. Para ello, completa las siguientes instrucciones:

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. Haz clic en el ícono Ver columna (), selecciona Caché y, luego, haz clic en Aceptar.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches create:

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

Reemplaza lo siguiente:

  • BUCKET_NAME por el nombre del bucket para el que deseas almacenar en caché los datos. Por ejemplo, my-bucket

  • ZONE por la zona en la que se ejecutará la caché. Por ejemplo, us-east1-b

    Para crear varias cachés a la vez, puedes especificar varias zonas. Por ejemplo, us-east1-b us-east1-c us-east1-d.

Configura las siguientes marcas opcionales para tener un mayor control sobre la creación de la caché:

  • --ttl: Especifica el tiempo de actividad (TTL) de los datos en la caché, en segundos. Si no se especifica, el valor predeterminado es 86400s (24 horas).

  • --admission-policy: Especifica en qué punto se transfieren los datos a la caché. Los valores pueden ser ADMIT_ON_FIRST_MISS o ADMIT_ON_SECOND_MISS. Si no se especifica, el valor predeterminado es ADMIT_ON_FIRST_MISS.

Si se ejecuta de forma correcta, el comando muestra el ID de la operación de larga duración asociada con la operación de creación de AnywhereCache. Puedes obtener detalles sobre la operación de larga duración o cancelar la operación de larga duración para detener la operación de creación de AnywhereCaches antes de que se complete.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Crea un archivo JSON que contenga la siguiente información:

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

    Reemplaza lo siguiente:

    • ZONE por la zona en la que se ejecutará la caché. Por ejemplo, us-east1-b

    • TIME_TO_LIVE con el tiempo de actividad (TTL) de los datos en la caché. El valor puede ser de 1 hora a 7 días, especificado en segundos. Si no se especifica, el valor predeterminado es 86400s (24 horas).

    • ADMISSION_POLICY con la política de admisión de la caché, que especifica cuándo se transfieren los datos. Los valores pueden ser admit-on-first-miss o admit-on-second-miss. Si no se especifica, el valor predeterminado es admit-on-first-miss.

  3. Usa cURL para llamar a la API de JSON con una solicitud para crear una caché:

    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"

    Reemplaza lo siguiente:

    • JSON_FILE_NAME con el nombre del archivo JSON que creaste en el paso 2.

    • BUCKET_NAME por el nombre del bucket para el que deseas almacenar en caché los datos. Por ejemplo, my-bucket

Si se realiza correctamente, la operación muestra una google.longrunning.Operation. Puedes obtener detalles sobre la operación de larga duración o cancelar la operación de larga duración para detener la operación de creación de AnywhereCaches antes de que se complete.

Cómo ver una caché

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas ver.

  3. En la página de detalles del bucket haz clic en la pestaña Configuración.

  4. En la sección Caché de Anywhere, haz clic en Editar junto al campo Caché.

  5. En la página Editar configuración que aparece, selecciona una región para ver todas las cachés dentro de las zonas de la región.

    En el panel Zonas de caché, puedes ver los detalles de cada caché disponible.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches describe:

gcloud storage buckets anywhere-caches describe ID

Reemplaza lo siguiente:

  • ID por el identificador de la instancia de la caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

Usa la marca opcional raw para generar una respuesta de API sin procesar en lugar de una respuesta de API estandarizada.

Si se completa correctamente, el comando muestra un recurso AnywhereCache.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud para obtener una caché:

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

    Reemplaza lo siguiente:

    • BUCKET_NAME con el nombre del bucket asociado con la caché que deseas recuperar. Por ejemplo, my-bucket

    • ANYWHERE_CACHE_ID por la zona en la que se encuentra la caché. Por ejemplo, us-east1-b

Si se realiza correctamente, esta operación muestra un recurso AnywhereCache.

Enumera las cachés

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket asociado con las cachés que deseas ver.

  3. En la página de detalles del bucket haz clic en la pestaña Configuración.

  4. En la sección Caché de Anywhere, haz clic en Editar junto al campo Caché.

  5. En la página Editar configuración que aparece, selecciona una región para ver todas las cachés dentro de las zonas de esa región.

    Todas las cachés disponibles para las zonas de la región aparecen en el panel Zonas de caché.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches list:

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

Reemplaza lo siguiente:

  • BUCKET_NAME con el nombre del bucket asociado con las cachés que deseas enumerar. Por ejemplo, my-bucket

Si se completa correctamente, el comando muestra una lista de recursos de AnywhereCache.

De forma opcional, puedes usar la marca --raw para mostrar una respuesta sin procesar de la API en lugar de una respuesta estandarizada. Para obtener más información sobre el control de los comportamientos de las fichas, como la paginación de resultados, consulta la documentación de gcloud storage ls.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud para enumerar las cachés:

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

    Reemplaza lo siguiente:

    • BUCKET_NAME con el nombre del bucket asociado con las cachés que deseas recuperar. Por ejemplo, my-bucket

    Cuando enumeras varias cachés, puedes paginar los resultados.

Si se realiza correctamente, esta operación muestra una lista de recursos de AnywhereCache. Para obtener detalles sobre la estructura de esta respuesta, consulta la respuesta en la documentación de la lista de AnywhereCaches.

Actualiza una caché

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas actualizar.

  3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Caché en el menú de navegación.

  4. Haz clic en Editar configuración.

  5. En la página Editar configuración que aparece, actualiza las propiedades de la caché y, luego, haz clic en Guardar.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches update:

gcloud storage buckets anywhere-caches update ID

Reemplaza lo siguiente:

  • ID por el identificador de la instancia de la caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

    Para actualizar varias cachés a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Usa las siguientes marcas para actualizar la configuración de la caché. Si no se especifica una marca, el valor no se modifica.

  • --ttl: Especifica el tiempo de actividad (TTL) de los datos en la caché, en segundos.

  • --admission-policy: Especifica en qué punto se transfieren los datos a la caché. Los valores pueden ser ADMIT_ON_FIRST_MISS o ADMIT_ON_SECOND_MISS.

Si se ejecuta de forma correcta, el comando muestra el ID de la operación de larga duración sin procesar asociada con la operación de actualización de AnywhereCache. Puedes obtener detalles sobre la operación de larga duración.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Crea un archivo JSON que incluya cambios en las propiedades de la caché que deseas actualizar.

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

    Reemplaza lo siguiente:

    • TIME_TO_LIVE con el TTL de los datos en la caché. El valor puede ser de 1 hora a 7 días, especificado en segundos. Si no se especifica, se seguirá usando el valor actual.

    • ADMISSION_POLICY con la política de admisión de la caché, que especifica cuándo se transfieren los datos. Los valores pueden ser admit-on-first-miss o admit-on-second-miss. Si no se especifica, se sigue usando el valor actual.

    En el siguiente ejemplo, se actualiza el TTL de la caché a 2 días y su política de admisión para transferir datos en la segunda omisión:

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

  3. Para aplicar las propiedades nuevas, usa cURL para llamar a la API de JSON con una solicitud para actualizar la caché:

    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"

    Reemplaza lo siguiente:

    • JSON_FILE_NAME con el nombre del archivo JSON que creaste en el paso 2.

    • BUCKET_NAME con el nombre del bucket asociado con la caché que deseas actualizar. Por ejemplo, my-bucket

    • ANYWHERE_CACHE_ID por el identificador de la caché. Por ejemplo, us-east1-b

Si se realiza correctamente, la operación muestra una google.longrunning.Operation. Puedes obtener detalles sobre la operación de larga duración.

Cómo pausar una caché

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas pausar.

  3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Caché en el menú de navegación.

  4. Haz clic en Pausar o reanudar una caché.

  5. En el panel que aparece, haz clic en el botón de activación Pausar caché.

  6. Haz clic en Pausar/reanudar.

  7. En el cuadro de diálogo que aparece, haz clic en Permitir.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches pause:

gcloud storage buckets anywhere-caches pause ID

Reemplaza lo siguiente:

  • ID con el identificador de la instancia de la caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

    Para pausar varias cachés a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Si se completa correctamente, el comando muestra un mensaje de éxito.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud para pausar una caché:

    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"

    Reemplaza lo siguiente:

    • BUCKET_NAME con el nombre del bucket asociado con la caché que deseas pausar. Por ejemplo, my-bucket

    • ANYWHERE_CACHE_ID por el identificador de la caché. Por ejemplo, us-east1-b

Si se realiza correctamente, la operación muestra un recurso AnywhereCache con formato.

Cómo reanudar una caché

Console

Para reanudar una caché que se detuvo, sigue estas instrucciones:

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas reanudar.

  3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Caché en el menú de navegación.

  4. Haz clic en Pausar o reanudar una caché.

  5. En el panel que aparece, haz clic en el botón de activación Pausar caché.

  6. Haz clic en Pausar/reanudar.

  7. En el cuadro de diálogo que aparece, haz clic en Permitir.

Para reanudar una caché que se inhabilitó, completa las siguientes instrucciones:

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas reanudar.

  3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Caché en el menú de navegación.

  4. Haz clic en Inhabilitar o reanudar una caché.

  5. En el panel que aparece, haz clic en el botón de activación Inhabilitar caché.

  6. Haz clic en Inhabilitar/reanudar.

  7. En el cuadro de diálogo que aparece, haz clic en Permitir.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches resume:

gcloud storage buckets anywhere-caches resume ID

Reemplaza lo siguiente:

  • ID por el identificador de la instancia de la caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

    Para reanudar varias cachés a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Si se completa correctamente, el comando muestra un recurso AnywhereCache con formato.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud para reanudar una caché:

    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"

    Reemplaza lo siguiente:

    • BUCKET_NAME con el nombre del bucket asociado con la caché que deseas reanudar. Por ejemplo, my-bucket

    • ANYWHERE_CACHE_ID por el identificador de la caché. Por ejemplo, us-east1-b

Si se realiza correctamente, la operación muestra un recurso AnywhereCache con formato.

Cómo inhabilitar una caché

Console

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas inhabilitar.

  3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Caché en el menú de navegación.

  4. Haz clic en Inhabilitar o reanudar una caché.

  5. En el panel que aparece, haz clic en el botón de activación Inhabilitar caché.

  6. Haz clic en Inhabilitar/reanudar.

  7. En el cuadro de diálogo que aparece, haz clic en Permitir.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches disable:

gcloud storage buckets anywhere-caches disable ID

Reemplaza lo siguiente:

  • ID por el identificador de la instancia de la caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

    Para inhabilitar varias cachés a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Si se completa correctamente, el comando muestra un recurso AnywhereCache con formato.

API de REST

API de JSON

  1. Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la API de JSON con una solicitud para inhabilitar una caché:

    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"

    Reemplaza lo siguiente:

    • BUCKET_NAME con el nombre del bucket asociado con la caché que deseas inhabilitar. Por ejemplo, my-bucket

    • ANYWHERE_CACHE_ID por el identificador de la caché. Por ejemplo, us-east1-b

Si se completa correctamente, el comando muestra un recurso AnywhereCache con formato.

Supervisa el rendimiento de la caché

La sección de Cloud Storage de la consola de Google Cloud proporciona gráficos de supervisión que te permiten hacer un seguimiento del rendimiento de tus cachés con métricas. Estos gráficos de supervisión también se pueden ver con Cloud Monitoring.

Gráficos disponibles

Gráfico Nivel de la jerarquía de recursos Descripción
Tasa de expulsión de bytes Bucket Es la tasa de bytes expulsados de la caché, que se muestrea cada hora. Estos datos se actualizan más de una vez por hora para permitir el procesamiento posterior de los datos.
Tasa de expulsión de bytes Proyecto Es la tasa de bytes expulsados de todas las cachés de un bucket, que se muestrea cada hora. Estos datos se actualizan más de una vez por hora para permitir el procesamiento posterior de los datos.
Bytes en la caché Bucket Es la tasa de bytes en la caché, que se muestrea cada hora. Estos datos se actualizan más de una vez por hora para permitir el procesamiento posterior de los datos.
Bytes en la caché Proyecto Es la tasa de bytes en todas las cachés de un bucket, que se muestrea cada hora. Estos datos se actualizan más de una vez por hora para permitir el procesamiento posterior de los datos.
Beneficio de capacidad de procesamiento de caché Proyecto Es la tasa de la cuota de ancho de banda de transferencia de datos para la región, el uso de la cuota y la capacidad de procesamiento adicional que entrega la caché. La capacidad de procesamiento adicional que entrega la caché no se tiene en cuenta para la cuota. Por lo tanto, el uso de la caché permite que los proyectos excedan la capacidad de procesamiento permitida por la cuota.
Operaciones de tasa de aciertos Bucket Es el porcentaje de operaciones de caché que entrega los datos solicitados desde la caché en relación con el total de operaciones aptas para caché, que se muestrean cada 60 segundos. Si una lectura se devuelve por completo desde la caché, la operación se considera un acierto. Si la lectura no se devuelve desde la caché o solo se devuelve parcialmente desde la caché, la operación se considera como un error.
Operaciones de tasa de aciertos Proyecto Es el porcentaje de operaciones de caché que entrega los datos solicitados desde todas las cachés de un bucket en relación con el total de operaciones aptas para caché, con una muestra de 60 segundos. Si una operación de lectura se devuelve por completo desde la caché, la operación se considera un acierto. Si la lectura no se devuelve desde la caché o solo se devuelve parcialmente desde la caché, la operación se considera como un error.
Bytes de tasa de aciertos Bucket Es el porcentaje de bytes que se entregan desde la caché en relación con el total de bytes aptos para caché, que se muestrea cada 60 segundos.
Bytes de tasa de aciertos Proyecto Es el porcentaje de bytes que se entregan desde todas las cachés de un bucket en relación con el total de bytes aptos para caché, con una muestra cada 60 segundos.
Tasa de transferencia de bytes sin procesar Bucket Es la tasa de bytes sin procesar transferidos a cada caché, con muestras cada 60 segundos. Todos los bytes transferidos, incluidos los no facturables, se usan para calcular el valor de esta métrica. Esta métrica se informa en tiempo real.
Tasa de transferencia de bytes sin procesar Proyecto Es la tasa de bytes sin procesar transferidos a todas las cachés de un bucket, que se muestrea cada 60 segundos. Para calcular el valor de esta métrica, se usan todos los bytes transferidos, incluidos los no facturables. Esta métrica se informa en tiempo real.
Capacidad de procesamiento: Acierto de caché Bucket La capacidad de procesamiento que se entrega desde la caché, con muestreos cada 60 segundos.
Capacidad de procesamiento: Acierto de caché Proyecto Es la capacidad de procesamiento que se entrega desde todas las cachés de un bucket, con muestreos cada 60 segundos.
Capacidad de procesamiento: Error de caché Bucket La capacidad de procesamiento que no se entrega desde la caché, con muestreo cada 60 segundos.
Capacidad de procesamiento: Error de caché Proyecto La capacidad de procesamiento que no se entrega desde ninguna de las cachés de un bucket, muestreada cada 60 segundos

Gráficos de acceso

Los gráficos de supervisión capturan datos de buckets individuales o de todos los buckets dentro de un proyecto. El nivel de jerarquía de recursos que captura un gráfico determina dónde puedes acceder a él.

Accede a gráficos a nivel del bucket

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket para el que deseas ver los gráficos de supervisión.

  3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad.

  4. En el menú de navegación, selecciona Caché en cualquier lugar.

    Se muestran los gráficos de supervisión.

Accede a gráficos a nivel del proyecto

  1. En la consola de Google Cloud, ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En el panel de navegación Cloud Storage, haz clic en Supervisión.

  3. En la barra de menú, haz clic en Caché en cualquier lugar.

    Se muestran los gráficos de supervisión.

Usa operaciones de larga duración

Cuando se ejecutan correctamente, las operaciones AnywhereCaches Create y Update inician una operación de larga duración. Puedes obtener y enumerar operaciones de larga duración para ver los detalles y el estado de la operación subyacente de AnywhereCaches, o cancelar una operación de larga duración para cancelar la operación subyacente de AnywhereCaches mientras está en curso.

Para obtener instrucciones sobre el uso de operaciones de larga duración para Anywhere Cache, consulta Usa operaciones de larga duración.

En el siguiente ejemplo, se muestra una operación de larga duración que se inicia desde una operación de creación de 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

Reintentos

Las APIs de AnywhereCaches asíncronas son idempotentes de forma predeterminada. Esto significa que puedes reintentar de manera segura las llamadas a la API de AnywhereCaches asíncronas sin preocuparte por modificar los recursos de forma involuntaria.

Por ejemplo, supongamos que realizas una operación de creación de AnywhereCaches para crear una caché en us-central1-a, que se realiza correctamente. Si realizas una operación de creación de AnywhereCaches posterior con la misma zona que se realiza correctamente, la solicitud muestra la misma operación de larga duración que la solicitud anterior. Ten en cuenta que este comportamiento solo ocurre si incluyes un request_id como parte de tu solicitud de creación de caché. Si no se incluye un request_id, se muestra un error ANYWHERE_CACHE_ALREADY_EXISTS cuando se intenta crear una caché que ya existe. Para obtener información sobre cómo incluir un request_id, consulta Solicitud de duplicación.

¿Qué sigue?

Obtén recomendaciones sobre para qué buckets y zonas crear una caché.