컴포넌트 모델 생성 - AWS IoT SiteWise
구성 요소 모델 생성 (AWS CLI)예제 컴포넌트 모델

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

컴포넌트 모델 생성

AWS IoT SiteWise 구성 요소 모델을 사용하여 자산 모델이나 다른 구성 요소 모델에서 참조할 수 있는 하위 어셈블리를 정의합니다. 이렇게 하면 컴포넌트의 정의를 다른 여러 모델에서 재사용하거나 동일한 모델 내에서 여러 번 재사용할 수 있습니다.

구성 요소 모델을 정의하는 프로세스는 자산 모델을 정의하는 것과 매우 유사합니다. 자산 모델과 마찬가지로 구성 요소 모델에도 이름, 설명 및 자산 속성이 있습니다. 하지만 구성 요소 모델에는 자산 계층 정의를 포함할 수 없습니다. 구성 요소 모델 자체는 자산을 직접 생성하는 데 사용할 수 없기 때문입니다. 또한 구성 요소 모델은 경보를 정의할 수 없습니다.

예를 들어 모터 온도, 엔코더 온도 및 절연 저항 속성을 사용하여 서보 모터의 부품을 정의할 수 있습니다. 그런 다음 CNC 기계와 같이 서보 모터가 포함된 장비에 대한 자산 모델을 정의할 수 있습니다.

참고

  • 가장 낮은 수준의 노드부터 시작해서 조직을 모델링하는 것이 좋습니다. 예를 들어, CNC 기계의 자산 모델을 생성하기 전에 서보 모터 컴포넌트를 생성하십시오. 자산 모델에는 기존 부품 모델에 대한 참조가 포함됩니다.

  • 구성 요소 모델에서 직접 에셋을 만들 수는 없습니다. 구성 요소를 사용하는 에셋을 만들려면 에셋에 대한 에셋 모델을 만들어야 합니다. 그런 다음 구성 요소를 참조하는 사용자 지정 복합 모델을 만듭니다. 자산 모델을 만드는 방법에 대한 자세한 자산 모델 생성 내용은 사용자 지정 복합 모델 만들기에 대한 자세한 내용은 을 참조하십시오사용자 지정 복합 모델 (구성 요소) 생성.

다음 섹션에서는 를 사용하여 구성 요소 모델을 만드는 AWS IoT SiteWise API 방법을 설명합니다.

구성 요소 모델 생성 (AWS CLI)

AWS Command Line Interface (AWS CLI) 를 사용하여 구성 요소 모델을 만들 수 있습니다.

CreateAssetModel작업을 사용하여 속성이 있는 구성 요소 모델을 만들 수 있습니다. 이 작업에는 다음과 같은 구조의 페이로드가 필요합니다.

{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}
구성 요소 모델을 만들려면 ()AWS CLI

  1. 라는 component-model-payload.json 파일을 만든 다음 다음 JSON 객체를 파일에 복사합니다.

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

  ]
}

  2. 선호하는 JSON 텍스트 편집기를 사용하여 다음과 같은 component-model-payload.json 파일을 편집하십시오.

    1. 컴포넌트 모델의 이름 (assetModelName) 을 입력합니다 (예: Servo Motor 또는)Servo Motor Model. 이 이름은 계정의 모든 자산 모델 및 구성 요소 모델에서 고유해야 AWS 리전합니다.

    2. (선택 사항) 구성 요소 모델의 외부 ID (assetModelExternalId) 를 입력합니다. 사용자 정의 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서의 외부 객체를 포함하는 참조 객체 IDs를 참조하십시오.

    3. (선택 사항) 자산 모델에 대한 설명(assetModelDescription)을 입력하거나 assetModelDescription 키-값 페어를 제거합니다.

    4. (선택 사항) 구성 요소 모델의 자산 속성 (assetModelProperties) 을 정의합니다. 자세한 내용은 데이터 속성을 정의합니다. 단원을 참조하십시오.

    5. (선택 사항) 자산 모델에 대한 태그(tags)를 추가합니다. 자세한 내용은 AWS IoT SiteWise 리소스에 태그 지정 단원을 참조하십시오.

  3. 다음 명령을 실행하여 JSON 파일의 정의에서 부품 모델을 생성합니다.

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

    이 작업은 자산 모델이나 다른 구성 요소 모델의 구성 요소 모델에 대한 참조를 추가할 때 참조하는 내용이 포함된 응답을 반환합니다. assetModelId 응답에는 모델의 상태(assetModelStatus.state)도 포함됩니다. 상태는 처음에 CREATING입니다. 구성 요소 모델의 상태는 변경 내용이 CREATING 전파될 때까지입니다.

    참고

    복잡한 모델의 경우 구성 요소 모델 생성 프로세스에 최대 몇 분이 걸릴 수 있습니다. 컴포넌트 모델의 현재 상태를 확인하려면 를 지정하여 DescribeAssetModel작업을 사용하십시오assetModelId. 구성 요소 모델 상태가 되면 ACTIVE 자산 모델이나 다른 구성 요소 모델에서 구성 요소 모델에 대한 참조를 추가할 수 있습니다. 자세한 내용은 자산 및 모델 상태 단원을 참조하십시오.

  4. (선택 사항) 구성 요소 모델을 위한 사용자 지정 복합 모델을 생성합니다. 사용자 지정 복합 모델을 사용하면 모델 내에서 속성을 그룹화하거나 다른 부품 모델을 참조하여 서브어셈블리를 포함시킬 수 있습니다. 자세한 내용은 사용자 지정 복합 모델 (구성 요소) 생성 단원을 참조하십시오.

예제 컴포넌트 모델

이 섹션에는 AWS CLI 및 를 사용하여 구성 요소 모델을 생성하는 데 사용할 수 있는 예제 구성 요소 모델 정의가 포함되어 AWS IoT SiteWise SDKs 있습니다. 이 컴포넌트 모델은 CNC 기계와 같은 다른 장비에 사용할 수 있는 서보 모터를 나타냅니다.

서보 모터 컴포넌트 모델

다음 부품 모델은 CNC 기계와 같은 장비 내에서 사용할 수 있는 서보 모터를 나타냅니다. 서보 모터는 온도 및 전기 저항과 같은 다양한 측정값을 제공합니다. 이러한 측정값은 서보 모터 부품 모델을 참조하는 자산 모델에서 생성된 자산의 속성으로 사용할 수 있습니다.

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