Dedicated Host Groups - List By Resource Group

Dienst:

Compute

API-Version:

2024-11-01

Listet alle dedizierten Hostgruppen in der angegebenen Ressourcengruppe auf. Verwenden Sie die nextLink-Eigenschaft in der Antwort, um die nächste Seite dedizierter Hostgruppen abzurufen.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups?api-version=2024-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
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.

Antworten

Name	Typ	Beschreibung
200 OK	DedicatedHostGroupListResult	OKAY
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen

DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen

DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups?api-version=2024-11-01

Java

/**
 * Samples for DedicatedHostGroups ListByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/
     * dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen.json
     */
    /**
     * Sample code: DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        dedicatedHostGroupListByResourceGroupMaximumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDedicatedHostGroups().listByResourceGroup("rgcompute",
            com.azure.core.util.Context.NONE);
    }
}

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 azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python dedicated_host_group_list_by_resource_group_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_host_groups.list_by_resource_group(
        resource_group_name="rgcompute",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_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"

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

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/250861bb6a886b75255edfa0aa5ee2dd0d6e7a11/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen.json
func ExampleDedicatedHostGroupsClient_NewListByResourceGroupPager_dedicatedHostGroupListByResourceGroupMaximumSetGen() {
	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)
	}
	pager := clientFactory.NewDedicatedHostGroupsClient().NewListByResourceGroupPager("rgcompute", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.DedicatedHostGroupListResult = armcompute.DedicatedHostGroupListResult{
		// 	Value: []*armcompute.DedicatedHostGroup{
		// 		{
		// 			Name: to.Ptr("myDedicatedHostGroup"),
		// 			Type: to.Ptr("aaaa"),
		// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup"),
		// 			Location: to.Ptr("westus"),
		// 			Tags: map[string]*string{
		// 			},
		// 			Properties: &armcompute.DedicatedHostGroupProperties{
		// 				Hosts: []*armcompute.SubResourceReadOnly{
		// 					{
		// 						ID: to.Ptr("aaaa"),
		// 				}},
		// 				InstanceView: &armcompute.DedicatedHostGroupInstanceView{
		// 					Hosts: []*armcompute.DedicatedHostInstanceViewWithName{
		// 						{
		// 							AssetID: to.Ptr("aaaa"),
		// 							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}()),
		// 							}},
		// 							Name: to.Ptr("aaaaaaaaaaaaaaaaaa"),
		// 					}},
		// 				},
		// 				PlatformFaultDomainCount: to.Ptr[int32](3),
		// 				SupportAutomaticPlacement: to.Ptr(true),
		// 			},
		// 			Zones: []*string{
		// 				to.Ptr("1")},
		// 		}},
		// 	}
	}
}

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");
require("dotenv/config");

/**
 * This sample demonstrates how to Lists all of the dedicated host groups in the specified resource group. Use the nextLink property in the response to get the next page of dedicated host groups.
 *
 * @summary Lists all of the dedicated host groups in the specified resource group. Use the nextLink property in the response to get the next page of dedicated host groups.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen.json
 */
async function dedicatedHostGroupListByResourceGroupMaximumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.dedicatedHostGroups.listByResourceGroup(resourceGroupName)) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MaximumSet_Gen.json
// this example is just showing the usage of "DedicatedHostGroups_ListByResourceGroup" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this DedicatedHostGroupResource
DedicatedHostGroupCollection collection = resourceGroupResource.GetDedicatedHostGroups();

// invoke the operation and iterate over the result
await foreach (DedicatedHostGroupResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    DedicatedHostGroupData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "location": "westus",
      "tags": {},
      "zones": [
        "1"
      ],
      "properties": {
        "platformFaultDomainCount": 3,
        "supportAutomaticPlacement": true,
        "hosts": [
          {
            "id": "aaaa"
          }
        ],
        "instanceView": {
          "hosts": [
            {
              "name": "aaaaaaaaaaaaaaaaaa",
              "assetId": "aaaa",
              "availableCapacity": {
                "allocatableVMs": [
                  {
                    "vmSize": "aaaaaaaaaaaaaaaaaaaa",
                    "count": 26
                  }
                ]
              },
              "statuses": [
                {
                  "code": "aaaaaaaaaaaaaaaaaaaaaaa",
                  "level": "Info",
                  "displayStatus": "aaaaaa",
                  "message": "a",
                  "time": "2021-11-30T12:58:26.522Z"
                }
              ]
            }
          ]
        }
      },
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup",
      "name": "myDedicatedHostGroup",
      "type": "aaaa"
    }
  ],
  "nextLink": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups?api-version=2024-11-01

Java

