Atualizar modelos compostos personalizados (componentes) - AWS IoT SiteWise
Atualizar um componente (console)Atualizar um modelo composto personalizado ()AWS CLI

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Atualizar modelos compostos personalizados (componentes)

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

Atualizar 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:

  8. Escolha Salvar.

Atualizar um modelo composto personalizado ()AWS CLI

Use o AWS Command Line Interface (AWS CLI) para atualizar um modelo composto personalizado.

Para atualizar o nome ou a descrição, use a UpdateAssetModelCompositeModeloperação. 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. Substituir composite-model-id com o ID ou o ID externo do modelo composto personalizado a ser atualizado e asset-model-id com o modelo de ativo ao qual o modelo composto personalizado está associado. Para obter mais informações, consulte o Guia do usuário do AWS IoT SiteWise .

    1. Execute o comando abaixo:

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

    2. O comando acima retorna a definição do modelo composto correspondente à versão mais recente do modelo associado. Para um caso de uso em que um modelo de ativo esteja em um FAILED estado, recupere a definição de modelo válida correspondente à sua versão ativa para criar sua solicitação de atualização. Para mais detalhes, consulte Versões do modelo de ativos.

    3. Execute o comando a seguir para recuperar a definição do modelo ativo:

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

    4. Para obter mais informações, consulte a DescribeAssetModelCompositeModeloperação.

  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 JSON objetoupdate-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. Substituir composite-model-id com o ID do modelo composto e asset-model-id com o ID do modelo de ativo em que 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
Importante

Quando vários usuários atualizam um modelo de ativo ao mesmo tempo, as alterações de um usuário podem ser inadvertidamente substituídas por outro usuário. Para evitar isso, você deve definir uma solicitação de atualização condicional. Consulte Bloqueio otimista para gravações de modelos de ativos.