event-schema-data-manager-for-agriculture.md

title	Azure Data Manager for Agriculture
description	Describes the properties that are provided for Azure Data Manager for Agriculture events with Azure Event Grid.
ms.topic	concept-article
ms.date	04/17/2023

Azure Data Manager for Agriculture (Preview) as Event Grid source

This article provides the properties and schema for Azure Data Manager for Agriculture (Preview) events. For an introduction to event schemas, see Azure Event Grid event schema and Cloud event schema.

Available event types

Farm management related event types (Preview)

Event Name	Description
Microsoft.AgFoodPlatform.PartyChanged	Published when a Party is created/updated/deleted.
Microsoft.AgFoodPlatform.FarmChanged.V2	Published when a Farm is created/updated/deleted.
Microsoft.AgFoodPlatform.FieldChanged.V2	Published when a Field is created/updated/deleted.
Microsoft.AgFoodPlatform.SeasonChanged	Published when a Season is created/updated/deleted.
Microsoft.AgFoodPlatform.SeasonalFieldChanged.V2	Published when a Seasonal Field is created/updated/deleted.
Microsoft.AgFoodPlatform.BoundaryChanged.V2	Published when a Boundary is created/updated/deleted.
Microsoft.AgFoodPlatform.CropChanged	Published when a Crop is created/updated/deleted.
Microsoft.AgFoodPlatform.CropProductChanged	Published when a Crop Product is created /updated/deleted.
Microsoft.AgFoodPlatform.AttachmentChanged.V2	Published when an Attachment is created/updated/deleted.
Microsoft.AgFoodPlatform.ManagementZoneChanged.V2	Published when a Management Zone is created/updated/deleted.
Microsoft.AgFoodPlatform.ZoneChanged.V2	Published when an Zone is created/updated/deleted.

Satellite data related event types (Preview)

Event Name	Description
Microsoft.AgFoodPlatform.SatelliteDataIngestionJobStatusChanged.V2	Published when a satellite data ingestion job's status is changed, for example, job is created, has progressed or completed.

Weather data related event types (Preview)

Event Name	Description
Microsoft.AgFoodPlatform.WeatherDataIngestionJobStatusChanged.V2	Published when a weather data ingestion job's status is changed, for example, job is created, has progressed or completed.
Microsoft.AgFoodPlatform.WeatherDataRefresherJobStatusChanged.V2	Published when a weather data refresher job status is changed, for example, job is created, has progressed or completed.

Farm activities data related event types (Preview)

Event Name	Description
Microsoft.AgFoodPlatform.ApplicationDataChanged.V2	Published when an Application Data is created/updated/deleted.
Microsoft.AgFoodPlatform.HarvestDataChanged.V2	Published when a Harvesting Data is created/updated/deleted.
Microsoft.AgFoodPlatform.TillageDataChanged.V2	Published when a Tillage Data is created/updated/deleted.
Microsoft.AgFoodPlatform.PlantingDataChanged.V2	Published when a Planting Data is created/updated/deleted.
Microsoft.AgFoodPlatform.ImageProcessingRasterizeJobStatusChanged.V2	Published when an image-processing rasterizes job's status is changed, for example, job is created, has progressed or completed.
Microsoft.AgFoodPlatform.FarmOperationDataIngestionJobStatusChanged.V2	Published when a farm operations data ingestion job's status is changed, for example, job is created, has progressed or completed.

Sensor data related event types (Preview)

Event Name	Description
Microsoft.AgFoodPlatform.SensorMappingChanged.V2	Published when a Sensor Mapping is created/updated/deleted.
Microsoft.AgFoodPlatform.SensorPartnerIntegrationChanged.V2	Published when a Sensor Partner Integration is created/updated/deleted.
Microsoft.AgFoodPlatform.DeviceDataModelChanged	Published when Device Data Model is created/updated/deleted.
Microsoft.AgFoodPlatform.DeviceChanged	Published when a Device is created/updated/deleted.
Microsoft.AgFoodPlatform.SensorDataModelChanged	Published when a Sensor Data Model is created/updated/deleted.
Microsoft.AgFoodPlatform.SensorChanged	Published when a Sensor is created/updated/deleted.

Insight and observations related event types (Preview)

Event Name	Description
Microsoft.AgFoodPlatform.PrescriptionChanged.V2	Published when a Prescription is created/updated/deleted.
Microsoft.AgFoodPlatform.PrescriptionMapChanged.V2	Published when a Prescription Map is created/updated/deleted.
Microsoft.AgFoodPlatform.PlantTissueAnalysisChanged.V2	Published when a Plant Tissue Analysis data is created/updated/deleted.
Microsoft.AgFoodPlatform.NutrientAnalysisChanged.V2	Published when a Nutrient Analysis data is created/updated/deleted.
Microsoft.AgFoodPlatform.InsightChanged.V2	Published when an Insight is created/updated/deleted.
Microsoft.AgFoodPlatform.InsightAttachmentChanged.V2	Published when an Insight Attachment is created/updated/deleted.

Model inference jobs related event types (Preview)

