Cree modelos de componentes - AWS IoT SiteWise
Crear un modelo de componentes (AWS CLI)Ejemplo de modelo de componentes

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cree modelos de componentes

Utilice modelos de AWS IoT SiteWise componentes para definir subconjuntos a los que pueda hacer referencia desde modelos de activos u otros modelos de componentes. De esta forma, puede reutilizar la definición del componente en varios modelos diferentes o varias veces dentro del mismo modelo.

El proceso de definición de un modelo de componentes es muy similar a la definición de un modelo de activos. Al igual que un modelo de activos, un modelo de componentes tiene un nombre, una descripción y propiedades de activos. Sin embargo, los modelos de componentes no pueden incluir definiciones de jerarquías de activos, ya que los modelos de componentes en sí mismos no se pueden utilizar para crear activos directamente. Los modelos de componentes tampoco pueden definir las alarmas.

Por ejemplo, puede definir un componente para un servomotor con las propiedades de temperatura del motor, temperatura del codificador y resistencia de aislamiento. A continuación, puede definir un modelo de activos para los equipos que contienen servomotores, como una máquina. CNC

nota

  • Le recomendamos que modele su operación comenzando con los nodos de nivel más bajo. Por ejemplo, cree el componente del servomotor antes de crear el modelo de activos de la CNC máquina. Los modelos de activos contienen referencias a los modelos de componentes existentes.

  • No puede crear un activo directamente a partir de un modelo de componentes. Para crear un activo que utilice su componente, debe crear un modelo de activo para su activo. A continuación, debe crear un modelo compuesto personalizado para él que haga referencia a su componente. Para obtener más información sobre la creación de modelos de activos, consulte Cree modelos de activos Para obtener más información sobre la creación de modelos compuestos personalizados, consulteCree modelos compuestos personalizados (componentes).

En las siguientes secciones se describe cómo utilizarlos AWS IoT SiteWise API para crear modelos de componentes.

Crear un modelo de componentes (AWS CLI)

Puede utilizar AWS Command Line Interface (AWS CLI) para crear un modelo de componentes.

Utilice la CreateAssetModeloperación para crear un modelo de componentes con propiedades. Esta operación espera una carga útil con la siguiente estructura:

{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}
Para crear un modelo de componentes ()AWS CLI

  1. Cree un archivo llamado component-model-payload.json y, a continuación, copie el siguiente JSON objeto en el archivo:

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

  ]
}

  2. Utilice el editor de JSON texto que prefiera para editar el component-model-payload.json archivo para lo siguiente:

    1. Introduzca un nombre (assetModelName) para el modelo del componente, como Servo Motor oServo Motor Model. Este nombre debe ser único en todos los modelos de activos y modelos de componentes de su cuenta en esta Región de AWS.

    2. (Opcional) Introduzca un identificador externo (assetModelExternalId) para el modelo del componente. Se trata de un ID definido por el usuario. Para obtener más información, consulte Haga referencia a objetos con objetos externos IDs en la Guía del usuario de AWS IoT SiteWise .

    3. (Opcional) Escriba una descripción (assetModelDescription) para el modelo de activos o elimine el par de clave-valor assetModelDescription.

    4. (Opcional) Defina las propiedades de los activos (assetModelProperties) para el modelo de componentes. Para obtener más información, consulte Defina las propiedades de los datos.

    5. (Opcional) Agregue etiquetas (tags) para el modelo de activos. Para obtener más información, consulte Etiquete sus AWS IoT SiteWise recursos.

  3. Ejecute el siguiente comando para crear un modelo de componentes a partir de la definición del JSON archivo.

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

    La operación devuelve una respuesta que contiene la respuesta a la assetModelId que hace referencia al añadir una referencia al modelo de componentes en un modelo de activos o en otro modelo de componentes. La respuesta también contiene el estado del modelo (assetModelStatus.state), que es inicialmente CREATING. El estado del modelo de componentes es CREATING hasta que se propaguen los cambios.

    nota

    El proceso de creación del modelo de componentes puede tardar unos minutos en el caso de modelos complejos. Para comprobar el estado actual del modelo de componentes, utilice la DescribeAssetModeloperación especificando elassetModelId. Una vez que el estado del modelo de componentes seaACTIVE, puede añadir referencias a su modelo de componentes en modelos de activos u otros modelos de componentes. Para obtener más información, consulte Estados de activos y modelos.

  4. (Opcional) Cree modelos compuestos personalizados para su modelo de componente. Con los modelos compuestos personalizados, puede agrupar propiedades dentro del modelo o incluir un subensamblaje haciendo referencia a otro modelo de componente. Para obtener más información, consulte Cree modelos compuestos personalizados (componentes).

Ejemplo de modelo de componentes

Esta sección contiene un ejemplo de definición de modelo de componentes que puede utilizar para crear un modelo de componentes con AWS CLI y AWS IoT SiteWise SDKs. Este modelo de componentes representa un servomotor que se puede utilizar en otro equipo, como una CNC máquina.

Modelo de componentes de servomotor

El siguiente modelo de componentes representa un servomotor que se puede utilizar en equipos como CNC máquinas. El servomotor proporciona diversas medidas, como la temperatura y la resistencia eléctrica. Estas medidas están disponibles como propiedades en los activos creados a partir de modelos de activos que hacen referencia al modelo de componentes del 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"
        }
    ]
}