Crop Products - Create Or Update

サービス:

Azure Data Manager for Agriculture

API バージョン:

2023-11-01-preview

トリミング製品リソースを作成または更新します。

PATCH {endpoint}/crop-products/{cropProductId}?api-version=2023-11-01-preview

URI パラメーター

名前	/	必須	型	説明
cropProductId	path	True	string	トリミング製品リソースの ID。
endpoint	path	True	string uri	名前空間のホスト名 (例: admaInstanceName.farmbeats.azure.net)
api-version	query	True	string	要求された API バージョン

要求ヘッダー

Media Types: "application/merge-patch+json"

名前	必須	型	説明
Authorization	True	string	承認された API 呼び出しに有効なベアラー トークンを指定してください。 以前に認証されていない呼び出しを試した場合は、ブラウザーのキャッシュをクリアする必要がある場合があることに注意してください。

要求本文

Media Types: "application/merge-patch+json"

名前	型	説明
brand	string	作物の商業ブランド。
company	Company	会社/製造元の詳細。
cropIds	string[]	化学製品に関連付けられている作物の ID。 注: cropProduct には、最大 25 個のトリミングを関連付けることができます。
description	string	リソースの説明テキスト。
location	string	特性。
name	string	リソースを識別する名前
product	string	作物製品の商用製品名。
properties		リソースに属するキー値ペアのコレクション。 各ペアは、50 文字を超えるキーを持つ必要があり、150 文字を超える値を持つ必要があります。 注: リソースには最大 25 個のキー値ペアを指定でき、文字列、数字、datetime (yyyy-MM-ddTHH:mm:ssZ) の値のみがサポートされます。
reference	Reference	データセット レコードへの参照。
relativeMaturity	RelativeMaturityMeasure	相対的な成熟度メジャー。
source	string	リソースのソース。
status	string	リソースの状態。
traitStack	string	CONV、RR2 などの表現表現。 これらは、CONV (Conventional)、RR2 (RoundUpReady) などの表現表現です。
traits	string	スタック内にある特性。
treatments	string[]	種子コーティング菌、昆虫などに適用されます。

応答

名前	型	説明
200 OK	CropProduct	Success
201 Created	CropProduct	作成済み
Other Status Codes	ErrorResponse	エラー ヘッダー x-ms-error-code: string

セキュリティ

Authorization

承認された API 呼び出しに有効なベアラー トークンを指定してください。 以前に認証されていない呼び出しを試した場合は、ブラウザーのキャッシュをクリアする必要がある場合があることに注意してください。

型: apiKey
/: header

例

CropProducts_CreateOrUpdate

要求のサンプル

HTTP

PATCH {endpoint}/crop-products/SEED123?api-version=2023-11-01-preview

{
  "brand": "BRAND123",
  "product": "AGTECH",
  "relativeMaturity": {
    "unit": "string",
    "value": 0
  },
  "treatments": [
    "string"
  ],
  "status": "Active",
  "name": "John Smith's Crop",
  "description": "Some description",
  "source": "source",
  "properties": {
    "Irrigated": "Yes",
    "RetailerId": "Retailer123"
  }
}

応答のサンプル

状態コード:

200