Event Name	Description
Microsoft.AgFoodPlatform.BiomassModelJobStatusChanged.V2	Published when a Biomass Model job's status is changed, for example, job is created, has progressed or completed.
Microsoft.AgFoodPlatform.SoilMoistureModelJobStatusChanged.V2	Published when a Soil Moisture Model job's status is changed, for example, job is created, has progressed or completed.
Microsoft.AgFoodPlatform.SensorPlacementModelJobStatusChanged.V2	Published when a Sensor Placement Model job's status is changed, for example, job is created, has progressed or completed.

Example events

Cloud event schema

The following example show schema for Microsoft.AgFoodPlatform.PartyChanged:

[
  {
      "data": {
        "actionType": "Deleted",
        "modifiedDateTime": "2022-10-17T18:43:37Z",
        "eTag": "0000000000-0000-0000-0000-0000000000000",
        "properties": {
        "key1": "value1",
        "key2": 123.45
        },
        "id": "<YOUR-PARTY-ID>",
        "createdDateTime": "2022-10-17T18:43:30Z"
      },
      "id": "000000000-0000-0000-0000-0000000000000",
      "source": "/subscriptions/{SUBSCRIPTION-ID}/resourceGroups/{RESOURCE-GROUP-NAME}/providers/Microsoft.AgFoodPlatform/farmBeats/{YOUR-RESOURCE-NAME}",
      "subject": "/parties/<YOUR-PARTY-ID>",
      "type": "Microsoft.AgFoodPlatform.PartyChanged",
      "specversion":"1.0",
      "time": "2022-10-17T18:43:37.3306735Z"
    }
]

Event Grid event schema

The following example show schema for Microsoft.AgFoodPlatform.PartyChanged:

[
  {
      "data": {
        "actionType": "Deleted",
        "modifiedDateTime": "2022-10-17T18:43:37Z",
        "eTag": "0000000-0000-0000-0000-000000000000",
        "properties": {
        "key1": "value1",
        "key2": 123.45
        },
        "id": "<YOUR-PARTY-ID>",
        "createdDateTime": "2022-10-17T18:43:30Z"
      },
      "id": "0000000-0000-0000-0000-00000000000",
      "topic": "/subscriptions/{SUBSCRIPTION-ID}/resourceGroups/{RESOURCE-GROUP-NAME}/providers/Microsoft.AgFoodPlatform/farmBeats/{YOUR-RESOURCE-NAME}",
      "subject": "/parties/<YOUR-PARTY-ID>",
      "eventType": "Microsoft.AgFoodPlatform.PartyChanged",
      "dataVersion": "1.0",
      "metadataVersion": "1",
      "eventTime": "2022-10-17T18:43:37.3306735Z"
    }
]

---

Event properties

Cloud event schema

An event has the following top-level data:

Property	Type	Description
source	string	Full resource path to the event source. This field isn't writeable. Event Grid provides this value.
subject	string	Publisher-defined path to the event subject.
type	string	One of the registered event types for this event source.
time	string	The time the event is generated based on the provider's UTC time.
id	string	Unique identifier for the event.
data	object	App Configuration event data.
specversion	string	CloudEvents schema specification version.

Event Grid event schema

An event has the following top-level data:

Property	Type	Description
topic	string	Full resource path to the event source. This field isn't writeable. Event Grid provides this value.
subject	string	Publisher-defined path to the event subject.
eventType	string	One of the registered event types for this event source.
eventTime	string	The time the event is generated based on the provider's UTC time.
id	string	Unique identifier for the event.
data	object	App Configuration event data.
dataVersion	string	The schema version of the data object. The publisher defines the schema version.
metadataVersion	string	The schema version of the event metadata. Event Grid defines the schema of the top-level properties. Event Grid provides this value.

---

The data object has the following common properties:

For resource change related event types

Property	Type	Description
id	String	Unique ID of resource.
actionType	String	Indicates the change, which triggered publishing of the event. Applicable values are created, updated, deleted.
properties	Object	It contains user defined key–value pairs.
modifiedDateTime	String	Indicates the time at which the event was last modified.
createdDateTime	String	Indicates the time at which the resource was created.
status	String	Contains the user defined status of the object.
eTag	String	Implements optimistic concurrency.
description	string	Textual description of the resource.
name	string	Name to identify resource.

For job status change related event types

Property	Type	Description
id	String	Unique ID of the job.
name	string	User-defined name of the job.
status	string	Various states a job can be in.
isCancellationRequested	boolean	Flag that gets set when job cancellation is requested.
description	string	Textual description of the job.
partyId	string	Party ID for which job was created.
message	string	Status message to capture more details of the job.
lastActionDateTime	date-time	Date-time when last action was taken on the job, sample format: yyyy-MM-ddTHH:mm:ssZ.
createdDateTime	date-time	Date-time when resource was created, sample format: yyyy-MM-ddTHH:mm:ssZ.
properties	Object	It contains user defined key-value pairs.

Next steps

• For an introduction to Azure Event Grid, see What is Event Grid?
• For more information about how to create an Azure Event Grid subscription, see Event Grid subscription schema.