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á.
# Crie modelos de ativos em AWS IoT SiteWise
AWS IoT SiteWise modelos de ativos impulsionam a padronização de seus dados industriais. Um modelo de ativo contém um nome, uma descrição, propriedades do ativo e definições da hierarquia de ativos. Por exemplo, você pode definir um modelo de turbina eólica com temperatura, rotações por minuto (RPM) e propriedades de energia. Depois, você define um modelo de parque eólico com uma propriedade de saída de energia útil e uma definição de hierarquia de turbinas eólicas.
**nota**
Recomendamos modelar sua operação começando com os nós de nível mais baixo. Por exemplo, crie seu modelo de turbina eólica antes de criar seu modelo de parque eólico. As definições de hierarquia de ativos contêm referências a modelos de ativos existentes. Com essa abordagem, você pode definir hierarquias de ativos conforme cria seus modelos.
Os modelos de ativo não podem conter outros modelos de ativo. Se você precisar definir um modelo ao qual possa fazer referência como um subconjunto dentro de outro modelo, crie um modelo de componente em vez disso. Para obter mais informações, consulte [Criar modelos de componente](create-component-models.md).
As seções a seguir descrevem como usar o AWS IoT SiteWise console ou a API para criar modelos de ativos. As seções a seguir também descrevem os diferentes tipos de propriedades e hierarquias de ativos que você pode usar para criar modelos.
**Topics**
+ [Criar um modelo de ativo (console)](#create-asset-model-console)
+ [Criar um modelo de ativo (AWS CLI)](#create-asset-model-cli)
+ [Exemplos de modelos de ativos](#asset-model-examples)
+ [Definir hierarquias de modelos de ativo](define-asset-hierarchies.md)
## Criar um modelo de ativo (console)
Você pode usar o AWS IoT SiteWise console para criar um modelo de ativo. O AWS IoT SiteWise console fornece vários recursos, como preenchimento automático de fórmulas, que podem ajudá-lo a definir modelos de ativos válidos.
**Como criar um modelo de ativo (console)**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. No painel de navegação, selecione **Modelos**.
1. Escolha **Criar modelo de ativo**.
1. Na página **Criar modelo**, faça o seguinte:
1. Insira um **Nome** para o modelo de ativo, como **Wind Turbine** ou **Wind Turbine Model**. Esse nome deve ser exclusivo em todos os modelos de sua conta nesta região.
1. (Opcional) Adicione um **ID externo** para o modelo. É um ID definido pelo usuário. Consulte mais informações em [Objetos de referência com objetos externos IDs](object-ids.md#external-id-references) no *Guia de Usuário AWS IoT SiteWise *.
1. (Opcional) Adicione **Definições de medição** ao modelo. As medições representam fluxos de dados do seu equipamento. Para obter mais informações, consulte [Definir fluxos de dados de equipamentos (medições)](measurements.md).
1. (Opcional) Adicione **Definições de transformação** ao modelo. As transformações são fórmulas que mapeiam dados de um formulário para outro. Para obter mais informações, consulte [Transformar dados (transformações)](transforms.md).
1. (Opcional) Adicione **Definições de métrica** ao modelo. Métricas são fórmulas que agregam dados em intervalos de tempo. As métricas podem inserir dados de entrada de ativos associados, para que você possa calcular valores que representem sua operação ou um subconjunto de sua operação. Para obter mais informações, consulte [Agregar dados de propriedades e outros ativos (métricas)](metrics.md).
1. (Opcional) Adicione **Definições de hierarquia** ao modelo. Hierarquias são relacionamentos entre ativos. Para obter mais informações, consulte [Definir hierarquias de modelos de ativo](define-asset-hierarchies.md).
1. (Opcional) Adicione tags ao modelo de ativo. Para obter mais informações, consulte [Marque seus AWS IoT SiteWise recursos](tag-resources.md).
1. Escolha **Criar modelo**.
Quando você cria um modelo de ativo, o AWS IoT SiteWise console navega até a página do novo modelo. Nessa página, você pode ver o **Status** do modelo que, inicialmente, é **CRIANDO**. Essa página é atualizada automaticamente, para que você possa aguardar a atualização do status do modelo.
**nota**
O processo de criação do modelo de ativo pode levar alguns minutos para modelos complexos. Depois que o status do modelo de ativo for **ATIVADO**, você poderá usá-lo para criar ativos. Para obter mais informações, consulte [Estados de ativos e modelos](asset-and-model-states.md).
1. (Opcional) Depois de criar seu modelo de ativo, você pode configurá-lo para a borda. Para obter mais informações sobre o SiteWise Edge, consulte[Configure os recursos de borda no AWS IoT SiteWise Edge](edge-data-collection-and-processing.md).
1. Na página do modelo, escolha **Configurar para Edge**.
**nota**
O recurso de pacote de processamento de dados (DPP) não está mais disponível para novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para ter mais informações, consulte [Data processing pack availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
1. Na página de configuração do modelo, escolha a configuração de borda para seu modelo. Isso controla onde é AWS IoT SiteWise possível calcular e armazenar propriedades associadas a esse modelo de ativo. Para obter mais informações sobre como configurar seu modelo para a borda, consulte [Configurar uma fonte OPC UA no SiteWise Edge](configure-opcua-source.md).
1. Para **Configuração de borda personalizada**, escolha o local que você deseja AWS IoT SiteWise calcular e armazenar cada uma das propriedades do seu modelo de ativo.
**nota**
As transformações e métricas associadas devem ser configuradas para o mesmo local. Para obter mais informações sobre como configurar seu modelo para a borda, consulte [Configurar uma fonte OPC UA no SiteWise Edge](configure-opcua-source.md).
1. Escolha **Salvar**. Na página do modelo, sua **configuração do Edge** agora deve estar **Configurada**.
## Criar um modelo de ativo (AWS CLI)
Você pode usar o AWS Command Line Interface (AWS CLI) para criar um modelo de ativo.
Use a operação [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) para criar um modelo de ativo com propriedades e hierarquias. Essa operação espera uma carga útil com a seguinte estrutura.
```
{
"assetModelType": "ASSET_MODEL",
"assetModelName": "String",
"assetModelDescription": "String",
"assetModelProperties": Array of AssetModelProperty,
"assetModelHierarchies": Array of AssetModelHierarchyDefinition
}
```
**Como criar um modelo de ativo (AWS CLI)**
1. Crie um arquivo chamado `asset-model-payload.json` e copie o objeto JSON a seguir no arquivo.
```
{
"assetModelType": "ASSET_MODEL",
"assetModelName": "",
"assetModelDescription": "",
"assetModelProperties": [
],
"assetModelHierarchies": [
],
"assetModelCompositeModels": [
]
}
```
1. Use seu editor de texto JSON preferido para editar o arquivo `asset-model-payload.json` para o seguinte:
1. Insira um nome (`assetModelName`) para o modelo de ativo, como **Wind Turbine** ou **Wind Turbine Model**. Esse nome deve ser exclusivo entre todos os modelos de ativo e modelos de componente da conta nessa Região da AWS.
1. (Opcional) Insira um ID externo (`assetModelExternalId`) para o modelo de ativo. É um ID definido pelo usuário. Consulte mais informações em [Objetos de referência com objetos externos IDs](object-ids.md#external-id-references) no *Guia de Usuário AWS IoT SiteWise *.
1. (Opcional) Insira uma descrição (`assetModelDescription`) para o modelo de ativo ou remova o par de chave-valor `assetModelDescription`.
1. (Opcional) Defina as propriedades do ativo (`assetModelProperties`) para o modelo. Para obter mais informações, consulte [Definir propriedades de dados](asset-properties.md).
1. (Opcional) Defina hierarquias de ativos (`assetModelHierarchies`) para o modelo. Para obter mais informações, consulte [Definir hierarquias de modelos de ativo](define-asset-hierarchies.md).
1. (Opcional) Defina alarmes para o modelo. Os alarmes monitoram outras propriedades para que você possa identificar quando equipamentos ou processos requerem atenção. Cada definição de alarme é um modelo composto (`assetModelCompositeModels`) que padroniza o conjunto de propriedades usado pelo alarme. Para obter mais informações, consulte [Monitore dados com alarmes em AWS IoT SiteWise](industrial-alarms.md) e [Defina alarmes em modelos de ativos em AWS IoT SiteWise](define-alarms.md).
1. (Opcional) Adicione tags (`tags`) ao modelo de ativo. Para obter mais informações, consulte [Marque seus AWS IoT SiteWise recursos](tag-resources.md).
1. Execute o seguinte comando para criar um modelo de ativo usando a definição no arquivo JSON.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
A operação retorna uma resposta que contém o `assetModelId` ao qual você faz referência ao criar um ativo. A resposta também contém o estado do modelo (`assetModelStatus.state`) que, inicialmente, é `CREATING`. O status do modelo de ativo é `CREATING` até que as alterações sejam propagadas.
**nota**
O processo de criação do modelo de ativo pode levar alguns minutos para modelos complexos. Para verificar o status atual do seu modelo de ativo, use a [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operação especificando o. `assetModelId` Depois que o status do modelo de ativo for `ACTIVE`, você poderá usá-lo para criar ativos. Para obter mais informações, consulte [Estados de ativos e modelos](asset-and-model-states.md).
1. (Opcional) Crie modelos compostos personalizados para o modelo de ativo. Com modelos compostos personalizados, você pode agrupar propriedades dentro do modelo ou incluir um subconjunto ao fazer referência a um modelo de componente. Para obter mais informações, consulte [Criar modelos compostos personalizados (componentes)](create-custom-composite-models.md).
## Exemplos de modelos de ativos
Esta seção contém exemplos de definições de modelos de ativos que você pode usar para criar modelos de ativos com AWS CLI AWS IoT SiteWise SDKs e. Esses modelos de ativos representam uma turbina eólica e um parque eólico. Os ativos da turbina eólica ingerem dados brutos do sensor e calculam valores como potência e velocidade média do vento. Os ativos do parque eólico calculam valores como a potência total de todas as turbinas eólicas do parque eólico.
**Topics**
+ [Modelo de ativo de turbina eólica](#example-wind-turbine)
+ [Modelo de ativo de parque eólico](#example-wind-farm)
### Modelo de ativo de turbina eólica
O modelo de ativo a seguir representa uma turbina em um parque eólico. A turbina eólica ingere dados do sensor para calcular valores como potência e velocidade média do vento.
**nota**
Este modelo de exemplo se assemelha ao modelo de turbina eólica da AWS IoT SiteWise demonstração. Para obter mais informações, consulte [Use a AWS IoT SiteWise demonstração](getting-started-demo.md).
```
{
"assetModelType": "ASSET_MODEL",
"assetModelName": "Wind Turbine Asset Model",
"assetModelDescription": "Represents a turbine in a wind farm.",
"assetModelProperties": [
{
"name": "Location",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Renton"
}
}
},
{
"name": "Make",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Amazon"
}
}
},
{
"name": "Model",
"dataType": "INTEGER",
"type": {
"attribute": {
"defaultValue": "500"
}
}
},
{
"name": "Torque (KiloNewton Meter)",
"dataType": "DOUBLE",
"unit": "kNm",
"type": {
"measurement": {}
}
},
{
"name": "Wind Direction",
"dataType": "DOUBLE",
"unit": "Degrees",
"type": {
"measurement": {}
}
},
{
"name": "RotationsPerMinute",
"dataType": "DOUBLE",
"unit": "RPM",
"type": {
"measurement": {}
}
},
{
"name": "Wind Speed",
"dataType": "DOUBLE",
"unit": "m/s",
"type": {
"measurement": {}
}
},
{
"name": "RotationsPerSecond",
"dataType": "DOUBLE",
"unit": "RPS",
"type": {
"transform": {
"expression": "rpm / 60",
"variables": [
{
"name": "rpm",
"value": {
"propertyId": "RotationsPerMinute"
}
}
]
}
}
},
{
"name": "Overdrive State",
"dataType": "DOUBLE",
"type": {
"transform": {
"expression": "gte(torque, 3)",
"variables": [
{
"name": "torque",
"value": {
"propertyId": "Torque (KiloNewton Meter)"
}
}
]
}
}
},
{
"name": "Average Power",
"dataType": "DOUBLE",
"unit": "Watts",
"type": {
"metric": {
"expression": "avg(torque) * avg(rps) * 2 * 3.14",
"variables": [
{
"name": "torque",
"value": {
"propertyId": "Torque (Newton Meter)"
}
},
{
"name": "rps",
"value": {
"propertyId": "RotationsPerSecond"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
},
{
"name": "Average Wind Speed",
"dataType": "DOUBLE",
"unit": "m/s",
"type": {
"metric": {
"expression": "avg(windspeed)",
"variables": [
{
"name": "windspeed",
"value": {
"propertyId": "Wind Speed"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
},
{
"name": "Torque (Newton Meter)",
"dataType": "DOUBLE",
"unit": "Nm",
"type": {
"transform": {
"expression": "knm * 1000",
"variables": [
{
"name": "knm",
"value": {
"propertyId": "Torque (KiloNewton Meter)"
}
}
]
}
}
},
{
"name": "Overdrive State Time",
"dataType": "DOUBLE",
"unit": "Seconds",
"type": {
"metric": {
"expression": "statetime(overdrive_state)",
"variables": [
{
"name": "overdrive_state",
"value": {
"propertyId": "Overdrive State"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
}
],
"assetModelHierarchies": []
}
```
### Modelo de ativo de parque eólico
O modelo de ativo a seguir representa um parque eólico que é composto por várias turbinas eólicas. Esse modelo de ativos define uma [hierarquia](define-asset-hierarchies.md) para o modelo de turbina eólica. Isso permite que o parque eólico calcule valores (como potência média) com base nos dados de todas as turbinas eólicas no parque.
**nota**
Esse modelo de exemplo se assemelha ao modelo de parque eólico da AWS IoT SiteWise demonstração. Para obter mais informações, consulte [Use a AWS IoT SiteWise demonstração](getting-started-demo.md).
Esse modelo de ativo depende do [Modelo de ativo de turbina eólica](#example-wind-turbine). Substitua os valores de `childAssetModelId` e `propertyId` por aqueles de um modelo de ativo de turbina eólica existente.
```
{
"assetModelName": "Wind Farm Asset Model",
"assetModelDescription": "Represents a wind farm.",
"assetModelProperties": [
{
"name": "Code",
"dataType": "INTEGER",
"type": {
"attribute": {
"defaultValue": "300"
}
}
},
{
"name": "Location",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Renton"
}
}
},
{
"name": "Reliability Manager",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Mary Major"
}
}
},
{
"name": "Total Overdrive State Time",
"dataType": "DOUBLE",
"unit": "seconds",
"type": {
"metric": {
"expression": "sum(overdrive_state_time)",
"variables": [
{
"name": "overdrive_state_time",
"value": {
"propertyId": "ID of Overdrive State Time property in Wind Turbine Asset Model",
"hierarchyId": "Turbine Asset Model"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
},
{
"name": "Total Average Power",
"dataType": "DOUBLE",
"unit": "Watts",
"type": {
"metric": {
"expression": "sum(turbine_avg_power)",
"variables": [
{
"name": "turbine_avg_power",
"value": {
"propertyId": "ID of Average Power property in Wind Turbine Asset Model",
"hierarchyId": "Turbine Asset Model"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
}
],
"assetModelHierarchies": [
{
"name": "Turbine Asset Model",
"childAssetModelId": "ID of Wind Turbine Asset Model"
}
]
}
```
# Definir hierarquias de modelos de ativo
Você pode definir hierarquias de modelos de ativos para criar associações lógicas entre os modelos de ativos em sua operação industrial. Por exemplo, você pode definir um parque eólico composto de parques eólicos terrestres e de deslocamento. Um parque eólico terrestre contém uma turbina e uma localização em terra. Um parque eólico offshore contém uma turbina e uma localização em deslocamento.
![\[AWS IoT SiteWise hierarquias de parques eólicos entre modelos de ativos.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/asset-model-hierarchies.png)
Quando um modelo de ativo filho é associado a um modelo de ativo pai por meio de uma hierarquia, as métricas modelo do ativo pai podem receber dados de entrada das métricas do modelo do ativo filho. Você pode usar hierarquias e métricas de modelo de ativos para calcular estatísticas que forneçam informações sobre sua operação ou sobre um subconjunto da operação. Para obter mais informações, consulte [Agregar dados de propriedades e outros ativos (métricas)](metrics.md).
Cada hierarquia define uma relação entre um modelo de ativo pai (e um modelo de ativo filho. Em um modelo de ativo pai, você pode definir várias hierarquias para o mesmo modelo de ativo filho. Por exemplo, se você tiver dois tipos diferentes de turbinas em seus parques eólicos, onde todas as turbinas eólicas forem representadas pelo mesmo modelo de ativo, você poderá definir uma hierarquia para cada tipo. Em seguida, você pode definir métricas no modelo de parque eólico para calcular estatísticas independentes e combinadas para cada tipo de turbina eólica.
Um modelo de ativo pai pode ser associado a vários modelos de ativos filho. Por exemplo, se você tem um parque eólico terrestre e um parque eólico remoto representados por dois modelos de ativos diferentes, você pode associar esses modelos de ativos ao mesmo modelo de ativo pai do parque eólico.
Um modelo de ativo filho pode ser associado a vários modelos de ativos filho. Por exemplo, se você tiver dois tipos diferentes de parques eólicos, onde todas as turbinas eólicas são representadas pelo mesmo modelo de ativo, você pode associar o modelo de ativo de turbina eólica a diferentes modelos de ativos de parques eólicos.
**nota**
Quando você define uma hierarquia de modelo de ativos, o modelo de ativo filho deve ser `ACTIVE` ou ter uma versão `ACTIVE` anterior. Para obter mais informações, consulte [Estados de ativos e modelos](asset-and-model-states.md).
Depois de definir modelos de ativos hierárquicos e criar ativos, você pode associar os ativos para concluir o relacionamento pai-filho. Para obter mais informações, consulte [Crie ativos para modelos de ativos em AWS IoT SiteWise](create-assets.md) e [Associar e desassociar ativos](add-associated-assets.md).
**Topics**
+ [Definir hierarquias de modelos de ativo (console)](#define-asset-hierarchies-console)
+ [Definir hierarquias de ativos (AWS CLI)](#define-asset-hierarchies-cli)
## Definir hierarquias de modelos de ativo (console)
Ao definir uma hierarquia para um modelo de ativo no AWS IoT SiteWise console, você especifica os seguintes parâmetros:
+ **Nome da hierarquia** — nome da hierarquia, como **Wind Turbines**.
+ **Modelo de hierarquia** — modelo de ativo filho.
+ **ID externo da hierarquia** (opcional): é um ID definido pelo usuário. Consulte mais informações em [Objetos de referência com objetos externos IDs](object-ids.md#external-id-references) no *Guia de Usuário AWS IoT SiteWise *.
Para obter mais informações, consulte [Criar um modelo de ativo (console)](create-asset-models.md#create-asset-model-console).
## Definir hierarquias de ativos (AWS CLI)
Ao definir uma hierarquia para um modelo de ativo com a AWS IoT SiteWise API, você especifica os seguintes parâmetros:
+ `name` — nome da hierarquia, como **Wind Turbines**.
+ `childAssetModelId`: o ID ou o ID externo do modelo de ativo filho para a hierarquia. Você pode usar a [ListAssetModels](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssetModels.html)operação para encontrar a ID de um modelo de ativo existente.
**Example Exemplo de definição de hierarquia**
O exemplo a seguir demonstra uma hierarquia de ativos que representa o relacionamento de um parque eólico com as turbinas eólicas. Esse objeto é um exemplo de um [AssetModelHierarchy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelHierarchy.html). Para obter mais informações, consulte [Criar um modelo de ativo (AWS CLI)](create-asset-models.md#create-asset-model-cli).
```
{
...
"assetModelHierarchies": [
{
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
},
]
}
```