

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di Amazon S3 Storage Lens con la console e l'API
<a name="S3LensExamples"></a>

Amazon S3 Storage Lens è una funzionalità di analisi dell'archiviazione su cloud che puoi utilizzare per avere una panoramica completa a livello di organizzazione sull'utilizzo e sulle attività relative all'archiviazione di oggetti. È possibile utilizzare i parametri di S3 Storage Lens per generare approfondimenti, ad esempio per scoprire la quantità di spazio di archiviazione disponibile nell'intera organizzazione o quali sono i bucket e i prefissi caratterizzati da una crescita più rapida. Puoi anche utilizzare i parametri di S3 Storage Lens per individuare le opportunità di ottimizzazione dei costi, implementare le best practice di protezione e sicurezza dei dati e migliorare le prestazioni dei carichi di lavoro delle applicazioni. Ad esempio, puoi identificare i bucket che non hanno regole del ciclo di vita S3 per far scadere i caricamenti in più parti incompleti che risalgono a più di 7 giorni. Puoi anche individuare i bucket non conformi alle best practice di protezione dei dati, come quelli che usano la replica S3 o il controllo delle versioni S3. S3 Storage Lens analizza i parametri di archiviazione per fornire raccomandazioni contestuali che puoi usare per ottimizzare i costi di archiviazione e applicare le best practice sulla protezione dei dati. 

