Atualização de modelos compostos personalizados (componentes)

Você pode usar a AWS IoT SiteWise API para atualizar um modelo composto personalizado ou o AWS IoT SiteWise console para atualizar componentes.

Atualizando um componente (console)

Você pode usar o AWS IoT SiteWise console para atualizar um componente.

Para atualizar um componente (console)

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

2. No painel de navegação, selecione Modelos.

3. Escolha o modelo de ativo em que o componente está.

4. Na guia Propriedades, escolha Componentes.

5. Escolha o componente que você deseja atualizar.

6. Selecione a opção Editar.

7. Na página Editar componente, faça o seguinte:

   • Em Detalhes do modelo, altere o Nome do modelo.

   • Altere qualquer uma das Definições de atributos. Não é possível alterar o Tipo de dados dos atributos existentes. Para ter mais informações, consulte Definindo dados estáticos (atributos).

   • Altere qualquer uma das Definições de medição. Não é possível alterar o Tipo de dados das medições existentes. Para ter mais informações, consulte Definindo fluxos de dados do equipamento (medições).

   • Altere qualquer uma das Definições de transformação. Para ter mais informações, consulte Transformando dados (transformações).

   • Altere qualquer uma das Definições de métrica. Não é possível alterar o Intervalo de tempo das métricas existentes. Para ter mais informações, consulte Agregando dados de propriedades e outros ativos (métricas).

8. Escolha Salvar.

Atualizando um modelo composto personalizado ()AWS CLI

Você pode usar o AWS Command Line Interface (AWS CLI) para atualizar um modelo composto personalizado.

Para atualizar o nome ou a descrição, use a operação UpdateAssetModelCompositeModelo. Somente para modelos compostos personalizados em linha, você também pode atualizar as propriedades. Você não pode atualizar as propriedades de um modelo composto component-model-based personalizado, porque o modelo de componente referenciado fornece as propriedades associadas.

Importante

Se você remover uma propriedade de um modelo composto personalizado, AWS IoT SiteWise excluirá todos os dados anteriores dessa propriedade. Você não pode alterar o tipo ou o tipo de dados de uma propriedade existente.

Para substituir uma propriedade de modelo composto existente por uma nova com a mesmaname, faça o seguinte:

1. Envie uma UpdateAssetModelCompositeModel solicitação com toda a propriedade existente removida.

2. Envie uma segunda UpdateAssetModelCompositeModel solicitação que inclua a nova propriedade. A nova propriedade do ativo terá a name mesma que a anterior e AWS IoT SiteWise gerará uma nova propriedade exclusivaid.

Para atualizar um modelo composto personalizado ()AWS CLI

1. Para recuperar a definição do modelo composto existente, execute o comando a seguir. Substitua composite-model-id pelo ID ou ID externo do modelo composto personalizado a ser atualizado e asset-model-id pelo modelo de ativo ao qual o modelo composto personalizado está associado. Para obter mais informações, consulte AWS IoT SiteWise no Manual do Usuário do .

   aws iotsitewise describe-asset-model-composite-model \
   --asset-model-composite-model-id composite-model-id \
   --asset-model-id asset-model-id

   Para obter mais informações, consulte a operação do DescribeAssetModelCompositemodelo.

2. Crie um arquivo chamado eupdate-custom-composite-model.json, em seguida, copie a resposta do comando anterior para o arquivo.

3. Remova todos os pares de valores-chave do objeto JSON, update-custom-composite-model.json exceto nos seguintes campos:

   • assetModelCompositeModelName

   • assetModelCompositeModelDescription(se presente)

   • assetModelCompositeModelProperties(se presente)

4. Em update-custom-composite-model.json proceda de uma das seguintes maneiras:

   • Altere o valor deassetModelCompositeModelName.

   • AdicioneassetModelCompositeModelDescription, remova ou altere seu valor.

   • Somente para modelos compostos personalizados em linha: altere, adicione ou remova qualquer uma das propriedades do modelo de ativo em. assetModelCompositeModelProperties

   Para obter mais informações sobre o formato necessário para esse arquivo, consulte a sintaxe da solicitação para UpdateAssetModelCompositeModel.

5. Execute o comando a seguir para atualizar o modelo composto personalizado com a definição armazenada emupdate-custom-composite-model.json. Substitua composite-model-id pelo ID do modelo composto e asset-model-id pelo ID do modelo de ativo em que ele está.

   aws iotsitewise update-asset-model-composite-model \
   --asset-model-composite-model-id composite-model-id \
   --asset-model-id asset-model-id \
   --cli-input-json file://update-custom-composite-model.json