Insights.GetInsightsByPartyIdModelIdAndResourceAsync Método

Referência

Definição

Namespace:: Azure.Verticals.AgriFood.Farming

Assembly:: Azure.Verticals.AgriFood.Farming.dll

Pacote:: Azure.Verticals.AgriFood.Farming v1.0.0-beta.2

Origem:: Insights.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma lista paginada de recursos de insight.

public virtual Azure.AsyncPageable<BinaryData> GetInsightsByPartyIdModelIdAndResourceAsync (string partyId, string modelId, string resourceType, string resourceId, DateTimeOffset? minInsightStartDateTime = default, DateTimeOffset? maxInsightStartDateTime = default, DateTimeOffset? minInsightEndDateTime = default, DateTimeOffset? maxInsightEndDateTime = default, System.Collections.Generic.IEnumerable<string> measurementFilters = default, System.Collections.Generic.IEnumerable<string> ids = default, System.Collections.Generic.IEnumerable<string> names = default, System.Collections.Generic.IEnumerable<string> propertyFilters = default, System.Collections.Generic.IEnumerable<string> statuses = default, DateTimeOffset? minCreatedDateTime = default, DateTimeOffset? maxCreatedDateTime = default, DateTimeOffset? minLastModifiedDateTime = default, DateTimeOffset? maxLastModifiedDateTime = default, int? maxPageSize = default, string skipToken = default, Azure.RequestContext context = default);

abstract member GetInsightsByPartyIdModelIdAndResourceAsync : string * string * string * string * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * seq<string> * seq<string> * seq<string> * seq<string> * seq<string> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<int> * string * Azure.RequestContext -> Azure.AsyncPageable<BinaryData>
override this.GetInsightsByPartyIdModelIdAndResourceAsync : string * string * string * string * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * seq<string> * seq<string> * seq<string> * seq<string> * seq<string> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * Nullable<int> * string * Azure.RequestContext -> Azure.AsyncPageable<BinaryData>

Public Overridable Function GetInsightsByPartyIdModelIdAndResourceAsync (partyId As String, modelId As String, resourceType As String, resourceId As String, Optional minInsightStartDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional maxInsightStartDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional minInsightEndDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional maxInsightEndDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional measurementFilters As IEnumerable(Of String) = Nothing, Optional ids As IEnumerable(Of String) = Nothing, Optional names As IEnumerable(Of String) = Nothing, Optional propertyFilters As IEnumerable(Of String) = Nothing, Optional statuses As IEnumerable(Of String) = Nothing, Optional minCreatedDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional maxCreatedDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional minLastModifiedDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional maxLastModifiedDateTime As Nullable(Of DateTimeOffset) = Nothing, Optional maxPageSize As Nullable(Of Integer) = Nothing, Optional skipToken As String = Nothing, Optional context As RequestContext = Nothing) As AsyncPageable(Of BinaryData)

Parâmetros

partyId: String

ID da parte associada.

modelId: String

ID do modelo associado.

resourceType: String

Tipo de recurso associado ao registro.

resourceId: String

ID do recurso associado.

minInsightStartDateTime: Nullable<DateTimeOffset>

Tempo mínimo de insightStartDateTime dos recursos de insight (inclusivo), formato de exemplo: aaaa-MM-ddTHH:mm:ssZ.

maxInsightStartDateTime: Nullable<DateTimeOffset>

Tempo máximo de insightStartDateTime de recursos de insight (inclusivo), formato de exemplo: aaaa-MM-ddTHH:mm:ssZ.

minInsightEndDateTime: Nullable<DateTimeOffset>

Tempo mínimo de insightEndDateTime dos recursos de insight (inclusivo), formato de exemplo: aaaa-MM-ddTHH:mm:ssZ.

maxInsightEndDateTime: Nullable<DateTimeOffset>

Tempo máximo de insightEndDateTime dos recursos de insight (inclusivo), formato de exemplo: aaaa-MM-ddTHH:mm:ssZ.

measurementFilters: IEnumerable<String>

Filtra os pares measureKey.unit/unitValue ou measureKey.value/value dentro do objeto Measures. ex. "measureKey.unit eq {testValue}" em que testValue é cadeia de caracteres. ex. "measureKey.value eq {testValue}" em que testValue = double.

ids: IEnumerable<String>

IDs do recurso.

names: IEnumerable<String>

Nomes do recurso.

propertyFilters: IEnumerable<String>

Filtra os pares chave-valor dentro do objeto Properties. ex. "{testKey} eq {testValue}".

statuses: IEnumerable<String>

Status do recurso.

minCreatedDateTime: Nullable<DateTimeOffset>

Data mínima de criação do recurso (inclusive).

maxCreatedDateTime: Nullable<DateTimeOffset>

Data máxima de criação do recurso (inclusive).

minLastModifiedDateTime: Nullable<DateTimeOffset>

Data mínima da última modificação do recurso (inclusive).

maxLastModifiedDateTime: Nullable<DateTimeOffset>

Data máxima da última modificação do recurso (inclusive).

maxPageSize: Nullable<Int32>

Número máximo de itens necessários (inclusivo). Mínimo = 10, Máximo = 1000, Valor padrão = 50.

