Operações em massa com ativos e modelos

Para trabalhar com um grande número de ativos ou modelos de ativos, use operações em massa para importar e exportar recursos em massa para um local diferente. Por exemplo, você pode criar um arquivo de dados que define ativos ou modelos de ativos em um bucket do Amazon S3 e usar a importação em massa para criá-los ou atualizá-los. AWS IoT SiteWise Como alternativa, se você tiver um grande número de ativos ou modelos de ativos AWS IoT SiteWise, poderá exportá-los para o Amazon S3.

nota

Você executa operações em massa AWS IoT SiteWise chamando operações no AWS IoT TwinMaker API. Você pode fazer isso sem configurar AWS IoT TwinMaker ou criar um AWS IoT TwinMaker espaço de trabalho. Tudo o que você precisa é de um bucket Amazon S3 onde você possa colocar seu AWS IoT SiteWise conteúdo.

Tópicos

• Principais conceitos e terminologia
• Funções compatíveis
• Pré-requisitos de operação em massa
• Executar um trabalho de importação em massa
• Executar um trabalho de exportação em massa
• Rastreamento do progresso de trabalhos e tratamento de erros
• Exemplos de importação de metadados
• Exemplos de exportação de metadados
• AWS IoT SiteWise esquema de trabalho de transferência de metadados

Principais conceitos e terminologia

AWS IoT SiteWise Os recursos de importação e exportação em massa dependem dos seguintes conceitos e terminologia:

• Importação: a ação de mover ativos ou modelos de ativos de um arquivo em um bucket do Amazon S3 para o. AWS IoT SiteWise

• Exportação: a ação de mover ativos ou modelos de ativos AWS IoT SiteWise para um bucket do Amazon S3.

• Fonte: o local inicial de onde você deseja mover o conteúdo.

  Por exemplo, um bucket do Amazon S3 é uma fonte de importação e AWS IoT SiteWise uma fonte de exportação.

• Destino: o local desejado para onde você deseja mover seu conteúdo.

  Por exemplo, um bucket do Amazon S3 é um destino de exportação e AWS IoT SiteWise um destino de importação.

• AWS IoT SiteWise Esquema: Esse esquema é usado para importar e exportar metadados do. AWS IoT SiteWise

• Recurso de nível superior: um AWS IoT SiteWise recurso que você pode criar ou atualizar individualmente, como um ativo ou modelo de ativo.

• Sub-recurso: um recurso aninhado em um AWS IoT SiteWise recurso de nível superior. Os exemplos incluem propriedades, hierarquias e modelos compostos.

• Metadados: informações importantes necessárias para importar ou exportar recursos com sucesso. Exemplos de metadados são definições de ativos e modelos de ativos.

• metadataTransferJob: o objeto criado quando você executaCreateMetadataTransferJob.

Funções compatíveis

Este tópico explica o que você pode fazer ao executar uma operação em massa. As operações em massa oferecem suporte às seguintes funcionalidades:

• Criação de recursos de nível superior: quando você importa um ativo ou modelo de ativo que não define um ID ou cujo ID não corresponde ao de um existente, ele será criado como um novo recurso.

• Substituição de recursos de nível superior: quando você importa um ativo ou modelo de ativo cuja ID corresponde a uma que já existe, ele substitui o recurso existente.

• Criação, substituição ou exclusão de sub-recursos: quando sua importação substitui um recurso de nível superior, como um ativo ou modelo de ativo, a nova definição substitui todos os sub-recursos, como propriedades, hierarquias ou modelos compostos.

  Por exemplo, se você atualizar um modelo de ativo durante uma importação em massa e a versão atualizada definir uma propriedade que não estava presente no original, uma nova propriedade será criada. Se definir uma propriedade que já existe, a propriedade existente será atualizada. Se o modelo de ativo atualizado omitir uma propriedade que estava presente no original, a propriedade será excluída.

• Sem exclusão de recursos de nível superior: operações em massa não excluem um ativo ou modelo de ativo. As operações em massa apenas as criam ou atualizam.