S3 Storage Lens aggrega i tuoi parametri e mostra le informazioni nella sezione **Account snapshot** (Snapshot dell'account) nella pagina **Buckets** (Bucket) della console di Amazon S3. S3 Storage Lens fornisce anche una dashboard interattiva che puoi utilizzare per visualizzare approfondimenti e tendenze, contrassegnare valori anomali e ricevere consigli per ottimizzare i costi di storage e applicare le migliori pratiche di protezione dei dati. La dashboard offre opzioni drill-down per generare e visualizzare informazioni a livello di organizzazione, account, classe di storage, bucket, prefisso Regione AWS o gruppo Storage Lens. Puoi anche inviare un rapporto giornaliero sulle metriche in formato CSV o in Parquet formato a un bucket S3 generico o esportare le metriche direttamente in un bucket di tabella S3 gestito. AWS

**Nota**  
[Storage Lens aggrega solo le metriche per i bucket S3 per uso generico.](UsingBucket.md)

Questa sezione contiene esempi di creazione, aggiornamento e visualizzazione delle configurazioni S3 Storage Lens e l'esecuzione di operazioni correlate alla funzione. Se utilizzi S3 Storage Lens con AWS Organizations, questi esempi coprono anche questi casi d'uso. Negli esempi, sostituisci tutti i valori segnaposto.

**Topics**
+ [Creare una dashboard di Amazon S3 Storage Lens](storage_lens_creating_dashboard.md)
+ [Aggiornare la dashboard di Amazon S3 Storage Lens](storage_lens_editing.md)
+ [Disattivare la dashboard di Amazon S3 Storage Lens](storage_lens_disabling.md)
+ [Eliminare la dashboard di Amazon S3 Storage Lens](storage_lens_deleting.md)
+ [Elenco delle dashboard di Amazon S3 Storage Lens](storage_lens_list_dashboard.md)
+ [Visualizzare i dettagli della configurazione della dashboard di Amazon S3 Storage Lens](storage_lens_viewing.md)
+ [Gestione dei tag AWS delle risorse con S3 Storage Lens](storage-lens-groups-manage-tags-dashboard.md)
+ [File helper per l'utilizzo di Amazon S3 Storage Lens](S3LensHelperFilesCLI.md)

# Creare una dashboard di Amazon S3 Storage Lens
<a name="storage_lens_creating_dashboard"></a>

Puoi creare dashboard personalizzati aggiuntivi di S3 Storage Lens che possono essere adattati alla tua organizzazione o a gruppi specifici AWS Organizations Regioni AWS o all'interno di un account. 

**Nota**  
Affinché la visualizzazione di qualsiasi aggiornamento alla configurazione del pannello di controllo sia accurata, possono essere necessarie fino a 48 ore.

## Utilizzo della console S3
<a name="storage_lens_console_creating"></a>

Attieniti alla procedura seguente per creare un pannello di controllo Amazon S3 Storage Lens sulla console Amazon S3.

**Passaggio 1: configura le impostazioni generali**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nella barra di navigazione nella parte superiore della pagina, scegli il nome del file attualmente visualizzato Regione AWS. Quindi, scegli la Regione a cui passare. 

1. Nel pannello di navigazione a sinistra, in **S3 Storage Lens** scegli **Pannelli di controllo**.

1. Seleziona **Crea pannello di controllo**.

1. Nella sezione **Generale** della pagina **Pannello di controllo** completa le seguenti operazioni:

   1. Visualizzare la **Regione di origine** della dashboard. La regione principale è la regione Regione AWS in cui sono archiviate la configurazione e le metriche di questa dashboard di Storage Lens.

   1. Specifica il nome di un pannello di controllo. 

      I nomi del pannello di controllo devono contenere meno di 65 caratteri e non possono contenere caratteri speciali o spazi. 
**Nota**  
Il nome del pannello di controllo dopo la creazione non potrà più essere modificato.

   1. Scegli **Abilitato** per visualizzare le metriche giornaliere aggiornate nella dashboard.

   1. (Facoltativo) Puoi scegliere di aggiungere **tag** alla tua dashboard. I tag possono essere utilizzati per gestire le autorizzazioni per il pannello di controllo e tenere traccia dei costi per S3 Storage Lens. Per ulteriori informazioni, consulta [Controllare l'accesso alle AWS risorse utilizzando i tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) nella *IAM User Guide* e [Using AWS-generated tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) nella *AWS Billing User Guide*.
**Nota**  
Puoi aggiungere fino a 50 tag alla configurazione del pannello di controllo.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Fase 2: Definire l'ambito del dashboard**

1. Nella sezione **Ambito della dashboard**, scegli le regioni e i bucket che desideri che S3 Storage Lens includa o escluda nella dashboard.

1. Scegli i bucket nelle regioni selezionate che desideri siano inclusi o esclusi da S3 Storage Lens. Puoi includere o escludere i bucket, ma non puoi eseguire entrambe le operazioni. Questa opzione non è disponibile quando crei dashboard a livello di organizzazione.
**Nota**  
Puoi anche includere o escludere Regioni e bucket. Questa opzione è limitata alle Regioni solo se si creano dashboard a livello di organizzazione tra gli account membri dell'organizzazione. 
Puoi scegliere fino a 50 bucket da includere o escludere.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 3: scegli il livello Storage Lens**

1. Nella sezione **Storage Lens tier**, scegli il livello di funzionalità che desideri aggregare per questa dashboard.

   1. **Per includere metriche gratuite aggregate a livello di bucket e disponibili per le query per 14 giorni, scegli il livello gratuito.**

   1. **Per abilitare le metriche avanzate, scegli il livello Avanzato.** Queste opzioni includono l'aggregazione di gruppi di prefissi o Storage Lens, la CloudWatch pubblicazione su Amazon, il report esteso sui prefissi e consigli contestuali. I dati sono disponibili per le query per 15 mesi. I parametri e i suggerimenti avanzati hanno un costo aggiuntivo. Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://aws.amazon.com/s3/pricing/).

      Per ulteriori informazioni su parametri avanzati e parametri gratuiti, consulta [Selezione delle metriche](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).

1. In **Categorie di metriche avanzate**, seleziona la categoria di metriche che desideri abilitare:
   + **Parametri delle attività**
   + **Detailed status code metrics** (Parametri dettagliati codice di stato)
   + **Metriche di ottimizzazione dei costi**
   + **Metriche di protezione dei dati**
   + **Metriche delle prestazioni**

   Per vedere in anteprima quali metriche sono incluse in ogni categoria, utilizza il pulsante con la freccia a discesa sotto l'elenco delle caselle di controllo delle categorie di metriche. Per ulteriori informazioni sulle categorie di parametri, consulta [Categorie di parametri](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Per un elenco completo di parametri, consulta [Glossario dei parametri di Amazon S3 Storage Lens](storage_lens_metrics_glossary.md).

1. Scegliete o specificate un **delimitatore di prefisso** per distinguere i livelli all'interno di ciascun prefisso. Questo valore viene utilizzato per identificare ogni livello di prefisso. Il valore predefinito in Amazon S3 è il carattere "`/`", ma la struttura di storage potrebbe utilizzare altri caratteri delimitatori.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 4: (Facoltativo) Scegli l'aggregazione delle metriche**

1. In **Aggregazione di metriche aggiuntive, scegli quali metriche vuoi aggregare**:
   + Aggregazione di prefisso
   + Aggregazione dei gruppi Storage Lens

1. **Se hai abilitato l'**aggregazione dei prefissi**, specifica la **soglia minima del prefisso per la dashboard e la profondità del prefisso**.** Quindi, scegli **Avanti** per salvare e procedere.
**Nota**  
L'impostazione della **profondità del prefisso** determina il numero di livelli gerarchici che deep S3 Storage Lens analizzerà i prefissi degli oggetti, con un limite massimo di 10 livelli. La **soglia del prefisso** specifica la percentuale minima di spazio di archiviazione totale che un prefisso deve rappresentare prima di essere incluso nelle metriche di Storage Lens.

1. Se hai abilitato l'**aggregazione dei gruppi di Storage Lens**, scegli una delle seguenti opzioni:
   + **Includi i gruppi Storage Lens**
   + **Escludi i gruppi Storage Lens**

1. Quando includi i gruppi Storage Lens nella tua aggregazione, puoi **includere tutti i gruppi Storage Lens nella tua regione d'origine** o specificare i gruppi Storage Lens da includere.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 5: (Facoltativo) Scegli le impostazioni di esportazione e pubblicazione delle metriche**

1. In **Pubblicazione di metriche**, scegli la **CloudWatchpubblicazione** se desideri accedere alle metriche di Storage Lens nella dashboard. CloudWatch
**Nota**  
Le metriche a livello di prefisso non sono disponibili in. CloudWatch

1. In **Esportazione delle metriche**, scegli i dati del dashboard di Storage Lens che desideri esportare ogni giorno:
   + **Rapporto sulle metriche predefinite**
   + **Rapporto esteso sulle metriche dei prefissi**

1. (Facoltativo) Se hai scelto Rapporto sulle **metriche predefinite, nelle impostazioni del rapporto sulle** **metriche predefinite, scegli il tipo** di bucket. Puoi esportare il report in un bucket Amazon S3 generico o in un bucket da tabella S3 AWS gestito. **In base al tipo di bucket selezionato, aggiorna le **impostazioni di destinazione del bucket per uso generico o le opzioni di destinazione del bucket Table**.**
**Nota**  
Il **rapporto sulle metriche predefinite** include solo i prefissi entro la soglia e la profondità impostate nelle impostazioni di aggregazione dei prefissi.  
Se scegli di specificare una chiave di crittografia, devi scegliere una chiave (SSE-KMS) o una AWS KMS chiave gestita Amazon S3 (SSE-S3). Se la policy del bucket di destinazione richiede la crittografia, devi fornire una chiave di crittografia per l'esportazione delle metriche. Senza la chiave di crittografia, l'esportazione verso S3 non riesce. Per ulteriori informazioni, consulta [Utilizzo di an AWS KMS key per crittografare le esportazioni delle metriche](storage_lens_encrypt_permissions.md).

1. (Facoltativo) Se hai scelto il rapporto sulle metriche dei **prefissi espansi, nelle impostazioni del rapporto sulle metriche** dei **prefissi espansi, scegli il tipo di bucket**. Puoi esportare il report in un bucket Amazon S3 generico o in un bucket da tabella S3 di sola lettura. **In base al tipo di bucket selezionato, aggiorna le impostazioni di destinazione del bucket per **uso generico o le impostazioni di destinazione del bucket Table.****
**Nota**  
Il **rapporto sulle metriche dei prefissi espansi** include tutti i prefissi fino alla profondità del prefisso 50 in tutti i bucket selezionati specificati nell'ambito del dashboard.  
Se scegli di specificare una chiave di crittografia, devi scegliere una chiave (SSE-KMS) o una AWS KMS chiave gestita Amazon S3 (SSE-S3). Se la policy del bucket di destinazione richiede la crittografia, devi fornire una chiave di crittografia per l'esportazione delle metriche. Senza la chiave di crittografia, l'esportazione verso S3 non riesce. Per ulteriori informazioni, consulta [Utilizzo di an AWS KMS key per crittografare le esportazioni delle metriche](storage_lens_encrypt_permissions.md).

1. Scegli **Avanti** per salvare le modifiche e procedere.

1. Controlla tutto nella pagina **Rivedi e crea**. Se non ci sono ulteriori modifiche, scegli **Avanti** per salvare le modifiche e creare la dashboard.

**Passaggio 6: rivedi la configurazione della dashboard e crea la dashboard**

1. Nella sezione **Generale**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Ambito della dashboard**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Storage Lens tier**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Aggregazione delle metriche**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Esportazione delle metriche**, rivedi le impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Dopo aver esaminato e confermato tutte le impostazioni di configurazione della dashboard, scegli **Invia** per creare la dashboard.

Dopo aver creato con successo la nuova dashboard di Storage Lens, puoi visualizzarla elencata nella pagina Storage Lens **Dashboard**.

## Usando il AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
Il seguente esempio di comando crea una configurazione di Amazon S3 Storage Lens con tag. Per utilizzare questi esempi, sostituisci `user input placeholders` con le tue informazioni.  

```
aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json
```

**Example**  
Il seguente esempio di comando crea una configurazione di Amazon S3 Storage Lens senza tag. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json
```

## Utilizzo dell' AWS SDK for Java
<a name="S3CreateandUpdateStorageLensConfigurationJava"></a>

**Example - Creare e aggiornare la configurazione di Amazon S3 Storage Lens**  
L'esempio seguente crea e aggiorna una configurazione di Amazon S3 Storage Lens in SDK per Java:  

```
package aws.example.s3control;

import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.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.AccountLevel;
import software.amazon.awssdk.services.s3control.model.ActivityMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedCostOptimizationMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedDataProtectionMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedPerformanceMetrics;
import software.amazon.awssdk.services.s3control.model.BucketLevel;
import software.amazon.awssdk.services.s3control.model.CloudWatchMetrics;
import software.amazon.awssdk.services.s3control.model.DetailedStatusCodesMetrics;
import software.amazon.awssdk.services.s3control.model.Format;
import software.amazon.awssdk.services.s3control.model.Include;
import software.amazon.awssdk.services.s3control.model.OutputSchemaVersion;
import software.amazon.awssdk.services.s3control.model.PrefixLevel;
import software.amazon.awssdk.services.s3control.model.PrefixLevelStorageMetrics;
import software.amazon.awssdk.services.s3control.model.PutStorageLensConfigurationRequest;
import software.amazon.awssdk.services.s3control.model.S3BucketDestination;
import software.amazon.awssdk.services.s3control.model.SSES3;
import software.amazon.awssdk.services.s3control.model.SelectionCriteria;
import software.amazon.awssdk.services.s3control.model.StorageLensAwsOrg;
import software.amazon.awssdk.services.s3control.model.StorageLensConfiguration;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExportEncryption;
import software.amazon.awssdk.services.s3control.model.StorageLensExpandedPrefixesDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensTableDestination;
import software.amazon.awssdk.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

public class CreateAndUpdateDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        String exportAccountId = "Destination Account ID";
        String exportBucketArn = "arn:aws:s3:::destBucketName"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
        String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh";
        Format exportFormat = Format.CSV;

        try {
            SelectionCriteria selectionCriteria = SelectionCriteria.builder()
                    .delimiter("/")
                    .maxDepth(5)
                    .minStorageBytesPercentage(10.0)
                    .build();

            PrefixLevelStorageMetrics prefixStorageMetrics = PrefixLevelStorageMetrics.builder()
                    .isEnabled(true)
                    .selectionCriteria(selectionCriteria)
                    .build();

            BucketLevel bucketLevel = BucketLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .prefixLevel(PrefixLevel.builder().storageMetrics(prefixStorageMetrics).build())
                    .build();

            AccountLevel accountLevel = AccountLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .bucketLevel(bucketLevel)
                    .build();

            Include include = Include.builder()
                    .buckets(Arrays.asList("arn:aws:s3:::bucketName"))
                    .regions(Arrays.asList("us-west-2"))
                    .build();

            StorageLensDataExportEncryption exportEncryption = StorageLensDataExportEncryption.builder()
                    .sses3(SSES3.builder().build())
                    .build();

            S3BucketDestination s3BucketDestination = S3BucketDestination.builder()
                    .accountId(exportAccountId)
                    .arn(exportBucketArn)
                    .encryption(exportEncryption)
                    .format(exportFormat)
                    .outputSchemaVersion(OutputSchemaVersion.V_1)
                    .prefix("Prefix")
                    .build();

            StorageLensTableDestination s3TablesDestination = StorageLensTableDestination.builder()
                    .encryption(exportEncryption)
                    .isEnabled(true)
                    .build();

            CloudWatchMetrics cloudWatchMetrics = CloudWatchMetrics.builder()
                    .isEnabled(true)
                    .build();

            StorageLensDataExport dataExport = StorageLensDataExport.builder()
                    .cloudWatchMetrics(cloudWatchMetrics)
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensAwsOrg awsOrg = StorageLensAwsOrg.builder()
                    .arn(awsOrgARN)
                    .build();

            StorageLensExpandedPrefixesDataExport expandedPrefixesDataExport = StorageLensExpandedPrefixesDataExport.builder()
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensConfiguration configuration = StorageLensConfiguration.builder()
                    .id(configurationId)
                    .accountLevel(accountLevel)
                    .include(include)
                    .dataExport(dataExport)
                    .awsOrg(awsOrg)
                    .expandedPrefixesDataExport(expandedPrefixesDataExport)
                    .prefixDelimiter("/")
                    .isEnabled(true)
                    .build();

            List<StorageLensTag> tags = Arrays.asList(
                    StorageLensTag.builder().key("key-1").value("value-1").build(),
                    StorageLensTag.builder().key("key-2").value("value-2").build()
            );

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();

            s3ControlClient.putStorageLensConfiguration(PutStorageLensConfigurationRequest.builder()
                    .accountId(sourceAccountId)
                    .configId(configurationId)
                    .storageLensConfiguration(configuration)
                    .tags(tags)
                    .build()
            );

        } catch (AwsServiceException 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();
        }
    }
}
```

Per accedere ai gruppi di S3 Storage Lens o ai prefissi espansi, devi aggiornare la dashboard per utilizzare il livello avanzato. Si applicano costi aggiuntivi. Per ulteriori informazioni sui livelli gratuito e avanzato, consulta[Selezione delle metriche](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Per ulteriori informazioni sui gruppi S3 Storage Lens, consulta [Operazioni con i gruppi S3 Storage Lens per filtrare e aggregare le metriche](storage-lens-groups-overview.md). 

# Aggiornare la dashboard di Amazon S3 Storage Lens
<a name="storage_lens_editing"></a>

 La dashboard predefinita di Amazon S3 Storage Lens è `default-account-dashboard`. Questo pannello di controllo è preconfigurato da Amazon S3 per aiutarti a visualizzare informazioni dettagliate di riepilogo e tendenze per i parametri avanzati e gratuiti aggregati dell'intero account nella console. Non puoi modificare l'ambito di configurazione del pannello di controllo predefinito, ma puoi aggiornare la selezione dei parametri dai parametri gratuiti ai suggerimenti e ai parametri avanzati a pagamento, configurare l'esportazione facoltativa dei parametri o addirittura disabilitare il pannello di controllo predefinito. La dashboard predefinita non può essere eliminata, ma solo disattivata. Per ulteriori informazioni, consulta [Utilizzo della console S3](storage_lens_console_deleting.md).

## Utilizzo della console S3
<a name="storage_lens_console_editing"></a>

Attieniti alla procedura seguente per aggiornare un pannello di controllo Amazon S3 Storage Lens sulla console Amazon S3.

**Passaggio 1: aggiorna la dashboard e configura le impostazioni generali**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione a sinistra, scegli **Storage Lens, Dashboards** (Storage Lens, Pannelli di controllo).

1. Scegli la dashboard che desideri modificare.

1. Scegli **Visualizza configurazione del pannello di controllo**.

1. Scegli **Modifica**. Ora puoi rivedere la configurazione della dashboard, passo dopo passo. Per apportare modifiche a uno qualsiasi dei passaggi, puoi fare clic direttamente sul passaggio utilizzando la barra di navigazione a sinistra. Per istruzioni su come aggiornare questi passaggi,
**Nota**  
Non è possibile modificare quanto segue:  
Il nome del pannello di controllo
La regione di origine

1. Nella pagina **Dashboard**, nella sezione **Generale**, puoi apportare modifiche a quanto segue:
   + Scegli **Abilitato** o **Disabilitato** per aggiornare se ricevi o meno le metriche giornaliere nella dashboard.
   + (Facoltativo) Puoi scegliere di aggiungere **tag** alla tua dashboard. I tag possono essere utilizzati per gestire le autorizzazioni per il pannello di controllo e tenere traccia dei costi per S3 Storage Lens. Per ulteriori informazioni, consulta [Controllare l'accesso alle AWS risorse utilizzando i tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) nella *IAM User Guide* e [Using AWS-generated tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) nella *AWS Billing User Guide*.
**Nota**  
Puoi aggiungere fino a 50 tag alla configurazione del pannello di controllo.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 2: aggiorna l'ambito del dashboard**

1. Nella sezione **Ambito della dashboard**, aggiorna le regioni e i bucket che desideri che S3 Storage Lens includa o escluda nella dashboard.
**Nota**  
Puoi anche includere o escludere Regioni e bucket. Questa opzione è limitata alle Regioni solo se si creano dashboard a livello di organizzazione tra gli account membri dell'organizzazione. 
Puoi scegliere fino a 50 bucket da includere o escludere.

1. Scegli i bucket nelle regioni selezionate che desideri siano inclusi o esclusi da S3 Storage Lens. Puoi includere o escludere i bucket, ma non puoi eseguire entrambe le operazioni. Questa opzione non è disponibile quando crei dashboard a livello di organizzazione.
**Nota**  
Puoi anche includere o escludere Regioni e bucket. Questa opzione è limitata alle Regioni solo se si creano dashboard a livello di organizzazione tra gli account membri dell'organizzazione.
Puoi scegliere fino a 50 bucket da includere o escludere.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 3: Aggiorna il livello Storage Lens Configura la selezione delle metriche**

1. Nella sezione di **selezione delle metriche** del **livello di Storage Lens**, aggiorna il livello di metriche che desideri aggregare per questa dashboard.
**Nota**  
Se stai effettuando l'aggiornamento dal **livello Gratuito al livello** **Avanzato**, dovrai aggiornare le impostazioni di aggregazione delle **Metriche**. Per aggiornare le **impostazioni di aggregazione delle metriche**, consulta **Passaggio 4: Aggiornamento** dell'aggregazione delle metriche.
**Se stai aggiornando il livello Storage Lens dal livello **Advanced al livello** **Free**, non dovrai aggiornare alcuna impostazione di aggregazione di Metrics.** La funzionalità di **aggregazione delle metriche** si applica solo alle categorie di metriche di **livello Advanced**.

1. **Per includere metriche gratuite aggregate a livello di bucket e disponibili per le query per 14 giorni, scegli il livello gratuito.**

1. **Per abilitare le metriche avanzate, scegli il livello Avanzato.** Queste opzioni includono l'aggregazione dei prefissi, la CloudWatch pubblicazione su Amazon e i consigli contestuali. I dati sono disponibili per le query per 15 mesi. I parametri e i suggerimenti avanzati hanno un costo aggiuntivo. Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://aws.amazon.com/s3/pricing/).

   Per ulteriori informazioni su parametri avanzati e parametri gratuiti, consulta [Selezione delle metriche](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).

1. In **Categorie di metriche avanzate**, scegli la categoria di metriche che desideri abilitare:
   + **Parametri delle attività**
   + **Detailed status code metrics** (Parametri dettagliati codice di stato)
   + **Metriche di ottimizzazione dei costi**
   + **Metriche di protezione dei dati**
   + **Metriche delle prestazioni**

   Per vedere in anteprima quali metriche sono incluse in ogni categoria, utilizza il pulsante con la freccia a discesa sotto l'elenco delle caselle di controllo delle categorie di metriche. Per ulteriori informazioni sulle categorie di parametri, consulta [Categorie di parametri](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Per un elenco completo di parametri, consulta [Glossario dei parametri di Amazon S3 Storage Lens](storage_lens_metrics_glossary.md).

1. Scegliete o specificate un **delimitatore di prefisso** per distinguere i livelli all'interno di ciascun prefisso. Questo valore viene utilizzato per identificare ogni livello di prefisso. Il valore predefinito in Amazon S3 è il carattere "`/`", ma la struttura di storage potrebbe utilizzare altri caratteri delimitatori.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 4: (Facoltativo) Aggiorna l'aggregazione delle metriche**

1. In **Aggregazione di metriche aggiuntive**, aggiorna le metriche che desideri aggregare scegliendo una delle seguenti opzioni:
   + Aggregazione di prefisso
   + Aggregazione dei gruppi Storage Lens

1. **Se hai abilitato l'**aggregazione dei prefissi**, specifica la **soglia minima del prefisso per la dashboard e la profondità del prefisso**.** Quindi, scegli **Avanti** per salvare e procedere.

1. Se hai abilitato l'**aggregazione dei gruppi Storage Lens**, scegli una delle seguenti opzioni:
   + **Includi i gruppi Storage Lens**
   + **Escludi i gruppi Storage Lens**

1. Quando includi i gruppi Storage Lens nella tua aggregazione, puoi **includere tutti i gruppi Storage Lens nella tua regione d'origine** o specificare i gruppi Storage Lens da includere.

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 5: (Facoltativo) Aggiorna le impostazioni di esportazione e pubblicazione delle metriche**

1. In **Pubblicazione di metriche**, scegli la **CloudWatchpubblicazione** se desideri accedere alle metriche di Storage Lens nella dashboard. CloudWatch
**Nota**  
Le metriche a livello di prefisso non sono disponibili in. CloudWatch

1. In **Esportazione delle metriche**, scegli i dati del dashboard di Storage Lens che desideri esportare ogni giorno:
   + **Rapporto sulle metriche predefinite**
   + **Rapporto esteso sulle metriche dei prefissi**

1. (Facoltativo) Se hai scelto Rapporto sulle **metriche predefinite, nelle impostazioni del rapporto sulle** **metriche predefinite, scegli il tipo** di bucket. Puoi esportare il report in un bucket S3 generico o in un bucket da tabella S3 di sola lettura. **In base al tipo di bucket selezionato, aggiorna le impostazioni di destinazione del bucket per **uso generico o le opzioni delle impostazioni di destinazione del bucket** per tabelle.**
**Nota**  
Il **rapporto sulle metriche predefinite** include solo i prefissi entro la soglia e la profondità impostate nelle impostazioni di aggregazione dei prefissi. Se l'aggregazione dei prefissi non è già configurata, la soglia include fino ai 100 prefissi più grandi per dimensione.
Se scegli di specificare una chiave di crittografia, devi scegliere una chiave (SSE-KMS) o una AWS KMS chiave gestita Amazon S3 (SSE-S3). Se la policy del bucket di destinazione richiede la crittografia, devi fornire una chiave di crittografia per l'esportazione delle metriche. Senza la chiave di crittografia, l'esportazione verso S3 non riesce. Per ulteriori informazioni, consulta [Utilizzo di an AWS KMS key per crittografare le esportazioni delle metriche](storage_lens_encrypt_permissions.md).

1. Scegli **Avanti** per salvare le modifiche e procedere.

1. (Facoltativo) Se hai scelto il rapporto **sulle metriche dei prefissi espansi, nelle impostazioni del rapporto sulle metriche** dei **prefissi espansi, scegli il tipo di bucket**. Puoi esportare il report in un bucket S3 generico o in un bucket da tabella S3 di sola lettura. **In base al tipo di bucket selezionato, aggiorna le impostazioni di destinazione del bucket per **uso generico o le impostazioni di destinazione del bucket** per tabelle.**
**Nota**  
Il **rapporto sulle metriche dei prefissi espansi** include i prefissi in tutti i bucket specificati nell'ambito del dashboard.
Se scegli di specificare una chiave di crittografia, devi scegliere una chiave (SSE-KMS) o una AWS KMS chiave gestita Amazon S3 (SSE-S3). Se la policy del bucket di destinazione richiede la crittografia, devi fornire una chiave di crittografia per l'esportazione delle metriche. Senza la chiave di crittografia, l'esportazione verso S3 non riesce. Per ulteriori informazioni, consulta [Utilizzo di an AWS KMS key per crittografare le esportazioni delle metriche](storage_lens_encrypt_permissions.md).

1. Scegli **Avanti** per salvare le modifiche e procedere.

**Passaggio 6: rivedi e aggiorna la configurazione della dashboard**

1. Nella sezione **Generale**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Ambito della dashboard**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Storage Lens tier**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Aggregazione delle metriche**, rivedi le tue impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Nella sezione **Esportazione delle metriche**, rivedi le impostazioni. Scegli **Modifica** per apportare eventuali modifiche.

1. Dopo aver esaminato e confermato tutte le impostazioni di configurazione della dashboard, scegli **Invia** per aggiornare la dashboard.

Dopo aver aggiornato con successo la nuova dashboard di Storage Lens, puoi visualizzare la configurazione aggiornata della dashboard elencata nella pagina Storage Lens **Dashboard**.

## Utilizzando il AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
Il seguente esempio di comando aggiorna la configurazione della dashboard di Amazon S3 Storage Lens. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json
```

## Utilizzo dell' AWS SDK for Java
<a name="S3UpdateStorageLensConfigurationAdvancedJava"></a>

**Example - Aggiornare la configurazione di Amazon S3 Storage Lens con metriche e raccomandazioni avanzate**  
Gli esempi seguenti mostrano come aggiornare la configurazione predefinita di S3 Storage Lens con metriche e raccomandazioni avanzate in SDK per Java:  

```
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.ActivityMetrics;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.Format;
import com.amazonaws.services.s3control.model.Include;
import com.amazonaws.services.s3control.model.OutputSchemaVersion;
import com.amazonaws.services.s3control.model.PrefixLevel;
import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.S3BucketDestination;
import com.amazonaws.services.s3control.model.SSES3;
import com.amazonaws.services.s3control.model.SelectionCriteria;
import com.amazonaws.services.s3control.model.StorageLensAwsOrg;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensDataExport;
import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class UpdateDefaultConfigWithPaidFeatures {

    public static void main(String[] args) {
        String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
        String sourceAccountId = "111122223333";

        try {
            SelectionCriteria selectionCriteria = new SelectionCriteria()
                    .withDelimiter("/")
                    .withMaxDepth(5)
                    .withMinStorageBytesPercentage(10.0);
            PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics()
                    .withIsEnabled(true)
                    .withSelectionCriteria(selectionCriteria);
            BucketLevel bucketLevel = new BucketLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
            AccountLevel accountLevel = new AccountLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withBucketLevel(bucketLevel);

            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();
        }
    }
}
```

Per accedere ai gruppi di S3 Storage Lens o ai prefissi espansi, devi aggiornare la dashboard per utilizzare il livello avanzato. Si applicano costi aggiuntivi. Per ulteriori informazioni sui livelli gratuito e avanzato, consulta[Selezione delle metriche](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Per ulteriori informazioni sui gruppi S3 Storage Lens, consulta [Operazioni con i gruppi S3 Storage Lens per filtrare e aggregare le metriche](storage-lens-groups-overview.md). 

# Disattivare la dashboard di Amazon S3 Storage Lens
<a name="storage_lens_disabling"></a>

È possibile disattivare una dashboard Amazon S3 Storage Lens dalla console Amazon S3. La disabilitazione di una dashboard ne impedisce la generazione di metriche in futuro. Un pannello di controllo disabilitato conserva ancora le informazioni di configurazione, in modo che possano essere facilmente richiamate in caso di riattivazione. Un pannello di controllo disabilitato conserva i dati della cronologia fino a quando non sarà più disponibile per le query.

# Utilizzo della console S3
<a name="storage_lens_console_disabling"></a>

Procedere come segue per disattivare una dashboard Amazon S3 Storage Lens sulla console Amazon S3.

**Per disabilitare una dashboard Amazon S3 Storage Lens**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione a sinistra, scegli **Storage Lens**, **Dashboards** (Pannelli di controllo).

1. Nell'elenco **Pannello di controllo** seleziona il pannello di controllo che desideri disabilitare, quindi seleziona **Disabilita** nella parte superiore dell'elenco.

1. Nella pagina visualizzata, conferma che desideri realmente disabilitare il pannello di controllo specificando il nome del pannello di controllo nel campo di testo, quindi seleziona **Conferma**.

# Eliminare la dashboard di Amazon S3 Storage Lens
<a name="storage_lens_deleting"></a>

Non puoi eliminare il pannello di controllo predefinito. Tuttavia, è possibile effettuarne la disabilitazione. Prima di eliminare un pannello di controllo che hai creato in precedenza, considera quanto segue:
+ In alternativa all'eliminazione di un pannello di controllo, puoi *disabilitarlo* in modo che sia disponibile per una riattivazione in futuro. Per ulteriori informazioni, consulta [Utilizzo della console S3](storage_lens_console_disabling.md).
+ L'eliminazione del pannello di controllo comporta l'eliminazione di tutte le impostazioni di configurazione ad esso associate.
+ I dati delle metriche della cronologia non saranno più disponibili. Questi dati storici sono ancora conservati per 15 mesi. Se desideri accedere nuovamente a questi dati, dovrai creare un pannello di controllo con lo stesso nome nella stessa regione di origine di quella eliminata. 

# Utilizzo della console S3
<a name="storage_lens_console_deleting"></a>

È possibile eliminare una dashboard Amazon S3 Storage Lens dalla console Amazon S3. Tuttavia, l'eliminazione di una dashboard ne impedisce la generazione di metriche in futuro.

**Eliminazione di un pannello di controllo di Amazon S3 Storage Lens**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione a sinistra, scegli **Storage Lens**, **Dashboards** (Pannelli di controllo).

1. Nell'elenco **Pannello di controllo** seleziona il pannello di controllo che desideri eliminare, quindi seleziona **Elimina** nella parte superiore dell'elenco.

1. Nella pagina **Elimina pannelli di controllo** conferma di voler realmente eliminare il pannello di controllo specificandone il nome nel campo di testo. Quindi scegli **Conferma**. 

# Utilizzando il AWS CLI
<a name="storage_lens_cli_deleting"></a>

**Example**  
 L'esempio seguente elimina una configurazione di S3 Storage Lens. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control delete-storage-lens-configuration --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id
```

## Utilizzo dell' AWS SDK for Java
<a name="S3DeleteStorageLensConfigurationJava"></a>

**Example - Eliminazione di una configurazione della dashboard Amazon S3 Storage Lens**  
L'esempio seguente mostra come eliminare una configurazione di S3 Storage Lens utilizzando SDK per Java:  

```
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.DeleteStorageLensConfigurationRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class DeleteDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfiguration(new DeleteStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } 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();
        }
    }
}
```

# Elenco delle dashboard di Amazon S3 Storage Lens
<a name="storage_lens_list_dashboard"></a>

 

# Utilizzo della console S3
<a name="storage_lens_console_listing"></a>

**Per elencare le dashboard di S3 Storage Lens**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione sinistro, spostarsi su **Storage Lens**.

1. Scegli **Dashboard**. Ora puoi visualizzare i dashboard nel tuo. Account AWS

## Utilizzando il AWS CLI
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
Il comando di esempio seguente elenca i dashboard di S3 Storage Lens presenti nel tuo. Account AWS Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1 --next-token=abcdefghij1234
```

