Merge pull request #283082 from lbpudi/main

Control plane access and weather

Author: v-ccolin

articles/data-manager-for-agri/concepts-byol-and-credentials.md

@@ -82,6 +82,9 @@ Add an access policy in the key vault for your Data Manager for Agriculture inst
 ### Step 5: Invoke control plane API call
 Use the [API call](/rest/api/data-manager-for-agri/controlplane-version2023-06-01-preview/data-connectors) to specify connector credentials. Key vault URI/ key name/ key version can be found after creating secret as shown in the following figure.
 
+> [!NOTE] 
+>For making control plane calls, you need owner access on ADMA resource scope.
+
 :::image type="content" source="./media/concepts-byol-and-credentials/details-key-vault.png" alt-text="Screenshot showing where key name and key version is available.":::
 
 #### Following values should be used for the connectors while invoking above APIs:

articles/data-manager-for-agri/concepts-ingest-weather-data.md

@@ -24,7 +24,6 @@ Here are some notes about the behavior of provider-agnostic APIs:
 * You can request weather data for up to 50 locations in a single call.
 * Forecast data isn't older than 15 minutes. Data for current conditions isn't older than 10 minutes.
 * After the initial call is made for a location, the data is cached for the defined time to live (TTL).
-* To keep the cache warm, you can use the `apiFreshnessTimeInMinutes` parameter in the weather extension. The platform keeps a job running for the defined amount of time and updates the cache. The default value is zero, which means the cache isn't kept warm by default.
 
 The following sections provide the commands to fetch weather data and ingest it into Azure Data Manager for Agriculture.
 
@@ -65,50 +64,6 @@ Here's sample output for the installation command:
 
 After you finish installing the extension, you can ingest weather data.
 
-If you want to update `apiFreshnessTimeInMinutes`, update the extension by using the following PowerShell command. Replace all values within angle brackets with your respective environment values.
-
-```azurepowershell-interactive
-armclient put /subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/<extensionid>?api-version=2021-09-01-preview '{"additionalApiProperties": {""15-day-daily-forecast"": {"apiFreshnessTimeInMinutes": <time>}, ""currents-on-demand"": {"apiFreshnessTimeInMinutes": <time>},""15-day-hourly-forecast"":{"apiFreshnessTimeInMinutes": <time>}}}'
-```
-
-The preceding update command merges patch operations. It updates freshness time for only the API mentioned in the command and retains the freshness time values for other APIs as they were before.  
-
-Here's sample output for the update command:
-
-```json
-{
-  "id": "/subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/extensions/<extensionid>",
-  "type": "Microsoft.AgFoodPlatform/farmBeats/extensions",
-  "systemData": {
-    "createdBy": "50e74af5-3b8f-4a8c-9521-4f506b4e0c16",
-    "createdByType": "User",
-    "createdAt": "2022-10-10T21:28:05Z",
-    "lastModifiedBy": "50e74af5-3b8f-4a8c-9521-4f506b4e0c16",
-    "lastModifiedByType": "User",
-    "lastModifiedAt": "2022-11-08T13:10:17Z"
-  },
-  "properties": {
-    "extensionId": "provider",
-    "extensionCategory": "Weather",
-    "installedExtensionVersion": "2.0",
-    "extensionApiDocsLink": "https://go.microsoft.com/fwlink/?linkid=2192974",
-    "additionalApiProperties": {
-      "15-day-daily-forecast": {
-        "apiFreshnessTimeInMinutes": 1600
-      },
-      "currents-on-demand": {
-        "apiFreshnessTimeInMinutes": 1600
-      },
-       "15-day-hourly-forecast": {
-        "apiFreshnessTimeInMinutes": 1600
-      }
-    }
-  },
-  "eTag": "ea0261d0-0000-0700-0000-636a55390000",
-  "name": "provider"
-}
-```
-
 ## Step 2: Fetch weather data
 
 After you get the credentials that are required to access the APIs, you need to call the [Weather Data API](/rest/api/data-manager-for-agri/dataplane-version2022-11-01-preview/weather-data) to fetch weather data.

articles/data-manager-for-agri/how-to-set-up-audit-logs.md

@@ -221,6 +221,8 @@ The following table lists the **operationName** values and corresponding REST AP
 
 ### ApplicationAuditLogs
 The write and delete logs present in other categories are also present in this category. The difference between the logs in this category and other categories for the same API call is that, ApplicationAuditLogs doesn't log the request-body, while in other categories the request-body is populated. Use the correlation-id to relate logs of two different categories to get more details. Some of the control plane operations that aren't part of the rest of the categories are listed below.
+> [!NOTE] 
+>For making control plane calls, you need owner access on ADMA resource scope.
 
 |operationName|
 | --- |