update applicationgateway tags

Author: mcgallan

.github/skills/azure-typespec-author/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: azure-typespec-author
+description: "Use this skill when authoring or modifying Azure TypeSpec API specifications in the azure-rest-api-specs repository. Triggers for any TypeSpec related tasks, including: adding new API versions (preview or stable), creating or modifying ARM resources or data-plane services, defining models/enums/unions, adding operations to resources or interfaces, updating TypeSpec definitions for Azure services, or fixing TypeSpec compilation errors. Keywords: TypeSpec, tsp, ARM, resource-manager, data-plane, API version, preview version, stable version, Azure resource, Azure service, resource provider."
+---
+
+# Azure TypeSpec Author
+
+## Operating Principles (non-negotiable)
+
+1. **Do not edit any files until you have required inputs and have retrieved solution** Use the `azure-sdk-mcp/azsdk_typespec_generate_authoring_plan` tool.
+2. Make **minimal, scoped edits** to satisfy the request. Avoid refactors unless explicitly asked.
+3. After edits, **validate** (compile / lint / emitter checks if available) and report results.
+4. Always provide **references** (titles/sections/links) from retrieved context that justify the recommended approach.
+
+## Required Inputs Checklist (ask if missing)
+Before planning edits, ensure you have:
+- **Spec root / folder** (where the TypeSpec project lives)
+- **Service Type**: management-plane vs data-plane
+- **Existing API versions**
+- **Target API version(s)** (existing or new; preview/stable)
+- **Intent**: add/modify/fix (resource, operation, model, decorator, versioning, etc.)
+- **Target resource/interface/operation names** (if known)
+- **Constraints**: breaking-change limits, naming/versioning rules, emitter targets, etc.
+
+If any of the above is missing, ask **up to 6 concise questions** and stop.
+
+## Workflow
+
+When encountering a TypeSpec authoring cases, follow this workflow (must follow exactly):
+
+### Step 1 — Intake & Clarification (no file edits)
+- Read the user request.
+- Extract any provided values for the Required Inputs Checklist.
+- If missing, ask concise questions and wait for the user reply. ask the questions one by one, with each question confirming a specific piece of information.
+
+### Step 2 — Retrieve Solution
+
+Call the `azure-sdk-mcp/azsdk_typespec_generate_authoring_plan` tool:
+
+- Provide the best available arguments derived from the intake:
+  - Service Type
+  - apiVersion / versions
+  - intent
+  - resource/interface/operation names
+  - key constraints / keywords
+- Use user request (verbatim) as parameter `request`
+- Read the relative code (.tsp) for this request, and put it as `additionalInformation` parameter
+- use typespec project root path as `typeSpecProjectRootPath` parameter
+
+### Step 3 — Apply Changes (edits)
+
+Only after a grounded plan is produced:
+
+- Make the minimal changes required in the relevant `.tsp` files
+- Prefer following the official template/pattern from RETRIEVED_CONTEXT even if the repo has older patterns
+
+### Step 4 — Validate
+
+- Run `azure-sdk-mcp/azsdk_run_typespec_validation` tool to run validation
+- If validation fails, fix forward with minimal changes
+
+### Step 5 — Summarize
+
+Return:
+
+- Files changed (list)
+- What changed and why (brief)
+- Validation results (pass/fail + key output)
+- References from RETRIEVED_CONTEXT used to justify important decisions
+
+---

.vscode/mcp.json

@@ -1,9 +1,10 @@
-{  
+{
     "servers": {
       "azure-sdk-mcp": {
         "type": "stdio",
-        "command": "pwsh",        
-        "args": ["${workspaceFolder}/eng/common/mcp/azure-sdk-mcp.ps1", "-Run"]
+        "command": "C:\\Users\\v-zihewang\\Downloads\\azsdk",
+        "args": ["start"],
+
     },
   }
-} 
+}

specification/network/resource-manager/Microsoft.Network/Network/ApplicationGateway.tsp

