共用方式為


用於農業的 Azure 資料管理員預覽作為事件方格來源

本文提供用於農業的 Azure 資料管理員事件的屬性和結構描述。 如需事件結構描述的簡介,請參閱 Azure 事件方格事件結構描述。

必要條件

請務必先完成下列必要條件後,再開始部署用於農業的 Azure 資料管理員內事件功能的步驟。

回應用於農業的資料管理員事件

用於農業的資料管理員事件可讓應用程式回應資源的建立、刪除和更新。 用於農業的資料管理員會使用 Azure 事件方格推送。

Azure Functions、Azure Logic Apps,甚至您自己的 HTTP 接聽程式都可以訂閱這些事件。 Azure 事件方格可透過多種重試原則和無效信件處理,對您的應用程式提供可靠的事件傳遞。

下列是在服務中取用事件的範例案例:

  1. 下載衛星或天氣資料或執行作業時,您可以使用事件來回應作業狀態的變更。 您可以將長時間輪詢降到最低,並減少對服務的 API 呼叫數目。 您也可以取得作業完成的提示通知。 我們所有的非同步擷取作業都能支援事件。

注意

目前不支援與 ISV 解決方案流程相關的事件。

  1. 如果資料平面資源 (例如合作對象、欄位、農場和其他類似的元素) 出現修改,您可以回應變更,也可以觸發工作流程。

篩選事件

您可以依資料物件中的事件類型、主旨或欄位,篩選用於農業的資料管理員事件。 事件方格中的篩選條件會比對主旨的開頭或結尾,讓具有相符項目的事件得以傳送至訂閱者。

例如,針對 PartyChanged 事件,若要接收識別碼為 Party1234 之特定合作對象的變更通知,您可以使用主旨篩選條件 “EndsWith”,如下所示:

EndsWith- /Party1234 此事件的主旨格式為 "/parties/Party1234"

事件結構描述中的主旨也會提供「開頭」和「完全相符」篩選條件。

同樣地,若要篩選符合一組合作對象識別碼的相同事件,請在事件資料物件中使用 partyId 欄位的進階篩選。 在單一訂用帳戶中,您可以為每個篩選的索引鍵新增五個進階篩選,最高限制使用 25 個值。

若要深入了解如何套用篩選,請參閱事件方格的篩選事件

訂閱事件

您可以使用 Azure 入口網站或 Azure Resource Manager 用戶端來訂閱用於農業的資料管理員事件。 這兩項服務都會為使用者提供一組功能。 請參閱下列資源,以深入了解每個方法。

透過入口網站訂閱事件

使用 ARM 範本用戶端訂閱事件

消費事件做法

處理用於農業的資料管理員事件的應用程式應該遵循幾個建議做法:

  • 檢查 eventType 也是必須進行的步驟之一,而且請勿假設您收到的所有事件都是您預期的類型。
  • 訊息有可能以錯誤的順序送達,請使用 [modifiedTime] 和 [Etag] 欄位了解任何特定物件的事件順序。
  • 用於農業的資料管理員事件可保證至少會向訂閱者傳遞一次,以確保所有訊息都會輸出。 不過,由於重試或訂用帳戶的可用性,可能偶爾會出現重複的訊息。 若要深入了解訊息傳遞和重試,請參閱事件方格訊息傳遞和重試
  • 請忽略您不了解的欄位。 此做法將有助於保持未來可能新增功能的彈性。

可用的事件類型

