Crea modelli di componenti - AWS IoT SiteWise
Creare un modello di componente (AWS CLI)Esempio di modello di componente

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea modelli di componenti

Utilizzate i modelli di AWS IoT SiteWise componenti per definire sottoassiemi a cui potete fare riferimento dai modelli di asset o da altri modelli di componenti. In questo modo, è possibile riutilizzare la definizione del componente su più altri modelli o più volte all'interno dello stesso modello.

Il processo di definizione di un modello di componente è molto simile alla definizione di un modello di asset. Analogamente a un modello di asset, un modello di componente ha un nome, una descrizione e proprietà di asset. Tuttavia, i modelli di componenti non possono includere definizioni della gerarchia degli asset, poiché i modelli di componenti stessi non possono essere utilizzati per creare risorse direttamente. Inoltre, i modelli di componenti non possono definire allarmi.

Ad esempio, è possibile definire un componente per un servomotore con proprietà di temperatura del motore, temperatura dell'encoder e resistenza di isolamento. Quindi, potete definire un modello di asset per apparecchiature che contengono servomotori, come una macchina. CNC

Nota

  • Si consiglia di modellare l'operazione partendo dai nodi di livello inferiore. Ad esempio, create il componente del servomotore prima di creare il modello di asset della CNC macchina. I modelli di asset contengono riferimenti a modelli di componenti esistenti.

  • Non è possibile creare una risorsa direttamente da un modello di componente. Per creare una risorsa che utilizza il componente, è necessario creare un modello di risorsa per la risorsa. Quindi, create un modello composito personalizzato che faccia riferimento al componente. Per ulteriori informazioni sulla creazione di modelli di asset, consulta Creazione di modelli di asset Per ulteriori informazioni sulla creazione di modelli compositi personalizzati, consultaCrea modelli compositi personalizzati (componenti).

Le sezioni seguenti descrivono come utilizzare AWS IoT SiteWise API per creare modelli di componenti.

Creare un modello di componente (AWS CLI)

È possibile utilizzare AWS Command Line Interface (AWS CLI) per creare un modello di componente.

Utilizzate l'CreateAssetModeloperazione per creare un modello di componente con proprietà. Questa operazione prevede un payload con la seguente struttura:

{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}
Per creare un modello di componente ()AWS CLI

  1. Create un file chiamato component-model-payload.json e poi copiate il seguente JSON oggetto nel file:

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

  ]
}

  2. Utilizzate il vostro editor di JSON testo preferito per modificare il component-model-payload.json file per quanto segue:

    1. Immettete un nome (assetModelName) per il modello del componente, ad esempio Servo Motor oServo Motor Model. In questo caso, questo nome deve essere univoco per tutti i modelli di asset e i modelli di componenti del tuo account Regione AWS.

    2. (Facoltativo) Inserite un ID esterno (assetModelExternalId) per il modello del componente. Si tratta di un ID definito dall'utente. Per ulteriori informazioni, consulta Oggetti di riferimento con oggetti esterni IDs nella Guida per l'utente di AWS IoT SiteWise .

    3. (Facoltativo) Immetti una descrizione (assetModelDescription) per il modello di asset o rimuovi la coppia chiave-valore assetModelDescription.

    4. (Facoltativo) Definite le proprietà degli asset (assetModelProperties) per il modello del componente. Per ulteriori informazioni, consulta Definite le proprietà dei dati.

    5. (Facoltativo) Aggiungi i tag (tags) per il modello di asset. Per ulteriori informazioni, consulta Etichetta le tue AWS IoT SiteWise risorse.

  3. Eseguite il comando seguente per creare un modello di componente dalla definizione contenuta nel JSON file.

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

    L'operazione restituisce una risposta che contiene il assetModelId riferimento a cui si fa riferimento quando si aggiunge un riferimento al modello di componente in un modello di asset o in un altro modello di componente. La risposta contiene anche lo stato del modello (assetModelStatus.state) che inizialmente è CREATING. Lo stato del modello di componente è valido CREATING fino alla propagazione delle modifiche.

    Nota

    Il processo di creazione del modello di componente può richiedere fino a qualche minuto per i modelli complessi. Per verificare lo stato corrente del modello di componente, utilizzate l'DescribeAssetModeloperazione specificando ilassetModelId. Una volta raggiunto lo stato del modello di componenteACTIVE, potete aggiungere riferimenti al modello di componente nei modelli di asset o in altri modelli di componenti. Per ulteriori informazioni, consulta Stati di asset e modelli.

  4. (Facoltativo) Create modelli compositi personalizzati per il modello di componente. Con i modelli compositi personalizzati, è possibile raggruppare le proprietà all'interno del modello o includere un sottoassieme facendo riferimento a un altro modello di componente. Per ulteriori informazioni, consulta Crea modelli compositi personalizzati (componenti).

Esempio di modello di componente

Questa sezione contiene un esempio di definizione del modello di componente che è possibile utilizzare per creare un modello di componente con AWS CLI and AWS IoT SiteWise SDKs. Questo modello di componente rappresenta un servomotore che può essere utilizzato all'interno di un'altra apparecchiatura, ad esempio una CNC macchina.

Modello di componente del servomotore

Il seguente modello di componente rappresenta un servomotore che può essere utilizzato all'interno di apparecchiature come CNC macchine. Il servomotore fornisce varie misurazioni, come temperature e resistenza elettrica. Queste misurazioni sono disponibili come proprietà sugli asset creati da modelli di asset che fanno riferimento al modello dei componenti del servomotore.

{
    "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"
        }
    ]
}