Definir as configurações de armazenamento para o nível frio (AWS CLI)

O procedimento a seguir mostra como definir as configurações de armazenamento para replicar os dados na camada fria usando o AWS CLI.

Para definir as configurações de armazenamento usando AWS 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 file-name pelo nome do arquivo que contém a configuração AWS IoT SiteWise de armazenamento.

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

   exemplo AWS IoT SiteWise configuração de armazenamento

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

   • Substitua o prefixo pelo prefixo do Amazon S3.

   • aws-account-idSubstitua pelo ID AWS da sua conta.

   • Substitua role-name pelo nome da função de acesso do Amazon S3 que AWS IoT SiteWise permite enviar dados para o Amazon S3.

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

   {
         "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ção de AWS IoT SiteWise armazenamento e na política do IAM.

   • Certifique-se de que sua função tem as permissões do 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-name pelo nome do bucket do Amazon S3.

   exemplo Retorno

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

   nota

   A atualização da configuração de armazenamento pode levar alguns minutos. AWS IoT SiteWise

2. Para obter as informações de configuração do repositório, use o seguinte comando:

   aws iotsitewise describe-storage-configuration

   exemplo Retorno

   {
         "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 interromper a exportação de dados para o bucket do Amazon S3, execute o comando a seguir para definir configurações de armazenamento:

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

   nota

   Por padrão, seus dados são armazenados apenas na camada ativa do AWS IoT SiteWise.

   exemplo Retorno

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

4. Para obter as informações de configuração do repositório, use o seguinte comando:

   aws iotsitewise describe-storage-configuration

   exemplo Retorno

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

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

Um armazenamento AWS IoT Analytics de dados é um repositório escalável e consultável que recebe e armazena dados. Você pode usar o AWS IoT SiteWise console ou as AWS IoT Analytics APIs para criar um armazenamento AWS IoT Analytics de dados para salvar seus AWS IoT SiteWise dados. Para consultar os dados, você cria conjuntos de dados usando o. AWS IoT Analytics Para obter mais informações, consulte Trabalhando com dados AWS IoT SiteWise no Guia do Usuário AWS IoT Analytics .

As etapas a seguir são usadas AWS CLI para criar um armazenamento de dados em AWS IoT Analytics.

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

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

nota

• Você deve especificar o nome de um bucket existente 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 S3 no Guia do usuário do Amazon S3.

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

exemplo AWS IoT Analytics configuração do armazenamento de dados

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

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

exemplo Retorno

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