@@ -47,16 +47,18 @@ model ApplicationGateway extends Resource {
 
 #suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
 @Azure.ResourceManager.Legacy.feature(Features.applicationGateway)
-@armResourceOperations
+@armResourceOperations(#{omitTags: true})
 interface ApplicationGateways {
   /**
    * Gets the specified application gateway.
    */
+  @tag("ApplicationGateways")
   get is ArmResourceRead<ApplicationGateway, Error = CloudError>;
 
   /**
    * Creates or updates the specified application gateway.
    */
+  @tag("ApplicationGateways")
   createOrUpdate is ArmResourceCreateOrReplaceAsync<
     ApplicationGateway,
     Error = CloudError
@@ -65,6 +67,7 @@ interface ApplicationGateways {
   /**
    * Updates the specified application gateway tags.
    */
+  @tag("ApplicationGateways")
   @patch(#{ implicitOptionality: false })
   updateTags is ArmCustomPatchSync<
     ApplicationGateway,
@@ -76,6 +79,7 @@ interface ApplicationGateways {
    * Deletes the specified application gateway.
    */
   #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @tag("ApplicationGateways")
   delete is ArmResourceDeleteWithoutOkAsync<
     ApplicationGateway,
     Response = ArmDeletedResponse | ArmDeleteAcceptedLroResponse | ArmDeletedNoContentResponse,
@@ -85,16 +89,19 @@ interface ApplicationGateways {
   /**
    * Lists all application gateways in a resource group.
    */
+  @tag("ApplicationGateways")
   list is ArmResourceListByParent<ApplicationGateway, Error = CloudError>;
 
   /**
    * Gets all the application gateways in a subscription.
    */
+  @tag("ApplicationGateways")
   listAll is ArmListBySubscription<ApplicationGateway, Error = CloudError>;
 
   /**
    * Starts the specified application gateway.
    */
+  @tag("ApplicationGateways")
   start is ArmResourceActionAsync<
     ApplicationGateway,
     void,
@@ -107,6 +114,7 @@ interface ApplicationGateways {
   /**
    * Stops the specified application gateway in a resource group.
    */
+  @tag("ApplicationGateways")
   stop is ArmResourceActionAsync<
     ApplicationGateway,
     void,
@@ -119,6 +127,7 @@ interface ApplicationGateways {
   /**
    * Gets the backend health of the specified application gateway in a resource group.
    */
+  @tag("ApplicationGateways")
   @action("backendhealth")
   backendHealth is ArmResourceActionAsync<
     ApplicationGateway,
@@ -137,6 +146,7 @@ interface ApplicationGateways {
   /**
    * Gets the backend health for given combination of backend pool and http setting of the specified application gateway in a resource group.
    */
+  @tag("ApplicationGateways")
   @action("getBackendHealthOnDemand")
   backendHealthOnDemand is ArmResourceActionAsync<
     ApplicationGateway,
@@ -157,6 +167,7 @@ interface ApplicationGateways {
    */
   #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
   @operationId("ApplicationGatewayPrivateLinkResources_List")
+  @tag("ApplicationGatewayPrivateLinkResources")
   @list
   @get
   @action("privateLinkResources")

specification/network/resource-manager/Microsoft.Network/Network/ApplicationGatewayAvailableSslOptions.tsp

@@ -51,12 +51,13 @@ alias ApplicationGatewayAvailableSslOptionsOps = Azure.ResourceManager.Legacy.Ro
 
 #suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
 @Azure.ResourceManager.Legacy.feature(Features.applicationGateway)
-@armResourceOperations(#{ allowStaticRoutes: true })
+@armResourceOperations(#{ allowStaticRoutes: true, omitTags: true })
 interface ApplicationGatewayAvailableSslOptionsOperationGroup {
   /**
    * Lists available Ssl options for configuring Ssl policy.
    */
   #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @tag("ApplicationGateways")
   @operationId("ApplicationGateways_ListAvailableSslOptions")
   @autoRoute
   listAvailableSslOptions is ArmResourceRead<
@@ -69,6 +70,7 @@ interface ApplicationGatewayAvailableSslOptionsOperationGroup {
    * Lists all SSL predefined policies for configuring Ssl policy.
    */
   #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @tag("ApplicationGateways")
   @operationId("ApplicationGateways_ListAvailableSslPredefinedPolicies")
   @list
   @get
@@ -86,6 +88,7 @@ interface ApplicationGatewayAvailableSslOptionsOperationGroup {
    * Gets Ssl predefined policy with the specified policy name.
    */
   #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @tag("ApplicationGateways")
   @operationId("ApplicationGateways_GetSslPredefinedPolicy")
   @get
   @route("/subscriptions/{subscriptionId}/providers/Microsoft.Network/applicationGatewayAvailableSslOptions/default/predefinedPolicies/{predefinedPolicyName}")

specification/network/resource-manager/Microsoft.Network/Network/ApplicationGatewayWafDynamicManifestResult.tsp

@@ -61,12 +61,13 @@ alias ApplicationGatewayWafDynamicManifestResultOps = Azure.ResourceManager.Lega
 
 #suppress "@azure-tools/typespec-azure-core/no-legacy-usage" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
 @Azure.ResourceManager.Legacy.feature(Features.applicationGateway)
-@armResourceOperations
+@armResourceOperations(#{omitTags: true})
 interface ApplicationGatewayWafDynamicManifestResults {
   /**
    * Gets the regional application gateway waf manifest.
    */
   #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @tag("ApplicationGateways")
   @operationId("ApplicationGatewayWafDynamicManifestsDefault_Get")
   get is ApplicationGatewayWafDynamicManifestResultOps.Read<
     ApplicationGatewayWafDynamicManifestResult,
@@ -77,6 +78,7 @@ interface ApplicationGatewayWafDynamicManifestResults {
    * Gets the regional application gateway waf manifest.
    */
   #suppress "@azure-tools/typespec-azure-core/no-openapi" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @tag("ApplicationGateways")
   @operationId("ApplicationGatewayWafDynamicManifests_Get")
   applicationGatewayWafDynamicManifestsGet is ArmResourceListByParent<
     ApplicationGatewayWafDynamicManifestResult,

specification/network/resource-manager/Microsoft.Network/Network/diff-output/ApplicationGateway/API_CHANGES.md

@@ -4,13 +4,9 @@
 
 | Path | Change Type | Value |
 |------|------------|-------|
-| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableRequestHeaders'].get.tags__deleted` | deleted | `["ApplicationGateways"]` |
-| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableResponseHeaders'].get.tags__deleted` | deleted | `["ApplicationGateways"]` |
-| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableServerVariables'].get.tags__deleted` | deleted | `["ApplicationGateways"]` |
-| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableWafRuleSets'].get.tags__deleted` | deleted | `["ApplicationGateways"]` |
-| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/locations/{location}/applicationGatewayWafDynamicManifests'].get.tags__added` | added | `["ApplicationGatewayWafDynamicManifestResults"]` |
-| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/locations/{location}/applicationGatewayWafDynamicManifests/dafault'].get.tags__added` | added | `["ApplicationGatewayWafDynamicManifestResults"]` |
-| `tags__added` | added | `[{"name":"ApplicationGateways"},{"name":"ApplicationGatewayAvailableSslOptionsOperationGroup"},{"nam...` |
+| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/locations/{location}/applicationGatewayWafDynamicManifests'].get.tags__added` | added | `["ApplicationGateways"]` |
+| `paths['/subscriptions/{subscriptionId}/providers/microsoft.Network/locations/{location}/applicationGatewayWafDynamicManifests/dafault'].get.tags__added` | added | `["ApplicationGateways"]` |
+| `tags__added` | added | `[{"name":"ApplicationGateways"},{"name":"ApplicationGatewayPrivateLinkResources"},{"name":"Applicati...` |
 
 ### Changes for `$ref`
 

specification/network/resource-manager/Microsoft.Network/Network/diff-output/ApplicationGateway/diff.json

@@ -4,24 +4,18 @@
       "name": "ApplicationGateways"
     },
     {
-      "name": "ApplicationGatewayAvailableSslOptionsOperationGroup"
+      "name": "ApplicationGatewayPrivateLinkResources"
     },
     {
       "name": "ApplicationGatewayPrivateEndpointConnections"
     },
-    {
-      "name": "ApplicationGatewayWafDynamicManifestResults"
-    },
     {
       "name": "WebApplicationFirewallPolicies"
     }
   ],
   "paths": {
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableRequestHeaders": {
       "get": {
-        "tags__deleted": [
-          "ApplicationGateways"
-        ],
         "responses": {
           "200": {
             "schema": {
@@ -45,9 +39,6 @@
     },
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableResponseHeaders": {
       "get": {
-        "tags__deleted": [
-          "ApplicationGateways"
-        ],
         "responses": {
           "200": {
             "schema": {
@@ -71,9 +62,6 @@
     },
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableServerVariables": {
       "get": {
-        "tags__deleted": [
-          "ApplicationGateways"
-        ],
         "responses": {
           "200": {
             "schema": {
@@ -97,16 +85,6 @@
     },
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableSslOptions/default": {
       "get": {
-        "tags": [
-          [
-            "-",
-            "ApplicationGateways"
-          ],
-          [
-            "+",
-            "ApplicationGatewayAvailableSslOptionsOperationGroup"
-          ]
-        ],
         "responses": {
           "default": {
             "schema": {
@@ -121,16 +99,6 @@
     },
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableSslOptions/default/predefinedPolicies": {
       "get": {
-        "tags": [
-          [
-            "-",
-            "ApplicationGateways"
-          ],
-          [
-            "+",
-            "ApplicationGatewayAvailableSslOptionsOperationGroup"
-          ]
-        ],
         "responses": {
           "default": {
             "schema": {
@@ -145,16 +113,6 @@
     },
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableSslOptions/default/predefinedPolicies/{predefinedPolicyName}": {
       "get": {
-        "tags": [
-          [
-            "-",
-            "ApplicationGateways"
-          ],
-          [
-            "+",
-            "ApplicationGatewayAvailableSslOptionsOperationGroup"
-          ]
-        ],
         "responses": {
           "default": {
             "schema": {
@@ -169,9 +127,6 @@
     },
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/applicationGatewayAvailableWafRuleSets": {
       "get": {
-        "tags__deleted": [
-          "ApplicationGateways"
-        ],
         "responses": {
           "default": {
             "schema": {
@@ -215,7 +170,7 @@
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/locations/{location}/applicationGatewayWafDynamicManifests": {
       "get": {
         "tags__added": [
-          "ApplicationGatewayWafDynamicManifestResults"
+          "ApplicationGateways"
         ],
         "responses": {
           "default": {
@@ -232,7 +187,7 @@
     "/subscriptions/{subscriptionId}/providers/microsoft.Network/locations/{location}/applicationGatewayWafDynamicManifests/dafault": {
       "get": {
         "tags__added": [
-          "ApplicationGatewayWafDynamicManifestResults"
+          "ApplicationGateways"
         ],
         "responses": {
           "default": {
@@ -522,16 +477,6 @@
     },
     "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.Network/applicationGateways/{applicationGatewayName}/privateLinkResources": {
       "get": {
-        "tags": [
-          [
-            "-",
-            "ApplicationGatewayPrivateLinkResources"
-          ],
-          [
-            "+",
-            "ApplicationGateways"
-          ]
-        ],
         "responses": {
           "default": {
             "schema": {