事件名稱 描述
Microsoft.AgFoodPlatform.PartyChanged 在用於農業的 Azure 資料管理員資源中建立/更新/刪除合作對象時發佈
Microsoft.AgFoodPlatform.FarmChangedV2 在用於農業的 Azure 資料管理員資源中建立/更新/刪除農場時發佈
Microsoft.AgFoodPlatform.FieldChangedV2 在用於農業的 Azure 資料管理員資源中建立/更新/刪除欄位時發佈
Microsoft.AgFoodPlatform.SeasonalFieldChangedV2 在用於農業的 Azure 資料管理員資源中建立/更新/刪除季節性欄位時發佈
Microsoft.AgFoodPlatform.CropChanged 在用於農業的 Azure 資料管理員資源中建立/更新/刪除農作物時發佈
Microsoft.AgFoodPlatform.CropProductChanged 在用於農業的 Azure 資料管理員資源中建立/更新/刪除農作物產品時發佈
Microsoft.AgFoodPlatform.SeasonChanged 在用於農業的 Azure 資料管理員資源中建立/更新/刪除季節時發佈
Microsoft.AgFoodPlatform.SatelliteDataIngestionJobStatusChangedV2 當衛星資料擷取作業的狀態變更時發佈,例如已建立、已處理或已完成作業。
Microsoft.AgFoodPlatform.WeatherDataIngestionJobStatusChangedV2 當天氣資料擷取作業的狀態變更時發佈,例如已建立、已處理或已完成作業。
Microsoft.AgFoodPlatform.WeatherDataRefresherJobStatusChangedV2 在天氣資料重新整理器工作狀態變更時發佈。
Microsoft.AgFoodPlatform.SensorMappingChangedV2 變更感測器對應時發佈
Microsoft.AgFoodPlatform.SensorPartnerIntegrationChangedV2 變更感應器合作夥伴整合時發佈
Microsoft.AgFoodPlatform.DeviceDataModelChanged 變更裝置資料模型時發佈
Microsoft.AgFoodPlatform.DeviceChanged 變更裝置時發佈
Microsoft.AgFoodPlatform.SensorDataModelChanged 變更感應器資料模型時發佈
Microsoft.AgFoodPlatform.SensorChanged 變更感應器時發佈
Microsoft.AgFoodPlatform.FarmOperationDataIngestionJobStatusChangedV2 當農場營運資料擷取作業的狀態變更時發佈,例如作業已建立、已處理或已完成。
Microsoft.AgFoodPlatform.ApplicationDataChangedV2 在用於農業的 Azure 資料管理員資源中建立/更新/刪除應用程式資料時發佈
Microsoft.AgFoodPlatform.HarvestDataChangedV2 在用於農業的 Azure 資料管理員資源中建立/更新/刪除收成資料時發佈
Microsoft.AgFoodPlatform.TillageDataChangedV2 在用於農業的 Azure 資料管理員資源中建立/更新/刪除耕作資料時發佈
Microsoft.AgFoodPlatform.PlantingDataChangedV2 在用於農業的 Azure 資料管理員資源中建立/更新/刪除栽種資料時發佈
Microsoft.AgFoodPlatform.AttachmentChangedV2 建立/更新/刪除附件時發佈。
Microsoft.AgFoodPlatform.ZoneChangedV2 建立/更新/刪除區域時發佈。
Microsoft.AgFoodPlatform.ManagementZoneChangedV2 建立/更新/刪除管理區域時發佈。
Microsoft.AgFoodPlatform.PrescriptionChangedV2 建立/更新/刪除處方時發佈。
Microsoft.AgFoodPlatform.PrescriptionMapChangedV2 建立/更新/刪除處方地圖時發佈。
Microsoft.AgFoodPlatform.PlantTissueAnalysisChangedV2 建立/更新/刪除植物組織分析資料時發佈。
Microsoft.AgFoodPlatform.NutrientAnalysisChangedV2 建立/更新/刪除營養分析資料時發佈。
Microsoft.AgFoodPlatform.ImageProcessingRasterizeJobStatusChangedV2 在影像處理點陣化作業的狀態變更時發佈,例如已建立、已處理或已完成作業。
Microsoft.AgFoodPlatform.InsightChangedV2 在建立/更新/刪除見解時發佈。
Microsoft.AgFoodPlatform.InsightAttachmentChangedV2 建立/更新/刪除見解附件時發佈。
Microsoft.AgFoodPlatform.BiomassModelJobStatusChangedV2 在生物量模型作業狀態變更時發佈
Microsoft.AgFoodPlatform.SoilMoistureModelJobStatusChangedV2 在土壤濕度作業狀態變更時發佈
Microsoft.AgFoodPlatform.SensorPlacementModelJobStatusChangedV2 在感應器放置模型作業狀態變更時發佈