/**
 * Samples for DedicatedHostGroups ListByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/
     * dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen.json
     */
    /**
     * Sample code: DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        dedicatedHostGroupListByResourceGroupMinimumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDedicatedHostGroups().listByResourceGroup("rgcompute",
            com.azure.core.util.Context.NONE);
    }
}

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 azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python dedicated_host_group_list_by_resource_group_minimum_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_host_groups.list_by_resource_group(
        resource_group_name="rgcompute",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MinimumSet_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"

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

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/250861bb6a886b75255edfa0aa5ee2dd0d6e7a11/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen.json
func ExampleDedicatedHostGroupsClient_NewListByResourceGroupPager_dedicatedHostGroupListByResourceGroupMinimumSetGen() {
	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)
	}
	pager := clientFactory.NewDedicatedHostGroupsClient().NewListByResourceGroupPager("rgcompute", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.DedicatedHostGroupListResult = armcompute.DedicatedHostGroupListResult{
		// 	Value: []*armcompute.DedicatedHostGroup{
		// 		{
		// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup"),
		// 			Location: to.Ptr("westus"),
		// 	}},
		// }
	}
}

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");
require("dotenv/config");

/**
 * This sample demonstrates how to Lists all of the dedicated host groups in the specified resource group. Use the nextLink property in the response to get the next page of dedicated host groups.
 *
 * @summary Lists all of the dedicated host groups in the specified resource group. Use the nextLink property in the response to get the next page of dedicated host groups.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen.json
 */
async function dedicatedHostGroupListByResourceGroupMinimumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.dedicatedHostGroups.listByResourceGroup(resourceGroupName)) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-01/examples/dedicatedHostExamples/DedicatedHostGroup_ListByResourceGroup_MinimumSet_Gen.json
// this example is just showing the usage of "DedicatedHostGroups_ListByResourceGroup" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this DedicatedHostGroupResource
DedicatedHostGroupCollection collection = resourceGroupResource.GetDedicatedHostGroups();

// invoke the operation and iterate over the result
await foreach (DedicatedHostGroupResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    DedicatedHostGroupData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup",
      "location": "westus"
    }
  ]
}

Definitionen

Name	Beschreibung
AdditionalCapabilities	Aktiviert oder deaktiviert eine Funktion für die dedizierte Hostgruppe. Mindest-API-Version: 2022-03-01.
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
CloudError	Eine Fehlerantwort des Computediensts.
DedicatedHostAllocatableVM	Stellt die dedizierte hostlose Kapazität in Bezug auf eine bestimmte VM-Größe dar.
DedicatedHostAvailableCapacity	Dedizierte Host- und nicht genutzte Kapazität.
DedicatedHostGroup	Gibt Informationen zur dedizierten Hostgruppe an, der die dedizierten Hosts zugewiesen werden sollen. Derzeit kann ein dedizierter Host nur zur Erstellungszeit einer dedizierten Hostgruppe hinzugefügt werden. Ein vorhandener dedizierter Host kann nicht einer anderen dedizierten Hostgruppe hinzugefügt werden.
DedicatedHostGroupInstanceView
DedicatedHostGroupListResult	Die dedizierte Hostgruppe auflisten mit Ressourcengruppenantwort.
DedicatedHostInstanceViewWithName	Die Instanzansicht eines dedizierten Hosts, der den Namen des dedizierten Hosts enthält. Sie wird für die Antwort auf die Instanzansicht einer dedizierten Hostgruppe verwendet.
InnerError	Innere Fehlerdetails.
InstanceViewStatus	Instanzansichtsstatus.
StatusLevelTypes	Der Ebenencode.
SubResourceReadOnly

AdditionalCapabilities

Objekt

Aktiviert oder deaktiviert eine Funktion für die dedizierte Hostgruppe. Mindest-API-Version: 2022-03-01.

Name	Typ	Beschreibung
ultraSSDEnabled	boolean	Das Kennzeichen, das eine Funktion aktiviert oder deaktiviert, um ultraSSD-aktivierte virtuelle Computer auf dedizierten Hosts der dedizierten Hostgruppe zu verwenden. Damit die virtuellen Computer ultraSSD aktiviert sind, muss auch das UltraSSDEnabled-Flag für die Ressource auf "true" festgelegt werden. Der Wert ist standardmäßig auf "false" festgelegt, wenn er nicht angegeben wird. Weitere Informationen zum Ultra SSD-Feature finden Sie unter https://docs.microsoft.com/en-us/azure/virtual-machines/disks-enable-ultra-ssd. Hinweis: Die Einstellung "ultraSSDEnabled" kann nur für Hostgruppen aktiviert werden, die als Zonal erstellt werden. Mindest-API-Version: 2022-03-01.

ApiError

Objekt

API-Fehler.

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