skipToken: String

Ignore o token para obter o próximo conjunto de resultados.

context: RequestContext

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

Retornos

AsyncPageable<BinaryData>

O AsyncPageable<T> do serviço que contém uma lista de BinaryData objetos. Os detalhes do esquema do corpo de cada item na coleção estão na seção Comentários abaixo.

Exceções

ArgumentNullException

partyId, modelId, resourceType ou resourceId é nulo.

ArgumentException

partyIdresourceType, modelIdou resourceId é uma cadeia de caracteres vazia e era esperado que não estivesse vazio.

RequestFailedException

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

Exemplos

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

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

await foreach (var data in client.GetInsightsByPartyIdModelIdAndResourceAsync("<partyId>", "<modelId>", "<resourceType>", "<resourceId>"))
{
    JsonElement result = JsonDocument.Parse(data.ToStream()).RootElement;
    Console.WriteLine(result.ToString());
}

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

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

await foreach (var data in client.GetInsightsByPartyIdModelIdAndResourceAsync("<partyId>", "<modelId>", "<resourceType>", "<resourceId>", DateTimeOffset.UtcNow, DateTimeOffset.UtcNow, DateTimeOffset.UtcNow, DateTimeOffset.UtcNow, new String[]{"<measurementFilters>"}, new String[]{"<ids>"}, new String[]{"<names>"}, new String[]{"<propertyFilters>"}, new String[]{"<statuses>"}, DateTimeOffset.UtcNow, DateTimeOffset.UtcNow, DateTimeOffset.UtcNow, DateTimeOffset.UtcNow, 1234, "<skipToken>"))
{
    JsonElement result = JsonDocument.Parse(data.ToStream()).RootElement;
    Console.WriteLine(result.GetProperty("partyId").ToString());
    Console.WriteLine(result.GetProperty("modelId").ToString());
    Console.WriteLine(result.GetProperty("resourceType").ToString());
    Console.WriteLine(result.GetProperty("resourceId").ToString());
    Console.WriteLine(result.GetProperty("modelVersion").ToString());
    Console.WriteLine(result.GetProperty("attachmentsLink").ToString());
    Console.WriteLine(result.GetProperty("insightStartDateTime").ToString());
    Console.WriteLine(result.GetProperty("insightEndDateTime").ToString());
    Console.WriteLine(result.GetProperty("measurements").GetProperty("<test>").GetProperty("unit").ToString());
    Console.WriteLine(result.GetProperty("measurements").GetProperty("<test>").GetProperty("value").ToString());
    Console.WriteLine(result.GetProperty("id").ToString());
    Console.WriteLine(result.GetProperty("status").ToString());
    Console.WriteLine(result.GetProperty("createdDateTime").ToString());
    Console.WriteLine(result.GetProperty("modifiedDateTime").ToString());
    Console.WriteLine(result.GetProperty("eTag").ToString());
    Console.WriteLine(result.GetProperty("name").ToString());
    Console.WriteLine(result.GetProperty("description").ToString());
    Console.WriteLine(result.GetProperty("createdBy").ToString());
    Console.WriteLine(result.GetProperty("modifiedBy").ToString());
    Console.WriteLine(result.GetProperty("properties").GetProperty("<test>").ToString());
}

Comentários

Abaixo está o esquema JSON para um item na resposta paginável.

Corpo da resposta:

Esquema para InsightListResponseValue:

{
  partyId: string, # Optional. Id of the associated party.
  modelId: string, # Optional. Id of the associated model.
  resourceType: "Party" | "Farm" | "Field" | "SeasonalField" | "Boundary", # Optional. Resource type associated with the record.
  resourceId: string, # Optional. Id of the associated resource.
  modelVersion: string, # Optional. Version of the associated model.
  attachmentsLink: string, # Optional. Gets link for attachments.
  insightStartDateTime: string (ISO 8601 Format), # Optional. Start date to which the insight is related.
  insightEndDateTime: string (ISO 8601 Format), # Optional. End date to which the insight is related.
  measurements: Dictionary<string, Measure>, # Optional. Measures to capture insights results.
  id: string, # Optional. Id of the resource.
  status: string, # Optional. Status of the resource.
  createdDateTime: string (ISO 8601 Format), # Optional. Date-time when resource was created, sample format: yyyy-MM-ddTHH:mm:ssZ.
  modifiedDateTime: string (ISO 8601 Format), # Optional. Date-time when resource was last modified, sample format: yyyy-MM-ddTHH:mm:ssZ.
  eTag: string, # Optional. The ETag value to implement optimistic concurrency.
  name: string, # Optional. Name to identify resource.
  description: string, # Optional. Textual description of the resource.
  createdBy: string, # Optional. Created by user/tenant id.
  modifiedBy: string, # Optional. Modified by user/tenant id.
  properties: Dictionary<string, any>, # Optional. A collection of key value pairs that belongs to the resource.
Each pair must not have a key greater than 50 characters
and must not have a value greater than 150 characters.
Note: A maximum of 25 key value pairs can be provided for a resource and
only string, numeral and datetime (yyyy-MM-ddTHH:mm:ssZ) values are supported.
}

Aplica-se a

Compartilhar via