Definir as configurações de armazenamento

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 Hot tier, faça o seguinte:

   • Se você quiser definir um período de retenção de quanto tempo seus dados serão armazenados no nível ativo antes de serem excluídos e movidos para o armazenamento de nível quente gerenciado pelo serviço, escolha Ativar 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 de nível quente, faça o seguinte:

   • Para optar pelo armazenamento em camada quente, selecione Confirmo a opção de armazenamento em camada quente para optar pelo armazenamento em camada quente.

   • (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ê opta pelo nível quente, a configuração é exibida apenas uma vez.

   • Para definir a retenção do nível quente, você deve ter armazenamento no nível quente 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 quente, você deve ter armazenamento no nível frio.

7. Escolha Salvar para salvar suas 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. Substituir file-name com o 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

  • Substituir bucket-name com o nome do seu bucket do Amazon S3.

  • Substituir prefix com seu prefixo Amazon S3.

  • Substituir aws-account-id com o ID AWS da sua conta.

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

  • Substituir hot-tier-retention-in-days com um número inteiro maior ou igual a 30 dias.

  • Substituir warm-tier-retention-in-days com 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:::bucket-name/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 IAM função 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 de bucket do Amazon S3 para a localização do bucket S3 que você usou na etapa anterior e na sua política. 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/*"
                        ]
                    }
                ]
            }

          Substituir bucket-name com o nome do seu bucket Amazon S3.

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

   4. Para configurar o hot tier, consulte a Etapa 5 emDefina as configurações de armazenamento para o nível quente (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: Substituir file-name com o 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

   • Substituir bucket-name com o nome do seu bucket do Amazon S3.

   • Substituir prefix com seu prefixo Amazon S3.

   • Substituir aws-account-id com o ID AWS da sua conta.

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

   • Substituir retention-in-days com 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 e IAM na AWS IoT SiteWise política de armazenamento.

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

     Substituir bucket-name com o nome do seu bucket Amazon S3.

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

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