Plant Tissue Analyses - Create Or Update

服務:: Azure Data Manager for Agriculture

API 版本:: 2023-11-01-preview

建立或更新植物組織分析資源。

PATCH {endpoint}/parties/{partyId}/plant-tissue-analyses/{plantTissueAnalysisId}?api-version=2023-11-01-preview

URI 參數

名稱	位於	必要	類型	Description
endpoint	path	True	string (uri)	命名空間的主機名，例如 admaInstanceName.farmbeats.azure.net
partyId	path	True	string	合作物件資源的標識碼。
plantTissueAnalysisId	path	True	string	植物組織分析資源的標識碼。
api-version	query	True	string	要求的 API 版本

要求標頭

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

名稱	必要	類型	Description
Authorization	True	string	請提供授權 API 呼叫的有效持有人令牌。請注意，如果您之前嘗試未驗證的呼叫，您可能需要清除瀏覽器快取。

要求本文

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

名稱	類型	Description
cropId	string	相關聯 Crop 的識別碼。
cropProductId	string	相關聯 Crop 產品的標識碼。
description	string minLength: 0 maxLength: 500	資源的文字描述。
fieldId	string	相關聯欄位的標識碼。
geometry	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON （如需詳細資訊：https://geojson.org/）。注意：座標必須是 [經度，緯度] 格式。
growthStage	string minLength: 0 maxLength: 200	這種植物組織分析的生長階段。
labDetails	LabDetails	代表 LabDetails 物件的模型。
name	string minLength: 0 maxLength: 100	用來識別資源的名稱。
plantAppearance	string minLength: 0 maxLength: 500	這種植物組織分析的植物外觀。
plantPart	string minLength: 0 maxLength: 200	此植物組織分析的植物部分。
plantPosition	string minLength: 0 maxLength: 200	此植物組織分析的植物位置。
plantingDateTime	string (date-time)	此植物組織分析的種植日期時間。
properties		屬於資源的索引鍵值組集合。每個配對不能有大於 50 個字元的索引鍵，而且不能有大於 150 個字元的值。注意：最多可以針對資源提供 25 個索引鍵值組，而且只支援字串、數位和日期時間（yyyy-MM-ddTHH：mm：ssZ）值。
sampleCollectionCondition	string minLength: 0 maxLength: 500	此植物組織分析的樣本收集條件。
sampleCollectionDateTime	string (date-time)	此植物組織分析的樣本收集日期時間。
sampleReceivedDateTime	string (date-time)	收到日期時間的範例。
sampleTestResultDateTime	string (date-time)	此植物組織分析的範例測試結果日期時間。
seasonId	string	相關聯季節的標識碼。
source	string minLength: 2 maxLength: 100	資源的來源。
status	string minLength: 0 maxLength: 100	資源的狀態。

回應

名稱	類型	Description
200 OK	PlantTissueAnalysis	成功
201 Created	PlantTissueAnalysis	已建立
Other Status Codes	ErrorResponse	錯誤標題 x-ms-error-code: string

名稱

類型

Description

200 OK

PlantTissueAnalysis

成功

201 Created

PlantTissueAnalysis

已建立

Other Status Codes

ErrorResponse

錯誤

標題

x-ms-error-code: string

安全性

Authorization

請提供授權 API 呼叫的有效持有人令牌。請注意，如果您之前嘗試未驗證的呼叫，您可能需要清除瀏覽器快取。

類型: apiKey
位於: header

範例

PlantTissueAnalyses_CreateOrUpdate

範例要求

HTTP

PATCH {endpoint}/parties/PARTY123/plant-tissue-analyses/PLANTTISSUEANALYSIS123?api-version=2023-11-01-preview

{
  "seasonId": "Season123",
  "cropId": "Crop123",
  "fieldId": "Field123",
  "plantingDateTime": "2022-05-11T07:00:10Z",
  "plantPart": "PlantPart",
  "plantPosition": "PlantPosition",
  "plantAppearance": "PlantAppearance",
  "sampleCollectionCondition": "SampleCollectionCondition",
  "sampleCollectionDateTime": "2021-04-21T06:49:30Z",
  "sampleReceivedDateTime": "2021-04-22T06:49:30Z",
  "sampleTestResultDateTime": "2021-04-23T06:49:30Z",
  "labDetails": {
    "code": "LabId",
    "name": "Name",
    "address": "Address",
    "description": "Description"
  },
  "status": "Active",
  "name": "John Smith's ManagementZone",
  "description": "Some description",
  "source": "source",
  "properties": {
    "Irrigated": "Yes"
  }
}

