API를 사용한 데이터 수집 AWS IoT SiteWise - AWS IoT SiteWise

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

API를 사용한 데이터 수집 AWS IoT SiteWise

AWS IoT SiteWise API를 사용하여 타임스탬프가 찍힌 산업 데이터를 자산의 속성 및 측정 속성으로 전송할 수 있습니다. API는 timestamp-quality-value (TQV) 구조가 포함된 페이로드를 받아들입니다.

BatchPutAssetPropertyValue작업을 사용하여 데이터를 업로드할 수 있습니다. 이 작업을 통해 한 번에 여러 데이터 항목을 업로드하여 여러 장치에서 데이터를 수집한 다음 단일 요청으로 모두 전송할 수 있습니다.

중요

BatchPutAssetPropertyValue작업에는 다음과 같은 할당량이 적용됩니다.

  • 요청당 최대 10개 항목.

  • 항목당 최대 10개의 속성 값(TQV 데이터 포인트).

  • AWS IoT SiteWise 는 타임스탬프가 과거 7일 이상 또는 미래 10분을 초과한 모든 데이터를 거부합니다.

이러한 할당량에 대한 자세한 내용은 API 참조를 참조하십시오 BatchPutAssetPropertyValue.AWS IoT SiteWise

자산 자산을 식별하려면 다음 중 하나를 지정하십시오.

  • 데이터가 전송되는 자산 propertyId 자산의 소유자. assetId

  • 데이터 스트림 별칭(예: /company/windfarm/3/turbine/7/temperature)인 propertyAlias. 이 옵션을 사용하려면 먼저 자산 속성의 별칭을 설정해야 합니다. 속성 별칭을 설정하려면 을 참조하십시오산업 데이터 스트림을 자산 속성에 매핑.

다음 예제는 JSON 파일에 저장된 페이로드로부터 풍력 터빈의 온도와 분당 회전 수(RPM) 판독값을 전송하는 방법을 보여줍니다.

aws iotsitewise batch-put-asset-property-value --cli-input-json file://batch-put-payload.json

batch-put-payload.json의 예제 페이로드에는 다음 내용이 포함되어 있습니다.

{ "entries": [ { "entryId": "unique entry ID", "propertyAlias": "/company/windfarm/3/turbine/7/temperature", "propertyValues": [ { "value": { "integerValue": 38 }, "timestamp": { "timeInSeconds": 1575691200 } } ] }, { "entryId": "unique entry ID", "propertyAlias": "/company/windfarm/3/turbine/7/rpm", "propertyValues": [ { "value": { "doubleValue": 15.09 }, "timestamp": { "timeInSeconds": 1575691200 }, "quality": "GOOD" } ] } ] }

페이로드의 각 항목은 고유한 문자열로 정의할 수 있는 entryId를 포함합니다. 요청 항목이 실패하면 각 오류에 해당 요청의 entryId가 포함되므로 다시 시도할 요청을 알 수 있습니다.

목록의 각 구조체는 a valuetimestamp, a 및 선택적으로 a를 포함하는 timestamp-quality-value (TQV) propertyValues 구조체입니다. quality

  • value - 설정되는 속성 유형에 따라 다음 필드 중 하나를 포함하는 구조입니다.

    • booleanValue

    • doubleValue

    • integerValue

    • stringValue

  • timestamp - 현재 Unix Epoch 시간(초) timeInSeconds를 포함하는 구조입니다. 시간적으로 정확한 데이터가 있는 경우 timestamp 구조에서 offsetInNanos 키를 설정할 수도 있습니다. AWS IoT SiteWise 과거 7일보다 오래된 타임스탬프 또는 향후 10분 이후의 타임스탬프가 있는 모든 데이터 포인트를 거부합니다.

  • quality – (선택 사항) 다음 품질 문자열 중 하나입니다.

    • GOOD – (기본값) 데이터가 어떤 문제의 영향도 받지 않습니다.

    • BAD – 데이터가 센서 고장과 같은 문제의 영향을 받습니다.

    • UNCERTAIN – 데이터가 센서 부정확과 같은 문제의 영향을 받습니다.

    계산에서 데이터 품질을 AWS IoT SiteWise 처리하는 방법에 대한 자세한 내용은 수식 표현식의 데이터 품질을 참조하십시오.