{
  "id": "SEED123",
  "cropIds": [
    "CORN123"
  ],
  "brand": "BRAND123",
  "product": "AGTECH",
  "relativeMaturity": {
    "unit": "string",
    "value": 0
  },
  "treatments": [
    "string"
  ],
  "name": "John Smith's Crop",
  "status": "Active",
  "description": "Some description",
  "source": "source",
  "properties": {
    "Irrigated": "Yes",
    "RetailerId": "Retailer123"
  },
  "createdDateTime": "2021-04-21T06:49:30Z",
  "modifiedDateTime": "2021-04-21T06:49:30Z",
  "createdBy": "00000000-0000-0000-0000-000000000000",
  "modifiedBy": "00000000-0000-0000-0000-000000000000",
  "eTag": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

状態コード:

201

{
  "id": "SEED123",
  "cropIds": [
    "CORN123"
  ],
  "brand": "BRAND123",
  "product": "AGTECH",
  "relativeMaturity": {
    "unit": "string",
    "value": 0
  },
  "treatments": [
    "string"
  ],
  "name": "John Smith's Crop",
  "status": "Active",
  "description": "Some description",
  "source": "source",
  "properties": {
    "Irrigated": "Yes",
    "RetailerId": "Retailer123"
  },
  "createdDateTime": "2021-04-21T06:49:30Z",
  "modifiedDateTime": "2021-04-21T06:49:30Z",
  "createdBy": "00000000-0000-0000-0000-000000000000",
  "modifiedBy": "00000000-0000-0000-0000-000000000000",
  "eTag": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

定義

名前	説明
Company	会社/製造元の詳細。
CropProduct	トリミング製品リソースのスキーマ。
Error	Azure AgPlatform サービスからのエラー。
ErrorResponse	Azure AgPlatform サービスからのエラー応答。 ErrorResponse リファレンス ドキュメントを参照してください https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。
InnerError	エラーの一覧を含む内部エラー。InnerError のリファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。
Reference	データセット レコードへの参照。
RelativeMaturityMeasure	相対的な成熟度メジャー。

Company

会社/製造元の詳細。

名前	型	説明
description	string	製造会社の説明。
name	string	製造会社の名前。
registrationNumber	string	会社の登録番号。

CropProduct

トリミング製品リソースのスキーマ。

名前	型	説明
brand	string	作物の商業ブランド。
company	Company	会社/製造元の詳細。
createdBy	string	ユーザー/テナント ID によって作成されます。
createdDateTime	string	リソースが作成された日時 (サンプル形式: yyyy-MM-ddTHH:mm:ssZ)。
cropIds	string[]	化学製品に関連付けられている作物の ID。 注: cropProduct には、最大 25 個のトリミングを関連付けることができます。
description	string	リソースの説明テキスト。
eTag	string	オプティミスティック コンカレンシーを実装する ETag 値。
id	string	一意のリソース ID。
location	string	特性。
modifiedBy	string	ユーザー/テナント ID によって変更されました。
modifiedDateTime	string	リソースが最後に変更された日時 (サンプル形式: yyyy-MM-ddTHH:mm:ssZ)。
name	string	リソースを識別する名前
product	string	作物製品の商用製品名。
properties		リソースに属するキー値ペアのコレクション。 各ペアは、50 文字を超えるキーを持つ必要があり、150 文字を超える値を持つ必要があります。 注: リソースには最大 25 個のキー値ペアを指定でき、文字列、数字、datetime (yyyy-MM-ddTHH:mm:ssZ) の値のみがサポートされます。
reference	Reference	データセット レコードへの参照。
relativeMaturity	RelativeMaturityMeasure	相対的な成熟度メジャー。
source	string	リソースのソース。
status	string	リソースの状態。
traitStack	string	CONV、RR2 などの表現表現。 これらは、CONV (Conventional)、RR2 (RoundUpReady) などの表現表現です。
traits	string	スタック内にある特性。
treatments	string[]	種子コーティング菌、昆虫などに適用されます。

Error

Azure AgPlatform サービスからのエラー。

名前	型	説明
code	string	サーバー定義のエラー コードのセット。
details	Error[]	この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innererror	InnerError	エラーの一覧を含む内部エラー。InnerError のリファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。
message	string	人が判読できるエラーの表現。
target	string	エラーのターゲット。

ErrorResponse

Azure AgPlatform サービスからのエラー応答。 ErrorResponse リファレンス ドキュメントを参照してください https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。

名前	型	説明
error	Error	Azure AgPlatform サービスからのエラー。
traceId	string	一意のトレース ID。

InnerError

エラーの一覧を含む内部エラー。InnerError のリファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。

名前	型	説明
code	string	含まれているエラーによって提供されたエラーコードより具体的なエラー コード。
innererror	InnerError	エラーの一覧を含む内部エラー。InnerError のリファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。

Reference

データセット レコードへの参照。

名前	型	説明
datasetId	string	データセット ID。
recordId	string	レコード ID。

RelativeMaturityMeasure

相対的な成熟度メジャー。

名前	型	説明
method	string	製品の相対的な成熟度を決定するために使用されるメソッド。 例としては、比較相対成熟度や熱単位などがあります。
unit	string	データ単位。
value	number	データ値。