As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Use a operação [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) para fazer upload dos seus dados. Com essa operação, você pode fazer upload de várias entradas de dados de uma só vez para coletar dados de vários dispositivos e enviar tudo em uma única solicitação.

**Importante**  
A [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)operação está sujeita às seguintes cotas:   
Até 10 [entradas](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html#API_BatchPutAssetPropertyValue_RequestSyntax) por solicitação.
Até 10 [valores de propriedade](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html#iotsitewise-Type-PutAssetPropertyValueEntry-propertyValues) (pontos de dados TQV) por entrada. 
AWS IoT SiteWise rejeita quaisquer dados com um timestamp datado de mais de 7 dias no passado ou mais de 10 minutos no futuro.
 Para obter mais informações sobre essas cotas, consulte [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) na *Referência de API do AWS IoT SiteWise *.

Para identificar uma propriedade de ativo, especifique uma das seguintes opções:
+ O `assetId` e `propertyId` da propriedade de ativo para a qual os dados são enviados.
+ O `propertyAlias`, que é um alias de fluxo de dados (por exemplo, `/company/windfarm/3/turbine/7/temperature`). Para usar esta opção, primeiro você deve definir o apelido da propriedade do seu ativo. Para definir aliases de propriedade, consulte [Gerencie fluxos de dados para AWS IoT SiteWise](manage-data-streams.md).

O exemplo a seguir demonstra como enviar leituras de temperatura e rotações por minuto (RPM) de uma turbina eólica a partir de uma carga útil armazenada em um arquivo JSON.

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

O exemplo de carga útil em `batch-put-payload.json` tem o seguinte conteúdo.

```
{
  "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"
        }
      ]
    }
  ]
}
```

Especificar `enablePartialEntryProcessing` como `true` permite a ingestão de todos os valores que não resultam em falha. O comportamento padrão é `false`. Se um valor for inválido, a entrada inteira falhará na ingestão.

Cada entrada na carga contém um `entryId` que você pode definir como qualquer string exclusiva. Se qualquer entrada de solicitação falhar, cada erro conterá o `entryId` da solicitação correspondente, para que você saiba quais solicitações tentar novamente.

Cada estrutura na lista de `propertyValues` é uma estrutura timestamp-quality-value (TQV) que contém a, a e`value`, `timestamp` opcionalmente, a. `quality`
+ `value` – uma estrutura contendo um dos valores a seguir, a depender do tipo de propriedade sendo definida:
  + `booleanValue`
  + `doubleValue`
  + `integerValue`
  + `stringValue`
  + `nullValue`
+ `nullValue`— Uma estrutura com o campo a seguir indicando o tipo do valor da propriedade com valor Nulo e qualidade de `BAD` ou. `UNCERTAIN`
  + `valueType`— Enumeração de {"B”, “D”, “S”, “I"}
+ `timestamp` – uma estrutura que contém o horário epoch Unix atual em segundos `timeInSeconds`. Você também pode definir a `offsetInNanos` chave na `timestamp` estrutura se tiver dados temporalmente precisos. AWS IoT SiteWise rejeita quaisquer pontos de dados com carimbos de data e hora anteriores a 7 dias ou mais recentes que 10 minutos no futuro.
+ `quality` – (opcional) uma das seguintes strings de qualidade:
  + `GOOD` – (padrão) os dados não são afetados por nenhum problema.
  + `BAD` – os dados são afetados por um problema, como a falha do sensor.
  + `UNCERTAIN` – os dados são afetados por um problema, como a imprecisão do sensor.

  Para obter mais informações sobre como AWS IoT SiteWise lidar com a qualidade de dados em cálculos, consulte [Qualidade de dados em expressões de fórmulas](expression-tutorials.md#data-quality).