**Example**  
L'esempio seguente elenca le configurazioni di S3 Storage Lens senza un token successivo. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1
```

## Utilizzo dell' AWS SDK for Java
<a name="S3ListStorageLensConfigurationsJava"></a>

**Example - Elenco delle configurazioni della dashboard S3 Storage Lens**  
Gli esempi seguenti mostrano come elencare le configurazioni di S3 Storage Lens in SDK per Java. Per utilizzare questo esempio, sostituisci `user input placeholders` con le informazioni appropriate. a ogni descrizione di esempio.  

```
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.ListStorageLensConfigurationEntry;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationsRequest;

import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class ListDashboard {

    public static void main(String[] args) {
        String sourceAccountId = "111122223333";
        String nextToken = "nextToken";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final List<ListStorageLensConfigurationEntry> configurations =
                    s3ControlClient.listStorageLensConfigurations(new ListStorageLensConfigurationsRequest()
                            .withAccountId(sourceAccountId)
                            .withNextToken(nextToken)
                    ).getStorageLensConfigurationList();

            System.out.println(configurations.toString());
        } 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();
        }
    }
}
```

# Visualizzare i dettagli della configurazione della dashboard di Amazon S3 Storage Lens
<a name="storage_lens_viewing"></a>

Puoi visualizzare un pannello di controllo di Amazon S3 Storage Lens dalla console Amazon S3 e dall'SDK for AWS CLI Java.

# Utilizzo della console S3
<a name="storage_lens_console_viewing"></a>

**Per visualizzare i dettagli della configurazione della dashboard di S3 Storage Lens**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione sinistro, spostarsi su **Storage Lens**.

1. Scegli **Dashboard**.

1. Dall'elenco **Dashboard**, fare clic sulla dashboard che si desidera visualizzare. È ora possibile visualizzare i dettagli della dashboard di Storage Lens.

## Utilizzando il AWS CLI
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
L'esempio seguente recupera una configurazione di S3 Storage Lens in modo da poterne visualizzare i dettagli. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control get-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Utilizzo dell' AWS SDK for Java
<a name="S3GetStorageLensConfigurationJava"></a>

**Example - Recuperare e visualizzare una configurazione S3 Storage Lens**  
L'esempio seguente mostra come recuperare la configurazione di un S3 Storage Lens in SDK for Java, in modo da poterne visualizzare i dettagli. Per utilizzare questo esempio, sostituisci `user input placeholders` con le informazioni appropriate.  

```
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.GetStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationResult;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class GetDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final StorageLensConfiguration configuration =
                    s3ControlClient.getStorageLensConfiguration(new GetStorageLensConfigurationRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getStorageLensConfiguration();

            System.out.println(configuration.toString());
        } 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();
        }
    }
}
```

# Gestione dei tag AWS delle risorse con S3 Storage Lens
<a name="storage-lens-groups-manage-tags-dashboard"></a>

Ogni dashboard di Amazon S3 Storage Lens viene conteggiata come una AWS risorsa con il proprio Amazon Resource Name (ARN). Pertanto, quando configuri la dashboard di Storage Lens, puoi facoltativamente aggiungere tag di AWS risorsa alla dashboard. È possibile aggiungere fino a 50 tag per ogni dashboard di Storage Lens. Per creare una dashboard Storage Lens con tag, è necessario disporre delle seguenti [Autorizzazioni S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_iam_permissions.html):
+ `s3:ListStorageLensConfigurations`
+ `s3:GetStorageLensConfiguration`
+ `s3:GetStorageLensConfigurationTagging`
+ `s3:PutStorageLensConfiguration`
+ ` s3:PutStorageLensConfigurationTagging`

È possibile utilizzare i tag AWS delle risorse per classificare le risorse in base al reparto, alla linea di attività o al progetto. Questa funzione è utile quando si dispone di numerose risorse dello stesso tipo. Applicando i tag, è possibile identificare rapidamente una specifica dashboard S3 Storage Lens in base ai tag assegnati. È possibile utilizzare i tag anche per monitorare e allocare i costi.

Inoltre, quando aggiungi un tag di AWS risorsa alla dashboard di Storage Lens, attivi il [controllo degli accessi basato sugli attributi (ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)). ABAC è una strategia di autorizzazione che definisce le autorizzazioni in base ad attributi come i tag. Puoi anche utilizzare condizioni che specificano i tag delle risorse nelle tue policy IAM per [controllare](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources) l'accesso alle risorse. AWS 

Puoi modificare chiavi e valori di tag e rimuovere tag da una risorsa in qualsiasi momento. Inoltre, tieni presente le limitazioni seguenti:
+ I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
+ Se aggiungi un tag con la stessa chiave di un tag esistente su quella risorsa, il nuovo valore sovrascrive il vecchio valore.
+ Se elimini una risorsa, verranno eliminati anche tutti i tag a essa associati. 
+ Non includere dati privati o sensibili nei tag delle AWS risorse.
+ I tag di sistema (con chiavi di tag che iniziano con `aws:`) non sono supportati.
+ La lunghezza di ogni chiave di tag non può superare i 128 caratteri. La lunghezza di ogni valore di tag non può superare i 256 caratteri.

Gli esempi seguenti mostrano come utilizzare i tag AWS delle risorse con la dashboard di Storage Lens.

**Topics**
+ [Aggiungere i tag AWS delle risorse a un pannello di controllo di Storage Lens](storage-lens-add-tags.md)
+ [Recupera i tag AWS delle risorse per una dashboard di Storage Lens](storage-lens-get-tags.md)
+ [Aggiornamento dei tag della dashboard di Storage Lens](storage-lens-update-tags.md)
+ [Eliminazione dei tag AWS delle risorse da un pannello di controllo di S3 Storage Lens](storage-lens-dashboard-delete-tags.md)

# Aggiungere i tag AWS delle risorse a un pannello di controllo di Storage Lens
<a name="storage-lens-add-tags"></a>

Gli esempi seguenti mostrano come aggiungere tag di AWS risorsa a una dashboard di S3 Storage Lens. Puoi aggiungere tag di risorsa utilizzando la console Amazon S3, AWS Command Line Interface (AWS CLI) e. AWS SDK per Java

## Utilizzo della console S3
<a name="storage-lens-add-tags-console"></a>

**Per aggiungere tag di AWS risorsa a un pannello di controllo di Storage Lens**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel pannello di navigazione sinistro, spostarsi su **Storage Lens** nel pannello di navigazione sinistro.

1. Scegli **Dashboard**.

1. Scegli il pulsante di opzione per la dashboard Storage Lens che si desidera aggiornare. Quindi scegli **Edit** (Modifica).

1. In **Generale**, scegli **Aggiungi tag**.

1. Nella pagina **Aggiungi tag**, aggiungere la nuova coppia chiave-valore.
**Nota**  
Aggiungendo un tag la cui chiave è la stessa di un tag esistente viene sovrascritto il valore del tag precedente.

1. (Facoltativo) Per aggiungere più di un nuovo tag, scegliete nuovamente **Aggiungi tag** e aggiungi nuove voci. Puoi aggiungere fino a 50 tag di AWS risorsa alla dashboard di Storage Lens.

1. (Facoltativo) Se desideri rimuovere un tag appena aggiunto, scegli **Rimuovi** accanto al tag che desideri eliminare.

1. Scegli **Save changes** (Salva modifiche).

## Utilizzando il AWS CLI
<a name="storage-lens-add-tags-cli"></a>

**Example**  
Il seguente esempio di comando aggiunge tag a una configurazione della dashboard S3 Storage Lens. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control put-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```