ApiErrorBase

Objekt

API-Fehlerbasis.

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

CloudError

Objekt

Eine Fehlerantwort des Computediensts.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

DedicatedHostAllocatableVM

Objekt

Stellt die dedizierte hostlose Kapazität in Bezug auf eine bestimmte VM-Größe dar.

Name	Typ	Beschreibung
count	number (double)	Maximale Anzahl von virtuellen Computern der Größe vmSize, die in die verbleibende Kapazität des dedizierten Hosts passen kann.
vmSize	string	VM-Größe in Bezug auf die nicht genutzte Kapazität dargestellt wird.

DedicatedHostAvailableCapacity

Objekt

Dedizierte Host- und nicht genutzte Kapazität.

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

DedicatedHostGroup

Objekt

Gibt Informationen zur dedizierten Hostgruppe an, der die dedizierten Hosts zugewiesen werden sollen. Derzeit kann ein dedizierter Host nur zur Erstellungszeit einer dedizierten Hostgruppe hinzugefügt werden. Ein vorhandener dedizierter Host kann nicht einer anderen dedizierten Hostgruppe hinzugefügt werden.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
location	string	Ressourcenspeicherort
name	string	Ressourcenname
properties.additionalCapabilities	AdditionalCapabilities	Aktiviert oder deaktiviert eine Funktion für die dedizierte Hostgruppe. Mindest-API-Version: 2022-03-01.
properties.hosts	SubResourceReadOnly[]	Eine Liste der Verweise auf alle dedizierten Hosts in der dedizierten Hostgruppe.
properties.instanceView	DedicatedHostGroupInstanceView	Die dedizierte Hostgruppeninstanzansicht mit der Liste der Instanzansicht der dedizierten Hosts unter der dedizierten Hostgruppe.
properties.platformFaultDomainCount	integer (int32) minimum: 1	Anzahl der Fehlerdomänen, die die Hostgruppe umfassen kann.
properties.supportAutomaticPlacement	boolean	Gibt an, ob virtuelle Computer oder Skalierungsgruppen für virtuelle Computer automatisch in der dedizierten Hostgruppe platziert werden können. Automatische Platzierung bedeutet, dass Ressourcen auf dedizierten Hosts zugewiesen werden, die von Azure unter der dedizierten Hostgruppe ausgewählt werden. Der Wert ist standardmäßig auf "false" festgelegt, wenn er nicht angegeben wird. Mindest-API-Version: 2020-06-01.
tags	object	Ressourcenetiketten
type	string	Ressourcentyp
zones	string[]	Verfügbarkeitszone, die für diese Hostgruppe verwendet werden soll. Es wird nur eine einzelne Zone unterstützt. Die Zone kann nur während der Erstellung zugewiesen werden. Wenn nicht angegeben, unterstützt die Gruppe alle Zonen in der Region. Wenn angegeben, erzwingt jeder Host in der Gruppe, dass er sich in derselben Zone befindet.

DedicatedHostGroupInstanceView

Objekt

Name	Typ	Beschreibung
hosts	DedicatedHostInstanceViewWithName[]	Liste der Instanzansicht der dedizierten Hosts unter der dedizierten Hostgruppe.

DedicatedHostGroupListResult

Objekt

Die dedizierte Hostgruppe auflisten mit Ressourcengruppenantwort.

Name	Typ	Beschreibung
nextLink	string	Der URI zum Abrufen der nächsten Seite dedizierter Hostgruppen. Call ListNext() mit diesem URI, um die nächste Seite der dedizierten Hostgruppen abzurufen.
value	DedicatedHostGroup[]	Die Liste der dedizierten Hostgruppen

DedicatedHostInstanceViewWithName

Objekt

Die Instanzansicht eines dedizierten Hosts, der den Namen des dedizierten Hosts enthält. Sie wird für die Antwort auf die Instanzansicht einer dedizierten Hostgruppe verwendet.

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

InnerError

Objekt

Innere Fehlerdetails.

Name	Typ	Beschreibung
errordetail	string	Die interne Fehlermeldung oder das Ausnahmeabbild.
exceptiontype	string	Der Ausnahmetyp.

InstanceViewStatus

Objekt

Instanzansichtsstatus.

Name	Typ	Beschreibung
code	string	Der Statuscode.
displayStatus	string	Die kurze lokalisierbare Bezeichnung für den Status.
level	StatusLevelTypes	Der Ebenencode.
message	string	Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen.
time	string (date-time)	Die Uhrzeit des Status.

StatusLevelTypes

Enumeration

Der Ebenencode.

Wert	Beschreibung
Error
Info
Warning

SubResourceReadOnly

Objekt

Name	Typ	Beschreibung
id	string	Ressourcen-ID