範例回覆

狀態碼:: 200

{
  "partyId": "PARTY123",
  "id": "PLANTTISSUEANALYSIS123",
  "seasonId": "Season123",
  "cropId": "Crop123",
  "fieldId": "Field123",
  "plantingDateTime": "2021-04-21T06:49:30Z",
  "plantPart": "PlantPart",
  "plantPosition": "PlantPosition",
  "plantAppearance": "PlantAppearance",
  "sampleCollectionCondition": "SampleCollectionCondition",
  "sampleCollectionDateTime": "2021-04-21T06:49:30Z",
  "sampleReceivedDateTime": "2021-04-22T06:49:30Z",
  "sampleTestResultDateTime": "2021-04-23T06:49:30Z",
  "labDetails": {
    "code": "LabId",
    "name": "Name",
    "address": "Address",
    "description": "Description"
  },
  "name": "John Smith's ManagementZone",
  "status": "Active",
  "description": "Some description",
  "source": "source",
  "properties": {
    "Irrigated": "Yes"
  },
  "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

{
  "partyId": "PARTY123",
  "id": "PLANTTISSUEANALYSIS123",
  "seasonId": "Season123",
  "cropId": "Crop123",
  "fieldId": "Field123",
  "plantingDateTime": "2021-04-21T06:49:30Z",
  "plantPart": "PlantPart",
  "plantPosition": "PlantPosition",
  "plantAppearance": "PlantAppearance",
  "sampleCollectionCondition": "SampleCollectionCondition",
  "sampleCollectionDateTime": "2021-04-21T06:49:30Z",
  "sampleReceivedDateTime": "2021-04-22T06:49:30Z",
  "sampleTestResultDateTime": "2021-04-23T06:49:30Z",
  "labDetails": {
    "code": "LabId",
    "name": "Name",
    "address": "Address",
    "description": "Description"
  },
  "name": "John Smith's ManagementZone",
  "status": "Active",
  "description": "Some description",
  "source": "source",
  "properties": {
    "Irrigated": "Yes"
  },
  "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"
}

定義

名稱	Description
Error	來自 Azure AgPlatform 服務的錯誤。
ErrorResponse	來自 Azure AgPlatform 服務的錯誤回應。如需 ErrorResponse 參考檔，請參閱 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
GeoJsonObjectType	GeoJSON 物件類型。
InnerError	包含錯誤清單的內部錯誤。請參閱 innerError 參考檔 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object。
LabDetails	代表 LabDetails 物件的模型。
MultiPolygon	MultiPolygon 幾何。
PlantTissueAnalysis	植物組織分析物件的 API 模型。
Point	點幾何。
Polygon	多邊形幾何。

Error

Object

來自 Azure AgPlatform 服務的錯誤。

名稱	類型	Description
code	string minLength: 1	伺服器定義的錯誤碼集。
details	Error[]	導致此錯誤之特定錯誤的詳細數據陣列。
innererror	InnerError	包含錯誤清單的內部錯誤。請參閱 innerError 參考檔 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object。
message	string minLength: 1	人類可讀取的錯誤表示法。
target	string	錯誤的目標。

ErrorResponse

Object

來自 Azure AgPlatform 服務的錯誤回應。如需 ErrorResponse 參考檔，請參閱 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名稱	類型	Description
error	Error	來自 Azure AgPlatform 服務的錯誤。
traceId	string	唯一追蹤標識碼。

GeoJsonObjectType

列舉型別

GeoJSON 物件類型。

值	Description
Point
Polygon
MultiPolygon

InnerError

Object

包含錯誤清單的內部錯誤。請參閱 innerError 參考檔 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object。

名稱	類型	Description
code	string	包含錯誤所提供的特定錯誤碼。
innererror	InnerError	包含錯誤清單的內部錯誤。請參閱 innerError 參考檔 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object。

LabDetails

Object

代表 LabDetails 物件的模型。

名稱	類型	Description
address	string minLength: 0 maxLength: 500	資源的位址。
code	string minLength: 0 maxLength: 150	資源的程序代碼。
description	string minLength: 0 maxLength: 500	資源的描述。
name	string minLength: 0 maxLength: 100	資源的名稱。

MultiPolygon

Object

MultiPolygon 幾何。

名稱	類型	Description
coordinates	number[] (double)	取得或設定 GeoJSON 物件的座標。它必須是多邊形陣列，每個多邊形都包含線性環形的清單。對於有多個環形的多邊形，第一個必須是外部環形，而任何其他必須是內部環形。
type	string: MultiPolygon	GeoJSON 物件類型。

PlantTissueAnalysis

Object

植物組織分析物件的 API 模型。

名稱	類型	Description
createdBy	string	由使用者/租使用者標識碼建立。
createdDateTime	string (date-time)	建立資源的日期時間，範例格式：yyyy-MM-ddTHH：mm：ssZ。
cropId	string	相關聯 Crop 的識別碼。
cropProductId	string	相關聯 Crop 產品的標識碼。
description	string minLength: 0 maxLength: 500	資源的文字描述。
eTag	string	要實作開放式並行存取的ETag值。
fieldId	string	相關聯欄位的標識碼。
geometry	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON （如需詳細資訊：https://geojson.org/）。注意：座標必須是 [經度，緯度] 格式。
growthStage	string minLength: 0 maxLength: 200	這種植物組織分析的生長階段。
id	string	唯一的資源標識碼。
labDetails	LabDetails	代表 LabDetails 物件的模型。
modifiedBy	string	由使用者/租使用者標識碼修改。
modifiedDateTime	string (date-time)	上次修改資源的日期時間，範例格式：yyyy-MM-ddTHH：mm：ssZ。
name	string minLength: 0 maxLength: 100	用來識別資源的名稱。
partyId	string	相關聯合作對象的標識碼。
plantAppearance	string minLength: 0 maxLength: 500	這種植物組織分析的植物外觀。
plantPart	string minLength: 0 maxLength: 200	此植物組織分析的植物部分。
plantPosition	string minLength: 0 maxLength: 200	此植物組織分析的植物位置。
plantingDateTime	string (date-time)	此植物組織分析的種植日期時間。
properties		屬於資源的索引鍵值組集合。每個配對不能有大於 50 個字元的索引鍵，而且不能有大於 150 個字元的值。注意：最多可以針對資源提供 25 個索引鍵值組，而且只支援字串、數位和日期時間（yyyy-MM-ddTHH：mm：ssZ）值。
sampleCollectionCondition	string minLength: 0 maxLength: 500	此植物組織分析的樣本收集條件。
sampleCollectionDateTime	string (date-time)	此植物組織分析的樣本收集日期時間。
sampleReceivedDateTime	string (date-time)	收到日期時間的範例。
sampleTestResultDateTime	string (date-time)	此植物組織分析的範例測試結果日期時間。
seasonId	string	相關聯季節的標識碼。
source	string minLength: 2 maxLength: 100	資源的來源。
status	string minLength: 0 maxLength: 100	資源的狀態。

Point

Object

點幾何。

名稱	類型	Description
coordinates	number[] (double)	取得或設定這個點的座標。它必須是 2D 或 3D 系統的 2 或 3 個項目陣列。
type	string: Point	GeoJSON 物件類型。

Polygon

Object

多邊形幾何。

名稱	類型	Description
coordinates	number[] (double)	取得或設定 GeoJSON 物件的類型。它必須是線性環形座標數位的陣列。對於有多個環形的多邊形，第一個必須是外部環形，而任何其他必須是內部環形。
type	string: Polygon	GeoJSON 物件類型。

共用方式為

Plant Tissue Analyses - Create Or Update

URI 參數

要求標頭

要求本文

回應

安全性

Authorization

範例

PlantTissueAnalyses_CreateOrUpdate

範例要求

範例回覆

定義

Error

ErrorResponse

GeoJsonObjectType

InnerError

LabDetails

MultiPolygon

PlantTissueAnalysis

Point

Polygon