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)
<a name="update-custom-composite-models"></a>

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

**Topics**
+ [Atualizar um componente (console)](#update-custom-composite-model-console)
+ [Atualizar um modelo composto personalizado (AWS CLI)](#update-custom-composite-model-cli)

## Atualizar um componente (console)
<a name="update-custom-composite-model-console"></a>

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

**Como atualizar um componente (console)**

1. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-models"></a>No painel de navegação, selecione **Modelos**.

1. Escolha o modelo de ativo no qual o componente está.

1. Na guia **Propriedades**, escolha **Componentes**.

1. Selecione o componente que você deseja atualizar.

1. Escolha **Editar**.

1. Na página **Editar componente**, faça uma das seguintes ações:
   + 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 obter mais informações, consulte [Definir dados estáticos (atributos)](attributes.md).
   + Altere qualquer uma das **Definições de medição**. Não é possível alterar o **Tipo de dados** das medições existentes. Para obter mais informações, consulte [Definir fluxos de dados de equipamentos (medições)](measurements.md).
   + Altere qualquer uma das **Definições de transformação**. Para obter mais informações, consulte [Transformar dados (transformações)](transforms.md).
   + Altere qualquer uma das **Definições de métrica**. Não é possível alterar o **Intervalo de tempo** das métricas existentes. Para obter mais informações, consulte [Agregar dados de propriedades e outros ativos (métricas)](metrics.md).

1. Escolha **Salvar**.

## Atualizar um modelo composto personalizado (AWS CLI)
<a name="update-custom-composite-model-cli"></a>

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

Para atualizar o nome ou a descrição, use a [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html)operaçã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. Não é possível alterar o tipo de uma propriedade existente ou o respectivo tipo de dado.  
Para substituir uma propriedade de modelo composto existente por uma nova com o mesmo `name`, faça o seguinte:  
Envie uma solicitação `UpdateAssetModelCompositeModel` com toda a propriedade existente removida.
Envie uma segunda solicitação `UpdateAssetModelCompositeModel` 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 exclusiva`id`.

**Como atualizar um modelo composto personalizado (AWS CLI)**

1. Para recuperar a definição do modelo composto existente, execute o comando a seguir. {{composite-model-id}}Substitua pela ID ou pela ID externa 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 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}}
      ```

   1.  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 está em um estado `FAILED`, recupere a definição de modelo válida correspondente à versão ativa para criar a solicitação de atualização. Para mais detalhes, consulte [Versões do modelo de ativo](model-active-version.md). 

   1. Execute o seguinte comando para recuperar a definição de modelo válida:

      ```
      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
      ```

   1. Para obter mais informações, consulte a operação [DescribeAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelCompositeModel.html).

1. Crie um arquivo chamado `update-custom-composite-model.json`, depois copie a resposta do comando anterior para o arquivo.

1. Remova todos os pares de chave/valor do objeto JSON em `update-custom-composite-model.json`, exceto os seguintes campos:
   + `assetModelCompositeModelName`
   + `assetModelCompositeModelDescription` (se presente)
   + `assetModelCompositeModelProperties` (se presente)

1. Em `update-custom-composite-model.json` proceda de uma das seguintes maneiras:
   + Altere o valor de `assetModelCompositeModelName`.
   + Adicione ou remova `assetModelCompositeModelDescription`, ou altere o 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](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html).

1. Execute o comando a seguir para atualizar o modelo composto personalizado com a definição armazenada em `update-custom-composite-model.json`. {{composite-model-id}}Substitua 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
   ```

**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. Para evitar isso, defina uma solicitação de atualização condicional. Consulte [Bloqueio positivo para gravações do modelo de ativo](opt-locking-for-model.md).