Crear un informe de caché para la puerta de enlace de archivo de S3 - AWS Storage Gateway

Crear un informe de caché para la puerta de enlace de archivo de S3

La puerta de enlace de archivo de S3 puede generar un informe de los metadatos de los archivos que se encuentran actualmente en la memoria caché de carga local de un recurso compartido de archivos específico. Puede aplicar filtros y criterios adicionales que determinen qué tipos específicos de archivos almacenados en la caché aparecen en el informe. Puede utilizar este informe para ayudar a detectar y resolver problemas de la puerta de enlace. Por ejemplo, si tiene archivos que no se cargan desde la puerta de enlace en Amazon S3, puede generar un informe que enumere los archivos específicos que no se cargan y los motivos de ello. El informe es un archivo CSV que contiene una lista de archivos que coinciden con el conjunto de parámetros de filtro que especifique. El archivo de salida se almacena como un objeto de Amazon S3 en una ubicación de bucket que especifique al configurar el informe. Para crear un informe de caché mediante la API de AWS Storage Gateway, consulte StartCacheReport en la Referencia de la API de Storage Gateway. Para crear un informe de caché en la consola de Storage Gateway, utilice el siguiente procedimiento.

Requisitos previos

  • La puerta de enlace debe tener permisos s3:PutObject y s3:AbortMultipartUpload para el bucket de Amazon S3 en el que desea almacenar el informe de caché.

  • Actualmente, no hay ningún otro informe de caché en curso para el recurso compartido de archivos.

  • Debe haber menos de 10 informes de caché existentes para el recurso compartido de archivos.

  • La puerta de enlace debe estar en línea y conectada a AWS.

  • El disco raíz de la puerta de enlace debe tener al menos 20 GB de espacio libre.

Para crear un informe de caché mediante la consola de Storage Gateway

  1. Abra la consola de Storage Gateway en https://console.aws.amazon.com/storagegateway/home/.

  2. En el panel de navegación situado en la parte izquierda de la página, elija Recursos compartidos de archivos y, a continuación, seleccione el recurso compartido de archivos para el que desea crear un informe de caché.

  3. En el menú desplegable Acciones, elija Crear informe de caché.

  4. En el campo Ubicación de Amazon S3, introduzca el bucket de Amazon S3 y el prefijo de la ubicación en la que desee guardar el objeto de archivo CSV del informe de caché completo en Amazon S3. Para seleccionar el bucket y el prefijo del almacenamiento de Amazon S3 existente, elija Examinar S3.

  5. En Rol de IAM, realice una de las siguientes acciones para especificar un rol de IAM que conceda a la puerta de enlace de archivo permisos para generar y almacenar el informe de caché:

    • Para especificar un rol de IAM existente, elija un rol de la lista desplegable.

    • Para crear manualmente un nuevo rol de IAM, seleccione Crear un rol y, a continuación, cree el nuevo rol mediante la consola de IAM.

    nota

    El rol de IAM que especifique debe tener los siguientes permisos para escribir objetos en la ubicación de Amazon S3 del bucket de informes y detener las cargas multiparte al bucket de informes:

    • s3:PutObject

    • s3:AbortMultipartUpload

    El rol también debe permitir que el servicio storagegateway.amazonaws.com asuma el rol mediante la acción sts:AssumeRole.

  6. En Filtro de informe, realice una de las siguientes acciones para determinar qué archivos se incluirán en el informe de caché:

    • Para incluir todos los archivos almacenados en la caché que actualmente no se pueden cargar en Amazon S3, seleccione Todos los archivos no se pueden cargar.

    • Para incluir solo los archivos que no se cargan en Amazon S3 por un motivo específico, seleccione Solo motivos específicos de error de carga. A continuación, en Motivos de error, seleccione uno o varios de los motivos siguientes:

      • Clase de almacenamiento inaccesible: la puerta de enlace no puede acceder a la clase de almacenamiento de Amazon S3 en la que está almacenado el objeto. Para obtener más información, consulte Error: InaccessibleStorageClass.

      • Estado del objeto no válido: el estado del archivo de la puerta de enlace no coincide con su estado en Amazon S3. Para obtener más información, consulte Error: InvalidObjectState.

      • Falta el objeto: el objeto se ha eliminado o movido en Amazon S3. Para obtener más información, consulte Error: ObjectMissing.

      • Acceso a S3 denegado: el rol de IAM de acceso al bucket de Amazon S3 no permite que la puerta de enlace realice la operación de carga. Para obtener más información, consulte Error: s3AccessDenied.

    nota

    La marca Carga errónea de archivos se restablece cada 24 horas y durante el reinicio de la puerta de enlace. Si este informe captura los archivos después del restablecimiento, pero antes de que se vuelvan a marcar, no se registrarán como archivos que no se han podido cargar.

  7. Para ¿Utilizar un punto de conexión de VPC para conectarse a S3?, realice una de las siguientes acciones para especificar cómo se conectará la puerta de enlace al bucket de Amazon S3:

    • Para conectarse directamente sin usar Amazon VPC, elija Conectar directamente al bucket.

    • Para examinar una lista de puntos de conexión de VPC existentes, seleccione Elegir un punto de conexión de VPC y, a continuación, especifique un punto de conexión de la lista desplegable Puntos de conexión de VPC que aparece.

    • Para especificar un punto de conexión de VPC de Amazon existente por su nombre de DNS, elija Introducir un nombre de DNS de punto de conexión de VPC y, a continuación, introduzca el nombre de DNS en el campo Nombre de DNS del punto de conexión de VPC que aparece.

    nota

    Si su recurso compartido de archivos utiliza un punto de conexión de VPC para conectarse a Amazon S3 para realizar operaciones normales, le recomendamos que utilice la misma VPC al configurar el informe de caché. La creación del informe de caché fallará si la puerta de enlace no se puede conectar al bucket de Amazon S3 por algún motivo, incluida una configuración de VPC no válida.

  8. (Opcional) En Etiquetas (opcional), seleccione Agregar nueva etiqueta y, a continuación, introduzca una Clave y un Valor para el informe de caché.

    Una etiqueta es un par clave-valor que distingue entre mayúsculas y minúsculas y que ayuda a categorizar los recursos de Storage Gateway. Agregar etiquetas puede facilitar el filtrado y la búsqueda del informe de caché. Puede repetir este paso para agregar hasta 50 etiquetas.

  9. Elija Crear informe cuando termine.

    Storage Gateway comienza a generar el informe. Puede comprobar el progreso y ver el estado en la pestaña Informes de caché de la página de detalles del recurso compartido de archivos.