Definir as configurações de armazenamento (AWS CLI)

O procedimento a seguir mostra como definir as configurações de armazenamento para replicar dados para a camada fria usandoAWS CLI.

Para definir as configurações de armazenamento usandoAWS CLI

1. Para exportar dados para um bucket do Amazon S3 em sua conta, execute o comando a seguir para definir as configurações de armazenamento. Substitua o nome do arquivo pelo nome do arquivo que contém a configuraçãoAWS IoT SiteWise de armazenamento.

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

   exemplo AWS IoT SiteWiseconfiguração de armazenamento

   • Substitua bucket name pelo nome do bucket do Amazon S3.

   • Substitua o prefixo pelo prefixo do Amazon S3.

   • Substitua aws-account-id pelo ID de sua conta da AWS.

   • Substitua o nome da função pelo nome da função de acesso do Amazon S3 que permiteAWS IoT SiteWise enviar dados para o Amazon S3.

   • retention-in-daysSubstitua por um número inteiro maior ou igual a 30 dias.

     nota

     AWS IoT SiteWiseexcluirá todos os dados na camada ativa que sejam anteriores ao período de retenção. Se você não definir um período de retenção, seus dados serão armazenados indefinidamente.

   {
         "storageType": "MULTI_LAYER_STORAGE",
         "multiLayerStorage": {
             "customerManagedS3Storage": {
                 "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/",
                 "roleArn": "arn:aws:iam::aws-account-id:role/role-name"
             }
         }, 
         "retentionPeriod": { 
             "numberOfDays": retention-in-days,
             "unlimited": false
         }
     }

   nota

   • Você deve usar o mesmo nome de bucket do Amazon S3 na configuraçãoAWS IoT SiteWise de armazenamento e na política do IAM.

   • Verifique se a função tem as permissões mostradas no exemplo a seguir.

     exemplo política de permissões

     {
           "Version": "2012-10-17",
           "Statement": [
               {
                   "Effect": "Allow",
                   "Action": [
                       "s3:PutObject",
                       "s3:GetObject",
                       "s3:DeleteObject",
                       "s3:GetBucketLocation",
                       "s3:ListBucket"
                   ],
                   "Resource": [
                       "arn:aws:s3:::bucket-name",
                       "arn:aws:s3:::bucket-name/*"
                   ]
               }
           ]
       }

     Substitua bucket do Amazon S3.

   exemplo response

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

   nota

   Pode demorar alguns minutos paraAWS IoT SiteWise que a atualização da configuração do armazenamento.

2. Para recuperar as informações de configuração do armazenamento, execute o comando a seguir.

   aws iotsitewise describe-storage-configuration

   exemplo response

   {
         "storageType": "MULTI_LAYER_STORAGE",
         "multiLayerStorage": {
             "customerManagedS3Storage": {
                 "s3ResourceArn": "arn:aws:s3:::DOC-EXAMPLE-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. Para parar de exportar dados para o bucket do Amazon S3, execute o comando a seguir para definir as configurações de armazenamento.

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

   nota

   Por padrão, seus dados são armazenados somente na camada quente deAWS IoT SiteWise.

   exemplo response

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

4. Para recuperar as informações de configuração do armazenamento, execute o comando a seguir.

   aws iotsitewise describe-storage-configuration

   exemplo response

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

(Opcional) Crie um armazenamentoAWS IoT Analytics de dados (AWS CLI)

Um armazenamentoAWS IoT Analytics de dados é um repositório escalável e consultável que recebe e armazena dados. Você pode usar oAWS IoT SiteWise console ou asAWS IoT Analytics APIs para criar um armazenamento deAWS IoT Analytics dados para salvar seusAWS IoT SiteWise dados. Para consultar os dados, você cria conjuntos de dados usandoAWS IoT Analytics. Para obter mais informações, consulte Como trabalhar comAWS IoT SiteWise dados no GuiaAWS IoT Analytics do usuário.

As etapas a seguir são usadasAWS CLI para criar um armazenamento de dados noAWS IoT Analytics.

Para criar um armazenamento de dados, execute o comando a seguir. Substitua o nome do arquivo pelo nome do arquivo que contém a configuração do armazenamento de dados.

aws iotanalytics create-datastore --cli-input-json file://file-name.json

nota

• Você deve especificar o nome de um bucket do Amazon S3. Se você não tiver um bucket do Amazon S3, crie um primeiro. Para obter mais informações, consulte Criar seu primeiro bucket do S3 no Guia do usuário do Amazon S3.

• Você deve usar o mesmo nome de bucket do Amazon S3 na configuraçãoAWS IoT SiteWise de armazenamento, na política do IAM e na configuração do armazenamento deAWS IoT Analytics dados.

exemplo AWS IoT Analyticsconfiguração do armazenamento de dados

Substitua data-store-namee s3-bucket-name pelo nome do seu armazenamento deAWS IoT Analytics dados e pelo nome do bucket do Amazon S3.

{
      "datastoreName": "data-store-name",
      "datastoreStorage": {
          "iotSiteWiseMultiLayerStorage": {
              "customerManagedS3Storage": {
                  "bucket": "s3-bucket-name"
              }
          }
      },
      "retentionPeriod": {
          "numberOfDays": 90
      }
  }

exemplo response

{
      "datastoreName": "datastore_IoTSiteWise_demo",
      "datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
      "retentionPeriod": {
          "numberOfDays": 90,
          "unlimited": false
      }
  }