[Hub Generated] Review request for Microsoft.VirtualMachineImages to …

…add version stable/2022-02-14 and stable/2023-07-01 (#26309)

* Adds base for updating Microsoft.VirtualMachineImages from version stable/2022-07-01 to version 2023-07-01

* Updates readme

* Updates API version in new specs and examples

* copying changes from ADO repo

* adding custom words

* adding distribute to ImageTemplate

* adding bracket for distrubute

* replacing CloudError with ErrorResponse

* fixing ErrorResponse typo

* added x-ms-identifiers and fixed other lintdiff

* prettier update

* removing response 200 from delete example files

* fixing distribute for ImageTemplateUpdateParameters

* Revert "fixing distribute for ImageTemplateUpdateParameters"

This reverts commit 09f692f.

* replacing distribute with properties

* prettier changes x2

custom-words.txt

@@ -2945,6 +2945,7 @@ vcsa
 vectorize
 vectorizer
 verifyx
+versioner
 versionid
 versionswithin
 vertica

specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2022-02-14/imagebuilder.json

@@ -844,6 +844,7 @@
           "type": "integer",
           "format": "int32",
           "minimum": 0,
+          "default": 0,
           "description": "Maximum number of updates to apply at a time. Omit or specify 0 to use the default (1000)"
         }
       }
@@ -982,7 +983,11 @@
       "properties": {
         "galleryImageId": {
           "type": "string",
-          "description": "Resource Id of the Shared Image Gallery image"
+          "description": "Resource Id of the Shared Image Gallery image",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
         },
         "replicationRegions": {
           "description": "A list of regions that the image will be replicated to",

specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2023-07-01/examples/CancelImageBuild.json

@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "imageTemplateName": "myImageTemplate",
+    "api-version": "2023-07-01"
+  },
+  "responses": {
+    "200": {},
+    "204": {},
+    "202": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.VirtualMachineImages/locations/{location}/operations/{operation-id}?api-version=2023-07-01"
+      }
+    }
+  }
+}

specification/imagebuilder/resource-manager/Microsoft.VirtualMachineImages/stable/2023-07-01/examples/CreateImageTemplateLinux.json

@@ -0,0 +1,147 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2023-07-01",
+    "imageTemplateName": "myImageTemplate",
+    "parameters": {
+      "location": "westus",
+      "tags": {
+        "imagetemplate_tag1": "IT_T1",
+        "imagetemplate_tag2": "IT_T2"
+      },
+      "identity": {
+        "type": "UserAssigned",
+        "userAssignedIdentities": {
+          "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {}
+        }
+      },
+      "properties": {
+        "source": {
+          "type": "ManagedImage",
+          "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+        },
+        "customize": [
+          {
+            "type": "Shell",
+            "name": "Shell Customizer Example",
+            "scriptUri": "https://example.com/path/to/script.sh"
+          }
+        ],
+        "distribute": [
+          {
+            "type": "ManagedImage",
+            "location": "1_location",
+            "runOutputName": "image_it_pir_1",
+            "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+            "artifactTags": {
+              "tagName": "value"
+            }
+          }
+        ],
+        "vmProfile": {
+          "vmSize": "Standard_D2s_v3",
+          "osDiskSizeGB": 64,
+          "vnetConfig": {
+            "subnetId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name"
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplates",
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {
+              "clientId": "00000000-0000-0000-0000-000000000000",
+              "principalId": "00000000-0000-0000-0000-000000000000"
+            }
+          }
+        },
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64,
+            "vnetConfig": {
+              "subnetId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet_name/subnets/subnet_name"
+            }
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate",
+        "name": "myImageTemplate",
+        "location": "westus",
+        "type": "Microsoft.VirtualMachineImages/imageTemplates",
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity_1": {
+              "clientId": "00000000-0000-0000-0000-000000000000",
+              "principalId": "00000000-0000-0000-0000-000000000000"
+            }
+          }
+        },
+        "properties": {
+          "source": {
+            "type": "ManagedImage",
+            "imageId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/images/source_image"
+          },
+          "customize": [
+            {
+              "type": "Shell",
+              "name": "Shell Customizer Example",
+              "scriptUri": "https://example.com/path/to/script.sh"
+            }
+          ],
+          "distribute": [
+            {
+              "type": "ManagedImage",
+              "location": "1_location",
+              "runOutputName": "image_it_pir_1",
+              "imageId": "/subscriptions/{subscription-id}/resourceGroups/rg1/providers/Microsoft.Compute/images/image_it_1",
+              "artifactTags": {
+                "tagName": "value"
+              }
+            }
+          ],
+          "vmProfile": {
+            "vmSize": "Standard_D2s_v3",
+            "osDiskSizeGB": 64
+          }
+        }
+      }
+    }
+  }
+}