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

# 에서 과거 자산 속성 값 쿼리 AWS IoT SiteWise
<a name="historical-values"></a>

 AWS IoT SiteWise API [GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html) 작업을 사용하여 자산 속성의 기록 값을 쿼리할 수 있습니다.

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

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

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

1. 다음 명령을 실행하여 자산 속성에 대한 값 기록을 가져옵니다. 이 명령은 특정한 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}}"
   }
   ```

1. 값 항목이 더 있는 경우, `nextToken` 필드의 페이지 매김 토큰을 [GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html)에 대한 후속 직접 호출에 전달할 수 있습니다.