事件屬性

每個用於農業的 Azure 資料管理員事件都有兩個部分,第一個部分在事件之間很常見,而第二個部分則是資料物件,其包含每個事件特有的屬性。

跨事件通用的部分會詳述於事件方格事件結構描述,並具有下列最上層資料:

屬性 類型​ 描述
主題 string 事件來源的完整資源路徑。 此欄位無法寫入。 事件方格提供此值。
主旨 string 發行者定義事件主旨的路徑。
eventType string 此事件來源已註冊的事件類型之一。
eventTime string 事件產生的時間,以提供者的 UTC 時間為準。
識別碼 string 事件的唯一識別碼。
資料 object 具有每個事件類型特定屬性的資料物件。
dataVersion string 資料物件的結構描述版本。 發行者會定義結構描述版本。
metadataVersion string 事件中繼資料的結構描述版本。 「事件方格」會定義最上層屬性的結構描述。 事件方格提供此值。

針對合作對象、季節、農作物、農作物產品變更事件,資料物件包含下列屬性:

屬性 類型​ 描述
識別碼 string 資源的唯一識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 用於識別資源的名稱。

針對農場事件,資料物件包含下列屬性:

屬性 類型​ 描述
識別碼 string 資源的唯一識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 用於識別資源的名稱。
partyId string 所屬之合作對象的識別碼。

針對裝置資料模型和感應器資料模型事件,資料物件包含下列屬性:

屬性 類型​ 描述
sensorPartnerId string 與 sensorPartner 相關聯的識別碼。
識別碼 string 資源的唯一識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 用於識別資源的名稱。

針對裝置事件,資料物件包含下列屬性:

屬性 類型​ 描述
deviceDataModelId string 與 deviceDataModel 相關聯的識別碼。
integrationId string 與整合相關聯的識別碼。
sensorPartnerId string 與 sensorPartner 相關聯的識別碼。
識別碼 string 資源的唯一識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 用於識別資源的名稱。

針對感應器事件,資料物件包含下列屬性:

屬性 類型​ 描述
sensorDataModelId string 與 sensorDataModel 相關聯的識別碼。
integrationId string 與整合相關聯的識別碼。
deviceId string 與裝置相關聯的識別碼。
sensorPartnerId string 與 sensorPartner 相關聯的識別碼。
識別碼 string 資源的唯一識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 用於識別資源的名稱。

針對感應器對應事件,資料物件包含下列屬性:

屬性 類型​ 描述
sensorId string 與感應器相關聯的識別碼。
partyId string 與合作對象相關聯的識別碼。
sensorPartnerId string 與 sensorPartner 相關聯的識別碼。
識別碼 string 資源的唯一識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 用於識別資源的名稱。

針對感應器合作夥伴整合事件,資料物件包含下列屬性:

屬性 類型​ 描述
integrationId string 與整合相關聯的識別碼。
partyId string 與合作對象相關聯的識別碼。
sensorPartnerId string 與 sensorPartner 相關聯的識別碼。
識別碼 string 資源的唯一識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 用於識別資源的名稱。

季節性欄位事件有下列資料物件:

屬性 類型​ 描述
識別碼 string 季節性欄位的使用者定義識別碼
farmId string 與該季節性欄位相關聯,由使用者定義的農場識別碼。
partyId string 所屬之合作對象的識別碼。
seasonId string 與該季節性欄位相關聯,由使用者定義的季節識別碼。
fieldId string 與該季節性欄位相關聯,由使用者定義的欄位識別碼。
NAME 字串 使用者定義的季節性欄位名稱。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。

見解事件具有下列資料物件:

