Defina as configurações de armazenamento em AWS IoT SiteWise

Para definir configurações de ingestão de dados no console:

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação, em Configurações, selecione Armazenamento.

3. No canto superior direito, escolha Editar.

4. Na página Editar permissões, faça o seguinte:

5. Para Configurações do nível quente, faça o seguinte:

   • Se quiser definir um período de retenção para armazenamento dos dados no nível quente antes que eles sejam excluídos e movidos para o armazenamento do nível morno gerenciado pelo serviço, escolha Habilitar período de retenção.

   • Para configurar um período de retenção, insira um número e escolha uma unidade. O período de retenção deve ser igual ou maior que 30 dias.

   AWS IoT SiteWise exclui todos os dados no hot tier que sejam mais antigos do que o período de retenção. Caso não defina um período de retenção, seus dados serão armazenados indefinidamente.

6. (Recomendado) Para Configurações do nível morno, faça o seguinte:

   • Para aceitar o armazenamento de nível morno, selecione Confirmo a opção de armazenamento de nível morno para aceitar o armazenamento de nível morno.

   • (Opcional) Para configurar um período de retenção, insira um número inteiro e escolha uma unidade. O período de retenção deve ser maior ou igual a 365 dias.

   AWS IoT SiteWise exclui dados no nível de aquecimento que existiam antes do período de retenção. Caso não defina um período de retenção, seus dados serão armazenados indefinidamente.

   nota

   • Quando você aceita o nível morno, a configuração só é exibida uma vez.

   • Para definir a retenção do nível quente, você deve ter um armazenamento de nível morno ou frio. Para eficiência de custos e recuperação de dados históricos, AWS IoT SiteWise recomenda que você armazene dados de longo prazo no nível quente.

   • Para definir a retenção do nível morno, você deve ter um armazenamento de nível frio.

7. Escolha Salvar para salvar as configurações de armazenamento.

Defina as configurações de armazenamento usando AWS CLI o armazenamento de camada fria existente

• 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 de armazenamento do AWS IoT SiteWise .

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

  exemplo AWS IoT SiteWise configuração de armazenamento

  • Substitua amzn-s3-demo-bucket pelo nome do bucket do Amazon S3.

  • prefixSubstitua pelo prefixo do Amazon S3.

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

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

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

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

  nota

  AWS IoT SiteWise excluirá todos os dados na camada quente que sejam mais antigos do que o período de retenção da camada fria. Caso não defina um período de retenção, seus dados serão armazenados indefinidamente.

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

  exemplo Retorno

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

Para definir configurações de ingestão de dados no console:

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação, em Configurações, selecione Armazenamento.

3. No canto superior direito, escolha Editar.

4. Na página Editar permissões, faça o seguinte:

   1. Em Configurações de armazenamento, escolha Ativar armazenamento em camada fria. O armazenamento de camada fria estará desabilitado por padrão.

   2. Em Localização do bucket do S3, insira o nome de um bucket existente do Amazon S3 e um prefixo.

      nota

      • O Amazon S3 usa o prefixo como nome de pasta para organizar os dados no bucket Amazon S3. O prefixo deve ter entre 1 e 255 caracteres e terminar com uma barra (/). Seus dados AWS IoT SiteWise serão salvos nessa pasta.

      • Se não tiver um bucket do Amazon S3, escolha Exibir e crie um no console do Amazon S3. Para obter mais informações, consulte Criar seu primeiro bucket do S3 no Guia do Usuário do Amazon S3.

   3. Para Função de acesso S3, siga um destes procedimentos:

      • Escolha Criar uma função a partir de um modelo AWS gerenciado, cria AWS automaticamente uma função do IAM que permite AWS IoT SiteWise enviar dados para o Amazon S3.

      • Escolha Usar uma função existente e, em seguida, a função criada a partir da lista.

        nota

        • Você deve usar o mesmo nome do bucket do Amazon S3 na Localização do bucket do S3 da etapa anterior e 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:::amzn-s3-demo-bucket",
                            "arn:aws:s3:::amzn-s3-demo-bucket/*"
                        ]
                    }
                ]
            }

          Substitua amzn-s3-demo-bucket pelo nome do bucket do Amazon S3.

        • Se o bucket do Amazon S3 for criptografado usando uma chave KMS gerenciada pelo cliente, a chave KMS deverá ter uma política de acesso com uma função do IAM para operações. kms:Decrypt kms:GenerateDataKey

   4. Para configurar o nível quente, consulte a etapa 5 em Definir configurações de armazenamento para nível morno (console).

   5. (Opcional) Para Integração AWS IoT Analytics , faça o seguinte:

      1. Se você quiser usar AWS IoT Analytics para consultar seus dados, escolha Armazenamento de AWS IoT Analytics dados ativado.

      2. AWS IoT SiteWise gera um nome para seu armazenamento de dados ou você pode inserir um nome diferente.

      AWS IoT SiteWise cria automaticamente um armazenamento de dados AWS IoT Analytics para salvar seus dados. Para consultar os dados, você pode usar AWS IoT Analytics para criar conjuntos de dados. Para obter mais informações, consulte Como trabalhar com AWS IoT SiteWise dados no Guia AWS IoT Analytics do usuário.

   6. Escolha Salvar.

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: file-nameSubstitua 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 amzn-s3-demo-bucket pelo nome do bucket do Amazon S3.

   • prefixSubstitua pelo prefixo do Amazon S3.

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

   • role-nameSubstitua pelo nome da função de acesso do Amazon S3 que permite enviar dados AWS IoT SiteWise 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:::amzn-s3-demo-bucket/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:::amzn-s3-demo-bucket",
                       "arn:aws:s3:::amzn-s3-demo-bucket/*"
                   ]
               }
           ]
       }

     Substitua amzn-s3-demo-bucket pelo nome do bucket do Amazon S3.

   • Se o bucket do Amazon S3 for criptografado usando uma chave KMS gerenciada pelo cliente, a chave KMS deverá ter uma política de acesso com uma função do IAM para operações. kms:Decrypt kms:GenerateDataKey

   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:::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. 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"
     }