## Utilizzo dell' AWS SDK for Java
<a name="storage-lens-add-tags-sdk-java"></a>

L'esempio seguente aggiunge tag a una configurazione di Amazon S3 Storage Lens in SDK per Java. Per utilizzare questo esempio, sostituisci `user input placeholders` con le informazioni appropriate.

**Example - Aggiungere tag a una configurazione di S3 Storage Lens**  

```
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.PutStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class PutDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            List<StorageLensTag> tags = Arrays.asList(
                    new StorageLensTag().withKey("key-1").withValue("value-1"),
                    new StorageLensTag().withKey("key-2").withValue("value-2")
            );

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withTags(tags)
            );
        } 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();
        }
    }
}
```

# Recupera i tag AWS delle risorse per una dashboard di Storage Lens
<a name="storage-lens-get-tags"></a>

Gli esempi seguenti mostrano come recuperare i tag AWS delle risorse per una dashboard di S3 Storage Lens. Puoi ottenere i tag delle risorse utilizzando la console Amazon S3, AWS Command Line Interface (AWS CLI) e. AWS SDK per Java

# Utilizzo della console S3
<a name="storage-lens-get-tags-console"></a>

**Per recuperare i tag delle AWS risorse per un pannello di controllo di Storage Lens**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione sinistro, spostarsi su **Storage Lens**.

