에서 과거 자산 속성 값 쿼리 AWS IoT SiteWise

PDF

RSS

포커스 모드

에서 과거 자산 속성 값 쿼리 AWS IoT SiteWise - AWS IoT SiteWise

AWS IoT SiteWise API GetAssetPropertyValueHistory 작업을 사용하여 자산 속성의 기록 값을 쿼리할 수 있습니다.

자산 속성을 식별하려면 다음 중 하나를 지정합니다.

데이터를 보낼 자산 속성의 assetId 및 propertyId
데이터 스트림 별칭(예: /company/windfarm/3/turbine/7/temperature)인 propertyAlias. 이 옵션을 사용하려면 먼저 자산 속성의 별칭을 설정해야 합니다. 속성 별칭을 설정하려면 에 대한 데이터 스트림 관리 AWS IoT SiteWise 섹션을 참조하세요.

다음 파라미터를 전달하여 결과를 구체화할 수도 있습니다.

startDate – Unix Epoch 시간(초)으로 표시되며 과거 데이터를 쿼리하기 시작할 범위의 시작(제외)입니다.
endDate – Unix Epoch 시간(초)으로 표시되며 과거 데이터를 쿼리하기 시작할 범위의 끝(포함)입니다.
maxResults – 하나의 요청에서 반환할 최대 결과 수입니다. 기본값은 20개의 결과입니다.
nextToken – 이 작업의 이전 호출에서 반환된 페이지 매김 토큰입니다.
timeOrdering – 반환된 값에 적용할 정렬은 ASCENDING 또는 DESCENDING 입니다.
qualities – 결과 필터링 기준이 되는 품질은 GOOD, BAD, 또는 UNCERTAIN입니다.

자산 속성에 대한 값 기록을 쿼리하려면(AWS CLI) 다음을 수행하세요.

다음 명령을 실행하여 자산 속성에 대한 값 기록을 가져옵니다. 이 명령은 특정한 10분 간격 동안 속성의 기록을 쿼리합니다. asset-id를 자산의 ID로 바꾸고 property-id를 속성의 ID로 바꿉니다. 날짜 매개 변수를 쿼리할 간격으로 바꿉니다.


aws iotsitewise get-asset-property-value-history \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575216600

이 작업은 다음 형식으로 속성의 기록 TQV를 포함하는 응답을 반환합니다.


{
  "assetPropertyValueHistory": [
    {
      "value": {
        "booleanValue": Boolean,
        "doubleValue": Number,
        "integerValue": Number,
        "stringValue": "String",
        "nullValue": {
            "valueType": "String"
        }
      },
      "timestamp": {
        "timeInSeconds": Number,
        "offsetInNanos": Number
      },
      "quality": "String"
    }
  ],
  "nextToken": "String"
}