Dedicated Hosts - Update

Service:

Compute

API Version:

2024-03-01

Aktualisieren Sie einen dedizierten Host.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
hostGroupName	path	True	string	Der Name der dedizierten Hostgruppe.
hostName	path	True	string	Der Name des dedizierten Hosts .
resourceGroupName	path	True	string	Der Name der Ressourcengruppe.
subscriptionId	path	True	string	Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Typ	Beschreibung
properties.autoReplaceOnFailure	boolean	Gibt an, ob der dedizierte Host im Falle eines Fehlers automatisch ersetzt werden soll. Der Wert wird standardmäßig auf "true" festgelegt, wenn er nicht angegeben wird.
properties.licenseType	DedicatedHostLicenseTypes	Gibt den Softwarelizenztyp an, der auf die auf dem dedizierten Host bereitgestellten VMs angewendet wird. Mögliche Werte sind: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Der Standardwert ist: None.
properties.platformFaultDomain	integer	Fehlerdomäne des dedizierten Hosts innerhalb einer dedizierten Hostgruppe.
sku	Sku	[Listet alle verfügbaren dedizierten Hostgrößen zum Ändern der Größe auf] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes). Die Größenänderung kann nur zum Hochskalieren von DedicatedHost verwendet werden. Es muss nur der Name festgelegt werden.
tags	object	Ressourcentags

Antworten

Name	Typ	Beschreibung
200 OK	DedicatedHost	OK
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

DedicatedHost_Update_MaximumSet_Gen

DedicatedHost_Update_MinimumSet_Gen

DedicatedHost_Update_Resize

DedicatedHost_Update_MaximumSet_Gen

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaa/hosts/aaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01

{
  "properties": {
    "platformFaultDomain": 1,
    "autoReplaceOnFailure": true,
    "licenseType": "Windows_Server_Hybrid",
    "instanceView": {
      "availableCapacity": {
        "allocatableVMs": [
          {
            "vmSize": "aaaaaaaaaaaaaaaaaaaa",
            "count": 26
          }
        ]
      },
      "statuses": [
        {
          "code": "aaaaaaaaaaaaaaaaaaaaaaa",
          "level": "Info",
          "displayStatus": "aaaaaa",
          "message": "a",
          "time": "2021-11-30T12:58:26.522Z"
        }
      ]
    }
  },
  "tags": {
    "key8813": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

Java

import com.azure.resourcemanager.compute.models.DedicatedHostLicenseTypes;
import com.azure.resourcemanager.compute.models.DedicatedHostUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DedicatedHosts Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * dedicatedHostExamples/DedicatedHost_Update_MaximumSet_Gen.json
     */
    /**
     * Sample code: DedicatedHost_Update_MaximumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void dedicatedHostUpdateMaximumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDedicatedHosts().update("rgcompute", "aaaaaaaaa",
            "aaaaaaaaaaaaaaaaaaaaa",
            new DedicatedHostUpdate().withTags(mapOf("key8813", "fakeTokenPlaceholder")).withPlatformFaultDomain(1)
                .withAutoReplaceOnFailure(true).withLicenseType(DedicatedHostLicenseTypes.WINDOWS_SERVER_HYBRID),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python dedicated_host_update_maximum_set_gen.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.dedicated_hosts.begin_update(
        resource_group_name="rgcompute",
        host_group_name="aaaaaaaaa",
        host_name="aaaaaaaaaaaaaaaaaaaaa",
        parameters={
            "properties": {
                "autoReplaceOnFailure": True,
                "instanceView": {
                    "availableCapacity": {"allocatableVMs": [{"count": 26, "vmSize": "aaaaaaaaaaaaaaaaaaaa"}]},
                    "statuses": [
                        {
                            "code": "aaaaaaaaaaaaaaaaaaaaaaa",
                            "displayStatus": "aaaaaa",
                            "level": "Info",
                            "message": "a",
                            "time": "2021-11-30T12:58:26.522Z",
                        }
                    ],
                },
                "licenseType": "Windows_Server_Hybrid",
                "platformFaultDomain": 1,
            },
            "tags": {"key8813": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_MaximumSet_Gen.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_MaximumSet_Gen.json
func ExampleDedicatedHostsClient_BeginUpdate_dedicatedHostUpdateMaximumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDedicatedHostsClient().BeginUpdate(ctx, "rgcompute", "aaaaaaaaa", "aaaaaaaaaaaaaaaaaaaaa", armcompute.DedicatedHostUpdate{
		Tags: map[string]*string{
			"key8813": to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaaaa"),
		},
		Properties: &armcompute.DedicatedHostProperties{
			AutoReplaceOnFailure: to.Ptr(true),
			InstanceView: &armcompute.DedicatedHostInstanceView{
				AvailableCapacity: &armcompute.DedicatedHostAvailableCapacity{
					AllocatableVMs: []*armcompute.DedicatedHostAllocatableVM{
						{
							Count:  to.Ptr[float64](26),
							VMSize: to.Ptr("aaaaaaaaaaaaaaaaaaaa"),
						}},
				},
				Statuses: []*armcompute.InstanceViewStatus{
					{
						Code:          to.Ptr("aaaaaaaaaaaaaaaaaaaaaaa"),
						DisplayStatus: to.Ptr("aaaaaa"),
						Level:         to.Ptr(armcompute.StatusLevelTypesInfo),
						Message:       to.Ptr("a"),
						Time:          to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T12:58:26.522Z"); return t }()),
					}},
			},
			LicenseType:         to.Ptr(armcompute.DedicatedHostLicenseTypesWindowsServerHybrid),
			PlatformFaultDomain: to.Ptr[int32](1),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DedicatedHost = armcompute.DedicatedHost{
	// 	Name: to.Ptr("myDedicatedHost"),
	// 	Type: to.Ptr("aaaaaaaaaaaaaaaaaaa"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armcompute.DedicatedHostProperties{
	// 		AutoReplaceOnFailure: to.Ptr(true),
	// 		HostID: to.Ptr("{GUID}"),
	// 		InstanceView: &armcompute.DedicatedHostInstanceView{
	// 			AssetID: to.Ptr("aaaaaaaaaaaaaaaa"),
	// 			AvailableCapacity: &armcompute.DedicatedHostAvailableCapacity{
	// 				AllocatableVMs: []*armcompute.DedicatedHostAllocatableVM{
	// 					{
	// 						Count: to.Ptr[float64](26),
	// 						VMSize: to.Ptr("aaaaaaaaaaaaaaaaaaaa"),
	// 				}},
	// 			},
	// 			Statuses: []*armcompute.InstanceViewStatus{
	// 				{
	// 					Code: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaa"),
	// 					DisplayStatus: to.Ptr("aaaaaa"),
	// 					Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 					Message: to.Ptr("a"),
	// 					Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T12:58:26.522Z"); return t}()),
	// 			}},
	// 		},
	// 		LicenseType: to.Ptr(armcompute.DedicatedHostLicenseTypesWindowsServerHybrid),
	// 		PlatformFaultDomain: to.Ptr[int32](1),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		ProvisioningTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T12:58:26.526Z"); return t}()),
	// 		VirtualMachines: []*armcompute.SubResourceReadOnly{
	// 			{
	// 				ID: to.Ptr("aaaa"),
	// 		}},
	// 	},
	// 	SKU: &armcompute.SKU{
	// 		Name: to.Ptr("DSv3-Type1"),
	// 		Capacity: to.Ptr[int64](7),
	// 		Tier: to.Ptr("aaa"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update a dedicated host .
 *
 * @summary Update a dedicated host .
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_MaximumSet_Gen.json
 */
async function dedicatedHostUpdateMaximumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const hostGroupName = "aaaaaaaaa";
  const hostName = "aaaaaaaaaaaaaaaaaaaaa";
  const parameters = {
    autoReplaceOnFailure: true,
    instanceView: {
      availableCapacity: {
        allocatableVMs: [{ count: 26, vmSize: "aaaaaaaaaaaaaaaaaaaa" }],
      },
      statuses: [
        {
          code: "aaaaaaaaaaaaaaaaaaaaaaa",
          displayStatus: "aaaaaa",
          level: "Info",
          message: "a",
          time: new Date("2021-11-30T12:58:26.522Z"),
        },
      ],
    },
    licenseType: "Windows_Server_Hybrid",
    platformFaultDomain: 1,
    tags: { key8813: "aaaaaaaaaaaaaaaaaaaaaaaaaaa" },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.dedicatedHosts.beginUpdateAndWait(
    resourceGroupName,
    hostGroupName,
    hostName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "location": "westus",
  "tags": {},
  "properties": {
    "platformFaultDomain": 1,
    "autoReplaceOnFailure": true,
    "hostId": "{GUID}",
    "virtualMachines": [
      {
        "id": "aaaa"
      }
    ],
    "licenseType": "Windows_Server_Hybrid",
    "provisioningTime": "2021-11-30T12:58:26.526Z",
    "provisioningState": "aaaaaaaaaaaaaaaaaaaaaaaaa",
    "instanceView": {
      "assetId": "aaaaaaaaaaaaaaaa",
      "availableCapacity": {
        "allocatableVMs": [
          {
            "vmSize": "aaaaaaaaaaaaaaaaaaaa",
            "count": 26
          }
        ]
      },
      "statuses": [
        {
          "code": "aaaaaaaaaaaaaaaaaaaaaaa",
          "level": "Info",
          "displayStatus": "aaaaaa",
          "message": "a",
          "time": "2021-11-30T12:58:26.522Z"
        }
      ]
    }
  },
  "sku": {
    "name": "DSv3-Type1",
    "tier": "aaa",
    "capacity": 7
  },
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
  "name": "myDedicatedHost",
  "type": "aaaaaaaaaaaaaaaaaaa"
}

DedicatedHost_Update_MinimumSet_Gen

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aa/hosts/aaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01

{}

Java

import com.azure.resourcemanager.compute.models.DedicatedHostUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DedicatedHosts Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * dedicatedHostExamples/DedicatedHost_Update_MinimumSet_Gen.json
     */
    /**
     * Sample code: DedicatedHost_Update_MinimumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void dedicatedHostUpdateMinimumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDedicatedHosts().update("rgcompute", "aa",
            "aaaaaaaaaaaaaaaaaaaaaaaaaa", new DedicatedHostUpdate(), com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

No code sample is available. To request a code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_MinimumSet_Gen.json
func ExampleDedicatedHostsClient_BeginUpdate_dedicatedHostUpdateMinimumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDedicatedHostsClient().BeginUpdate(ctx, "rgcompute", "aa", "aaaaaaaaaaaaaaaaaaaaaaaaaa", armcompute.DedicatedHostUpdate{}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DedicatedHost = armcompute.DedicatedHost{
	// 	Location: to.Ptr("westus"),
	// 	SKU: &armcompute.SKU{
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update a dedicated host .
 *
 * @summary Update a dedicated host .
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_MinimumSet_Gen.json
 */
async function dedicatedHostUpdateMinimumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const hostGroupName = "aa";
  const hostName = "aaaaaaaaaaaaaaaaaaaaaaaaaa";
  const parameters = {};
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.dedicatedHosts.beginUpdateAndWait(
    resourceGroupName,
    hostGroupName,
    hostName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "location": "westus",
  "sku": {}
}

DedicatedHost_Update_Resize

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaa/hosts/aaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01

{
  "sku": {
    "name": "DSv3-Type1"
  }
}

Java

import com.azure.resourcemanager.compute.models.DedicatedHostUpdate;
import com.azure.resourcemanager.compute.models.Sku;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DedicatedHosts Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * dedicatedHostExamples/DedicatedHost_Update_Resize.json
     */
    /**
     * Sample code: DedicatedHost_Update_Resize.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void dedicatedHostUpdateResize(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDedicatedHosts().update("rgcompute", "aaaaaaaaa",
            "aaaaaaaaaaaaaaaaaaaaa", new DedicatedHostUpdate().withSku(new Sku().withName("DSv3-Type1")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python dedicated_host_update_resize.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.dedicated_hosts.begin_update(
        resource_group_name="rgcompute",
        host_group_name="aaaaaaaaa",
        host_name="aaaaaaaaaaaaaaaaaaaaa",
        parameters={"sku": {"name": "DSv3-Type1"}},
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_Resize.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_Resize.json
func ExampleDedicatedHostsClient_BeginUpdate_dedicatedHostUpdateResize() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDedicatedHostsClient().BeginUpdate(ctx, "rgcompute", "aaaaaaaaa", "aaaaaaaaaaaaaaaaaaaaa", armcompute.DedicatedHostUpdate{
		SKU: &armcompute.SKU{
			Name: to.Ptr("DSv3-Type1"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DedicatedHost = armcompute.DedicatedHost{
	// 	Name: to.Ptr("myDedicatedHost"),
	// 	Type: to.Ptr("aaaaaaaaaaaaaaaaaaa"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armcompute.DedicatedHostProperties{
	// 		AutoReplaceOnFailure: to.Ptr(true),
	// 		HostID: to.Ptr("{GUID}"),
	// 		LicenseType: to.Ptr(armcompute.DedicatedHostLicenseTypesWindowsServerHybrid),
	// 		PlatformFaultDomain: to.Ptr[int32](1),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		ProvisioningTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T12:58:26.526Z"); return t}()),
	// 		VirtualMachines: []*armcompute.SubResourceReadOnly{
	// 			{
	// 				ID: to.Ptr("aaaa"),
	// 		}},
	// 	},
	// 	SKU: &armcompute.SKU{
	// 		Name: to.Ptr("DSv3-Type1"),
	// 		Capacity: to.Ptr[int64](7),
	// 		Tier: to.Ptr("aaa"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update a dedicated host .
 *
 * @summary Update a dedicated host .
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_Update_Resize.json
 */
async function dedicatedHostUpdateResize() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const hostGroupName = "aaaaaaaaa";
  const hostName = "aaaaaaaaaaaaaaaaaaaaa";
  const parameters = { sku: { name: "DSv3-Type1" } };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.dedicatedHosts.beginUpdateAndWait(
    resourceGroupName,
    hostGroupName,
    hostName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "location": "westus",
  "tags": {},
  "properties": {
    "platformFaultDomain": 1,
    "autoReplaceOnFailure": true,
    "hostId": "{GUID}",
    "virtualMachines": [
      {
        "id": "aaaa"
      }
    ],
    "licenseType": "Windows_Server_Hybrid",
    "provisioningTime": "2021-11-30T12:58:26.526Z",
    "provisioningState": "aaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "sku": {
    "name": "DSv3-Type1",
    "tier": "aaa",
    "capacity": 7
  },
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
  "name": "myDedicatedHost",
  "type": "aaaaaaaaaaaaaaaaaaa"
}

Definitionen

Name	Beschreibung
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
CloudError	Eine Fehlerantwort des Computediensts.
DedicatedHost	Gibt Informationen zum dedizierten Host an.
DedicatedHostAllocatableVM	Stellt die nicht ausgelastete Kapazität des dedizierten Hosts in Bezug auf eine bestimmte VM-Größe dar.
DedicatedHostAvailableCapacity	Nicht ausgelastete Kapazität des dedizierten Hosts.
DedicatedHostInstanceView	Die instance Ansicht eines dedizierten Hosts.
DedicatedHostLicenseTypes	Gibt den Softwarelizenztyp an, der auf die auf dem dedizierten Host bereitgestellten VMs angewendet wird. Mögliche Werte sind: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Der Standardwert ist: None.
DedicatedHostUpdate	Gibt Informationen zum dedizierten Host an. Nur Tags, autoReplaceOnFailure und licenseType können aktualisiert werden.
InnerError	Innere Fehlerdetails.
InstanceViewStatus	Instanzansicht status.
Sku	Beschreibt eine SKU für vm-Skalierungsgruppen. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der sich die Skalierungsgruppe derzeit befindet, nicht unterstützt wird, müssen Sie die Zuordnung der virtuellen Computer in der Skalierungsgruppe beheben, bevor Sie den SKU-Namen ändern.
StatusLevelTypes	Der Ebenencode.
SubResourceReadOnly

ApiError

API-Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
details	ApiErrorBase[]	Api-Fehlerdetails
innererror	InnerError	Der innere Api-Fehler
message	string	Die Fehlermeldung.
target	string	Das Ziel des jeweiligen Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
message	string	Die Fehlermeldung.
target	string	Das Ziel des jeweiligen Fehlers.

CloudError

Eine Fehlerantwort des Computediensts.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

DedicatedHost

Gibt Informationen zum dedizierten Host an.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
location	string	Ressourcenspeicherort
name	string	Ressourcenname
properties.autoReplaceOnFailure	boolean	Gibt an, ob der dedizierte Host im Falle eines Fehlers automatisch ersetzt werden soll. Der Wert wird standardmäßig auf "true" festgelegt, wenn er nicht angegeben wird.
properties.hostId	string	Eine eindeutige ID, die von der Plattform generiert und dem dedizierten Host zugewiesen wird. Ändert sich nicht während der gesamten Lebensdauer des Hosts.
properties.instanceView	DedicatedHostInstanceView	Der dedizierte Host instance Ansicht.
properties.licenseType	DedicatedHostLicenseTypes	Gibt den Softwarelizenztyp an, der auf die auf dem dedizierten Host bereitgestellten VMs angewendet wird. Mögliche Werte sind: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Der Standardwert ist: None.
properties.platformFaultDomain	integer	Fehlerdomäne des dedizierten Hosts innerhalb einer dedizierten Hostgruppe.
properties.provisioningState	string	Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
properties.provisioningTime	string	Das Datum, an dem der Host zum ersten Mal bereitgestellt wurde.
properties.timeCreated	string	Gibt den Zeitpunkt an, zu dem die Dedicated Host-Ressource erstellt wurde. Api-Mindestversion: 2021-11-01.
properties.virtualMachines	SubResourceReadOnly[]	Eine Liste der Verweise auf alle virtuellen Computer im dedizierten Host.
sku	Sku	SKU des dedizierten Hosts für Hardwaregenerierung und VM-Familie. Es muss nur der Name festgelegt werden. Auflisten von Microsoft.Compute-SKUs für eine Liste möglicher Werte.
tags	object	Ressourcentags
type	string	Ressourcentyp

DedicatedHostAllocatableVM

Stellt die nicht ausgelastete Kapazität des dedizierten Hosts in Bezug auf eine bestimmte VM-Größe dar.

Name	Typ	Beschreibung
count	number	Maximale Anzahl von VMs der Größe vmSize, die in die verbleibende Kapazität des dedizierten Hosts passen können.
vmSize	string	VM-Größe, in der die nicht ausgelastete Kapazität dargestellt wird.

DedicatedHostAvailableCapacity

Nicht ausgelastete Kapazität des dedizierten Hosts.

Name	Typ	Beschreibung
allocatableVMs	DedicatedHostAllocatableVM[]	Die nicht ausgelastete Kapazität des dedizierten Hosts in Bezug auf jede VM-Größe, die auf dem dedizierten Host bereitgestellt werden darf.

DedicatedHostInstanceView

Die instance Ansicht eines dedizierten Hosts.

Name	Typ	Beschreibung
assetId	string	Gibt die eindeutige ID des dedizierten physischen Computers an, auf dem sich der dedizierte Host befindet.
availableCapacity	DedicatedHostAvailableCapacity	Nicht ausgelastete Kapazität des dedizierten Hosts.
statuses	InstanceViewStatus[]	Die Ressource status Informationen.

DedicatedHostLicenseTypes

Gibt den Softwarelizenztyp an, der auf die auf dem dedizierten Host bereitgestellten VMs angewendet wird. Mögliche Werte sind: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Der Standardwert ist: None.

Name	Typ	Beschreibung
None	string
Windows_Server_Hybrid	string
Windows_Server_Perpetual	string

DedicatedHostUpdate

Gibt Informationen zum dedizierten Host an. Nur Tags, autoReplaceOnFailure und licenseType können aktualisiert werden.

Name	Typ	Beschreibung
properties.autoReplaceOnFailure	boolean	Gibt an, ob der dedizierte Host im Falle eines Fehlers automatisch ersetzt werden soll. Der Wert wird standardmäßig auf "true" festgelegt, wenn er nicht angegeben wird.
properties.hostId	string	Eine eindeutige ID, die von der Plattform generiert und dem dedizierten Host zugewiesen wird. Ändert sich nicht während der gesamten Lebensdauer des Hosts.
properties.instanceView	DedicatedHostInstanceView	Der dedizierte Host instance Ansicht.
properties.licenseType	DedicatedHostLicenseTypes	Gibt den Softwarelizenztyp an, der auf die auf dem dedizierten Host bereitgestellten VMs angewendet wird. Mögliche Werte sind: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Der Standardwert ist: None.
properties.platformFaultDomain	integer	Fehlerdomäne des dedizierten Hosts innerhalb einer dedizierten Hostgruppe.
properties.provisioningState	string	Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
properties.provisioningTime	string	Das Datum, an dem der Host zum ersten Mal bereitgestellt wurde.
properties.timeCreated	string	Gibt den Zeitpunkt an, zu dem die Dedicated Host-Ressource erstellt wurde. Api-Mindestversion: 2021-11-01.
properties.virtualMachines	SubResourceReadOnly[]	Eine Liste der Verweise auf alle virtuellen Computer im dedizierten Host.
sku	Sku	[Listet alle verfügbaren dedizierten Hostgrößen zum Ändern der Größe auf] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes). Die Größenänderung kann nur zum Hochskalieren von DedicatedHost verwendet werden. Es muss nur der Name festgelegt werden.
tags	object	Ressourcentags

InnerError

Innere Fehlerdetails.

Name	Typ	Beschreibung
errordetail	string	Das interne Fehlermeldungs- oder Ausnahmedump.
exceptiontype	string	Der Ausnahmetyp.

InstanceViewStatus

Instanzansicht status.

Name	Typ	Beschreibung
code	string	Der Statuscode.
displayStatus	string	Die kurze lokalisierbare Bezeichnung für die status.
level	StatusLevelTypes	Der Ebenencode.
message	string	Die detaillierte status Meldung, einschließlich Warnungen und Fehlermeldungen.
time	string	Die Zeit des status.

Sku

Beschreibt eine SKU für vm-Skalierungsgruppen. HINWEIS: Wenn die neue VM-SKU auf der Hardware, auf der sich die Skalierungsgruppe derzeit befindet, nicht unterstützt wird, müssen Sie die Zuordnung der virtuellen Computer in der Skalierungsgruppe beheben, bevor Sie den SKU-Namen ändern.

Name	Typ	Beschreibung
capacity	integer	Gibt die Anzahl der virtuellen Computer in der Skalierungsgruppe an.
name	string	Der sku-Name.
tier	string	Gibt die Ebene der virtuellen Computer in einer Skalierungsgruppe an. Mögliche Werte: Standard Grundlegend

StatusLevelTypes

Der Ebenencode.

Name	Typ	Beschreibung
Error	string
Info	string
Warning	string

SubResourceReadOnly

Name	Typ	Beschreibung
id	string	Ressourcen-ID