1. Scegli **Dashboard**.

1. Scegli il pulsante di opzione per la configurazione della dashboard Storage Lens che si desidera visualizzare. Quindi, scegli **Visualizza configurazione dashboard**.

1. In **Tag**, esaminare i tag associati alla dashboard.

1. (Facoltativo) Se si desidera aggiungere un nuovo tag, scegli **Modifica**. Quindi scegli **Aggiungi tag**. Nella pagina **Aggiungi tag**, aggiungere la nuova coppia chiave-valore.
**Nota**  
Aggiungendo un tag la cui chiave è la stessa di un tag esistente viene sovrascritto il valore del tag precedente.

1. (Facoltativo) Se desideri rimuovere un tag appena aggiunto, scegli **Rimuovi** accanto al tag che desideri eliminare.

1. Scegli **Save changes** (Salva modifiche).

## Utilizzando il AWS CLI
<a name="storage-lens-get-tags-cli"></a>

**Example**  
Il seguente esempio di comando recupera i tag per una configurazione della dashboard S3 Storage Lens. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control get-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```

## Utilizzo dell' AWS SDK for Java
<a name="S3GetStorageLensConfigurationTaggingJava"></a>

**Example - Ottenere i tag per una configurazione della dashboard S3 Storage Lens**  
L'esempio seguente mostra come recuperare i tag per una configurazione della dashboard S3 Storage Lens in SDK per Java. Per utilizzare questo esempio, sostituisci `user input placeholders` con le informazioni appropriate.  

```
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.DeleteStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class GetDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final List<StorageLensTag> s3Tags = s3ControlClient
                    .getStorageLensConfigurationTagging(new GetStorageLensConfigurationTaggingRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getTags();

            System.out.println(s3Tags.toString());
        } 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();
        }
    }
}
```

# Aggiornamento dei tag della dashboard di Storage Lens
<a name="storage-lens-update-tags"></a>

Gli esempi seguenti mostrano come aggiornare i tag del dashboard di Storage Lens utilizzando la console Amazon S3, AWS Command Line Interface (AWS CLI) e. AWS SDK per Java

## Utilizzo della console S3
<a name="storage-lens-dashboard-update-tags-console"></a>

**Per aggiornare un tag di AWS risorsa per un pannello di controllo di Storage Lens**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione sinistro, spostarsi su **Storage Lens**.

1. Scegli **Dashboard**.

1. Scegli il pulsante di opzione per la configurazione della dashboard Storage Lens che si desidera visualizzare. Quindi, scegli **Visualizza configurazione dashboard**.

1. In **Tag**, esaminare i tag associati alla dashboard.

1. (Facoltativo) Se si desidera aggiungere un nuovo tag, scegli **Modifica**. Quindi scegli **Aggiungi tag**. Nella pagina **Aggiungi tag**, aggiungere la nuova coppia chiave-valore.
**Nota**  
Aggiungendo un tag la cui chiave è la stessa di un tag esistente viene sovrascritto il valore del tag precedente.

1. (Facoltativo) Se desideri rimuovere un tag appena aggiunto, scegli **Rimuovi** accanto al tag che desideri eliminare.

1. Scegli **Save changes** (Salva modifiche).

## Utilizzando il AWS CLI
<a name="storage-lens-dashboard-update-tags-cli"></a>

**Example**  
Il seguente esempio di comando aggiunge o sostituisce i tag in una configurazione esistente della dashboard Amazon S3 Storage Lens. Per utilizzare questi esempi, sostituisci `user input placeholders` con le informazioni appropriate.  

```
aws s3control put-storage-lens-configuration-tagging --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --config-id=your-configuration-id
```

## Utilizzo dell' AWS SDK for Java
<a name="storage-lens-dashboard-update-tags-sdk-java"></a>

L' AWS SDK per Java esempio seguente aggiorna i tag AWS delle risorse su un dashboard di Storage Lens esistente. Per utilizzare questo esempio, sostituisci `user input placeholders` con le informazioni appropriate.

**Example - Aggiornare i tag su una configurazione della dashboard Storage Lens esistente**  

```
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.PutStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class PutDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            List<StorageLensTag> tags = Arrays.asList(
                    new StorageLensTag().withKey("key-1").withValue("value-1"),
                    new StorageLensTag().withKey("key-2").withValue("value-2")
            );

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withTags(tags)
            );
        } 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();
        }
    }
}
```

# Eliminazione dei tag AWS delle risorse da un pannello di controllo di S3 Storage Lens
<a name="storage-lens-dashboard-delete-tags"></a>

Gli esempi seguenti mostrano come eliminare i tag AWS delle risorse da una dashboard di Storage Lens esistente. Puoi eliminare i tag utilizzando la console Amazon S3, AWS Command Line Interface (AWS CLI) e. AWS SDK per Java

## Utilizzo della console S3
<a name="storage-lens-groups-delete-tags-console"></a>

**Per eliminare i tag AWS delle risorse da una dashboard di Storage Lens esistente**

1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione sinistro, spostarsi su **Storage Lens**.

1. Scegli **Dashboard**.

1. Scegli il pulsante di opzione per la configurazione della dashboard Storage Lens che si desidera visualizzare. Quindi, scegli **Visualizza configurazione dashboard**.

1. In **Tag**, esaminare i tag associati alla dashboard.

1. Scegli **Rimuovi** accanto al tag che si desidera rimuovere.

1. Scegli **Save changes** (Salva modifiche).

## Utilizzando il AWS CLI
<a name="storage-lens-dashboard-delete-tags-cli"></a>

Il AWS CLI comando seguente elimina i tag AWS delle risorse da un dashboard di Storage Lens esistente. Per utilizzare questo comando di esempio, sostituisci `user input placeholders` con le tue informazioni.

**Example**  

```
aws s3control delete-storage-lens-configuration-tagging --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Utilizzo dell' AWS SDK for Java
<a name="storage-lens-dashboard-delete-tags-sdk-java"></a>

