Management Zones - Create Or Update

服務:

Azure Data Manager for Agriculture

API 版本:

2023-11-01-preview

建立或更新管理區域資源。

PATCH {endpoint}/parties/{partyId}/management-zones/{managementZoneId}?api-version=2023-11-01-preview

URI 參數

名稱	位於	必要	類型	Description
endpoint	path	True	string uri	命名空間的主機名，例如 admaInstanceName.farmbeats.azure.net
managementZoneId	path	True	string	管理區域資源的標識碼。
partyId	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	與ManagementZone相關聯的裁剪標識碼。
description	string	資源的文字描述。
fieldId	string	與 ManagementZone 相關聯的欄位標識碼。
name	string	用於識別資源的名稱。
properties		屬於資源的索引鍵值組集合。 每個配對的索引鍵不能大於 50 個字元，而且不能有大於 150 個字元的值。 注意：最多可以針對資源提供 25 個索引鍵值組，而且只支援字串、數位和 datetime (yyyy-MM-ddTHH：mm：ssZ) 值。
seasonId	string	與 ManagementZone 相關聯的季標識碼。
source	string	資源的來源。
status	string	資源的狀態。
type	string	ManagementZone 的類型。

回應

名稱	類型	Description
200 OK	ManagementZone	Success
201 Created	ManagementZone	建立時間
Other Status Codes	ErrorResponse	錯誤 標題 x-ms-error-code: string

安全性

Authorization

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

類型: apiKey
位於: header

範例

ManagementZones_CreateOrUpdate

範例要求

HTTP

PATCH {endpoint}/parties/PARTY123/management-zones/ManagementZone123?api-version=2023-11-01-preview

{
  "type": "Nutrient rich",
  "seasonId": "Season123",
  "cropId": "Crop123",
  "fieldId": "Field123",
  "status": "Active",
  "name": "John Smith's ManagementZone",
  "description": "Some description",
  "source": "source",
  "properties": {
    "Irrigated": "Yes"
  }
}

範例回覆

狀態碼:

200

{
  "partyId": "PARTY123",
  "id": "ManagementZone123",
  "type": "Nutrient rich",
  "seasonId": "Season123",
  "cropId": "Crop123",
  "fieldId": "Field123",
  "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": "ManagementZone123",
  "type": "Nutrient rich",
  "seasonId": "Season123",
  "cropId": "Crop123",
  "fieldId": "Field123",
  "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 服務的錯誤回應。 請參閱 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses ErrorResponse 參考檔。
InnerError	包含錯誤清單的內部錯誤。請參閱 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object InnerError 參考檔。
ManagementZone	ManagementZone 物件的 Api 模型。

Error

來自 Azure AgPlatform 服務的錯誤。

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

ErrorResponse

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

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

InnerError

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

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

ManagementZone

ManagementZone 物件的 Api 模型。

名稱	類型	Description
createdBy	string	由使用者/租使用者標識碼建立。
createdDateTime	string	建立資源的日期時間，範例格式：yyyy-MM-ddTHH:mm:ssZ。
cropId	string	與ManagementZone相關聯的裁剪標識碼。
description	string	資源的文字描述。
eTag	string	要實作開放式並行存取的ETag值。
fieldId	string	與 ManagementZone 相關聯的欄位標識碼。
id	string	唯一的資源標識碼。
modifiedBy	string	由使用者/租使用者標識碼修改。
modifiedDateTime	string	上次修改資源的日期時間，範例格式：yyyy-MM-ddTHH:mm:ssZ。
name	string	用於識別資源的名稱。
partyId	string	與 ManagementZone 相關聯的合作對象識別碼。
properties		屬於資源的索引鍵值組集合。 每個配對的索引鍵不能大於 50 個字元，而且不能有大於 150 個字元的值。 注意：最多可以針對資源提供 25 個索引鍵值組，而且只支援字串、數位和 datetime (yyyy-MM-ddTHH：mm：ssZ) 值。
seasonId	string	與 ManagementZone 相關聯的季標識碼。
source	string	資源的來源。
status	string	資源的狀態。
type	string	ManagementZone 的類型。