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

# BatchPutAssetPropertyValue API
<a name="ingest-api-batch-putasset"></a>

[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) 작업을 사용하여 데이터를 업로드할 수 있습니다. 이 작업을 사용하면 한 번에 여러 데이터 항목을 업로드할 수 있으므로, 여러 디바이스에서 데이터를 수집하여 단일 요청으로 모두 전송할 수 있습니다.

**중요**  
[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) 작업에는 다음 할당량이 적용됩니다.  
요청당 최대 10개 [항목](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html#API_BatchPutAssetPropertyValue_RequestSyntax).
항목당 최대 10개의 [속성 값](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html#iotsitewise-Type-PutAssetPropertyValueEntry-propertyValues)(TQV 데이터 포인트).
AWS IoT SiteWise 는 과거 7일 이상 또는 향후 10분 이상으로 날짜가 지정된 타임스탬프가 있는 모든 데이터를 거부합니다.
 이러한 할당량에 대한 자세한 내용은 *AWS IoT SiteWise API 참조*의 [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)를 참조하세요.

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

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

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

의 예제 페이로드에는 다음과 같은 콘텐츠`batch-put-payload.json`가 있습니다.

```
{
  "enablePartialEntryProcessing": true,      
  "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": "unique entry ID",
      "propertyAlias": "/company/windfarm/3/turbine/7/rpm",
      "propertyValues": [
        {
  "value": {
  "nullValue":{"valueType": "D"}
          },
          "timestamp": {
  "timeInSeconds": 1575691200
          },
          "quality": "BAD"
        }
      ]
    }
  ]
}
```

`enablePartialEntryProcessing` 로 지정하면 실패를 초래하지 않는 모든 값을 `true` 수집할 수 있습니다. 기본값은 `false`입니다. 값이 유효하지 않으면 전체 항목이 수집에 실패합니다.

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

`propertyValues` 목록에서 각 구조는 `value`, `timestamp` 및(`quality`선택 사항)를 포함하는 TQV(타임스탬프-품질-값) 구조입니다.
+ `value` - 설정되는 속성 유형에 따라 다음 필드 중 하나를 포함하는 구조입니다.
  + `booleanValue`
  + `doubleValue`
  + `integerValue`
  + `stringValue`
  + `nullValue`
+ `nullValue` - 값이 Null이고 품질이 `BAD` 또는 인 속성 값의 유형을 나타내는 다음 필드가 있는 구조입니다`UNCERTAIN`.
  + `valueType` - {"B", "D", "S", "I"}의 열거형
+ `timestamp` - 현재 Unix Epoch 시간(초) `timeInSeconds`를 포함하는 구조입니다. 시간적으로 정확한 데이터가 있는 경우 `timestamp` 구조에서 `offsetInNanos` 키를 설정할 수도 있습니다.는 타임스탬프가 과거 7일 이상 지난 데이터 포인트 또는 향후 10분 이상 지난 데이터 포인트를 AWS IoT SiteWise 거부합니다.
+ `quality` – (선택 사항) 다음 품질 문자열 중 하나입니다.
  + `GOOD` – (기본값) 데이터가 어떤 문제의 영향도 받지 않습니다.
  + `BAD` – 데이터가 센서 고장과 같은 문제의 영향을 받습니다.
  + `UNCERTAIN` – 데이터가 센서 부정확과 같은 문제의 영향을 받습니다.

  가 계산에서 데이터 품질을 AWS IoT SiteWise 처리하는 방법에 대한 자세한 내용은 [공식 표현식의 데이터 품질을 참조하세요](expression-tutorials.md#data-quality).