What is Azure Data Manager for Agriculture?
Adopting sustainable agriculture practices is crucial for the future of our planet—that’s why Microsoft Azure Data Manager for Agriculture was built to enable the industry to accelerate agriculture and sustainability digital solutions.
Azure Data Manager for Agriculture helps enable a more sustainable future and a more productive agriculture industry by empowering organizations to drive innovation through insight, reduce their environmental impact, optimize agriculture operations, and build that trust rooted in transparency.
With access to data and insights from the farm, organizations can drive harvest and production efficiency, reduce food waste, create nutrient dense and high-quality products, automate/improve ESG and Scope 3 emissions reporting, and provide transparency to stakeholders—all of which help building a sustainable agriculture industry that can feed the world and support the planet.
Note
Azure Data Manager for Agriculture is currently in Public Preview. For more information, see Supplemental Terms of Use for Microsoft Azure Previews. Azure Data Manager for Agriculture is provided without a service level agreement. Write to us at madma@microsoft.com for any queries.
Azure Data Manager for Agriculture REST APIs
Azure Data Manager for Agriculture REST APIs provides programmatic access to data-plane resources to create, update, read, and delete farm management, satellite, weather, sensor and farm operations resources.
The following section is a high-level overview of the services that Azure Data Manager for Agriculture offers:
Data-plane REST APIs
Base url for data-plane APIs is https://{data-manager-for-agri-resource-name}.farmbeats.azure.net, which one can find from provisioned Azure Data Manager for Agriculture resource in Azure portal
Supported data-plane API Versions
The following table lists the supported data-plane REST API versions by the Azure Data Manager for Agriculture service. The version must be specified as a query api-version in URI of every request.
| Version | Changes introduced | Retirement date |
|---|---|---|
| 2023-11-01-preview | Reference datasets support and satellite data processing flow enhancements (Latest recommended) | |
| 2023-07-01-preview | Climate FieldView Integration and geo-spatial data search support | 2024-06-01 |
| 2023-06-01-preview | Satellite/Weather Secret BYOL changes | 2023-12-01 |
| 2023-04-01-preview | Satellite BYOL changes (Limited functionalities) | 2023-10-01 |
| 2022-11-01-preview | Public Preview API version (Limited functionalities) | 2023-10-01 |
| 2021-07-31-preview | Private Preview API version (deprecated) | 2023-04-30 |
Farm Management
| Operation group | Description |
|---|---|
| Parties | Create, read, update, overlap and delete a Party resource. |
| Farms | Create, read, update and delete a Farm resource. |
| Fields | Create, read, update, search and delete a Field resource. |
| Seasonal Fields | Create, read, update, search and delete a Seasonal field resource. |
| Seasons | Create, read, update and delete a Season resource. |
| Crops | Create, read, update and delete a Crop resource. |
| Crop Products | Create, read, update and delete a Crop product resource. |
| Attachments | Create, read, update and delete an Attachment resource. |
| Zones | Create, read, update, search and delete a Zone resource. |
| Management Zones | Create, read, update and delete a Management zone resource. |
| Chemical Products | Create, read, update and delete a chemical product resource. |
| Farm Equipments | Create, read, update and delete a farm equipment resource. |
Satellite
| Operation group | Description |
|---|---|
| Scenes | Ingest, search, query and download satellite scene images/data. |
Sensor
| Operation group | Description |
|---|---|
| Device Data Models | Create, read, update and delete a Device data model (blueprint) resource. |
| Devices | Create, read, update and delete a Device resource. |
| Sensor Data Models | Create, read, update and delete a Sensor data model (blueprint) resource. |
| Sensors | Create, read, update and delete a Sensor resource. |
| Sensor Mappings | Create, read, update and delete a Sensor mapping resource. |
| Sensor Partner Integrations | Create, read, update and delete a Sensor partner integration resource. |
| Sensor Events | Egress sensor events ingested by partners |
Weather
| Operation group | Description |
|---|---|
| Weather Data | Fetch and cache weather data for multiple locations. |
Farm Operations
| Operation group | Description |
|---|---|
| Application Data | Create, read, update, search and delete an Application data resource. |
| Tillage Data | Create, read, update, search and delete a Tillage data resource. |
| Planting Data | Create, read, update, search and delete a Planting data resource. |
| Harvest Data | Create, read, update, search and delete a Harvest data resource. |
| Farm Operations | Ingest farm operations data for various operations. |
| oAuth Providers | Create, read, update and delete oAuth provider. |
| oAuth Tokens | Create connection link and read access token information. |
| Image Processing | Create an image processing rasterization job. |
Insights and Observations
| Operation group | Description |
|---|---|
| Prescriptions | Create, read, update, search and delete a Prescriptions resource. |
| Prescription Maps | Create, read, update and delete a Prescriptions map resource. |
| Plant Tissue Analyses | Create, read, update, search and delete a Plant tissue analysis resource. |
| Nutrient Analyses | Create, read, update and delete a Nutrient analysis resource. |
| Insight | Create, read, update and delete an Insight zone resource. |
| Insight Attachments | Create, read, update and delete an Insight attachment resource. |
Solution Inferences
| Operation group | Description |
|---|---|
| Solution Inference | Trigger solution inference provided by third parties to generate insights. |
Reference Datasets
| Operation group | Description |
|---|---|
| Reference Datasets | Create, read, update, search and delete a reference dataset resource. |
| Reference Dataset Records | Create, read, update, search and delete a reference dataset record resource. |
Azure Resource Manager REST APIs (Control-plane)
Base url for control-plane APIs is https://management.azure.com/
Supported control-plane API Versions
The following table lists the supported control-plane REST API versions by the Azure Data Manager for Agriculture service. The version must be specified as a query api-version in URI of every request.
| Version | Change introduced | Retirement date |
|---|---|---|
| 2023-06-01-preview | BYOL Data connectors configurations (Latest recommended) | |
| 2021-09-01-preview | Public Preview API version (Limited functionalities) | 2023-10-01 |
| 2020-05-12-preview | Private Preview API version (deprecated) | 2023-05-12 |
Control-plane operations
| Operation group | Description |
|---|---|
| Data Manager for Agriculture Resource | Create, read, update and delete a Data Manager for Agriculture resource. |
| Available Extensions | Get all extensions available in Data Manager for Agriculture. |
| Management of Extensions | Install, uninstall, upgrade extensions under a Data Manager for Agriculture resource. |
| Check Name Availability | Checks the name availability of the resource with requested resource name. |
| Operations | Lists the available operations of Microsoft.AgFoodPlatform Resource Provider. |
| Async Operation Result | Get current status of async operation. |
| Private Endpoint Connections | Private Endpoint connection management. |
| Private Link Resources | Private Link resources under a Data Manager for Agriculture resource. |
| Solutions Discoverability | Get all solution available in Data Manager for Agriculture. |
| Solutions | Install, uninstall, upgrade solution under a Data Manager for Agriculture resource. |
| DataConnectors | Create, update, delete Data Connectors under a Data Manager for Agriculture resource. |
See also
- For more information, see Azure Data Manager for Agriculture