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á.
Ingira dados usando o AWS IoT SiteWise API
Use o AWS IoT SiteWise API para enviar dados industriais com data e hora às propriedades de atributo e medição de seus ativos. O API aceita uma carga útil que contém estruturas timestamp-quality-value (TQV).
Use a BatchPutAssetPropertyValueoperação para carregar seus dados. Com essa operação, você pode carregar várias entradas de dados ao mesmo tempo para coletar dados de vários dispositivos e enviar tudo em uma única solicitação.
Importante
A BatchPutAssetPropertyValueoperação está sujeita às seguintes cotas:
Até 10 entradas por solicitação.
Até 10 valores de propriedade (pontos TQV de dados) 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 BatchPutAssetPropertyValuena AWS IoT SiteWise APIReferência.
Para identificar uma propriedade do ativo, especifique uma das seguintes opções:
-
O
assetId
fimpropertyId
da propriedade do 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 propriedades, consulteMapeie fluxos de dados industriais para propriedades de ativos.
O exemplo a seguir demonstra como enviar as leituras de temperatura e rotações por minuto (RPM) de uma turbina eólica de uma carga armazenada em um arquivo. JSON
aws iotsitewise batch-put-asset-property-value --cli-input-json file://batch-put-payload.json
O exemplo de carga no batch-put-payload.json
contém o conteúdo a seguir.
{ "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" } ] } ] }
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 avalue
, a etimestamp
, opcionalmente, a. quality
-
value
– uma estrutura contendo um dos valores a seguir, a depender do tipo de propriedade sendo definida:-
booleanValue
-
doubleValue
-
integerValue
-
stringValue
-
-
timestamp
– uma estrutura que contém o horário epoch Unix atual em segundostimeInSeconds
. Você também pode definir aoffsetInNanos
chave natimestamp
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.
-