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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 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 contendo a configuração de armazenamento AWS IoT SiteWise.

    aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
    exemplo Configuração de armazenamento AWS IoT SiteWise
    • 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 role-name pelo nome da função de acesso do Amazon S3 que permite que o AWS IoT SiteWise envie 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 armazenamento do AWS IoT SiteWise 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

    Pode demorar alguns minutos para que o AWS IoT SiteWise atualize a configuração de armazenamento.

  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 quente 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 de dados AWS IoT Analytics (AWS CLI)

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

As etapas a seguir usam o AWS CLI para criar um armazenamento de dados no 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 armazenamento do AWS IoT SiteWise, na política do IAM e na configuração de armazenamento de dados do AWS IoT Analytics.

exemplo Configuração de armazenamento de dados AWS IoT Analytics

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