Client Parity Refresh for New Relic (#28710)

Co-authored-by: Copilot <[email protected]>

Author: Vansh-Joshi

src/NewRelic/NewRelic.Autorest/Properties/AssemblyInfo.cs

@@ -0,0 +1,26 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the Apache License, Version 2.0 (the ""License"");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an ""AS IS"" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code
+// is regenerated.
+
+using System;
+using System.Reflection;
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+
+[assembly: System.Reflection.AssemblyCompanyAttribute("Microsoft")]
+[assembly: System.Reflection.AssemblyCopyrightAttribute("Copyright © Microsoft")]
+[assembly: System.Reflection.AssemblyProductAttribute("Microsoft Azure PowerShell")]
+[assembly: System.Reflection.AssemblyTitleAttribute("Microsoft Azure PowerShell - NewRelic")]
+[assembly: System.Reflection.AssemblyFileVersionAttribute("0.2.1")]
+[assembly: System.Reflection.AssemblyVersionAttribute("0.2.1")]
+[assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)]
+[assembly: System.CLSCompliantAttribute(false)]

src/NewRelic/NewRelic.Autorest/README.md

@@ -28,8 +28,8 @@ For information on how to develop for `Az.NewRelic`, see [how-to.md](how-to.md).
 
 ```yaml
 # pin the swagger version by using the commit id instead of branch name
-commit: 559f989d2b38bc80db762cfd277614583dddc3bb
-tag: package-2024-01-01
+commit: 91e3aca0bfa4b59a9f578959d0b214a26b90df40
+tag: package-2025-05-01-preview
 require:
 # readme.azure.noprofile.md is the common configuration file
   - $(this-folder)/../../readme.azure.noprofile.md
@@ -151,6 +151,12 @@ directive:
       subject: MonitorAppService
     set:
       subject: MonitoredAppService
+  - where:
+      verb: Invoke
+      subject: ResubscribeMonitor
+      parameter-name: -SubscriptionId1
+    set:
+      parameter-name: -NewSubscriptionId
   # customize the body property and parameter name
   # - from: source-file-csharp
   #   where: $

src/NewRelic/NewRelic.Autorest/UX/NewRelic.Observability/monitors-monitoredSubscriptions.json

@@ -1,13 +1,13 @@
 {
   "resourceType": "monitors/monitoredSubscriptions",
-  "apiVersion": "2024-01-01",
+  "apiVersion": "2025-05-01-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.newrelic"
   },
   "commands": [
     {
       "name": "Get-AzNewRelicMonitoredSubscription",
-      "description": "List the subscriptions currently being monitored by the NewRelic monitor resource.",
+      "description": "Lists all the subscriptions currently being monitored by the NewRelic monitor resource.",
       "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/monitoredSubscriptions/{configurationName}",
       "help": {
         "learnMore": {
@@ -25,7 +25,7 @@
       },
       "examples": [
         {
-          "description": "List the subscriptions currently being monitored by the NewRelic monitor resource.",
+          "description": "Lists all the subscriptions currently being monitored by the NewRelic monitor resource.",
           "parameters": [
             {
               "name": "-MonitorName",

src/NewRelic/NewRelic.Autorest/UX/NewRelic.Observability/monitors-tagRules.json

@@ -1,13 +1,13 @@
 {
   "resourceType": "monitors/tagRules",
-  "apiVersion": "2024-01-01",
+  "apiVersion": "2025-05-01-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.newrelic"
   },
   "commands": [
     {
       "name": "Get-AzNewRelicMonitorTagRule",
-      "description": "Get a TagRule",
+      "description": "Retrieves the details of the tag rules for a specific New Relic monitor resource, providing insight into its setup and status",
       "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/tagRules/{ruleSetName}",
       "help": {
         "learnMore": {
@@ -26,7 +26,7 @@
       },
       "examples": [
         {
-          "description": "Get a TagRule",
+          "description": "Retrieves the details of the tag rules for a specific New Relic monitor resource, providing insight into its setup and status",
           "parameters": [
             {
               "name": "-MonitorName",
@@ -50,7 +50,7 @@
     },
     {
       "name": "Remove-AzNewRelicMonitorTagRule",
-      "description": "Delete a TagRule",
+      "description": "Deletes a tag rule set for a given New Relic monitor resource, removing fine-grained control over observability based on resource tags",
       "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/tagRules/{ruleSetName}",
       "help": {
         "learnMore": {
@@ -69,7 +69,7 @@
       },
       "examples": [
         {
-          "description": "Delete a TagRule",
+          "description": "Deletes a tag rule set for a given New Relic monitor resource, removing fine-grained control over observability based on resource tags",
           "parameters": [
             {
               "name": "-MonitorName",

src/NewRelic/NewRelic.Autorest/UX/NewRelic.Observability/monitors.json

@@ -1,13 +1,13 @@
 {
   "resourceType": "monitors",
-  "apiVersion": "2024-01-01",
+  "apiVersion": "2025-05-01-preview",
   "learnMore": {
     "url": "https://learn.microsoft.com/powershell/module/az.newrelic"
   },
   "commands": [
     {
       "name": "Get-AzNewRelicBillingInfo",
-      "description": "Get marketplace info mapped to the given monitor.",
+      "description": "Retrieves marketplace and organization information mapped to the given New Relic monitor resource",
       "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/getBillingInfo",
       "help": {
         "learnMore": {
@@ -25,7 +25,7 @@
       },
       "examples": [
         {
-          "description": "Get marketplace info mapped to the given monitor.",
+          "description": "Retrieves marketplace and organization information mapped to the given New Relic monitor resource",
           "parameters": [
             {
               "name": "-MonitorName",
@@ -45,7 +45,7 @@
     },
     {
       "name": "Invoke-AzNewRelicHostMonitor",
-      "description": "Returns the payload that needs to be passed in the request body for installing NewRelic agent on a VM.",
+      "description": "Returns the payload that needs to be passed in the request body for installing the New Relic agent on a VM, providing the necessary configuration details",
       "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/vmHostPayloads",
       "help": {
         "learnMore": {
@@ -63,7 +63,45 @@
       },
       "examples": [
         {
-          "description": "Returns the payload that needs to be passed in the request body for installing NewRelic agent on a VM.",
+          "description": "Returns the payload that needs to be passed in the request body for installing the New Relic agent on a VM, providing the necessary configuration details",
+          "parameters": [
+            {
+              "name": "-MonitorName",
+              "value": "[Path.monitorName]"
+            },
+            {
+              "name": "-ResourceGroupName",
+              "value": "[Path.resourceGroupName]"
+            },
+            {
+              "name": "-SubscriptionId",
+              "value": "[Path.subscriptionId]"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Invoke-AzNewRelicLatestMonitorLinkedSaaS",
+      "description": "Returns the latest SaaS linked to the newrelic organization of the underlying monitor.",
+      "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/NewRelic.Observability/monitors/{monitorName}/latestLinkedSaaS",
+      "help": {
+        "learnMore": {
+          "url": "https://learn.microsoft.com/powershell/module/az.newrelic/invoke-aznewreliclatestmonitorlinkedsaas"
+        },
+        "parameterSets": [
+          {
+            "parameters": [
+              "-MonitorName <String>",
+              "-ResourceGroupName <String>",
+              "[-SubscriptionId <String>]"
+            ]
+          }
+        ]
+      },
+      "examples": [
+        {
+          "description": "Returns the latest SaaS linked to the newrelic organization of the underlying monitor.",
           "parameters": [
             {
               "name": "-MonitorName",

src/NewRelic/NewRelic.Autorest/custom/autogen-model-cmdlets/New-AzNewRelicFilteringTagObject.ps1

@@ -26,6 +26,7 @@ Microsoft.Azure.PowerShell.Cmdlets.NewRelic.Models.FilteringTag
 https://learn.microsoft.com/powershell/module/Az.NewRelic/new-aznewrelicfilteringtagobject
 #>
 function New-AzNewRelicFilteringTagObject {
+    [Microsoft.Azure.PowerShell.Cmdlets.NewRelic.ModelCmdletAttribute()]
     [OutputType('Microsoft.Azure.PowerShell.Cmdlets.NewRelic.Models.FilteringTag')]
     [CmdletBinding(PositionalBinding=$false)]
     Param(

src/NewRelic/NewRelic.Autorest/custom/autogen-model-cmdlets/New-AzNewRelicMonitoredSubscriptionObject.ps1

@@ -26,6 +26,7 @@ Microsoft.Azure.PowerShell.Cmdlets.NewRelic.Models.MonitoredSubscription
 https://learn.microsoft.com/powershell/module/Az.NewRelic/new-aznewrelicmonitoredsubscriptionobject
 #>
 function New-AzNewRelicMonitoredSubscriptionObject {
+    [Microsoft.Azure.PowerShell.Cmdlets.NewRelic.ModelCmdletAttribute()]
     [OutputType('Microsoft.Azure.PowerShell.Cmdlets.NewRelic.Models.MonitoredSubscription')]
     [CmdletBinding(PositionalBinding=$false)]
     Param(

src/NewRelic/NewRelic.Autorest/docs/Az.NewRelic.md

@@ -1,6 +1,6 @@
 ---
 Module Name: Az.NewRelic
-Module Guid: fcb6df7e-4a86-4278-88de-1e16f349572c
+Module Guid: 9594ee80-6c29-41b6-a615-e8689b5ae0dd
 Download Help Link: https://learn.microsoft.com/powershell/module/az.newrelic
 Help Version: 1.0.0.0
 Locale: en-US
@@ -12,10 +12,10 @@ Microsoft Azure PowerShell: NewRelic cmdlets
 
 ## Az.NewRelic Cmdlets
 ### [Get-AzNewRelicAccount](Get-AzNewRelicAccount.md)
-List all the existing accounts
+Lists all the New Relic accounts linked to your email address, helping you understand the existing accounts that have been created
 
 ### [Get-AzNewRelicBillingInfo](Get-AzNewRelicBillingInfo.md)
-Get marketplace info mapped to the given monitor.
+Retrieves marketplace and organization information mapped to the given New Relic monitor resource
 
 ### [Get-AzNewRelicConnectedPartnerResource](Get-AzNewRelicConnectedPartnerResource.md)
 List of all active deployments that are associated with the marketplace subscription linked to the given monitor.
@@ -24,34 +24,46 @@ List of all active deployments that are associated with the marketplace subscrip
 Get a NewRelicMonitorResource
 
 ### [Get-AzNewRelicMonitoredAppService](Get-AzNewRelicMonitoredAppService.md)
-List the app service resources currently being monitored by the NewRelic resource.
+Lists the app service resources currently being monitored by the New Relic resource, helping you understand which app services are under monitoring
 
 ### [Get-AzNewRelicMonitoredHost](Get-AzNewRelicMonitoredHost.md)
-List the compute vm resources currently being monitored by the NewRelic resource.
+Lists all VM resources currently being monitored by the New Relic monitor resource, helping you manage observability
 
 ### [Get-AzNewRelicMonitoredSubscription](Get-AzNewRelicMonitoredSubscription.md)
-List the subscriptions currently being monitored by the NewRelic monitor resource.
+Lists all the subscriptions currently being monitored by the NewRelic monitor resource.
 
 ### [Get-AzNewRelicMonitorMetricRule](Get-AzNewRelicMonitorMetricRule.md)
-Get metric rules
+Retrieves the metric rules that are configured in the New Relic monitor resource
 
 ### [Get-AzNewRelicMonitorMetricStatus](Get-AzNewRelicMonitorMetricStatus.md)
-Get metric status
+Retrieves the metric status that are configured in the New Relic monitor resource
 
 ### [Get-AzNewRelicMonitorMonitoredResource](Get-AzNewRelicMonitorMonitoredResource.md)
-List the resources currently being monitored by the NewRelic monitor resource.
+Lists all Azure resources that are currently being monitored by the specified New Relic monitor resource, providing insight into the coverage of your observability setup
 
 ### [Get-AzNewRelicMonitorTagRule](Get-AzNewRelicMonitorTagRule.md)
-Get a TagRule
+Retrieves the details of the tag rules for a specific New Relic monitor resource, providing insight into its setup and status
 
 ### [Get-AzNewRelicOrganization](Get-AzNewRelicOrganization.md)
-List all the existing organizations
+Lists all the New Relic organizations linked to your email address, helping you understand the existing organizations that have been created
 
 ### [Get-AzNewRelicPlan](Get-AzNewRelicPlan.md)
-List plans data
+Lists the plans data linked to your organization, providing an overview of the available plans
+
+### [Initialize-AzNewRelicSaaSResource](Initialize-AzNewRelicSaaSResource.md)
+Resolve the token to get the SaaS resource ID and activate the SaaS resource
 
 ### [Invoke-AzNewRelicHostMonitor](Invoke-AzNewRelicHostMonitor.md)
-Returns the payload that needs to be passed in the request body for installing NewRelic agent on a VM.
+Returns the payload that needs to be passed in the request body for installing the New Relic agent on a VM, providing the necessary configuration details
+
+### [Invoke-AzNewRelicLatestMonitorLinkedSaaS](Invoke-AzNewRelicLatestMonitorLinkedSaaS.md)
+Returns the latest SaaS linked to the newrelic organization of the underlying monitor.
+
+### [Invoke-AzNewRelicLinkMonitorSaaS](Invoke-AzNewRelicLinkMonitorSaaS.md)
+Links a new SaaS to the newrelic organization of the underlying monitor.
+
+### [Invoke-AzNewRelicResubscribeMonitor](Invoke-AzNewRelicResubscribeMonitor.md)
+Resubscribes the New Relic Organization of the underlying Monitor Resource to be billed by Azure Marketplace
 
 ### [New-AzNewRelicFilteringTagObject](New-AzNewRelicFilteringTagObject.md)
 Create an in-memory object for FilteringTag.
@@ -60,29 +72,32 @@ Create an in-memory object for FilteringTag.
 Create a NewRelicMonitorResource
 
 ### [New-AzNewRelicMonitoredSubscription](New-AzNewRelicMonitoredSubscription.md)
-Add the subscriptions that should be monitored by the NewRelic monitor resource.
+Add subscriptions to be monitored by the New Relic monitor resource, enabling observability and monitoring.
 
 ### [New-AzNewRelicMonitoredSubscriptionObject](New-AzNewRelicMonitoredSubscriptionObject.md)
 Create an in-memory object for MonitoredSubscription.
 
 ### [New-AzNewRelicMonitorTagRule](New-AzNewRelicMonitorTagRule.md)
-Create a TagRule
+Create a new set of tag rules for a specific New Relic monitor resource, determining which Azure resources are monitored based on their tags
 
 ### [Remove-AzNewRelicMonitor](Remove-AzNewRelicMonitor.md)
-Delete a NewRelicMonitorResource
+Deletes an existing New Relic monitor resource from your Azure subscription, removing the integration and stopping the observability of your Azure resources through New Relic
 
 ### [Remove-AzNewRelicMonitoredSubscription](Remove-AzNewRelicMonitoredSubscription.md)
 Deletes the subscriptions that are being monitored by the NewRelic monitor resource
 
 ### [Remove-AzNewRelicMonitorTagRule](Remove-AzNewRelicMonitorTagRule.md)
-Delete a TagRule
+Deletes a tag rule set for a given New Relic monitor resource, removing fine-grained control over observability based on resource tags
 
 ### [Switch-AzNewRelicMonitorBilling](Switch-AzNewRelicMonitorBilling.md)
-Switches the billing for NewRelic monitor resource.
+Switches the billing for the New Relic Monitor resource to be billed by Azure Marketplace
 
 ### [Update-AzNewRelicMonitoredSubscription](Update-AzNewRelicMonitoredSubscription.md)
-Add the subscriptions that should be monitored by the NewRelic monitor resource.
+Add subscriptions to be monitored by the New Relic monitor resource, enabling observability and monitoring.
+
+### [Update-AzNewRelicMonitorIngestionKey](Update-AzNewRelicMonitorIngestionKey.md)
+Refreshes the ingestion key for all monitors linked to the same account associated to the underlying monitor.
 
 ### [Update-AzNewRelicMonitorTagRule](Update-AzNewRelicMonitorTagRule.md)
-Update a TagRule
+Update the tag rules for a specific New Relic monitor resource, allowing you to modify the rules that control which Azure resources are monitored
 

src/NewRelic/NewRelic.Autorest/docs/Get-AzNewRelicAccount.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-AzNewRelicAccount
 
 ## SYNOPSIS
-List all the existing accounts
+Lists all the New Relic accounts linked to your email address, helping you understand the existing accounts that have been created
 
 ## SYNTAX
 
@@ -18,7 +18,7 @@ Get-AzNewRelicAccount -Location <String> -UserEmail <String> [-SubscriptionId <S
 ```
 
 ## DESCRIPTION
-List all the existing accounts
+Lists all the New Relic accounts linked to your email address, helping you understand the existing accounts that have been created
 
 ## EXAMPLES
 

src/NewRelic/NewRelic.Autorest/docs/Get-AzNewRelicBillingInfo.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-AzNewRelicBillingInfo
 
 ## SYNOPSIS
-Get marketplace info mapped to the given monitor.
+Retrieves marketplace and organization information mapped to the given New Relic monitor resource
 
 ## SYNTAX
 
@@ -25,7 +25,7 @@ Get-AzNewRelicBillingInfo -InputObject <INewRelicIdentity> [-DefaultProfile <PSO
 ```
 
 ## DESCRIPTION
-Get marketplace info mapped to the given monitor.
+Retrieves marketplace and organization information mapped to the given New Relic monitor resource
 
 ## EXAMPLES