Configuration des paramètres de stockage

Pour configurer les paramètres de stockage dans la console

1. Accédez à la console AWS IoT SiteWise.

2. Dans le volet de navigation, sous Paramètres, choisissez Stockage.

3. Dans le coin supérieur droit, choisissez Modifier.

4. Sur la page Modifier le stockage, procédez comme suit :

5. Pour les paramètres Hot Tier, procédez comme suit :

   • Si vous souhaitez définir une période de conservation correspondant à la durée pendant laquelle vos données sont stockées dans le niveau chaud avant d'être supprimées et déplacées vers le stockage à chaud géré par le service, choisissez Activer la période de conservation.

   • Pour configurer une période de rétention, entrez un nombre entier et choisissez une unité. La durée de conservation doit être supérieure ou égale à 30 jours.

   AWS IoT SiteWise supprime toutes les données du hot tier qui sont antérieures à la période de conservation. Si vous ne définissez pas de période de conservation, vos données sont stockées indéfiniment.

6. (Recommandé) Pour les paramètres du niveau Warm, procédez comme suit :

   • Pour opter pour le stockage à niveau chaud, sélectionnez Je confirme pour activer le stockage à niveau chaud pour opter pour le stockage à niveau chaud.

   • (Facultatif) Pour configurer une période de rétention, entrez un nombre entier et choisissez une unité. La durée de conservation doit être supérieure ou égale à 365 jours.

   AWS IoT SiteWise supprime les données du niveau chaud qui existaient avant la période de rétention. Si vous ne définissez pas de période de conservation, vos données sont stockées indéfiniment.

   Note

   • Lorsque vous optez pour le niveau chaud, la configuration ne s'affiche qu'une seule fois.

   • Pour définir le niveau de rétention à chaud, vous devez disposer d'un niveau de stockage à chaud ou à froid. Pour des raisons de rentabilité et de récupération des données historiques, il est AWS IoT SiteWise recommandé de stocker les données à long terme dans le niveau chaud.

   • Pour définir le niveau de rétention à chaud, vous devez disposer d'un niveau de stockage à froid.

7. Choisissez Enregistrer pour enregistrer vos paramètres de stockage.

Configuration des paramètres de stockage à l' AWS CLI aide du stockage à froid existant

• Exécutez la commande suivante pour configurer les paramètres de stockage. Remplacez file-name avec le nom du fichier contenant la configuration AWS IoT SiteWise de stockage.

  aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json

  Exemple AWS IoT SiteWise configuration de stockage

  • Remplacez amzn-s3-demo-bucket avec le nom de votre compartiment Amazon S3.

  • Remplacez prefix avec votre préfixe Amazon S3.

  • Remplacez aws-account-id avec votre identifiant de AWS compte.

  • Remplacez role-name avec le nom du rôle d'accès Amazon S3 qui permet d' AWS IoT SiteWise envoyer des données à Amazon S3.

  • Remplacez hot-tier-retention-in-days avec un nombre entier supérieur ou égal à 30 jours.

  • Remplacez warm-tier-retention-in-days avec un nombre entier supérieur ou égal à 365 jours.

  Note

  AWS IoT SiteWise supprimera toutes les données du niveau chaud qui sont antérieures à la période de conservation du niveau froid. Si vous ne définissez pas de période de conservation, vos données sont stockées indéfiniment.

  {
        "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
      }
  }

  Exemple réponse

  {
        "storageType": "MULTI_LAYER_STORAGE",
        "configurationStatus": {
          "state": "UPDATE_IN_PROGRESS"
         }
  }

Pour configurer les paramètres de stockage dans la console

1. Accédez à la console AWS IoT SiteWise.

2. Dans le volet de navigation, sous Paramètres, choisissez Stockage.

3. Dans le coin supérieur droit, choisissez Modifier.

