Executando um trabalho de exportação em massa

A exportação em massa é a ação de mover metadados de um AWS IoT SiteWise espaço de trabalho para um bucket do Amazon S3.

Ao realizar uma exportação em massa do seu AWS IoT SiteWise conteúdo para o Amazon S3, você pode especificar filtros para limitar quais modelos de ativos e ativos específicos você gostaria de exportar.

Os filtros devem ser especificados em uma iotSiteWiseConfiguration seção dentro da seção de fontes da sua solicitação JSON.

nota

Você pode incluir vários filtros em sua solicitação. A operação em massa exportará modelos de ativos e ativos que correspondam a qualquer um dos filtros.

Se você não fornecer nenhum filtro, a operação em massa exportará todos os seus modelos e ativos de ativos.

exemplo corpo da solicitação com filtros

{
      "metadataTransferJobId": "your-transfer-job-id",
      "sources": [
       {
        "type": "iotsitewise",
        "iotSiteWiseConfiguration": {
          "filters": [
           {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID"
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeAssets": true
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeOffspring": true
               }
             }
           ]
          }
        }
       ],
       "destination": {
          "type": "s3",
          "s3Configuration": {
            "location": "arn:aws:s3:::your-S3-bucket-location"
          }
      }
}

Exportar metadados (console)

O procedimento a seguir explica a ação de exportação do console:

Crie um trabalho de exportação no Console do AWS IoT SiteWise

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

2. Escolha Operações em massa Novas no painel de navegação.

3. Escolha Nova exportação para iniciar o processo de exportação.

4. Na página Exportar metadados:

   • Insira um nome para o trabalho de exportação. Esse é o nome usado para o arquivo exportado em seu bucket do Amazon S3.

   • Escolha seus recursos para exportar, o que define os filtros para o trabalho:

     • Exporte todos os ativos e modelos de ativos. Use filtros em ativos e modelos de ativos.

     • Exportar ativos. Filtre seus ativos.

       • Selecione o ativo a ser usado para o filtro de exportação.

       • (Opcional) Adicione a descendência ou o modelo de ativo associado.

     • Exporte modelos de ativos. Filtre seus modelos de ativos.

       • Selecione o modelo de ativo a ser usado para o filtro de exportação.

       • (Opcional) Adicione a prole, o ativo associado ou ambos.

     • Escolha Próximo.

   • Navegue até o bucket do Amazon S3:

     • Escolha Navegar no Amazon S3 para visualizar o bucket e os arquivos do Amazon S3.

     • Navegue até o bucket do Amazon S3 onde o arquivo deve ser colocado.

     • Escolha Próximo.

   • Revise o trabalho de exportação e escolha Exportar.

5. A página Operações em massa em SiteWise metadados do Console do AWS IoT SiteWise exibe o trabalho de importação recém-criado na tabela de progresso dos trabalhos.

Para conhecer as diferentes formas de usar filtros ao exportar metadados, consulte. Exemplos de exportação de metadados

Exportar metadados ()AWS CLI

O procedimento a seguir explica a ação de AWS CLI exportação:

Exportar dados AWS IoT SiteWise para o Amazon S3

1. Crie um arquivo JSON com o corpo da solicitação. O corpo da solicitação especifica a origem e o destino da tarefa de transferência. O exemplo a seguir mostra um exemplo de corpo de solicitação:

   
   {
       "metadataTransferJobId": "your-transfer-job-Id",
       "sources": [{
           "type": "iotsitewise"
       }],
       "destination": {
           "type": "s3",
           "s3Configuration": {
               "location": "arn:aws:s3:::your-S3-bucket-location"
           }
       }
   }

   Certifique-se de especificar seu bucket do Amazon S3 como o destino do trabalho de transferência de metadados.

   nota

   Este exemplo exportará todos os seus modelos e ativos de ativos. Para limitar a exportação a modelos de ativos ou ativos específicos, você pode incluir filtros no corpo da solicitação. Para obter mais informações sobre a aplicação de filtros de exportação, consulteExemplos de exportação de metadados.

2. Salve o arquivo do corpo da solicitação para usar na próxima etapa. Neste exemplo, o nome do arquivo é createMetadataTransferJobExport.json.

3. Invoque o CreateMetadataTransferJob executando o seguinte AWS CLI comando:

   
   aws iottwinmaker create-metadata-transfer-job --region us-east-1 \ 
            --cli-input-json file://createMetadataTransferJobExport.json
   

   Substitua o arquivo createMetadataTransferJobExport.json JSON de entrada pelo nome do seu próprio arquivo de transferência.