

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à.

# 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 pannello di controllo**

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. Scegli o specifica 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 quanti livelli gerarchici 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**.

## Utilizzando 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). 