4. Sur la page Modifier le stockage, procédez comme suit :

   1. Pour les paramètres de stockage, choisissez Activer le stockage à froid. Le stockage à froid est désactivé par défaut.

   2. Pour l'emplacement du compartiment S3, entrez le nom d'un compartiment Amazon S3 existant et un préfixe.

      Note

      • Amazon S3 utilise le préfixe comme nom de dossier dans le compartiment Amazon S3. Le préfixe doit comporter de 1 à 255 caractères et se terminer par une barre oblique (/). Vos AWS IoT SiteWise données sont enregistrées dans ce dossier.

      • Si vous n'avez pas de compartiment Amazon S3, choisissez View, puis créez-en un dans la console Amazon S3. Pour plus d'informations, consultez la section Création de votre premier compartiment S3 dans le guide de l'utilisateur Amazon S3.

   3. Pour le rôle d'accès S3, effectuez l'une des opérations suivantes :

      • Choisissez Créer un rôle à partir d'un modèle AWS géré, pour créer AWS automatiquement un IAM rôle qui permet AWS IoT SiteWise d'envoyer des données à Amazon S3.

      • Choisissez Utiliser un rôle existant, puis choisissez le rôle que vous avez créé dans la liste.

        Note

        • Vous devez utiliser le même nom de compartiment Amazon S3 pour l'emplacement du compartiment S3 que celui que vous avez utilisé à l'étape précédente et dans votre IAM politique.

        • Assurez-vous que votre rôle dispose des autorisations indiquées dans l'exemple suivant.

          Exemple politique d'autorisations :

          {
                "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/*"
                        ]
                    }
                ]
            }

          Remplacez amzn-s3-demo-bucket par le nom de votre compartiment Amazon S3.

        • Si le compartiment S3 est chiffré à l'aide d'une KMS clé gérée par le client, la KMS clé doit être assortie d'une politique d'accès comportant un IAM rôle kms:Decrypt et des kms:GenerateDataKey opérations.

   4. Pour configurer le hot tier, reportez-vous à l'étape 5 deConfigurer les paramètres de stockage pour Warm Tier (console).

   5. (Facultatif) Pour AWS IoT Analytics l'intégration, procédez comme suit.

      1. Si vous souhaitez l'utiliser AWS IoT Analytics pour interroger vos données, choisissez Enabled AWS IoT Analytics data store.

      2. AWS IoT SiteWise génère un nom pour votre banque de données ou vous pouvez saisir un autre nom.

      AWS IoT SiteWise crée automatiquement un magasin de données AWS IoT Analytics pour enregistrer vos données. Pour interroger les données, vous pouvez AWS IoT Analytics créer des ensembles de données. Pour plus d'informations, consultez la section Utilisation des AWS IoT SiteWise données dans le Guide de AWS IoT Analytics l'utilisateur.

   6. Choisissez Save (Enregistrer).

Pour configurer les paramètres de stockage à l'aide de AWS CLI

1. Pour exporter des données vers un compartiment Amazon S3 de votre compte, exécutez la commande suivante pour configurer les paramètres de stockage. Remplacez file-name avec le nom du fichier contenant la configuration AWS IoT SiteWise de stockage.

   aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json

   Exemple AWS IoT SiteWise configuration de stockage

   • Remplacez amzn-s3-demo-bucket avec le nom de votre compartiment Amazon S3.

   • Remplacez prefix avec votre préfixe Amazon S3.

   • Remplacez aws-account-id avec votre identifiant de AWS compte.

   • Remplacez role-name avec le nom du rôle d'accès Amazon S3 qui permet d' AWS IoT SiteWise envoyer des données à Amazon S3.

   • Remplacez retention-in-days avec un nombre entier supérieur ou égal à 30 jours.

   {
         "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
         }
     }

   Note

   • Vous devez utiliser le même nom de compartiment Amazon S3 dans la configuration et la IAM politique de AWS IoT SiteWise stockage.

   • Assurez-vous que votre rôle dispose des autorisations indiquées dans l'exemple suivant.

     Exemple politique d'autorisations :

     {
           "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/*"
                   ]
               }
           ]
       }

     Remplacez amzn-s3-demo-bucket par le nom de votre compartiment Amazon S3.

   • Si le compartiment S3 est chiffré à l'aide d'une KMS clé gérée par le client, la KMS clé doit être assortie d'une politique d'accès comportant un IAM rôle kms:Decrypt et des kms:GenerateDataKey opérations.

   Exemple réponse

   {
       "storageType": "MULTI_LAYER_STORAGE",
       "retentionPeriod": {
           "numberOfDays": 100,
           "unlimited": false
       },
       "configurationStatus": {
           "state": "UPDATE_IN_PROGRESS"
       }
   }

   Note

   La mise à jour de la configuration AWS IoT SiteWise de stockage peut prendre quelques minutes.

2. Pour récupérer les informations de configuration du stockage, exécutez la commande suivante.

   aws iotsitewise describe-storage-configuration

   Exemple réponse

   {
         "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"
     }

3. Pour arrêter d'exporter des données vers le compartiment Amazon S3, exécutez la commande suivante pour configurer les paramètres de stockage.

   aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE

   Note

   Par défaut, vos données ne sont stockées que dans le niveau chaud de AWS IoT SiteWise.

   Exemple réponse

   {
         "storageType": "SITEWISE_DEFAULT_STORAGE",
         "configurationStatus": {
             "state": "UPDATE_IN_PROGRESS"
         }
     }

4. Pour récupérer les informations de configuration du stockage, exécutez la commande suivante.

   aws iotsitewise describe-storage-configuration

   Exemple réponse

   {
         "storageType": "SITEWISE_DEFAULT_STORAGE",
         "configurationStatus": {
             "state": "ACTIVE"
         },
         "lastUpdateDate": "2021-03-30T15:57:14-07:00"
     }