屬性 類型​ 描述
modelId string 相關聯模型的識別碼。
resourceId string 資源的使用者定義識別碼,例如農場、欄位等。
resourceType string 資源類型名稱。 適用的值為 Party、Farm、Field、SeasonalField 等。
partyId string 所屬之合作對象的識別碼。
modelVersion string 相關聯模型的版本。
識別碼 string 資源的使用者定義識別碼。
status 字串 包含作業的狀態。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
modifiedDateTime date-time 上次修改資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
eTag string 實作開放式同步存取
description string 描述此資源的金鑰值組清單。 僅支援字串和數值。
NAME 字串 使用者定義的資源名稱。
內容 object 使用者定義的資源名稱。

InsightAttachment 事件有下列資料物件:

屬性 類型​ 描述
modelId string 相關聯模型的識別碼。
resourceId string 資源的使用者定義識別碼,例如農場、欄位等。
resourceType string 資源類型名稱。
partyId string 所屬之合作對象的識別碼。
insightId string 與見解資源相關聯的識別碼。
識別碼 string 資源的使用者定義識別碼。
status 字串 包含作業的狀態。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
modifiedDateTime date-time 上次修改資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
eTag string 實作開放式同步存取
description string 描述此資源的金鑰值組清單。 僅支援字串和數值。
NAME 字串 使用者定義的資源名稱。
內容 object 使用者定義的資源名稱。

欄位事件具有下列資料物件:

屬性 類型​ 描述
識別碼 string 使用者定義的欄位識別碼。
farmId string 與該欄位相關聯,由使用者定義的農場識別碼。
partyId string 所屬之合作對象的識別碼。
NAME 字串 使用者定義的欄位名稱。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
內容 Object 包含使用者定義的機碼值組。
modifiedDateTime string 表示上次修改事件的時間。
createdDateTime string 表示資源建立的時間。
status 字串 包含使用者定義的物件狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。

ImageProcessingRasterizeJobStatusChanged 事件具有下列資料物件:

屬性 類型​ 描述
shapefileAttachmentId string 相關聯形狀檔的使用者定義識別碼名稱。
partyId string 已建立作業的合作對象識別碼。
識別碼 string 作業的唯一識別碼。
NAME 字串 使用者定義的作業名稱。
status 字串 作業可以處於的各種狀態。 適用值為 Waiting、Running、Succeeded、Failed、Canceled 等。
isCancellationRequested boolean 要求取消作業時設定的旗標。
description string 作業的文字描述。
message string 擷取更多作業詳細資料的狀態訊息。
lastActionDateTime date-time 上次針對作業採取動作的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
內容 Object 包含使用者定義的機碼值組

SatelliteDataIngestionJobChanged、WeatherDataIngestionJobChanged、WeatherDataRefresherJobChanged、BiomassModelJobStatusChanged、SoilMoistureModelJobStatusChanged 和 FarmOperationDataIngestionJobChanged 事件具有下列資料物件:

屬性 類型​ 描述
識別碼 string 作業的唯一識別碼。
NAME 字串 使用者定義的作業名稱。
status 字串 作業可以處於的各種狀態。
isCancellationRequested boolean 要求取消作業時設定的旗標。
description string 作業的文字描述。
partyId string 已建立作業的合作對象識別碼。
message string 擷取更多作業詳細資料的狀態訊息。
lastActionDateTime date-time 上次針對作業採取動作的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
內容 Object 包含使用者定義的機碼值組。

農場作業資料事件 (例如應用程式資料、收成資料、栽種資料和耕作資料) 具有下列資料物件:

屬性 類型​ 描述
識別碼 string 資源的唯一識別碼。
status 字串 包含使用者定義的資源狀態。
partyId string 所屬之合作對象的識別碼。
來源 string 來自用於農業的 Azure 資料管理員的訊息,提供作業的詳細資料。
modifiedDateTime string 表示上次修改事件的時間
createdDateTime string 表示資源建立的時間
eTag string 實作開放式同步存取
NAME 字串 用於識別資源的名稱。
description string 資源的文字描述
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
內容 Object 包含使用者定義的機碼值組。

AttachmentChanged 事件具有下列資料物件