L' AWS SDK per Java esempio seguente elimina un tag di AWS risorsa dalla dashboard di Storage Lens utilizzando l'Amazon Resource Name (ARN) specificato nell'account. `111122223333` Per utilizzare questo esempio, sostituisci `user input placeholders` con le informazioni appropriate.

**Example - Eliminazione dei tag per una configurazione della dashboard S3 Storage Lens**  

```
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.DeleteStorageLensConfigurationTaggingRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class DeleteDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfigurationTagging(new DeleteStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } 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();
        }
    }
}
```

# File helper per l'utilizzo di Amazon S3 Storage Lens
<a name="S3LensHelperFilesCLI"></a>

Utilizza i seguenti file JSON e i suoi input chiave per i tuoi esempi.

## Esempio di configurazione di S3 Storage Lens in JSON
<a name="S3LensHelperFilesSampleConfigurationCLI"></a>

**Example `config.json`**  
Il file `config.json` contiene i dettagli relativi alla configurazione di *parametri e suggerimenti avanzati* a livello di organizzazioni S3 Storage Lens. Per utilizzare il seguente esempio, sostituisci `user input placeholders` con le tue informazioni.  
Per i suggerimenti e i parametri avanzati verranno applicati costi aggiuntivi. Per ulteriori informazioni, consulta [Parametri e suggerimenti avanzati](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_basics_metrics_recommendations.html#storage_lens_basics_metrics_selection).

```
{
  "Id": "SampleS3StorageLensConfiguration", //Use this property to identify your S3 Storage Lens configuration.
  "AwsOrg": { //Use this property when enabling S3 Storage Lens for AWS Organizations.
    "Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh"
  },
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "DetailedStatusCodesMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
        "IsEnabled":true
      },
      "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
      },
      "AdvancedCostOptimizationMetrics": {
        "IsEnabled":true
      },
      "DetailedStatusCodesMetrics": {
        "IsEnabled":true
      },
      "PrefixLevel":{
        "StorageMetrics":{
          "IsEnabled":true,
          "SelectionCriteria":{
            "MaxDepth":5,
            "MinStorageBytesPercentage":1.25,
            "Delimiter":"/"
          }
        }
      }
    }
  },
  "Exclude": { //Replace with "Include" if you prefer to include Regions.
    "Regions": [
      "eu-west-1"
    ],
    "Buckets": [ //This attribute is not supported for AWS Organizations-level configurations.
      "arn:aws:s3:::amzn-s3-demo-source-bucket"
    ]
  },
  "IsEnabled": true, //Whether the configuration is enabled
  "DataExport": { //Details about the metrics export
    "S3BucketDestination": {
      "OutputSchemaVersion": "V_1",
      "Format": "CSV", //You can add "Parquet" if you prefer.
      "AccountId": "111122223333",
      "Arn": "arn:aws:s3:::
amzn-s3-demo-destination-bucket", // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. 
      "Prefix": "prefix-for-your-export-destination",
      "Encryption": {
        "SSES3": {}
      }
    },
    "CloudWatchMetrics": {
      "IsEnabled": true
    }
  }
}
```

## Esempio di configurazione di S3 Storage Lens con gruppi Storage Lens in JSON
<a name="StorageLensGroupsHelperFilesCLI"></a>

**Example `config.json`**  

Il file `config.json` contiene i dettagli da applicare alla configurazione di Storage Lens quando si usano i gruppi Storage Lens. Per usare questo esempio, sostituisci `user input placeholders` con le tue informazioni.

Per collegare tutti i gruppi Storage Lens al pannello di controllo, aggiorna la configurazione di Storage Lens con la seguente sintassi:

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
    "StorageLensGroupLevel": {},
  "IsEnabled": true
}
```

Per includere solo due gruppi di Storage Lens nella configurazione del dashboard di Storage Lens (*slg-1*e*slg-2*), utilizza la seguente sintassi:

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Include": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}
```

