# Trabajo con grupos de Lente de almacenamiento de S3 para filtrar y agregar métricas Un grupo de Lente de almacenamiento de Amazon S3 agrega métricas mediante filtros personalizados en función de metadatos de objeto. Los grupos de Lente de almacenamiento le ayudan a desglosar las características de sus datos, como la distribución de los objetos por antigüedad, sus tipos de archivos más comunes, etc. Por ejemplo, puede filtrar las métricas por etiqueta de objeto para identificar sus conjuntos de datos de crecimiento más rápido o visualizar su almacenamiento en función del tamaño y la antigüedad del objeto para fundamentar su estrategia de archivado de almacenamiento. Como resultado, los grupos de Lente de almacenamiento de Amazon S3 le ayudan a comprender y optimizar mejor su almacenamiento de S3. Cuando utiliza grupos de Lente de almacenamiento, puede analizar y filtrar las métricas de S3 Lente de almacenamiento utilizando metadatos de objetos, como prefijos, sufijos, [etiquetas de objetos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html), tamaño de objetos o antigüedad de objetos. También puede aplicar una combinación de estos filtros. Después de asociar su grupo de Lente de almacenamiento al panel de S3 Lente de almacenamiento, podrá ver las métricas de S3 Lente de almacenamiento agregadas por los grupos de Lente de almacenamiento de Amazon S3 directamente en su panel. Por ejemplo, también puede filtrar sus métricas por tamaño de objeto o por franjas de antigüedad para determinar qué parte de su almacenamiento está formada por objetos pequeños. A continuación, puede utilizar esta información con S3 Intelligent-Tiering o S3 Lifecycle para realizar la transición de los objetos pequeños a diferentes clases de almacenamiento con el fin de optimizar los costes y el almacenamiento. **Topics** + [Cómo funcionan los grupos de S3 Storage Lens](storage-lens-groups.md) + [Uso de grupos de Lente de almacenamiento](storage-lens-group-tasks.md) # Cómo funcionan los grupos de S3 Storage Lens Puede usar los grupos de Lente de almacenamiento para agregar métricas mediante filtros personalizados en función de los metadatos de objetos. Al definir un filtro personalizado, puede usar prefijos, sufijos, etiquetas de objetos, tamaños de objetos, antigüedad de objetos o una combinación de estos filtros personalizados. Durante la creación del grupo de Lente de almacenamiento, también puede incluir un filtro único o varias condiciones de filtro. Para especificar varias condiciones de filtro, utilice los operadores lógicos `And` o `Or`. Al crear y configurar un grupo de Lente de almacenamiento, el propio grupo de Lente de almacenamiento actúa como un filtro personalizado en el panel al que se asocia el grupo. A continuación, en su panel, puede utilizar el filtro de grupo de Lente de almacenamiento para obtener métricas de almacenamiento en función del filtro personalizado que haya definido en el grupo. Para ver los datos de su grupo de Lente de almacenamiento en el panel Lente de almacenamiento de S3, debe asociar el grupo al panel una vez creado el grupo. Cuando el grupo de Lente de almacenamiento esté asociado al panel de Lente de almacenamiento, este recopilará las métricas de uso del almacenamiento en un plazo de 48 horas. A continuación, puede visualizar estos datos en el panel de Lente de almacenamiento o exportarlos mediante una exportación de métricas. Si olvida asociar un grupo de Lente de almacenamiento a un panel, los datos del grupo de Lente de almacenamiento no se capturarán ni se mostrarán en ningún lugar. **nota** Cuando crea un grupo de S3 Lente de almacenamiento, está creando un recurso de AWS. Por lo tanto, cada grupo de Lente de almacenamiento tiene su propio nombre de recurso de Amazon (ARN), que puede especificar al [asociarlo o excluirlo de un panel de S3 Lente de almacenamiento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html). Si su grupo de Lente de almacenamiento no está asociado a un panel, no incurrirá en ningún cargo adicional por crear un grupo de Lente de almacenamiento. S3 Lente de almacenamiento agrega las métricas de uso para un objeto en todos los grupos de Lente de almacenamiento coincidentes. Por lo tanto, si un objeto cumple las condiciones de filtrado de dos o más grupos de Lente de almacenamiento, verá recuentos repetidos para el mismo objeto a lo largo de su uso de almacenamiento. Puede crear un grupo de Lente de almacenamiento a nivel de cuenta de una región de origen específica (de la lista de Regiones de AWS admitidas). A continuación, puede asociar su grupo de Lente de almacenamiento a varios paneles de Lente de almacenamiento, siempre que los paneles se encuentren en la misma Cuenta de AWS y región de origen. Puede crear hasta 50 grupos de Lente de almacenamiento por región de origen en cada Cuenta de AWS. Puede crear y administrar los grupos de S3 Storage Lens mediante la consola de Amazon S3, AWS Command Line Interface, (AWS CLI), los SDK de AWS o la API de REST de Amazon S3. **Topics** + [Visualización de las métricas agregadas del grupo de Lente de almacenamiento](#storage-lens-group-aggregation) + [Permisos de grupos de Storage Lens](#storage-lens-group-permissions) + [Configuración de grupos de Lente de almacenamiento](#storage-lens-groups-configuration) + [Etiquetas de recursos de AWS](#storage-lens-group-resource-tags) + [Exportación de métricas de grupos de Lente de almacenamiento](#storage-lens-groups-metrics-export) ## Visualización de las métricas agregadas del grupo de Lente de almacenamiento Puede ver las métricas agregadas de sus grupos de Lente de almacenamiento asociando los grupos a un panel. Los grupos de Lente de almacenamiento que desee asociar deben encontrarse en la región de origen designada en la cuenta del panel. Para asociar un grupo de Lente de almacenamiento a un panel, debe especificar el grupo en la sección **Agregación de grupos de Lente de almacenamiento** de la configuración del panel. Si tiene varios grupos de Lente de almacenamiento, puede filtrar los resultados de la **Agregación de grupos de Lente de almacenamiento** para incluir o excluir solo los grupos que desee. Para obtener más información acerca de cómo asociar grupos a sus paneles, consulte [Asociación o eliminación de grupos de S3 Lente de almacenamiento a o desde su panel](storage-lens-groups-dashboard-console.md). Una vez que haya asociado los grupos, verá los datos de agregación de grupos de Lente de almacenamiento adicionales en el panel en un plazo de 48 horas. **nota** Para ver las métricas agregadas para su grupo de Lente de almacenamiento, debe asociar el grupo a un panel de S3 Lente de almacenamiento. ## Permisos de grupos de Storage Lens Los grupos de Storage Lens requieren determinados permisos en AWS Identity and Access Management (IAM) para autorizar el acceso a las acciones del grupo de S3 Storage Lens. Para conceder estos permisos, puede utilizar una política de IAM basada en identidades. Para asociar esta política a usuarios, grupos o roles de IAM para concederles permisos. Estos permisos pueden incluir la posibilidad de crear o eliminar grupos de Lente de almacenamiento, ver sus configuraciones o administrar sus etiquetas. El rol o usuario de IAM al que concede permisos debe pertenecer a la cuenta que creó o ser propietaria del grupo de Lente de almacenamiento. Para usar los grupos de Lente de almacenamiento y ver las métricas de los grupos de Lente de almacenamiento, debe tener primero los permisos adecuados para usar S3 Lente de almacenamiento. Para obtener más información, consulte [Configuración de permisos de Lente de almacenamiento de Amazon S3](storage_lens_iam_permissions.md). Para crear y administrar grupos de S3 Lente de almacenamiento, debe tener los siguientes permisos de IAM, en función de las acciones que desee realizar: | Action | Permisos de IAM | | --- | --- | | Crear un nuevo grupo de Lente de almacenamiento | `s3:CreateStorageLensGroup` | | Crear un nuevo grupo de Lente de almacenamiento con etiquetas | `s3:CreateStorageLensGroup`, `s3:TagResource` | | Actualizar un grupo de Lente de almacenamiento existente | `s3:UpdateStorageLensGroup` | | Devolver los detalles de una configuración de grupo de Lente de almacenamiento | `s3:GetStorageLensGroup` | | Enumerar todos los grupos de Lente de almacenamiento de su región de origen | `s3:ListStorageLensGroups` | | Eliminar un grupo de Lente de almacenamiento | `s3:DeleteStorageLensGroup` | | Enumerar las etiquetas que se agregaron a su grupo de Lente de almacenamiento | `s3:ListTagsForResource` | | Agregar o actualizar una etiqueta de grupo de Lente de almacenamiento para un grupo de Lente de almacenamiento existente | `s3:TagResource` | | Eliminar una etiqueta de un grupo de Lente de almacenamiento | `s3:UntagResource` | Este es un ejemplo de cómo configurar la política de IAM en la cuenta que crea el grupo de Lente de almacenamiento. Para usar esta política, sustituya `us-east-1` por la región de origen en la que se encuentra su grupo de Lente de almacenamiento. Sustituya `111122223333` por su ID Cuenta de AWS, y `example-storage-lens-group` por el nombre de su grupo de Lente de almacenamiento. Para aplicar estos permisos a todos los grupos de Lente de almacenamiento, sustituya `example-storage-lens-group` por un `*`. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "EXAMPLE-Statement-ID", "Effect": "Allow", "Action": [ "s3:CreateStorageLensGroup", "s3:UpdateStorageLensGroup", "s3:GetStorageLensGroup", "s3:ListStorageLensGroups", "s3:DeleteStorageLensGroup, "s3:TagResource", "s3:UntagResource", "s3:ListTagsForResource" ], "Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens-group/example-storage-lens-group" } ] } ``` Para obtener más información acerca del uso de S3 Storage Lens, consulte [Configuración de permisos de Lente de almacenamiento de Amazon S3](storage_lens_iam_permissions.md). Para obtener más información sobre el lenguaje de la política de IAM, consulte [Políticas y permisos en Amazon S3](access-policy-language-overview.md). ## Configuración de grupos de Lente de almacenamiento ### Nombre de grupo de S3 Lente de almacenamiento Recomendamos dar a los grupos de Lente de almacenamiento nombres que indiquen su finalidad para que pueda determinar con facilidad qué grupos desea asociar a sus paneles. Para [asociar un grupo de Lente de almacenamiento a un panel](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html), debe especificar el grupo en la sección **Agregación de grupos de Lente de almacenamiento** de la configuración del panel. Los nombres de grupos de Storage Lens deben ser únicos dentro de la cuenta. No deben contener más de 64 caracteres, y pueden contener únicamente letras (a-z, A-Z), números (0-9), guiones (`-`) y guiones bajos (`_`). ### Región de origen La región de origen es la Región de AWS donde se crea y mantiene su grupo de Lente de almacenamiento. Su grupo de Lente de almacenamiento se crea en la misma región de origen que su panel de Lente de almacenamiento de Amazon S3. La configuración y las métricas del grupo de Lente de almacenamiento también se almacenan en esta región. Puede crear hasta 50 grupos de Lente de almacenamiento en una región de origen. Después de crear su grupo de Lente de almacenamiento, no puede editar la región de origen. ### Ámbito Para incluir objetos en su grupo de Lente de almacenamiento, deben estar dentro del ámbito de su panel de Lente de almacenamiento de Amazon S3. El ámbito de su panel de Lente de almacenamiento viene determinado por los buckets que incluyó en el **Ámbito del panel** de su configuración del panel de S3 Lente de almacenamiento. Puede usar diferentes filtros para sus objetos con el fin de definir el ámbito de su grupo de Lente de almacenamiento. Para ver estas métricas de grupo de Lente de almacenamiento en su panel de S3 Lente de almacenamiento, los objetos deben coincidir con los filtros que incluye en sus grupos de Lente de almacenamiento. Por ejemplo, supongamos que su grupo de Lente de almacenamiento incluye objetos con el prefijo `marketing` y el sufijo`.png`, pero ningún objeto cumple esos criterios. En este caso, no se generarán las métricas de este grupo de Lente de almacenamiento en su exportación de métricas diaria y no se mostrará ninguna métrica para este grupo en su panel. ### Filtros Puede usar los siguientes filtros en un grupo de S3 Lente de almacenamiento: + **Prefijos**: especifica el [prefijo](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) de los objetos incluidos, que es una cadena de caracteres al principio del nombre de la clave de objeto. Por ejemplo, un valor de `images` para el filtro de **Prefijos** incluye los objetos con cualquiera de los siguientes prefijos: `images/`, `images-marketing` y `images/production`. La longitud máxima de un prefijo es de 1024 bytes. + **Sufijos**: especifica el sufijo de los objetos incluidos (por ejemplo, `.png`, `.jpeg` o `.csv`). La longitud máxima de un sufijo es de 1024 bytes. + **Etiquetas de objetos**: especifica la lista de [etiquetas de objetos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) por las que desea filtrar. Una clave de etiqueta no puede superar los 128 caracteres Unicode y el valor de una etiqueta no puede superar los 256 caracteres Unicode. Tenga en cuenta que si el campo de valor de la etiqueta del objeto se deja vacío, los grupos de lentes de almacenamiento de S3 solo harán coincidir el objeto con otros objetos que también tengan valores de etiqueta vacíos. + **Antigüedad**: especifica el rango de antigüedad de los objetos incluidos en días. Solo se admiten números enteros. + **Tamaño**: especifica el rango de tamaños de objeto de los objetos incluidos en bytes. Solo se admiten números enteros. El valor máximo permitido es de 50 TB. ### Etiquetas de objetos del grupo de Lente de almacenamiento Puede [crear un grupo de Lente de almacenamiento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-create.html) que incluya hasta 10 filtros de etiquetas de objetos. El siguiente ejemplo incluye dos pares clave-valor de etiquetas de objetos como filtros para un grupo de Lente de almacenamiento denominado `Marketing-Department`. Para usar este ejemplo, sustituya `Marketing-Department` por el nombre del grupo y reemplace`object-tag-key-1`, y así sucesivamente`object-tag-value-1`, por los pares clave-valor de etiquetas de objeto por los que desee filtrar. ``` { "Name": "Marketing-Department", "Filter": { "MatchAnyTag":[ { "Key": "object-tag-key-1", "Value": "object-tag-value-1" }, { "Key": "object-tag-key-2", "Value": "object-tag-value-2" } ] } } ``` ### Operadores lógicos (`And` o `Or`) Para incluir varias condiciones de filtro en su grupo de Lente de almacenamiento, puede utilizar operadores lógicos (`And` o `Or`). En el siguiente ejemplo, el grupo de Lente de almacenamiento `Marketing-Department` tiene un operador `And` que contiene los filtros `Prefix`, `ObjectAge` y `ObjectSize`. Como se utiliza un operador `And`, solo los objetos que coincidan con **todas** estas condiciones de filtro se incluirán en el ámbito del grupo de Lente de almacenamiento. Para usar este ejemplo, sustituya los `user input placeholders` por los valores por los que desee filtrar. ``` { "Name": "Marketing-Department", "Filter": { "And": { "MatchAnyPrefix": [ "prefix-1", "prefix-2", "prefix-3/sub-prefix-1" ], "MatchObjectAge": { "DaysGreaterThan": 10, "DaysLessThan": 60 }, "MatchObjectSize": { "BytesGreaterThan": 10, "BytesLessThan": 60 } } } } ``` **nota** Si desea incluir objetos que cumplan **alguna** de las condiciones de los filtros, sustituya el operador lógico `And` por el operador lógico `Or` de este ejemplo. ## Etiquetas de recursos de AWS Cada grupo de S3 Lente de almacenamiento se considera un recurso de AWS con su propio nombre de recurso de Amazon (ARN). Por lo tanto, al configurar su grupo de Lente de almacenamiento, si lo desea, puede añadir etiquetas de recursos de AWS al grupo. Puede añadir un máximo de 50 etiquetas a cada grupo de Lente de almacenamiento. Para crear un grupo de Lente de almacenamiento con etiquetas, debe tener los permisos `s3:CreateStorageLensGroup` y `s3:TagResource`. Puede usar etiquetas de recursos de AWS para clasificar los recursos por departamento, línea de negocio o proyecto. Esto resulta útil cuando se tienen muchos recursos del mismo tipo. Al aplicar etiquetas, puede identificar rápidamente un grupo de Lente de almacenamiento específico en función de las etiquetas que le haya asignado. También puede utilizar etiquetas para realizar un seguimiento de los costes y asignarlos. Además, cuando agrega una etiqueta de recurso de AWS a su grupo de Lente de almacenamiento, activa el [control de acceso basado en atributos (ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)). ABAC es una estrategia de autorización que define permisos basados en atributos, en este caso, etiquetas. También puede utilizar las condiciones que especifican etiquetas de recursos en sus políticas de IAM para [controlar el acceso a los recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources). Puede editar las claves y los valores de las etiquetas y también puede eliminar etiquetas de un recurso en cualquier momento. Además, debe tener en cuenta las siguientes limitaciones: + Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. + Si añade una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al antiguo. + Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso. + No incluya datos privados o confidenciales en sus etiquetas de recursos de AWS. + No se admiten etiquetas del sistema (o las etiquetas con claves de etiquetas que comiencen por `aws:`). + La longitud de cada clave de etiqueta no puede superar los 128 caracteres. La longitud del valor de cada etiqueta no puede superar los 256 caracteres. ## Exportación de métricas de grupos de Lente de almacenamiento Las métricas del grupo de Lente de almacenamiento de S3 se incluyen en la [Exportación de métricas de Lente de almacenamiento de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_understanding_metrics_export_schema.html) para el panel al que está asociado el grupo de Lente de almacenamiento. Para obtener información general acerca de la característica de exportación de métricas de Lente de almacenamiento, consulte [Visualización de las métricas de Amazon S3 Storage Lens mediante una exportación de datos](storage_lens_view_metrics_export.md). La exportación de métricas para los grupos de Lente de almacenamiento incluye las métricas de S3 Lente de almacenamiento que estén incluidas en el panel al que asoció el grupo de Lente de almacenamiento. La exportación también incluye datos de métricas adicionales para los grupos de Lente de almacenamiento. Una vez creado su grupo de Lente de almacenamiento, la exportación de métricas se envía a diario al bucket que seleccionó al configurar la exportación de métricas para el panel al que está asociado su grupo. Puede tardar hasta 48 horas en recibir la primera exportación de métricas. Para generar métricas en la exportación diaria, los objetos deben coincidir con los filtros que incluya en sus grupos de Lente de almacenamiento. Si ningún objeto coincide con los filtros que ha incluido en su grupo de Lente de almacenamiento, no se generará ninguna métrica. Sin embargo, si un objeto coincide con dos o más grupos de Lente de almacenamiento, el objeto aparece por separado para cada grupo cuando se muestra en la exportación de métricas. Para identificar las métricas de los grupos de Lente de almacenamiento, busque uno de los siguientes valores en la columna `record_type` de la exportación de métricas de su panel: + `STORAGE_LENS_GROUP_BUCKET` + `STORAGE_LENS_GROUP_ACCOUNT` La columna `record_value` muestra el ARN del recurso para el grupo de Lente de almacenamiento (por ejemplo, `arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department`). # Uso de grupos de Lente de almacenamiento Los grupos de Lente de almacenamiento de Amazon S3 agregan métricas mediante filtros personalizados basados en metadatos de objetos. Puede analizar y filtrar las métricas de S3 Lente de almacenamiento mediante prefijos, sufijos, etiquetas de objetos, tamaño de objetos y antigüedad de objetos. Con los grupos de Lente de almacenamiento de Amazon S3, también puede clasificar su uso dentro de buckets de Amazon S3 y entre ellos. Como resultado, podrá comprender y optimizar mejor su almacenamiento de S3. Para empezar a visualizar los datos de un grupo de Lente de almacenamiento, primero debe [asociar el grupo de Lente de almacenamiento a un panel de S3 Lente de almacenamiento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Si necesita administrar los grupos de Lente de almacenamiento en el panel, puede editar la configuración del panel. Para comprobar qué grupos de Lente de almacenamiento están en su cuenta, puede incluirlos en una lista. Para comprobar qué grupos de Lente de almacenamiento están asociados a su panel, siempre puede consultar la pestaña **Grupos de Lente de almacenamiento** en el panel. Para revisar o actualizar el ámbito de un grupo de Lente de almacenamiento existente, puede ver sus detalles. También puede eliminar permanentemente un grupo de Lente de almacenamiento. Para administrar los permisos, puede crear y agregar etiquetas de recursos de AWS definidas por el usuario a sus grupos de Lente de almacenamiento. Puede usar etiquetas de recursos de AWS para clasificar recursos según el departamento, la línea de negocio o el proyecto. Esto resulta útil cuando se tienen muchos recursos del mismo tipo. Al aplicar etiquetas, puede identificar rápidamente un grupo de Lente de almacenamiento específico en función de las etiquetas que le haya asignado. Además, cuando agrega una etiqueta de recurso de AWS a su grupo de Lente de almacenamiento, activa el [control de acceso basado en atributos (ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)). ABAC es una estrategia de autorización que define permisos basados en atributos, en este caso, etiquetas. También puede utilizar las condiciones que especifican etiquetas de recursos en sus políticas de IAM para [controlar el acceso a los recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources). **Topics** + [Creación de un grupo de Lente de almacenamiento](storage-lens-groups-create.md) + [Asociación o eliminación de grupos de S3 Lente de almacenamiento a o desde su panel](storage-lens-groups-dashboard-console.md) + [Visualización de los datos de grupos de Lente de almacenamiento](storage-lens-groups-visualize.md) + [Actualización de un grupo de Lente de almacenamiento](storage-lens-groups-update.md) + [Administración de etiquetas de recursos de AWS con grupos de Lente de almacenamiento](storage-lens-groups-manage-tags.md) + [Enumeración de todos los grupos de Lente de almacenamiento](storage-lens-groups-list.md) + [Visualización de los detalles del grupo de Lente de almacenamiento](storage-lens-groups-view.md) + [Eliminación de un grupo de Lente de almacenamiento](storage-lens-groups-delete.md) # Creación de un grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo crear un grupo de Lente de almacenamiento de Amazon S3 mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) yAWS SDK para Java. ## Uso de la consola de S3 **Para crear un grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En la barra de navegación de la parte superior de la página, elija el nombre de la región de AWS que aparece. A continuación, elija la región a la que desea cambiar. 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. Elija **Crear grupo de Lente de almacenamiento**. 1. En **General**, vea la **Región de origen** e introduzca el nombre de su **grupo de lentes de almacenamiento**. 1. En **Ámbito**, elija el filtro que desea aplicar a su grupo de Lente de almacenamiento. Para aplicar varios filtros, elíjalos y, a continuación, elija el operador lógico **AND** u **OR**. + Para el filtro **Prefijos**, elija **Prefijos** e introduzca una cadena de prefijos. Para añadir varios prefijos, elija **Agregar prefijo**. Para eliminar un prefijo, elija **Eliminar** que está ubicado junto al prefijo que desea eliminar. + Para el filtro **Etiquetas de objetos**, elija **Etiquetas de objeto** e introduzca el par clave-valor del objeto. A continuación, elija **Agregar etiqueta**. Para eliminar una etiqueta, elija **Eliminar** junto a la etiqueta que desee eliminar. + Para el filtro **Sufijos**, elija **Sufijos** e introduzca una cadena de sufijos. Para añadir varios sufijos, elija **Agregar sufijo.** Para eliminar un sufijo, elija **Eliminar** que está ubicado junto al sufijo que desea eliminar. + Para el filtro **Antigüedad**, especifique el rango de antigüedad de objeto en días. Elija **Especificar la edad mínima del objeto** e introduzca la edad mínima del objeto. A continuación, elija **Especificar la edad máxima del objeto** e introduzca la edad máxima del objeto. + Para el filtro **Tamaño**, especifique el rango de tamaño de objeto y la unidad de medida. Elija **Especificar el tamaño mínimo del objeto** e introduzca el tamaño mínimo del objeto. Elija **Especificar el tamaño máximo del objeto** e introduzca el tamaño máximo del objeto. 1. (Opcional) Para las etiquetas de recursos de AWS, añada el par clave-valor y, a continuación, seleccione **Agregar etiqueta**. 1. Seleccione **Crear grupo de Lente de almacenamiento**. ## Uso de AWS CLI El siguiente comando de AWS CLI de ejemplo crea un grupo de Storage Lens. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control create-storage-lens-group --account-id 111122223333 \ --region us-east-1 --storage-lens-group=file://./marketing-department.json ``` El siguiente comando de ejemplo de AWS CLI crea un grupo de Lente de almacenamiento con dos etiquetas de recursos de AWS. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control create-storage-lens-group --account-id 111122223333 \ --region us-east-1 --storage-lens-group=file://./marketing-department.json \ --tags Key=k1,Value=v1 Key=k2,Value=v2 ``` Para ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration). ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java crea un grupo de Lente de almacenamiento. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. **Example — Crear un grupo de Lente de almacenamiento con un solo filtro** El ejemplo siguiente crea un grupo de Storage Lens denominado `Marketing-Department`: Este grupo tiene un filtro de antigüedad de objetos que especifica el rango de antigüedad como de `90` a `30` días. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest; import software.amazon.awssdk.services.s3control.model.MatchObjectAge; import software.amazon.awssdk.services.s3control.model.StorageLensGroup; import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter; public class CreateStorageLensGroupWithObjectAge { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { StorageLensGroupFilter objectAgeFilter = StorageLensGroupFilter.builder() .matchObjectAge(MatchObjectAge.builder() .daysGreaterThan(30) .daysLessThan(90) .build()) .build(); StorageLensGroup storageLensGroup = StorageLensGroup.builder() .name(storageLensGroupName) .filter(objectAgeFilter) .build(); CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder() .storageLensGroup(storageLensGroup) .accountId(accountId).build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` **Example — Crear un grupo de Lente de almacenamiento con un operador `AND` que incluya varios filtros** El ejemplo siguiente crea un grupo de Storage Lens denominado `Marketing-Department`: Este grupo usa el operador `AND` para indicar que los objetos deben coincidir con **todas** las condiciones de filtro. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest; import software.amazon.awssdk.services.s3control.model.MatchObjectAge; import software.amazon.awssdk.services.s3control.model.MatchObjectSize; import software.amazon.awssdk.services.s3control.model.S3Tag; import software.amazon.awssdk.services.s3control.model.StorageLensGroup; import software.amazon.awssdk.services.s3control.model.StorageLensGroupAndOperator; import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter; public class CreateStorageLensGroupWithAndFilter { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { // Create object tags. S3Tag tag1 = S3Tag.builder() .key("object-tag-key-1") .value("object-tag-value-1") .build(); S3Tag tag2 = S3Tag.builder() .key("object-tag-key-2") .value("object-tag-value-2") .build(); StorageLensGroupAndOperator andOperator = StorageLensGroupAndOperator.builder() .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1") .matchAnySuffix(".png", ".gif", ".jpg") .matchAnyTag(tag1, tag2) .matchObjectAge(MatchObjectAge.builder() .daysGreaterThan(30) .daysLessThan(90).build()) .matchObjectSize(MatchObjectSize.builder() .bytesGreaterThan(1000L) .bytesLessThan(6000L).build()) .build(); StorageLensGroupFilter andFilter = StorageLensGroupFilter.builder() .and(andOperator) .build(); StorageLensGroup storageLensGroup = StorageLensGroup.builder() .name(storageLensGroupName) .filter(andFilter) .build(); CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder() .storageLensGroup(storageLensGroup) .accountId(accountId).build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` **Example — Crear un grupo de Lente de almacenamiento con un operador `OR` que incluya varios filtros** El ejemplo siguiente crea un grupo de Storage Lens denominado `Marketing-Department` Este grupo usa un operador `OR` para aplicar un filtro de prefijo (`prefix-1`, `prefix-2`, `prefix3/sub-prefix-1`) o un filtro de tamaño de objeto con un rango de tamaño entre `1000` bytes y `6000` bytes. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest; import software.amazon.awssdk.services.s3control.model.MatchObjectSize; import software.amazon.awssdk.services.s3control.model.StorageLensGroup; import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter; import software.amazon.awssdk.services.s3control.model.StorageLensGroupOrOperator; public class CreateStorageLensGroupWithOrFilter { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { StorageLensGroupOrOperator orOperator = StorageLensGroupOrOperator.builder() .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1") .matchObjectSize(MatchObjectSize.builder() .bytesGreaterThan(1000L) .bytesLessThan(6000L) .build()) .build(); StorageLensGroupFilter orFilter = StorageLensGroupFilter.builder() .or(orOperator) .build(); StorageLensGroup storageLensGroup = StorageLensGroup.builder() .name(storageLensGroupName) .filter(orFilter) .build(); CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder() .storageLensGroup(storageLensGroup) .accountId(accountId).build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` **Example — Crear un grupo de Lente de almacenamiento con un solo filtro y dos etiquetas de recursos de AWS** En el siguiente ejemplo, se crea un grupo de Lente de almacenamiento denominado `Marketing-Department` que tiene un filtro de sufijo. En este ejemplo también se agregan dos etiquetas de recursos AWS al grupo de Lente de almacenamiento. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest; import software.amazon.awssdk.services.s3control.model.StorageLensGroup; import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter; import software.amazon.awssdk.services.s3control.model.Tag; public class CreateStorageLensGroupWithResourceTags { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { // Create AWS resource tags. Tag resourceTag1 = Tag.builder() .key("resource-tag-key-1") .value("resource-tag-value-1") .build(); Tag resourceTag2 = Tag.builder() .key("resource-tag-key-2") .value("resource-tag-value-2") .build(); StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder() .matchAnySuffix(".png", ".gif", ".jpg") .build(); StorageLensGroup storageLensGroup = StorageLensGroup.builder() .name(storageLensGroupName) .filter(suffixFilter) .build(); CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder() .storageLensGroup(storageLensGroup) .tags(resourceTag1, resourceTag2) .accountId(accountId).build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` Para ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration). # Asociación o eliminación de grupos de S3 Lente de almacenamiento a o desde su panel Una vez que se haya actualizado al nivel avanzado en Lente de almacenamiento de Amazon S3, puede asociar un [grupo de Lente de almacenamiento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-overview.html) a su panel. Si tiene varios grupos de Lente de almacenamiento, puede incluir o excluir los grupos que desee. Sus grupos de Lente de almacenamiento deben encontrarse en la región de origen designada en la cuenta del panel. Después de asociar un grupo de Lente de almacenamiento a su panel, recibirá los datos adicionales de agregación de grupos de Lente de almacenamiento en su exportación de métricas en un plazo de 48 horas. **nota** Si desea ver las métricas agregadas para su grupo de Lente de almacenamiento, debe asociarlas al panel de Lente de almacenamiento. Para ver ejemplos de los archivos de configuración JSON del grupo de Lente de almacenamiento, consulte [Ejemplo de configuración de S3 Lente de almacenamiento con grupos de Lente de almacenamiento en JSON](S3LensHelperFilesCLI.md#StorageLensGroupsHelperFilesCLI). ## Uso de la consola de S3 **Para asociar un grupo de Lente de almacenamiento a un panel de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, en **Storage Lens**, elija **Paneles**. 1. Seleccione el botón de opción del panel de Lente de almacenamiento al que desee asociar un grupo de Lente de almacenamiento. 1. Elija **Edit (Edición de)**. 1. En **Metrics selection** (Selección de métricas), elija **Advanced metrics and recommendations** (Métricas y recomendaciones avanzadas). 1. Seleccione la **Agregación de grupos de Lente de almacenamiento**. **nota** De forma predeterminada, también está seleccionada la opción **Métricas avanzadas**. Sin embargo, también puede anular la selección de esta configuración, ya que no es necesaria para agregar los datos de los grupos de Lente de almacenamiento. 1. Desplácese hasta **Agregación de grupos de Lente de almacenamiento** y especifique el grupo o los grupos de Lente de almacenamiento que desee incluir o excluir en la agregación de datos. Puede utilizar las siguientes opciones de filtrado: + Si desea incluir determinados grupos de Lente de almacenamiento, elija **Incluir grupos de Lente de almacenamiento**. En **Grupos de Lente de almacenamiento para incluir**, seleccione sus grupos de Lente de almacenamiento. + Si desea incluir todos los grupos de Lente de almacenamiento, seleccione **Incluir todos los grupos de Lente de almacenamiento de la región de origen en esta cuenta**. + Si desea excluir determinados grupos de Lente de almacenamiento, elija **Excluir grupos de Lente de almacenamiento**. En **Grupos de Lente de almacenamiento para excluir**, seleccione los grupos de Lente de almacenamiento que desee excluir. 1. Seleccione **Save changes (Guardar cambios)**. Si ha configurado los grupos de Lente de almacenamiento correctamente, verá los datos de agregación de grupo de Lente de almacenamiento adicionales en su panel en un plazo de 48 horas. **Para eliminar un grupo de Lente de almacenamiento de un panel de S3 Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, en **Storage Lens**, elija **Paneles**. 1. Elija el botón de opción del panel de Lente de almacenamiento del que desee eliminar un grupo de Lente de almacenamiento. 1. Elija **Ver la configuración del panel**. 1. Elija **Edit (Edición de)**. 1. Desplácese hasta la sección **Selección de métricas**. 1. En la sección **Agregación de grupos de Lente de almacenamiento**, elija la **X** situada junto al grupo de Lente de almacenamiento que desee eliminar. De este modo, se elimina el grupo de Lente de almacenamiento. Si ha incluido todos los grupos de Lente de almacenamiento en su panel, desactive la casilla situada junto a **Incluir todos los grupos de Lente de almacenamiento de la región de origen en esta cuenta**. 1. Seleccione **Save changes (Guardar cambios)**. **nota** El panel tardará hasta 48 horas en reflejar las actualizaciones de la configuración. ## Uso de AWS SDK para Java **Example – Asociación de todos los grupos de Lente de almacenamiento a un panel** En el siguiente ejemplo de SDK para Java, se asocian todos los grupos de Lente de almacenamiento de la cuenta *111122223333* al panel *DashboardConfigurationID*: ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.services.s3control.AWSS3Control; import com.amazonaws.services.s3control.AWSS3ControlClient; import com.amazonaws.services.s3control.model.BucketLevel; import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.s3control.model.AccountLevel; import com.amazonaws.services.s3control.model.StorageLensConfiguration; import com.amazonaws.services.s3control.model.StorageLensGroupLevel; import static com.amazonaws.regions.Regions.US_WEST_2; public class CreateDashboardWithStorageLensGroups { public static void main(String[] args) { String configurationId = "ExampleDashboardConfigurationId"; String sourceAccountId = "111122223333"; try { StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel(); AccountLevel accountLevel = new AccountLevel() .withBucketLevel(new BucketLevel()) .withStorageLensGroupLevel(storageLensGroupLevel); StorageLensConfiguration configuration = new StorageLensConfiguration() .withId(configurationId) .withAccountLevel(accountLevel) .withIsEnabled(true); AWSS3Control s3ControlClient = AWSS3ControlClient.builder() .withCredentials(new ProfileCredentialsProvider()) .withRegion(US_WEST_2) .build(); s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest() .withAccountId(sourceAccountId) .withConfigId(configurationId) .withStorageLensConfiguration(configuration) ); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` **Example – Asociación de dos grupos de Lente de almacenamiento a un panel** En el siguiente ejemplo de AWS SDK para Java, se asocian dos grupos de lentes de almacenamiento (*StorageLensGroupName1* y *StorageLensGroupName2*) al panel *ExampleDashboardConfigurationId*. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.s3control.AWSS3Control; import com.amazonaws.services.s3control.AWSS3ControlClient; import com.amazonaws.services.s3control.model.AccountLevel; import com.amazonaws.services.s3control.model.BucketLevel; import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest; import com.amazonaws.services.s3control.model.StorageLensConfiguration; import com.amazonaws.services.s3control.model.StorageLensGroupLevel; import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria; import static com.amazonaws.regions.Regions.US_WEST_2; public class CreateDashboardWith2StorageLensGroups { public static void main(String[] args) { String configurationId = "ExampleDashboardConfigurationId"; String storageLensGroupName1 = "StorageLensGroupName1"; String storageLensGroupName2 = "StorageLensGroupName2"; String sourceAccountId = "111122223333"; try { StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria() .withInclude( "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1, "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2); System.out.println(selectionCriteria); StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel() .withSelectionCriteria(selectionCriteria); AccountLevel accountLevel = new AccountLevel() .withBucketLevel(new BucketLevel()) .withStorageLensGroupLevel(storageLensGroupLevel); StorageLensConfiguration configuration = new StorageLensConfiguration() .withId(configurationId) .withAccountLevel(accountLevel) .withIsEnabled(true); AWSS3Control s3ControlClient = AWSS3ControlClient.builder() .withCredentials(new ProfileCredentialsProvider()) .withRegion(US_WEST_2) .build(); s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest() .withAccountId(sourceAccountId) .withConfigId(configurationId) .withStorageLensConfiguration(configuration) ); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` **Example – Asociación de todos los grupos de Lente de almacenamiento con exclusiones** El siguiente ejemplo de SDK para Java asocia todos los grupos de Lente de almacenamiento al panel *ExampleDashboardConfigurationID*, excepto los dos especificados (*StorageLensGroupName1* y *StorageLensGroupName2*): ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.s3control.AWSS3Control; import com.amazonaws.services.s3control.AWSS3ControlClient; import com.amazonaws.services.s3control.model.AccountLevel; import com.amazonaws.services.s3control.model.BucketLevel; import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest; import com.amazonaws.services.s3control.model.StorageLensConfiguration; import com.amazonaws.services.s3control.model.StorageLensGroupLevel; import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria; import static com.amazonaws.regions.Regions.US_WEST_2; public class CreateDashboardWith2StorageLensGroupsExcluded { public static void main(String[] args) { String configurationId = "ExampleDashboardConfigurationId"; String storageLensGroupName1 = "StorageLensGroupName1"; String storageLensGroupName2 = "StorageLensGroupName2"; String sourceAccountId = "111122223333"; try { StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria() .withInclude( "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1, "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2); System.out.println(selectionCriteria); StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel() .withSelectionCriteria(selectionCriteria); AccountLevel accountLevel = new AccountLevel() .withBucketLevel(new BucketLevel()) .withStorageLensGroupLevel(storageLensGroupLevel); StorageLensConfiguration configuration = new StorageLensConfiguration() .withId(configurationId) .withAccountLevel(accountLevel) .withIsEnabled(true); AWSS3Control s3ControlClient = AWSS3ControlClient.builder() .withCredentials(new ProfileCredentialsProvider()) .withRegion(US_WEST_2) .build(); s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest() .withAccountId(sourceAccountId) .withConfigId(configurationId) .withStorageLensConfiguration(configuration) ); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` # Visualización de los datos de grupos de Lente de almacenamiento Puede visualizar sus datos de grupos de Lente de almacenamiento [asociando el grupo al panel de Lente de almacenamiento de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Una vez que haya incluido el grupo de Lente de almacenamiento en la agregación de grupos de Lente de almacenamiento de la configuración del panel, pueden pasar hasta 48 horas para que los datos del grupo de Lente de almacenamiento se muestren en su panel. Una vez actualizada la configuración del panel, todos los grupos de Lente de almacenamiento recién asociados aparecen en la lista de recursos disponibles en la pestaña **Grupos de Lente de almacenamiento**. También puede analizar aún más el uso del almacenamiento en la pestaña **Información general** dividiendo los datos por otra dimensión. Por ejemplo, puede elegir uno de los elementos que figuran en las **3 categorías principales** y, a continuación, **Analizar por** para dividir los datos por otra dimensión. No puede aplicar la misma dimensión que el propio filtro. **nota** No puede aplicar un filtro de grupo de Lente de almacenamiento junto con un filtro de prefijo, ni a la inversa. Tampoco puede analizar aún más un grupo de Lente de almacenamiento mediante un filtro de prefijo. Puede utilizar la pestaña **Grupos de Lente de almacenamiento** del panel de Lente de almacenamiento de Amazon S3 para personalizar la visualización de los datos de los grupos de Lente de almacenamiento asociados a su panel. Puede visualizar los datos de algunos grupos de Lente de almacenamiento que están asociados a su panel, o todos ellos. Al visualizar los datos de los grupos de Lente de almacenamiento en el panel de S3 Lente de almacenamiento, tenga en cuenta lo siguiente: + S3 Lente de almacenamiento agrega las métricas de uso para un objeto en todos los grupos de Lente de almacenamiento coincidentes. Por lo tanto, si un objeto cumple las condiciones de filtrado de dos o más grupos de Lente de almacenamiento, verá recuentos repetidos para el mismo objeto a lo largo de su uso de almacenamiento. + Los objetos deben coincidir con los filtros que incluya en sus grupos de Lente de almacenamiento. Si ningún objeto coincide con los filtros que incluye en su grupo de Lente de almacenamiento, no se generará ninguna métrica. Para determinar si hay objetos sin asignar, compruebe el recuento total de objetos en el panel a nivel de cuenta y de bucket. # Actualización de un grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo actualizar un grupo de Lente de almacenamiento de Amazon S3. Puede actualizar un grupo de Lente de almacenamiento mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java. ## Uso de la consola de S3 **Para actualizar un grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desee actualizar. 1. En **Ámbito**, elija **Editar**. 1. En la página **Ámbito**, seleccione el filtro que desee aplicar a su grupo de Lente de almacenamiento. Para aplicar varios filtros, selecciónelos y elija el operador lógico **AND** u **OR**. + Para el filtro **Prefijos**, seleccione **Prefijos** e introduzca una cadena de prefijos. Para añadir varios prefijos, elija **Agrgar prefijo**. Para eliminar un prefijo, elija **Eliminar** que está ubicado junto al prefijo que desea eliminar. + Para el filtro **Etiquetas de objetos**, introduzca el par clave-valor para el objeto. A continuación, elija **Agregar etiqueta**. Para eliminar una etiqueta, elija **Eliminar** junto a la etiqueta que desee eliminar. + Para el filtro **Sufijos**, seleccione **Sufijos** e introduzca una cadena de sufijos. Para añadir varios sufijos, elija **Agregar sufijo.** Para eliminar un sufijo, elija **Eliminar** que está ubicado junto al sufijo que desea eliminar. + Para el filtro **Antigüedad**, especifique el rango de antigüedad de objeto en días. Elija **Especificar la edad mínima del objeto** e introduzca la edad mínima del objeto. En **Especificar la edad máxima del objeto**, introduzca la edad máxima del objeto. + Para el filtro **Tamaño**, especifique el rango de tamaño de objeto y la unidad de medida. Elija **Especificar el tamaño mínimo del objeto** e introduzca el tamaño mínimo del objeto. En **Especificar el tamaño máximo del objeto**, introduzca el tamaño máximo del objeto. 1. Seleccione **Save changes (Guardar cambios)**. Aparecerá la página de detalles del grupo de Lente de almacenamiento. 1. (Opcional) Si desea añadir una nueva etiqueta de recurso de AWS, desplácese hasta la sección de **etiquetas de recursos de AWS** y, a continuación, seleccione **Agregar etiquetas**. Aparece la página **Add tags (Agregar etiquetas)**. Agregue el nuevo par clave-valor y, a continuación, elija **Guardar cambios**. Aparecerá la página de detalles del grupo de Lente de almacenamiento. 1. (Opcional) Si desea eliminar una etiqueta de recurso AWS, desplácese hasta la sección de **etiquetas de recursos de AWS** y seleccione la etiqueta de recurso. A continuación, elija **Eliminar**. Aparecerá el cuadro de diálogo **Eliminar etiquetas de AWS**. Vuelva a elegir **Eliminar** para eliminar permanentemente la etiqueta de recurso de AWS. **nota** Después de eliminar permanentemente una etiqueta de recurso de AWS, no se puede restaurar. ## Uso de AWS CLI El siguiente comando de ejemplo de AWS CLI devuelve los detalles de configuración de un grupo de Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control get-storage-lens-group --account-id 111122223333 \ --region us-east-1 --name marketing-department ``` En el siguiente ejemplo de AWS CLI, se actualiza un grupo de Lente de almacenamiento. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control update-storage-lens-group --account-id 111122223333 \ --region us-east-1 --storage-lens-group=file://./marketing-department.json ``` Para ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration). ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java devuelve los detalles de configuración del grupo de Lente de almacenamiento `Marketing-Department` de la cuenta `111122223333`. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupRequest; import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse; public class GetStorageLensGroup { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder() .name(storageLensGroupName) .accountId(accountId).build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest); System.out.println(response); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` En el siguiente ejemplo, se actualiza el grupo de Lente de almacenamiento denominado `Marketing-Department` en la cuenta `111122223333`. En este ejemplo, se actualiza el ámbito del panel para incluir objetos que coincidan con alguno de los siguientes sufijos: `.png`, `.gif`, `.jpg` o `.jpeg`. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.StorageLensGroup; import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter; import software.amazon.awssdk.services.s3control.model.UpdateStorageLensGroupRequest; public class UpdateStorageLensGroup { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { // Create updated filter. StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder() .matchAnySuffix(".png", ".gif", ".jpg", ".jpeg") .build(); StorageLensGroup storageLensGroup = StorageLensGroup.builder() .name(storageLensGroupName) .filter(suffixFilter) .build(); UpdateStorageLensGroupRequest updateStorageLensGroupRequest = UpdateStorageLensGroupRequest.builder() .name(storageLensGroupName) .storageLensGroup(storageLensGroup) .accountId(accountId) .build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.updateStorageLensGroup(updateStorageLensGroupRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` Para ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration). # Administración de etiquetas de recursos de AWS con grupos de Lente de almacenamiento Cada grupo de Lente de almacenamiento de Amazon S3 se cuenta como un recurso de AWS con su propio nombre de recurso de Amazon (ARN). Por lo tanto, al configurar su grupo de Lente de almacenamiento, si lo desea, puede añadir etiquetas de recursos de AWS al grupo. Puede añadir un máximo de 50 etiquetas a cada grupo de Lente de almacenamiento. Para crear un grupo de Lente de almacenamiento con etiquetas, debe tener los permisos `s3:CreateStorageLensGroup` y `s3:TagResource`. Puede usar etiquetas de recursos de AWS para clasificar los recursos por departamento, línea de negocio o proyecto. Esto resulta útil cuando se tienen muchos recursos del mismo tipo. Al aplicar etiquetas, puede identificar rápidamente un grupo de Lente de almacenamiento específico en función de las etiquetas que le haya asignado. También puede utilizar etiquetas para realizar un seguimiento de los costes y asignarlos. Además, cuando agrega una etiqueta de recurso de AWS a su grupo de Lente de almacenamiento, activa el [control de acceso basado en atributos (ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)). ABAC es una estrategia de autorización que define permisos basados en atributos, en este caso, etiquetas. También puede utilizar las condiciones que especifican etiquetas de recursos en sus políticas de IAM para [controlar el acceso a los recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources). Puede editar las claves y los valores de las etiquetas y también puede eliminar etiquetas de un recurso en cualquier momento. Además, debe tener en cuenta las siguientes limitaciones: + Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. + Si añade una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al antiguo. + Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso. + No incluya datos privados o confidenciales en sus etiquetas de recursos de AWS. + No se admiten etiquetas del sistema (con claves de etiqueta que comiencen por `aws:`). + La longitud de cada clave de etiqueta no puede superar los 128 caracteres. La longitud del valor de cada etiqueta no puede superar los 256 caracteres. En los siguientes ejemplos se muestra cómo utilizar etiquetas de recursos de AWS con grupos de Lente de almacenamiento. **Topics** + [Adición de una etiqueta de recurso de AWS a un grupo de Lente de almacenamiento](storage-lens-groups-add-tags.md) + [Actualización de los valores de las etiquetas de grupo de Lente de almacenamiento](storage-lens-groups-update-tags.md) + [Eliminación de una etiqueta de recurso de AWS de un grupo de Lente de almacenamiento](storage-lens-groups-delete-tags.md) + [Enumeración de etiquetas de grupo de Lente de almacenamiento](storage-lens-groups-list-tags.md) # Adición de una etiqueta de recurso de AWS a un grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo agregar etiquetas de recursos de AWS a un grupo de Lente de almacenamiento de Amazon S3. Puede añadir etiquetas de recursos mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java. ## Uso de la consola de S3 **Para agregar una etiqueta de recurso de AWS a un grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En los **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desee actualizar. 1. En **Etiquetas de recursos de AWS**, elija **Agregar etiquetas**. 1. En la página **Agregar etiquetas**, añada el nuevo par clave-valor. **nota** Si añade una nueva etiqueta con la misma clave que una etiqueta existente, se sobrescribirá el valor de la etiqueta anterior. 1. (Opcional) Para añadir más de una etiqueta nueva, vuelve a elegir **Agregar etiqueta** para seguir añadiendo nuevas entradas. Puede añadir un máximo de 50 etiquetas de recursos de AWS a su grupo de Lente de almacenamiento. 1. (Opcional) Si desea eliminar una entrada recién agregada, elija **Eliminar** junto a la etiqueta que desea eliminar. 1. Elija **Save changes (Guardar cambios)**. ## Mediante AWS CLI El siguiente comando de ejemplo de AWS CLI añade dos etiquetas de recursos a un grupo de Lente de almacenamiento existente denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control tag-resource --account-id 111122223333 \ --resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \ --region us-east-1 --tags Key=k1,Value=v1 Key=k2,Value=v2 ``` ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java añade dos etiquetas de recursos de AWS a un grupo de Lente de almacenamiento existente. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.Tag; import software.amazon.awssdk.services.s3control.model.TagResourceRequest; public class TagResource { public static void main(String[] args) { String resourceARN = "Resource_ARN"; String accountId = "111122223333"; try { Tag resourceTag1 = Tag.builder() .key("resource-tag-key-1") .value("resource-tag-value-1") .build(); Tag resourceTag2 = Tag.builder() .key("resource-tag-key-2") .value("resource-tag-value-2") .build(); TagResourceRequest tagResourceRequest = TagResourceRequest.builder() .resourceArn(resourceARN) .tags(resourceTag1, resourceTag2) .accountId(accountId) .build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.tagResource(tagResourceRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` # Actualización de los valores de las etiquetas de grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo actualizar los valores de las etiquetas de grupo de Lente de almacenamiento mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java. ## Uso de la consola de S3 **Para actualizar una etiqueta de recursos de AWS para un grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desee actualizar. 1. En las **Etiquetas de recursos de AWS**, selecciona la etiqueta que desee actualizar. 1. Añada el nuevo valor de etiqueta usando la misma clave del par clave-valor que desee actualizar. Haga clic en el icono de marca de verificación para actualizar el valor de la etiqueta. **nota** Si añade una nueva etiqueta con la misma clave que una etiqueta existente, se sobrescribirá el valor de la etiqueta anterior. 1. (Opcional) Si desea añadir nuevas etiquetas, elija **Agregar etiqueta** para añadir nuevas entradas. Aparece la página **Add tags (Agregar etiquetas)**. Puede agregar hasta 50 etiquetas de recursos de AWS para su grupo de Lente de almacenamiento. Cuando haya terminado de añadir etiquetas, elija **Guardar cambios**. 1. (Opcional) Si desea eliminar una entrada recién agregada, elija **Eliminar** junto a la etiqueta que desea eliminar. Cuando haya terminado de eliminar etiquetas, elija **Guardar cambios**. ## Uso de AWS CLI El siguiente comando AWS CLI de ejemplo actualiza dos valores de etiqueta para el grupo de Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control tag-resource --account-id 111122223333 \ --resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \ --region us-east-1 --tags Key=k1,Value=v3 Key=k2,Value=v4 ``` ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java actualiza dos valores de etiqueta de grupo de Lente de almacenamiento. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.Tag; import software.amazon.awssdk.services.s3control.model.TagResourceRequest; public class UpdateTagsForResource { public static void main(String[] args) { String resourceARN = "Resource_ARN"; String accountId = "111122223333"; try { Tag updatedResourceTag1 = Tag.builder() .key("resource-tag-key-1") .value("resource-tag-updated-value-1") .build(); Tag updatedResourceTag2 = Tag.builder() .key("resource-tag-key-2") .value("resource-tag-updated-value-2") .build(); TagResourceRequest tagResourceRequest = TagResourceRequest.builder() .resourceArn(resourceARN) .tags(updatedResourceTag1, updatedResourceTag2) .accountId(accountId) .build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.tagResource(tagResourceRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` # Eliminación de una etiqueta de recurso de AWS de un grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo eliminar una etiqueta de recurso de AWS de un grupo de Lente de almacenamiento. Puede eliminar etiquetas mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java. ## Uso de la consola de S3 **Para eliminar una etiqueta de recurso de AWS de un grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desea actualizar. 1. En **Etiquetas de recursos de AWS**, seleccione el par clave-valor que desea eliminar. 1. Elija **Eliminar**. Aparece el cuadro de diálogo **Eliminar etiquetas de recursos de AWS**. **nota** Si se utilizan etiquetas para controlar el acceso, continuar con esta acción puede afectar a los recursos relacionados. Después de eliminar una etiqueta de forma permanente, no se puede restaurar. 1. Elija **Eliminar** para eliminar el par clave-valor de forma permanente. ## Uso de AWS CLI El siguiente comando de AWS CLI elimina dos etiquetas de recursos de AWS de un grupo de Lente de almacenamiento existente: para usar este comando de ejemplo, reemplace los `user input placeholders` por su propia información. ``` aws s3control untag-resource --account-id 111122223333 \ --resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department \ --region us-east-1 --tag-keys k1 k2 ``` ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java elimina dos etiquetas de recursos de AWS del Nombre de Recurso de Amazon (ARN) del grupo de Lente de almacenamiento que especifica en la cuenta `111122223333`. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.UntagResourceRequest; public class UntagResource { public static void main(String[] args) { String resourceARN = "Resource_ARN"; String accountId = "111122223333"; try { String tagKey1 = "resource-tag-key-1"; String tagKey2 = "resource-tag-key-2"; UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder() .resourceArn(resourceARN) .tagKeys(tagKey1, tagKey2) .accountId(accountId) .build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.untagResource(untagResourceRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` # Enumeración de etiquetas de grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo enumerar las etiquetas de recursos de AWS asociadas a un grupo de Lente de almacenamiento. Puede enumerar etiquetas mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java. ## Uso de la consola de S3 **Para revisar la lista de etiquetas y los valores de las etiquetas de un grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que le interesa. 1. Desplácese hasta la sección **Etiquetas de recursos de AWS**. Todas las etiquetas de recursos de AWS definidas por el usuario que se añaden a su grupo de Lente de almacenamiento aparecen junto con sus valores de etiqueta. ## Uso de AWS CLI El siguiente comando de ejemplo de AWS CLI muestra todos los valores de etiqueta de grupo de Lente de almacenamiento del grupo Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control list-tags-for-resource --account-id 111122223333 \ --resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \ --region us-east-1 ``` ## Uso de AWS SDK para Java En el siguiente ejemplo de AWS SDK para Java se muestran los valores de etiqueta de grupo de Lente de almacenamiento para el nombre de recurso de Amazon (ARN) del grupo Lente de almacenamiento que especifique. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.ListTagsForResourceRequest; import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse; public class ListTagsForResource { public static void main(String[] args) { String resourceARN = "Resource_ARN"; String accountId = "111122223333"; try { ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder() .resourceArn(resourceARN) .accountId(accountId) .build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); ListTagsForResourceResponse response = s3ControlClient.listTagsForResource(listTagsForResourceRequest); System.out.println(response); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` # Enumeración de todos los grupos de Lente de almacenamiento En los ejemplos siguientes, se muestra cómo enumerar todos los grupos de Lente de almacenamiento de Amazon S3 de una Cuenta de AWS y una región de origen. En estos ejemplos se muestra cómo enumerar todos los grupos de Lente de almacenamiento mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) yAWS SDK para Java. ## Uso de la consola de S3 **Para enumerar todos los grupos de Lente de almacenamiento en una cuenta y región de origen** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En **Grupos de Lente de almacenamiento**, se muestra la lista de grupos de Lente de almacenamiento de su cuenta. ## Uso de AWS CLI El siguiente ejemplo de AWS CLI muestra todos los grupos de Lente de almacenamiento para su cuenta. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control list-storage-lens-groups --account-id 111122223333 \ --region us-east-1 ``` ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java muestra los grupos de Lente de almacenamiento para la cuenta `111122223333`. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsRequest; import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsResponse; public class ListStorageLensGroups { public static void main(String[] args) { String accountId = "111122223333"; try { ListStorageLensGroupsRequest listStorageLensGroupsRequest = ListStorageLensGroupsRequest.builder() .accountId(accountId) .build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); ListStorageLensGroupsResponse response = s3ControlClient.listStorageLensGroups(listStorageLensGroupsRequest); System.out.println(response); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` # Visualización de los detalles del grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo ver los detalles de configuración del grupo de Lente de almacenamiento de Amazon S3. Puede ver estos detalles mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java. ## Uso de la consola de S3 **Para ver los detalles de configuración del grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En los **Grupos de Lente de almacenamiento**, elija el botón de opción situado junto al grupo de Lente de almacenamiento que le interese. 1. Elija **Ver detalles**. Ahora puede revisar los detalles de su grupo de Lente de almacenamiento. ## Uso de AWS CLI El siguiente ejemplo de AWS CLI devuelve los detalles de configuración de un grupo de Lente de almacenamiento. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control get-storage-lens-group --account-id 111122223333 \ --region us-east-1 --name marketing-department ``` ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java devuelve los detalles de configuración del grupo de Lente de almacenamiento denominado `Marketing-Department` en la cuenta `111122223333`. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupRequest; import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse; public class GetStorageLensGroup { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder() .name(storageLensGroupName) .accountId(accountId).build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest); System.out.println(response); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` # Eliminación de un grupo de Lente de almacenamiento En los siguientes ejemplos se muestra cómo eliminar un grupo de Lente de almacenamiento de Amazon S3 mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) yAWS SDK para Java. ## Uso de la consola de S3 **Para eliminar un grupo de Lente de almacenamiento** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. En el panel de navegación izquierdo, elija **Grupos de Storage Lens**. 1. En **Grupos de Lente de almacenamiento**, elija el botón de opción situado junto al grupo de Lente de almacenamiento que desea eliminar. 1. Elija **Eliminar**. Aparece un cuadro de diálogo **Eliminar grupo de Lente de almacenamiento**. 1. Vuelva a elegir **Eliminar** para eliminar permanentemente su grupo de Lente de almacenamiento. **nota** Después de eliminar un grupo de Lente de almacenamiento, no se puede restaurar. ## Uso de AWS CLI El siguiente ejemplo de AWS CLI elimina el grupo de Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws s3control delete-storage-lens-group --account-id 111122223333 \ --region us-east-1 --name marketing-department ``` ## Uso de AWS SDK para Java El siguiente ejemplo de AWS SDK para Java elimina el grupo de Lente de almacenamiento denominado `Marketing-Department` en la cuenta `111122223333`. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información. ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.DeleteStorageLensGroupRequest; public class DeleteStorageLensGroup { public static void main(String[] args) { String storageLensGroupName = "Marketing-Department"; String accountId = "111122223333"; try { DeleteStorageLensGroupRequest deleteStorageLensGroupRequest = DeleteStorageLensGroupRequest.builder() .name(storageLensGroupName) .accountId(accountId).build(); S3ControlClient s3ControlClient = S3ControlClient.builder() .region(Region.US_WEST_2) .credentialsProvider(ProfileCredentialsProvider.create()) .build(); s3ControlClient.deleteStorageLensGroup(deleteStorageLensGroupRequest); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ```