Fix the api descrption (#31188)

* decription fix. * remove \n * fix invalid armId. * fix \n * fix arm id. * Create sdk-suppressions.yaml * Update specification/standbypool/StandbyPool.Management/sdk-suppressions.yaml * edit cSpell.json. * edit cSpell.json. --------- Co-authored-by: kazrael2119 <98569699+kazrael2119@users.noreply.github.com>
Azure · Jan 10, 2025 · e524180 · e524180
1 parent dc7fc98
commit e524180
Show file tree

Hide file tree

Showing 13 changed files with 28 additions and 14 deletions.
diff --git a/cSpell.json b/cSpell.json
@@ -1791,6 +1791,12 @@
                 "multiapiscript",
                 "modelerfour"
             ]
+        },
+        {
+            "filename": "**/specification/standbypool/StandbyPool.Management/sdk-suppressions.yaml",
+            "words": [
+                "standbypool"
+            ]
         }
     ],
     "enableFiletypes": [

diff --git a/...bypool/StandbyPool.Management/examples/2024-03-01-preview/StandbyVirtualMachines_Get.json b/...bypool/StandbyPool.Management/examples/2024-03-01-preview/StandbyVirtualMachines_Get.json
@@ -12,7 +12,7 @@
     "200": {
       "body": {
         "properties": {
-          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
           "provisioningState": "Succeeded"
         },
         "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/...es/2024-03-01-preview/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json b/...es/2024-03-01-preview/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json
@@ -13,7 +13,7 @@
         "value": [
           {
             "properties": {
-              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
               "provisioningState": "Succeeded"
             },
             "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/...on/standbypool/StandbyPool.Management/examples/2024-03-01/StandbyVirtualMachines_Get.json b/...on/standbypool/StandbyPool.Management/examples/2024-03-01/StandbyVirtualMachines_Get.json
@@ -12,7 +12,7 @@
     "200": {
       "body": {
         "properties": {
-          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
           "provisioningState": "Succeeded"
         },
         "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/...t/examples/2024-03-01/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json b/...t/examples/2024-03-01/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json
@@ -13,7 +13,7 @@
         "value": [
           {
             "properties": {
-              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
               "provisioningState": "Succeeded"
             },
             "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/specification/standbypool/StandbyPool.Management/sdk-suppressions.yaml b/specification/standbypool/StandbyPool.Management/sdk-suppressions.yaml
@@ -0,0 +1,8 @@
+suppressions:
+  azure-sdk-for-js:
+    - package: '@azure/arm-standbypool'
+      breaking-changes:
+      - Enum KnownOrigin no longer has value System
+      - Enum KnownOrigin no longer has value User
+      - Enum KnownOrigin no longer has value UserSystem
+      - Enum KnownRefillPolicy no longer has value Always
diff --git a/specification/standbypool/StandbyPool.Management/standbyVirtualMachinePoolRuntimeView.tsp b/specification/standbypool/StandbyPool.Management/standbyVirtualMachinePoolRuntimeView.tsp
@@ -37,7 +37,7 @@ model StandbyVirtualMachinePoolRuntimeViewResource
 @doc("Contains information about a standby pool as last known by the StandbyPool resource provider.")
 @added(Microsoft.StandbyPool.Versions.`2024-03-01-preview`)
 model StandbyVirtualMachinePoolRuntimeViewResourceProperties {
-  @doc("A list containing the counts of virtual machines in each possible power state for each zone if enabled, as known by the StandbyPool resource provider.\nIf zones are not enabled on the attached VMSS, the list will contain a single entry with null zone values.\nNote: any updates to pool resources outside of StandbyPoolRP (i.e deleting a VM through portal) are not reflected here.\nNote: any resources in the Running state may still be installing extensions / not fully provisioned.")
+  @doc("A list containing the counts of virtual machines in each possible power state for each zone if enabled, as known by the StandbyPool resource provider. If zones are not enabled on the attached VMSS, the list will contain a single entry without zone values. Note: any resources in the Running state may still be installing extensions / not fully provisioned.")
   @visibility("read")
   @extension("x-ms-identifiers", [])
   instanceCountSummary: VirtualMachineInstanceCountSummary[];
@@ -48,7 +48,7 @@ model StandbyVirtualMachinePoolRuntimeViewResourceProperties {
 }
 
 @added(Microsoft.StandbyPool.Versions.`2024-03-01-preview`)
-@doc("Contains the counts of VMs in each power state in a given zone, fault domain, as known by the StandbyPool resource provider.\nNote: any updates to pool resources outside of StandbyPoolRP (i.e deleting a VM through portal) are not reflected here.\nNote: any resources in the Running state may still be installing extensions / not fully provisioned.")
+@doc("Contains the counts of VMs in each power state in a given zone, fault domain, as known by the StandbyPool resource provider. Note: any resources in the Running state may still be installing extensions / not fully provisioned.")
 model VirtualMachineInstanceCountSummary {
   @doc("The zone that the provided counts are in. This is null if zones are not enabled on the attached VMSS.")
   zone?: int64;

diff --git a/...Microsoft.StandbyPool/preview/2024-03-01-preview/examples/StandbyVirtualMachines_Get.json b/...Microsoft.StandbyPool/preview/2024-03-01-preview/examples/StandbyVirtualMachines_Get.json
@@ -12,7 +12,7 @@
     "200": {
       "body": {
         "properties": {
-          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
           "provisioningState": "Succeeded"
         },
         "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/...3-01-preview/examples/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json b/...3-01-preview/examples/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json
@@ -13,7 +13,7 @@
         "value": [
           {
             "properties": {
-              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
               "provisioningState": "Succeeded"
             },
             "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/...bypool/resource-manager/Microsoft.StandbyPool/preview/2024-03-01-preview/standbypool.json b/...bypool/resource-manager/Microsoft.StandbyPool/preview/2024-03-01-preview/standbypool.json
@@ -1535,7 +1535,7 @@
       "properties": {
         "instanceCountSummary": {
           "type": "array",
-          "description": "A list containing the counts of virtual machines in each possible power state for each zone if enabled, as known by the StandbyPool resource provider.\nIf zones are not enabled on the attached VMSS, the list will contain a single entry with null zone values.\nNote: any updates to pool resources outside of StandbyPoolRP (i.e deleting a VM through portal) are not reflected here.\nNote: any resources in the Running state may still be installing extensions / not fully provisioned.",
+          "description": "A list containing the counts of virtual machines in each possible power state for each zone if enabled, as known by the StandbyPool resource provider. If zones are not enabled on the attached VMSS, the list will contain a single entry without zone values. Note: any resources in the Running state may still be installing extensions / not fully provisioned.",
           "items": {
             "$ref": "#/definitions/VirtualMachineInstanceCountSummary"
           },
@@ -1634,7 +1634,7 @@
     },
     "VirtualMachineInstanceCountSummary": {
       "type": "object",
-      "description": "Contains the counts of VMs in each power state in a given zone, fault domain, as known by the StandbyPool resource provider.\nNote: any updates to pool resources outside of StandbyPoolRP (i.e deleting a VM through portal) are not reflected here.\nNote: any resources in the Running state may still be installing extensions / not fully provisioned.",
+      "description": "Contains the counts of VMs in each power state in a given zone, fault domain, as known by the StandbyPool resource provider. Note: any resources in the Running state may still be installing extensions / not fully provisioned.",
       "properties": {
         "zone": {
           "type": "integer",

diff --git a/...-manager/Microsoft.StandbyPool/stable/2024-03-01/examples/StandbyVirtualMachines_Get.json b/...-manager/Microsoft.StandbyPool/stable/2024-03-01/examples/StandbyVirtualMachines_Get.json
@@ -12,7 +12,7 @@
     "200": {
       "body": {
         "properties": {
-          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+          "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
           "provisioningState": "Succeeded"
         },
         "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/...e/2024-03-01/examples/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json b/...e/2024-03-01/examples/StandbyVirtualMachines_ListByStandbyVirtualMachinePoolResource.json
@@ -13,7 +13,7 @@
         "value": [
           {
             "properties": {
-              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/provider/Microsoft.Compute/virtualMachines/virtualMachine",
+              "virtualMachineResourceId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachines/virtualMachine",
               "provisioningState": "Succeeded"
             },
             "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool/standbyVirtualMachines/virtualMachine",

diff --git a/...ion/standbypool/resource-manager/Microsoft.StandbyPool/stable/2024-03-01/standbypool.json b/...ion/standbypool/resource-manager/Microsoft.StandbyPool/stable/2024-03-01/standbypool.json
@@ -1535,7 +1535,7 @@
       "properties": {
         "instanceCountSummary": {
           "type": "array",
-          "description": "A list containing the counts of virtual machines in each possible power state for each zone if enabled, as known by the StandbyPool resource provider.\nIf zones are not enabled on the attached VMSS, the list will contain a single entry with null zone values.\nNote: any updates to pool resources outside of StandbyPoolRP (i.e deleting a VM through portal) are not reflected here.\nNote: any resources in the Running state may still be installing extensions / not fully provisioned.",
+          "description": "A list containing the counts of virtual machines in each possible power state for each zone if enabled, as known by the StandbyPool resource provider. If zones are not enabled on the attached VMSS, the list will contain a single entry without zone values. Note: any resources in the Running state may still be installing extensions / not fully provisioned.",
           "items": {
             "$ref": "#/definitions/VirtualMachineInstanceCountSummary"
           },
@@ -1634,7 +1634,7 @@
     },
     "VirtualMachineInstanceCountSummary": {
       "type": "object",
-      "description": "Contains the counts of VMs in each power state in a given zone, fault domain, as known by the StandbyPool resource provider.\nNote: any updates to pool resources outside of StandbyPoolRP (i.e deleting a VM through portal) are not reflected here.\nNote: any resources in the Running state may still be installing extensions / not fully provisioned.",
+      "description": "Contains the counts of VMs in each power state in a given zone, fault domain, as known by the StandbyPool resource provider. Note: any resources in the Running state may still be installing extensions / not fully provisioned.",
       "properties": {
         "zone": {
           "type": "integer",