Per escludere solo alcuni gruppi Storage Lens dalla configurazione del pannello di controllo, utilizza la seguente sintassi:

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Exclude": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}
```

## File JSON con tag per configurazione di esempio di S3 Storage Lens
<a name="S3LensHelperFilesSampleConfigurationTagsCLI"></a>

**Example `tags.json`**  
Il file `tags.json` contiene i tag da applicare alla configurazione di S3 Storage Lens. Per utilizzare questo esempio, sostituisci `user input placeholders` con le informazioni appropriate.  

```
[
    {
        "Key": "key1",
        "Value": "value1"
    },
    {
        "Key": "key2",
        "Value": "value2"
    }
]
```

## Esempio di configurazione delle autorizzazioni IAM di S3 Storage Lens
<a name="S3LensHelperFilesSampleConfigurationIAMPermissionsCLI"></a>

**Example `permissions.json`: nome del pannello di controllo specifico**  
Questa policy di esempio mostra il file `permissions.json` IAM di S3 Storage Lens con un nome specificato per il pannello di controllo. Sostituisci *`value1`*, `us-east-1`, `your-dashboard-name` e `example-account-id` con il tuo valore.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/your-dashboard-name"
        }
    ]
}
```

**Example `permissions.json`: nessun nome del pannello di controllo specifico**  
Questa policy di esempio mostra il file `permissions.json` IAM di S3 Storage Lens senza un nome specificato per il pannello di controllo. Sostituisci *`value1`*, `us-east-1` e `example-account-id` con il tuo valore.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/*"
        }
    ]
}
```