翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) オペレーションを使用して、データをアップロードしてください。このオペレーションを使用すると、一度に複数のデータエントリをアップロードできるため、複数のデバイスからデータを収集して、1 つのリクエストですべてを送信できます。

**重要**  
[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) オペレーションには以下のクォータが適用されます。  
1 リクエストあたりの[エントリ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html#API_BatchPutAssetPropertyValue_RequestSyntax)数: 最大 10。
1 エントリあたりの[プロパティ値](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html#iotsitewise-Type-PutAssetPropertyValueEntry-propertyValues) (TQV データポイント) 数: 最大 10。
AWS IoT SiteWise は、7 日以上前または 10 分以上先のタイムスタンプを持つデータを拒否します。
 これらのクォータの詳細については、*[API Reference AWS IoT SiteWise ]* (APIリファレンス) の[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) を参照してください。

アセットプロパティを特定するには、次のいずれかを指定します。
+ データが送信されるアセットプロパティの `assetId` と `propertyId`。
+ データストリームのエイリアスである `propertyAlias` (例えば、`/company/windfarm/3/turbine/7/temperature`)。このオプションを使用するには、最初にアセットプロパティのエイリアスを設定する必要があります。プロパティのエイリアスを設定するには、「[のデータストリームを管理する AWS IoT SiteWise](manage-data-streams.md)」を参照してください。

次の例は、JSON ファイルに格納されているペイロードから風力タービンの温度と 1 分あたりの回転数 (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 エポック時刻 (秒単位) を含む構造。`timeInSeconds`時間的に正確なデータがある場合は、 `timestamp`構造で `offsetInNanos`キーを設定することもできます。 は、過去 7 日以上前、または 10 分以上前のタイムスタンプを持つデータポイント AWS IoT SiteWise を拒否します。
+ `quality` -(オプション) 次の品質の文字列のいずれか。
  + `GOOD` - (デフォルト) データはいずれの問題による影響も受けません。
  + `BAD` - データはセンサーの障害などの問題による影響を受けます。
  + `UNCERTAIN` - データはセンサーの不正確さなどの問題による影響を受けます。

  が計算でデータ品質 AWS IoT SiteWise を処理する方法の詳細については、[「数式におけるデータ品質](expression-tutorials.md#data-quality)」を参照してください。