Merge pull request #952 from william051200/vm-host-group

Author: yanzhudd

Commands/vm/host/group/_create.md

@@ -14,3 +14,14 @@ Create a dedicated host group.
     ```bash
         vm host group create --name MyDedicatedHostGroup --platform-fault-domain-count 2 --resource-group MyResourceGroup
     ```
+
+### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHMve30=/2024-11-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups/{} 2024-11-01 -->
+
+#### examples
+
+- Create a dedicated host group.
+    ```bash
+        vm host group create --name MyDedicatedHostGroup --platform-fault-domain-count 2 --resource-group MyResourceGroup
+    ```

Commands/vm/host/group/_delete.md

@@ -7,3 +7,7 @@ Delete a dedicated host group.
 ### [2019-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHMve30=/2019-03-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups/{} 2019-03-01 -->
+
+### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHMve30=/2024-11-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups/{} 2024-11-01 -->

Commands/vm/host/group/_list.md

@@ -10,3 +10,8 @@ List dedicated host groups by subscription. If resource group is specified, list
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.compute/hostgroups 2019-03-01 -->
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups 2019-03-01 -->
+
+### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHM=/2024-11-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.compute/hostgroups 2024-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups 2024-11-01 -->

Commands/vm/host/group/_show.md

@@ -14,3 +14,14 @@ Get the details of a dedicated host group.
     ```bash
         vm host group show --name MyDedicatedHostGroup --resource-group MyResourceGroup
     ```
+
+### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHMve30=/2024-11-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups/{} 2024-11-01 -->
+
+#### examples
+
+- Get the details of a dedicated host group.
+    ```bash
+        vm host group show --name MyDedicatedHostGroup --resource-group MyResourceGroup
+    ```

Commands/vm/host/group/_update.md

@@ -7,3 +7,14 @@ Update a dedicated host group.
 ### [2019-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHMve30=/2019-03-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups/{} 2019-03-01 -->
+
+### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHMve30=/2024-11-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups/{} 2024-11-01 -->
+
+#### examples
+
+- Update a dedicated host group with Ultra SSD support.
+    ```bash
+        vm host group update --resource-group myResourceGroup --name myDedicatedHostGroup --set tags.foo="bar"
+    ```

Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2hvc3Rncm91cHM=/2024-11-01.json

@@ -0,0 +1 @@
+{"plane": "mgmt-plane", "resources": [{"id": "/subscriptions/{}/providers/microsoft.compute/hostgroups", "version": "2024-11-01", "swagger": "mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9wcm92aWRlcnMvTWljcm9zb2Z0LkNvbXB1dGUvaG9zdEdyb3Vwcw==/V/MjAyNC0xMS0wMQ=="}, {"id": "/subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups", "version": "2024-11-01", "swagger": "mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuQ29tcHV0ZS9ob3N0R3JvdXBz/V/MjAyNC0xMS0wMQ=="}], "commandGroups": [{"name": "vm host group", "commands": [{"name": "list", "version": "2024-11-01", "resources": [{"id": "/subscriptions/{}/providers/microsoft.compute/hostgroups", "version": "2024-11-01", "swagger": "mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9wcm92aWRlcnMvTWljcm9zb2Z0LkNvbXB1dGUvaG9zdEdyb3Vwcw==/V/MjAyNC0xMS0wMQ=="}, {"id": "/subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/hostgroups", "version": "2024-11-01", "swagger": "mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuQ29tcHV0ZS9ob3N0R3JvdXBz/V/MjAyNC0xMS0wMQ=="}], "argGroups": [{"name": "", "args": [{"type": "ResourceGroupName", "var": "$Path.resourceGroupName", "options": ["g", "resource-group"], "idPart": "resource_group"}, {"type": "SubscriptionId", "var": "$Path.subscriptionId", "options": ["subscription"], "required": true, "idPart": "subscription"}]}], "conditions": [{"var": "$Condition_DedicatedHostGroups_ListBySubscription", "operator": {"type": "and", "operators": [{"type": "hasValue", "arg": "$Path.subscriptionId"}, {"type": "not", "operator": {"type": "hasValue", "arg": "$Path.resourceGroupName"}}]}}, {"var": "$Condition_DedicatedHostGroups_ListByResourceGroup", "operator": {"type": "and", "operators": [{"type": "hasValue", "arg": "$Path.resourceGroupName"}, {"type": "hasValue", "arg": "$Path.subscriptionId"}]}}], "operations": [{"when": ["$Condition_DedicatedHostGroups_ListBySubscription"], "operationId": "DedicatedHostGroups_ListBySubscription", "http": {"path": "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/hostGroups", "request": {"method": "get", "path": {"params": [{"type": "string", "name": "subscriptionId", "arg": "$Path.subscriptionId", "required": true, "format": {"minLength": 1}}]}, "query": {"consts": [{"readOnly": true, "const": true, "default": {"value": "2024-11-01"}, "type": "string", "name": "api-version", "required": true, "format": {"minLength": 1}}]}}, "responses": [{"statusCode": [200], "body": {"json": {"var": "$Instance", "schema": {"type": "object", "props": [{"type": "string", "name": "nextLink"}, {"type": "array<object>", "name": "value", "required": true, "item": {"type": "object", "props": [{"readOnly": true, "type": "ResourceId", "name": "id", "format": {"template": "/subscriptions/{}/resourceGroups/{}/providers/Microsoft.Compute/hostGroups/{}"}}, {"type": "ResourceLocation", "name": "location", "required": true}, {"readOnly": true, "type": "string", "name": "name"}, {"type": "object", "name": "properties", "props": [{"type": "object", "name": "additionalCapabilities", "props": [{"type": "boolean", "name": "ultraSSDEnabled"}]}, {"readOnly": true, "type": "array<object>", "name": "hosts", "item": {"type": "object", "props": [{"readOnly": true, "type": "string", "name": "id"}]}}, {"readOnly": true, "type": "object", "name": "instanceView", "props": [{"type": "array<object>", "name": "hosts", "item": {"type": "object", "props": [{"readOnly": true, "type": "string", "name": "assetId"}, {"type": "object", "name": "availableCapacity", "props": [{"type": "array<object>", "name": "allocatableVMs", "item": {"type": "object", "props": [{"type": "float64", "name": "count"}, {"type": "string", "name": "vmSize"}]}}]}, {"readOnly": true, "type": "string", "name": "name"}, {"type": "array<object>", "name": "statuses", "item": {"type": "object", "props": [{"type": "string", "name": "code"}, {"type": "string", "name": "displayStatus"}, {"type": "string", "name": "level", "enum": {"items": [{"value": "Error"}, {"value": "Info"}, {"value": "Warning"}]}}, {"type": "string", "name": "message"}, {"type": "dateTime", "name": "time", "format": {"protocol": "iso"}}]}}]}, "identifiers": ["name"]}]}, {"type": "integer32", "name": "platformFaultDomainCount", "required": true, "format": {"minimum": 1}}, {"type": "boolean", "name": "supportAutomaticPlacement"}], "clientFlatten": true}, {"readOnly": true, "type": "object", "name": "systemData", "props": [{"type": "dateTime", "name": "createdAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "createdBy"}, {"type": "string", "name": "createdByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}, {"type": "dateTime", "name": "lastModifiedAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "lastModifiedBy"}, {"type": "string", "name": "lastModifiedByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}]}, {"type": "object", "name": "tags", "additionalProps": {"item": {"type": "string"}}}, {"readOnly": true, "type": "string", "name": "type"}, {"type": "array<string>", "name": "zones", "item": {"type": "string"}}]}}]}}}}, {"isError": true, "body": {"json": {"schema": {"type": "@ODataV4Format"}}}}]}}, {"when": ["$Condition_DedicatedHostGroups_ListByResourceGroup"], "operationId": "DedicatedHostGroups_ListByResourceGroup", "http": {"path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups", "request": {"method": "get", "path": {"params": [{"type": "string", "name": "resourceGroupName", "arg": "$Path.resourceGroupName", "required": true, "format": {"maxLength": 90, "minLength": 1}}, {"type": "string", "name": "subscriptionId", "arg": "$Path.subscriptionId", "required": true, "format": {"minLength": 1}}]}, "query": {"consts": [{"readOnly": true, "const": true, "default": {"value": "2024-11-01"}, "type": "string", "name": "api-version", "required": true, "format": {"minLength": 1}}]}}, "responses": [{"statusCode": [200], "body": {"json": {"var": "$Instance", "schema": {"type": "object", "props": [{"type": "string", "name": "nextLink"}, {"type": "array<object>", "name": "value", "required": true, "item": {"type": "object", "props": [{"readOnly": true, "type": "ResourceId", "name": "id", "format": {"template": "/subscriptions/{}/resourceGroups/{}/providers/Microsoft.Compute/hostGroups/{}"}}, {"type": "ResourceLocation", "name": "location", "required": true}, {"readOnly": true, "type": "string", "name": "name"}, {"type": "object", "name": "properties", "props": [{"type": "object", "name": "additionalCapabilities", "props": [{"type": "boolean", "name": "ultraSSDEnabled"}]}, {"readOnly": true, "type": "array<object>", "name": "hosts", "item": {"type": "object", "props": [{"readOnly": true, "type": "string", "name": "id"}]}}, {"readOnly": true, "type": "object", "name": "instanceView", "props": [{"type": "array<object>", "name": "hosts", "item": {"type": "object", "props": [{"readOnly": true, "type": "string", "name": "assetId"}, {"type": "object", "name": "availableCapacity", "props": [{"type": "array<object>", "name": "allocatableVMs", "item": {"type": "object", "props": [{"type": "float64", "name": "count"}, {"type": "string", "name": "vmSize"}]}}]}, {"readOnly": true, "type": "string", "name": "name"}, {"type": "array<object>", "name": "statuses", "item": {"type": "object", "props": [{"type": "string", "name": "code"}, {"type": "string", "name": "displayStatus"}, {"type": "string", "name": "level", "enum": {"items": [{"value": "Error"}, {"value": "Info"}, {"value": "Warning"}]}}, {"type": "string", "name": "message"}, {"type": "dateTime", "name": "time", "format": {"protocol": "iso"}}]}}]}, "identifiers": ["name"]}]}, {"type": "integer32", "name": "platformFaultDomainCount", "required": true, "format": {"minimum": 1}}, {"type": "boolean", "name": "supportAutomaticPlacement"}], "clientFlatten": true}, {"readOnly": true, "type": "object", "name": "systemData", "props": [{"type": "dateTime", "name": "createdAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "createdBy"}, {"type": "string", "name": "createdByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}, {"type": "dateTime", "name": "lastModifiedAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "lastModifiedBy"}, {"type": "string", "name": "lastModifiedByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}]}, {"type": "object", "name": "tags", "additionalProps": {"item": {"type": "string"}}}, {"readOnly": true, "type": "string", "name": "type"}, {"type": "array<string>", "name": "zones", "item": {"type": "string"}}]}}]}}}}, {"isError": true, "body": {"json": {"schema": {"type": "@ODataV4Format"}}}}]}}], "outputs": [{"type": "array", "ref": "$Instance.value", "clientFlatten": true, "nextLink": "$Instance.nextLink"}], "confirmation": ""}]}]}