屬性 類型​ 描述
resourceId string 資源的使用者定義識別碼,例如農場、欄位等。
resourceType string 資源類型名稱。
partyId string 所屬之合作對象的識別碼。
識別碼 string 資源的使用者定義識別碼。
status 字串 包含作業的狀態。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
modifiedDateTime date-time 上次修改資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
eTag string 實作開放式同步存取
description string 資源的文字描述
NAME 字串 使用者定義的資源名稱。

ZoneChanged 事件具有下列資料物件

屬性 類型​ 描述
managementZoneId string 與區域相關聯的管理區域識別碼。
partyId string 相關聯欄位的使用者定義識別碼。
識別碼 string 所屬之合作對象的識別碼
status 字串 包含使用者定義的資源狀態。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
modifiedDateTime date-time 上次修改資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
eTag string 實作開放式同步存取
description string 資源的文字描述
NAME 字串 使用者定義的資源名稱。
內容 object 描述此資源的金鑰值組清單。 僅支援字串和數值。

PrescriptionChanged 事件具有下列資料物件

屬性 類型​ 描述
prescriptionMapId string 相關聯處方地圖的使用者定義識別碼。
partyId string 所屬之合作對象的識別碼。
識別碼 string 處方的使用者定義識別碼。
actionType string 表示發佈事件期間所觸發的變更。 適用值為 Created (建立)、Updated (更新)、Deleted (刪除)
status 字串 包含使用者定義的處方狀態。
內容 object 包含使用者定義的索引鍵-值組。
modifiedDateTime date-time 上次修改資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
eTag string 實作開放式同步存取
description string 資源的文字描述
NAME 字串 處方的使用者定義名稱。

PrescriptionMapChanged 和 ManagementZoneChanged 事件具有下列資料物件:

屬性 類型​ 描述
seasonId string 相關聯季節的使用者定義識別碼。
cropId string 相關聯農作物的使用者定義識別碼。
fieldId string 相關聯欄位的使用者定義識別碼。
partyId string 所屬之合作對象的識別碼。
識別碼 string 資源的使用者定義識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
modifiedDateTime date-time 上次修改資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
eTag string 實作開放式同步存取
description string 資源的文字描述
NAME 字串 處方地圖的使用者定義名稱。
內容 object 包含使用者定義的索引鍵-值組
status 字串 資源的狀態。

PlantTissueAnalysisChanged 事件具有下列資料物件:

屬性 類型​ 描述
seasonId string 相關聯季節的使用者定義識別碼。
cropId string 相關聯農作物的使用者定義識別碼。
cropProductId string 與植物組織分析相關聯的農作物產品識別碼。
fieldId string 相關聯欄位的使用者定義識別碼。
partyId string 所屬之合作對象的識別碼。
識別碼 string 資源的使用者定義識別碼。
actionType string 表示觸發事件發佈的變更。 適用值為 created、updated、deleted。
modifiedDateTime date-time 上次修改資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立資源的日期時間,範例格式:yyyy-MM-ddTHH:mm:ssZ。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 處方地圖的使用者定義名稱。
內容 object 包含使用者定義的索引鍵-值組。
status 字串 資源的狀態。

NutrientAnalysisChanged 事件具有下列資料物件:

屬性 類型​ 描述
parentId string 父代營養分析所屬的識別碼。
parentType string 父代營養分析所屬的類型。 適用值為 PlantTissueAnalysis。
partyId string 所屬之合作對象的識別碼。
識別碼 string 營養分析的使用者定義識別碼。
actionType string 表示發佈事件期間所觸發的變更。 適用值為 Created (建立)、Updated (更新)、Deleted (刪除)。
內容 object 包含使用者定義的索引鍵-值組。
modifiedDateTime date-time 上次修改營養分析的日期時間,範例格式: yyyy-MM-ddTHH:mm:ssZ。
createdDateTime date-time 建立營養分析的日期時間,範例格式: yyyy-MM-ddTHH:mm:ssZ。
status 字串 包含使用者定義的營養分析狀態。
eTag string 實作開放式同步存取。
description string 資源的文字描述。
NAME 字串 營養分析的使用者定義名稱。

取樣事件

如需範例事件,請參閱頁面

下一步