Crie modelos de componentes

Use modelos de AWS IoT SiteWise componentes para definir submontagens que você pode referenciar a partir de modelos de ativos ou outros modelos de componentes. Dessa forma, você pode reutilizar a definição do componente em vários outros modelos ou várias vezes no mesmo modelo.

O processo de definição de um modelo de componente é muito semelhante à definição de um modelo de ativo. Assim como um modelo de ativo, um modelo de componente tem nome, descrição e propriedades de ativos. No entanto, os modelos de componentes não podem incluir definições de hierarquia de ativos, pois os modelos de componentes em si não podem ser usados para criar ativos diretamente. Os modelos de componentes também não podem definir alarmes.

Por exemplo, você pode definir um componente para um servomotor com propriedades de temperatura do motor, temperatura do codificador e resistência de isolamento. Em seguida, você pode definir um modelo de ativos para equipamentos que contenham servomotores, como uma CNC máquina.

nota

• Recomendamos modelar sua operação começando com os nós de nível mais baixo. Por exemplo, crie seu componente de servomotor antes de criar o modelo de ativos de sua CNC máquina. Os modelos de ativos contêm referências aos modelos de componentes existentes.

• Você não pode criar um ativo diretamente de um modelo de componente. Para criar um ativo que usa seu componente, você deve criar um modelo de ativo para seu ativo. Em seguida, você cria um modelo composto personalizado para ele que faz referência ao seu componente. Para obter mais informações sobre a criação de modelos de ativos, consulte Crie modelos de ativos Para obter mais informações sobre a criação de modelos compostos personalizados, consulteCrie modelos compostos personalizados (componentes).

As seções a seguir descrevem como usar o AWS IoT SiteWise API para criar modelos de componentes.

Crie um modelo de componente (AWS CLI)

Você pode usar o AWS Command Line Interface (AWS CLI) para criar um modelo de componente.

Use a CreateAssetModeloperação para criar um modelo de componente com propriedades. Essa operação espera uma carga útil com a seguinte estrutura:

{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}

Para criar um modelo de componente (AWS CLI)

1. Crie um arquivo chamado component-model-payload.json e, em seguida, copie o seguinte JSON objeto no arquivo:

   {
     "assetModelType": "COMPONENT_MODEL",
     "assetModelName": "",
     "assetModelDescription": "",
     "assetModelProperties": [
   
     ]
   }

2. Use seu editor de JSON texto preferido para editar o component-model-payload.json arquivo para o seguinte:

   1. Insira um nome (assetModelName) para o modelo do componente, como Servo Motor ouServo Motor Model. Nesse caso, esse nome deve ser exclusivo em todos os modelos de ativos e modelos de componentes da sua conta Região da AWS.

   2. (Opcional) Insira uma ID externa (assetModelExternalId) para o modelo do componente. Esse é um ID definido pelo usuário. Para obter mais informações, consulte Objetos de referência com objetos externos IDs no Guia de Usuário AWS IoT SiteWise .

   3. (Opcional) Insira uma descrição (assetModelDescription) para o modelo de ativo ou remova o par de chave-valor assetModelDescription.

   4. (Opcional) Defina as propriedades do ativo (assetModelProperties) para o modelo do componente. Para obter mais informações, consulte Definir propriedades de dados.

   5. (Opcional) Adicione tags (tags) ao modelo de ativo. Para obter mais informações, consulte Marque seus AWS IoT SiteWise recursos.

3. Execute o comando a seguir para criar um modelo de componente a partir da definição no JSON arquivo.

   aws iotsitewise create-asset-model --cli-input-json file://component-model-payload.json

   A operação retorna uma resposta que contém a assetModelId que você se refere ao adicionar uma referência ao seu modelo de componente em um modelo de ativo ou outro modelo de componente. A resposta também contém o estado do modelo (assetModelStatus.state) que, inicialmente, é CREATING. O status do modelo do componente é CREATING até que as alterações se propaguem.

   nota

   O processo de criação do modelo de componente pode levar alguns minutos para modelos complexos. Para verificar o status atual do seu modelo de componente, use a DescribeAssetModeloperação especificando o. assetModelId Depois que o status do modelo de componente forACTIVE, você poderá adicionar referências ao seu modelo de componente em modelos de ativos ou outros modelos de componentes. Para obter mais informações, consulte Estados de ativos e modelos.

4. (Opcional) Crie modelos compostos personalizados para seu modelo de componente. Com modelos compostos personalizados, você pode agrupar propriedades dentro do modelo ou incluir uma submontagem fazendo referência a outro modelo de componente. Para obter mais informações, consulte Crie modelos compostos personalizados (componentes).

Exemplo de modelo de componente

Esta seção contém um exemplo de definição de modelo de componente que você pode usar para criar um modelo de componente com AWS CLI AWS IoT SiteWise SDKs e. Esse modelo de componente representa um servomotor que pode ser usado em outro equipamento, como uma CNC máquina.

Tópicos

• Modelo de componente de servomotor

Modelo de componente de servomotor

O modelo de componente a seguir representa um servomotor que pode ser usado em equipamentos como CNC máquinas. O servomotor fornece várias medidas, como temperaturas e resistência elétrica. Essas medições estão disponíveis como propriedades em ativos criados a partir de modelos de ativos que fazem referência ao modelo de componentes do servomotor.

{
    "assetModelName": "ServoMotor",
    "assetModelType": "COMPONENT_MODEL",
    "assetModelProperties": [
        {
            "dataType": "DOUBLE",
            "name": "Servo Motor Temperature",
            "type": {
            "measurement": {}
            },
            "unit": "Celsius"
        },
        {
            "dataType": "DOUBLE",
            "name": "Spindle speed",
            "type": {
            "measurement": {}
            },
            "unit": "rpm"
        }
    ]
}