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à.
# Configurare le impostazioni di archiviazione in AWS IoT SiteWise
È possibile configurare le impostazioni di archiviazione per attivare lo storage warm tier gestito dal servizio e anche per replicare i dati sul piano freddo. Per ulteriori informazioni sul periodo di conservazione per i livelli caldo e caldo, consulta[Impatto sulla conservazione dei dati](#retention-period). Durante la configurazione delle impostazioni di archiviazione, procedi come segue:
+ **Conservazione a livello elevato**: imposta un periodo di conservazione per quanto tempo i dati vengono archiviati nel livello più elevato prima che vengano eliminati e spostati nello storage a livello caldo o a livello freddo gestito dal servizio in base alle impostazioni di archiviazione. AWS IoT SiteWise eliminerà tutti i dati del livello più elevato che esistevano prima della fine del periodo di conservazione. Se non imposti un periodo di conservazione, i tuoi dati vengono archiviati a tempo indeterminato nel livello più elevato.
+ **Conservazione a livello caldo**: imposta un periodo di conservazione per quanto tempo i dati vengono archiviati nel livello caldo prima che vengano eliminati dallo AWS IoT SiteWise storage e trasferiti nello storage cold tier gestito dal cliente. AWS IoT SiteWise elimina tutti i dati dal livello caldo che esisteva prima della fine del periodo di conservazione. Se non è impostato un periodo di conservazione, i dati vengono archiviati a tempo indeterminato nel livello caldo.
**Nota**
Per migliorare le prestazioni delle query, imposta un periodo di conservazione di livello elevato con lo storage di livello caldo.
## Impatto della conservazione dei dati nello storage di livello caldo e caldo
+ Quando si riduce il periodo di conservazione dello storage hot tier, i dati vengono trasferiti in modo permanente dal livello caldo a quello caldo o freddo. Quando si riduce il periodo di conservazione del livello caldo, i dati vengono spostati sul livello freddo ed eliminati definitivamente dal livello caldo.
+ Quando si aumenta il periodo di conservazione dello storage di livello caldo o caldo, la modifica influisce sui dati inviati AWS IoT SiteWise da quel momento in poi. AWS IoT SiteWise non recupera i dati dallo storage a caldo o a freddo per inserirli nel livello più caldo. Ad esempio, se il periodo di conservazione dello storage hot tier è inizialmente impostato su 30 giorni e poi aumentato a 60 giorni, occorrono 30 giorni perché lo storage hot tier contenga 60 giorni di dati.
**Topics**
+ [
## Impatto della conservazione dei dati nello storage di livello caldo e caldo
](#retention-period)
+ [
## Configura le impostazioni di archiviazione per il livello caldo (console)
](#configure-storage-console-warm)
+ [
## Configura le impostazioni di archiviazione per warm tier (AWS CLI)
](#configure-storage-cli-warm)
+ [
## Configura le impostazioni di archiviazione per il livello freddo (console)
](#configure-storage-console)
+ [
## Configura le impostazioni di archiviazione per il livello freddo (AWS CLI)
](#configure-storage-cli)
## Configura le impostazioni di archiviazione per il livello caldo (console)
La procedura seguente mostra come configurare le impostazioni di archiviazione per replicare i dati sul livello warm della AWS IoT SiteWise console.
**Per configurare le impostazioni di archiviazione nella console**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione, in **Impostazioni**, scegli **Archiviazione**.
1. Nell'angolo in alto a destra, scegliere **Edit (Modifica)**.
1. Nella pagina **Modifica archiviazione**, procedi come segue:
1. Per **le impostazioni Hot tier**, procedi come segue:
+ Se desideri impostare un periodo di conservazione per il periodo di archiviazione dei dati nel livello più elevato prima di essere eliminati e spostati nello storage di livello caldo gestito dal servizio, scegli **Abilita periodo di conservazione**.
+ Per configurare un periodo di conservazione, inserisci un numero intero e scegli un'unità. Il periodo di conservazione deve essere maggiore o uguale a 30 giorni.
AWS IoT SiteWise elimina tutti i dati del livello più importante che sono più vecchi del periodo di conservazione. Se non imposti un periodo di conservazione, i dati vengono archiviati a tempo indeterminato.
1. (Consigliato) Per **le impostazioni del livello Warm**, procedi come segue:
+ Per attivare l'archiviazione di livello caldo, seleziona **Confermo e attiva l'opzione di archiviazione di livello caldo** per attivare l'archiviazione di livello caldo.
+ (Facoltativo) Per configurare un periodo di conservazione, inserisci un numero intero e scegli un'unità. Il periodo di conservazione deve essere maggiore o uguale a 365 giorni.
AWS IoT SiteWise elimina i dati del livello «warm» che esistevano prima del periodo di conservazione. Se non imposti un periodo di conservazione, i dati vengono archiviati a tempo indeterminato.
**Nota**
Quando si opta per il livello caldo, la configurazione viene visualizzata una sola volta.
Per impostare la conservazione a caldo, è necessario disporre di un livello di archiviazione a caldo o a freddo. Per l'efficienza in termini di costi e il recupero dei dati storici, AWS IoT SiteWise consiglia di archiviare i dati a lungo termine nel livello caldo.
Per impostare la conservazione del livello caldo, è necessario disporre di un livello di conservazione a freddo.
1. Scegli **Salva** per salvare le impostazioni di archiviazione.
Nella sezione **AWS IoT SiteWise Archiviazione**, lo **storage Warm tier** si trova in uno di questi stati:
+ **Abilitato**: se i dati esistevano prima del periodo di conservazione del livello più elevato, li AWS IoT SiteWise sposta nel livello caldo».
+ **Disabilitato**: lo storage warm tier è disabilitato.
## Configura le impostazioni di archiviazione per warm tier (AWS CLI)
È possibile configurare le impostazioni di archiviazione per spostare i dati al livello caldo utilizzando AWS CLI i comandi seguenti.
Per evitare di sovrascrivere la configurazione esistente, recupera le informazioni sulla configurazione di archiviazione corrente eseguendo il comando seguente:
```
aws iotsitewise describe-storage-configuration
```
**Example risposta senza una configurazione di livello freddo esistente**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-10-14T15:53:35-07:00",
"warmTier": "DISABLED"
}
```
**Example risposta con la configurazione Cold Tier esistente**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": retention-in-days
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2023-10-25T15:59:46-07:00",
"warmTier": "DISABLED"
}
```
### Configura le impostazioni di archiviazione per il piano caldo con AWS CLI
Esegui il comando seguente per configurare le impostazioni di archiviazione. Sostituisci `file-name` con il nome del file che contiene la configurazione AWS IoT SiteWise di archiviazione.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configurazione con livello caldo e caldo**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"warmTier": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
}
}
```
`hot-tier-retention-in-days`deve essere un numero intero maggiore o uguale a 30 giorni.
**Example risposta**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
Se hai abilitato lo storage a livello freddo, vedi[Configura le impostazioni di archiviazione con AWS CLI un piano freddo esistente](#configure-storage-cli-existing-cold).
### Configura le impostazioni di archiviazione con AWS CLI un piano freddo esistente
**Configura le impostazioni di archiviazione utilizzando AWS CLI lo storage a livello freddo esistente**
+ Esegui il comando seguente per configurare le impostazioni di archiviazione. Sostituisci *file-name* con il nome del file che contiene la configurazione AWS IoT SiteWise di archiviazione.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configurazione di archiviazione**
+ *amzn-s3-demo-bucket*Sostituiscilo con il nome del tuo bucket Amazon S3.
+ *prefix*Sostituiscilo con il tuo prefisso Amazon S3.
+ Sostituiscilo *aws-account-id* con l'ID del tuo AWS account.
+ Sostituisci *role-name* con il nome del ruolo di accesso di Amazon S3 che consente di inviare dati AWS IoT SiteWise ad Amazon S3.
+ Sostituisci *hot-tier-retention-in-days* con un numero intero maggiore o uguale a 30 giorni.
+ Sostituire *warm-tier-retention-in-days* con un numero intero maggiore o uguale a 365 giorni.
**Nota**
AWS IoT SiteWise eliminerà tutti i dati del livello caldo più vecchi del periodo di conservazione del livello freddo. Se non imposti un periodo di conservazione, i dati vengono archiviati a tempo indeterminato.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
},
"warmTier": "ENABLED",
"warmTierRetentionPeriod": {
"numberOfDays": warm-tier-retention-in-days
}
}
```
**Example risposta**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
## Configura le impostazioni di archiviazione per il livello freddo (console)
La procedura seguente mostra come configurare le impostazioni di archiviazione per replicare i dati sul livello freddo della AWS IoT SiteWise console.
**Per configurare le impostazioni di archiviazione nella console**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione, in **Impostazioni**, scegli **Archiviazione**.
1. Nell'angolo in alto a destra, scegliere **Edit (Modifica)**.
1. Nella pagina **Modifica archiviazione**, procedi come segue:
1. Per **le impostazioni di archiviazione**, scegli **Abilita archiviazione a freddo**. La memorizzazione a livello freddo è disabilitata per impostazione predefinita.
1. Per la **posizione del bucket S3**, inserisci il nome di un bucket Amazon S3 esistente e un prefisso.
**Nota**
Amazon S3 utilizza il prefisso come nome di cartella nel bucket Amazon S3. Il prefisso deve contenere da 1 a 255 caratteri e terminare con una barra (/). AWS IoT SiteWise I dati vengono salvati in questa cartella.
Se non disponi di un bucket Amazon S3, scegli **Visualizza**, quindi creane uno nella console Amazon S3. Per ulteriori informazioni, consulta [Crea il tuo primo bucket S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) nella *Amazon S3* User Guide.
1. Per il **ruolo di accesso S3**, esegui una delle seguenti operazioni:
+ Scegli **Crea un ruolo da un modello AWS gestito**, crea AWS automaticamente un ruolo IAM che consente di AWS IoT SiteWise inviare dati ad Amazon S3.
+ Scegli **Usa un ruolo esistente**, quindi scegli il ruolo che hai creato dall'elenco.
**Nota**
È necessario utilizzare lo stesso nome di bucket Amazon S3 per la **posizione del bucket S3** utilizzato nel passaggio precedente e nella policy IAM.
Assicurati che il tuo ruolo disponga delle autorizzazioni mostrate nell'esempio seguente.
**Example politica delle autorizzazioni:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Sostituisci amzn-s3-demo-bucket con il nome del tuo bucket Amazon S3.
Se il bucket Amazon S3 è crittografato utilizzando una chiave KMS gestita dal cliente, la chiave KMS deve avere una politica di accesso con un ruolo e operazioni IAM. `kms:Decrypt` `kms:GenerateDataKey`
1. Per configurare l'hot tier, consulta la Fase 5 di. [Configura le impostazioni di archiviazione per il livello caldo (console)](#configure-storage-console-warm)
1. (Facoltativo) Per **AWS IoT Analytics l'integrazione**, procedi come segue.
**Nota**
Avviso di fine del supporto: il 15 dicembre 2025, AWS terminerà il supporto per AWS IoT Analytics. Dopo il 15 dicembre 2025, non potrai più accedere alla AWS IoT Analytics console o AWS IoT Analytics alle risorse. Per ulteriori informazioni, consulta [AWS IoT Analytics Fine del supporto](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
1. Se desideri utilizzarli AWS IoT Analytics per interrogare i tuoi dati, scegli **Archivio AWS IoT Analytics dati abilitato**.
1. AWS IoT SiteWise genera un nome per il tuo data store oppure puoi inserire un nome diverso.
AWS IoT SiteWise crea automaticamente un data store in AWS IoT Analytics cui salvare i dati. Per interrogare i dati, puoi usarli AWS IoT Analytics per creare set di dati. Per ulteriori informazioni, consulta [Lavorare con AWS IoT SiteWise i dati](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) nella *Guida per l'AWS IoT Analytics utente*.
1. Scegli **Save** (Salva).
Nella sezione **AWS IoT SiteWise Archiviazione**, lo **storage Cold tier** può avere uno dei seguenti valori:
+ **Abilitato**: AWS IoT SiteWise replica i dati nel bucket Amazon S3 specificato.
+ **Abilitazione**: AWS IoT SiteWise sta elaborando la richiesta per abilitare lo storage a freddo. Il completamento di questo processo può richiedere diversi minuti.
+ **Enable\$1Failed**: AWS IoT SiteWise impossibile elaborare la tua richiesta di abilitare lo storage a freddo. Se hai abilitato AWS IoT SiteWise l'invio di log ad Amazon CloudWatch Logs, puoi utilizzare questi log per risolvere i problemi. Per ulteriori informazioni, consulta [Monitoraggio con Amazon CloudWatch Logs](monitor-cloudwatch-logs.md).
+ **Disabilitato**: lo storage a livello freddo è disabilitato.
## Configura le impostazioni di archiviazione per il livello freddo (AWS CLI)
La procedura seguente mostra come configurare le impostazioni di archiviazione per replicare i dati nel livello freddo utilizzando AWS CLI.
**Per configurare le impostazioni di archiviazione utilizzando AWS CLI**
1. Per esportare i dati in un bucket Amazon S3 nel tuo account, esegui il seguente comando per configurare le impostazioni di archiviazione. Sostituisci *file-name* con il nome del file che contiene la configurazione AWS IoT SiteWise di storage.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configurazione di archiviazione**
+ *amzn-s3-demo-bucket*Sostituiscilo con il nome del tuo bucket Amazon S3.
+ *prefix*Sostituiscilo con il tuo prefisso Amazon S3.
+ Sostituiscilo *aws-account-id* con l'ID del tuo AWS account.
+ Sostituisci *role-name* con il nome del ruolo di accesso di Amazon S3 che consente di inviare dati AWS IoT SiteWise ad Amazon S3.
+ Sostituisci *retention-in-days* con un numero intero maggiore o uguale a 30 giorni.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"retentionPeriod": {
"numberOfDays": retention-in-days,
"unlimited": false
}
}
```
**Nota**
È necessario utilizzare lo stesso nome di bucket Amazon S3 nella configurazione AWS IoT SiteWise dello storage e nella policy IAM.
Assicurati che il tuo ruolo disponga delle autorizzazioni mostrate nell'esempio seguente.
**Example politica delle autorizzazioni:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Sostituisci amzn-s3-demo-bucket con il nome del tuo bucket Amazon S3.
Se il bucket Amazon S3 è crittografato utilizzando una chiave KMS gestita dal cliente, la chiave KMS deve avere una politica di accesso con un ruolo e operazioni IAM. `kms:Decrypt` `kms:GenerateDataKey`
**Example risposta**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
**Nota**
L'aggiornamento della configurazione di storage può richiedere alcuni minuti. AWS IoT SiteWise
1. Per recuperare le informazioni sulla configurazione dello storage, esegui il comando seguente.
```
aws iotsitewise describe-storage-configuration
```
**Example risposta**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/torque/",
"roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role"
}
},
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:54:14-07:00"
}
```
1. Per interrompere l'esportazione dei dati nel bucket Amazon S3, esegui il seguente comando per configurare le impostazioni di archiviazione.
```
aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
```
**Nota**
Per impostazione predefinita, i tuoi dati vengono archiviati solo nel livello più elevato di. AWS IoT SiteWise
**Example risposta**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
1. Per recuperare le informazioni sulla configurazione dello storage, esegui il comando seguente.
```
aws iotsitewise describe-storage-configuration
```
**Example risposta**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:57:14-07:00"
}
```
### (Facoltativo) Creare un archivio AWS IoT Analytics dati ()AWS CLI
**Nota**
Avviso di fine del supporto: il 15 dicembre 2025, AWS terminerà il supporto per AWS IoT Analytics. Dopo il 15 dicembre 2025, non potrai più accedere alla AWS IoT Analytics console o AWS IoT Analytics alle risorse. Per ulteriori informazioni, consulta [AWS IoT Analytics Fine del supporto](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
Un AWS IoT Analytics data store è un repository scalabile e interrogabile che riceve e archivia dati. È possibile utilizzare la AWS IoT SiteWise console o AWS IoT Analytics APIs creare un archivio dati per salvare AWS IoT Analytics i dati. AWS IoT SiteWise Per interrogare i dati, si creano set di dati utilizzando AWS IoT Analytics. Per ulteriori informazioni, consulta [Lavorare con AWS IoT SiteWise i dati](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) nella *Guida per l'AWS IoT Analytics utente*.
I passaggi seguenti consentono AWS CLI di creare un archivio dati in AWS IoT Analytics.
Per creare un archivio dati, esegui il comando seguente. Sostituisci *file-name* con il nome del file che contiene la configurazione del data store.
```
aws iotanalytics create-datastore --cli-input-json file://file-name.json
```
**Nota**
È necessario specificare il nome di un bucket Amazon S3 esistente. Se non disponi di un bucket Amazon S3, creane prima uno. Per ulteriori informazioni, consulta [Crea il tuo primo bucket S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) nella *Amazon S3* User Guide.
È necessario utilizzare lo stesso nome di bucket Amazon S3 nella configurazione AWS IoT SiteWise dello storage, nella policy IAM e nella configurazione del AWS IoT Analytics data store.
**Example AWS IoT Analytics configurazione del data store**
Sostituisci *data-store-name* e *amzn-s3-demo-bucket* con il nome del tuo AWS IoT Analytics data store e il nome del bucket Amazon S3.
```
{
"datastoreName": "data-store-name",
"datastoreStorage": {
"iotSiteWiseMultiLayerStorage": {
"customerManagedS3Storage": {
"bucket": "amzn-s3-demo-bucket"
}
}
},
"retentionPeriod": {
"numberOfDays": 90
}
}
```
**Example risposta**
```
{
"datastoreName": "datastore_IoTSiteWise_demo",
"datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
"retentionPeriod": {
"numberOfDays": 90,
"unlimited": false
}
}
```