Insights.GetInsightAsync メソッド

定義

名前空間:

Azure.Verticals.AgriFood.Farming

アセンブリ:

Azure.Verticals.AgriFood.Farming.dll

パッケージ:

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

ソース:

Insights.cs

特定のパーティの指定された分析情報リソースを取得します。

public virtual System.Threading.Tasks.Task<Azure.Response> GetInsightAsync (string partyId, string modelId, string resourceType, string resourceId, string insightId, Azure.RequestContext context = default);

abstract member GetInsightAsync : string * string * string * string * string * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
override this.GetInsightAsync : string * string * string * string * string * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function GetInsightAsync (partyId As String, modelId As String, resourceType As String, resourceId As String, insightId As String, Optional context As RequestContext = Nothing) As Task(Of Response)

パラメーター

partyId

String

関連付けられたパーティの ID。

modelId

String

関連付けられたモデルの ID。 "BiomassModelId"、"SensorPlacementModelId"、"SoilMoistureModelId"、または任意のソリューション ID のいずれかを指定できます。

resourceType

String

レコードに関連付けられているリソースの種類。

resourceId

String

関連付けられているリソースの ID。

insightId

String

分析情報リソースの ID。

context

RequestContext

要求コンテキスト。これは、呼び出しごとにクライアント パイプラインの既定の動作をオーバーライドできます。

戻り値

Task<Response>

サービスから返された応答。 応答本文スキーマの詳細については、以下の「解説」セクションを参照してください。

例外

ArgumentNullException

partyId、 modelId、 resourceType、 resourceId または insightId が null です。

ArgumentException

partyId、 modelId、 resourceType、 resourceId または insightId は空の文字列であり、空でないと想定されていました。

RequestFailedException

サービスから成功以外の状態コードが返されました。

例

このサンプルでは、必要なパラメーターを使用して GetInsightAsync を呼び出し、結果を解析する方法を示します。

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

Response response = await client.GetInsightAsync("<partyId>", "<modelId>", "<resourceType>", "<resourceId>", "<insightId>");

JsonElement result = JsonDocument.Parse(response.ContentStream).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());

注釈

応答ペイロードの JSON スキーマを次に示します。

応答本文:

の Insightスキーマ:

{
  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.
}