Compartilhar via


SensorEvents.GetSensorEventsAsync Método

Definição

Retorna uma lista de dados de eventos de sensor. O período de tempo para consulta é limitado a 90 dias por vez. Retorna os eventos dos últimos 90 dias quando startDateTime e endDateTime não são fornecidos.

public virtual System.Threading.Tasks.Task<Azure.Response> GetSensorEventsAsync (string sensorId, string sensorPartnerId, DateTimeOffset? startDateTime = default, DateTimeOffset? endDateTime = default, bool? excludeDuplicateEvents = default, Azure.RequestContext context = default);
abstract member GetSensorEventsAsync : string * string * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<bool> * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
override this.GetSensorEventsAsync : string * string * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<bool> * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
Public Overridable Function GetSensorEventsAsync (sensorId As String, sensorPartnerId As String, Optional startDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional endDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional excludeDuplicateEvents As Nullable(Of Boolean) = Nothing, Optional context As RequestContext = Nothing) As Task(Of Response)

Parâmetros

sensorId
String

Id do sensor associado.

sensorPartnerId
String

Id do parceiro de sensor associado.

startDateTime
Nullable<DateTimeOffset>

Tempo de início do intervalo de pesquisa de eventos de sensor (inclusivo), formato de exemplo: yyyy-MM-ddTHH:mm:ssZ. Ele será truncado até segundos se a fração for fornecida.

endDateTime
Nullable<DateTimeOffset>

Tempo de término de pesquisa de eventos de sensor (inclusivo), formato de exemplo:yyy-MM-ddTHH:mm:ssZ. Ele será truncado até segundos se a fração for fornecida.

excludeDuplicateEvents
Nullable<Boolean>

Sinalizar para excluir eventos duplicados e usar somente os mais recentes (Padrão: true).

context
RequestContext

O contexto de solicitação, que pode substituir os comportamentos padrão do pipeline do cliente por chamada.

Retornos

A resposta retornada do serviço. Os detalhes do esquema do corpo da resposta estão na seção Comentários abaixo.

Exceções

sensorId ou sensorPartnerId é nulo.

O serviço retornou um código de status sem êxito.

Exemplos

Este exemplo mostra como chamar GetSensorEventsAsync com os parâmetros necessários e analisar o resultado.

var credential = new DefaultAzureCredential();
var client = new FarmBeatsClient(credential).GetSensorEventsClient(<2022-11-01-preview>);

Response response = await client.GetSensorEventsAsync("<sensorId>", "<sensorPartnerId>");

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("value")[0].ToString());

Este exemplo mostra como chamar GetSensorEventsAsync com todos os parâmetros e como analisar o resultado.

var credential = new DefaultAzureCredential();
var client = new FarmBeatsClient(credential).GetSensorEventsClient(<2022-11-01-preview>);

Response response = await client.GetSensorEventsAsync("<sensorId>", "<sensorPartnerId>", DateTimeOffset.UtcNow, DateTimeOffset.UtcNow, true);

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("value")[0].GetProperty("sensorId").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("sensorPartnerId").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("partyId").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("boundaryId").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("eventDateTime").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("ingestionDateTime").ToString());
Console.WriteLine(result.GetProperty("value")[0].GetProperty("measures").GetProperty("<test>").ToString());
Console.WriteLine(result.GetProperty("skipToken").ToString());
Console.WriteLine(result.GetProperty("nextLink").ToString());

Comentários

Abaixo está o esquema JSON para o conteúdo da resposta.

Corpo da resposta:

Esquema para SensorEventListResponse:

{
  value: [
    {
      sensorId: string, # Optional. Id of the sensor.
      sensorPartnerId: string, # Optional. Id of the sensor partner.
      partyId: string, # Optional. Id of the associated party.
      boundaryId: string, # Optional. Id of the associated boundary.
      eventDateTime: string (ISO 8601 Format), # Optional. DateTime of sensor event observation.
      ingestionDateTime: string (ISO 8601 Format), # Optional. DateTime of sensor event ingestion to data store.
      measures: Dictionary<string, any>, # Optional. Sensor measures.
    }
  ], # Required. List of requested objects.
  skipToken: string, # Optional. Token used in retrieving the next page. If null, there are no additional pages.
  nextLink: string, # Optional. Continuation link (absolute URI) to the next page of results in the list.
}

Aplica-se a