Dedicated Hosts - List By Host Group
Listy wszystkich dedykowanych hostów w określonej dedykowanej grupie hostów. Użyj właściwości nextLink w odpowiedzi, aby uzyskać następną stronę dedykowanych hostów.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts?api-version=2024-03-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
host
|
path | True |
string |
Nazwa dedykowanej grupy hostów. |
resource
|
path | True |
string |
Nazwa grupy zasobów. |
subscription
|
path | True |
string |
Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Dedicated |
Dedicated |
DedicatedHost_ListByHostGroup_MaximumSet_Gen
Sample Request
Sample Response
{
"value": [
{
"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"
}
],
"nextLink": "aaaaaaa"
}
DedicatedHost_ListByHostGroup_MinimumSet_Gen
Sample Request
Sample Response
{
"value": [
{
"location": "westus",
"sku": {},
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myHost"
}
]
}
Definicje
Nazwa | Opis |
---|---|
Api |
Błąd interfejsu API. |
Api |
Baza błędów interfejsu API. |
Cloud |
Odpowiedź o błędzie z usługi Compute. |
Dedicated |
Określa informacje o dedykowanym hoście. |
Dedicated |
Reprezentuje dedykowaną pojemność nieuprawnionego hosta pod względem określonego rozmiaru maszyny wirtualnej. |
Dedicated |
Dedykowana pojemność hosta nieuprawnionego. |
Dedicated |
Widok wystąpienia dedykowanego hosta. |
Dedicated |
Określa typ licencji oprogramowania, który zostanie zastosowany do maszyn wirtualnych wdrożonych na dedykowanym hoście. Możliwe wartości to: Brak,Windows_Server_Hybrid,Windows_Server_Perpetual. Wartość domyślna to: Brak. |
Dedicated |
Lista dedykowana odpowiedź operacji hosta. |
Inner |
Szczegóły błędu wewnętrznego. |
Instance |
Stan widoku wystąpienia. |
Sku |
Opisuje jednostkę SKU zestawu skalowania maszyn wirtualnych. UWAGA: Jeśli nowa jednostka SKU maszyny wirtualnej nie jest obecnie obsługiwana na sprzęcie, zestaw skalowania jest obecnie włączony, należy cofnąć przydział maszyn wirtualnych w zestawie skalowania przed zmodyfikowaniem nazwy jednostki SKU. |
Status |
Kod poziomu. |
Sub |
ApiError
Błąd interfejsu API.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu. |
details |
Szczegóły błędu interfejsu API |
|
innererror |
Wewnętrzny błąd interfejsu API |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy określonego błędu. |
ApiErrorBase
Baza błędów interfejsu API.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod błędu. |
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy określonego błędu. |
CloudError
Odpowiedź o błędzie z usługi Compute.
Nazwa | Typ | Opis |
---|---|---|
error |
Błąd interfejsu API. |
DedicatedHost
Określa informacje o dedykowanym hoście.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu |
location |
string |
Lokalizacja zasobu |
name |
string |
Nazwa zasobu |
properties.autoReplaceOnFailure |
boolean |
Określa, czy dedykowany host powinien zostać automatycznie zastąpiony w przypadku awarii. Wartość jest domyślnie ustawiona na wartość "true", jeśli nie zostanie podana. |
properties.hostId |
string |
Unikatowy identyfikator wygenerowany i przypisany do dedykowanego hosta przez platformę. Nie zmienia się przez cały okres istnienia hosta. |
properties.instanceView |
Widok dedykowanego wystąpienia hosta. |
|
properties.licenseType |
Określa typ licencji oprogramowania, który zostanie zastosowany do maszyn wirtualnych wdrożonych na dedykowanym hoście. Możliwe wartości to: Brak,Windows_Server_Hybrid,Windows_Server_Perpetual. Wartość domyślna to: Brak. |
|
properties.platformFaultDomain |
integer |
Domena błędów dedykowanego hosta w dedykowanej grupie hostów. |
properties.provisioningState |
string |
Stan aprowizacji, który pojawia się tylko w odpowiedzi. |
properties.provisioningTime |
string |
Data pierwszej aprowizacji hosta. |
properties.timeCreated |
string |
Określa czas utworzenia zasobu dedykowanego hosta. Minimalna wersja interfejsu API: 2021-11-01. |
properties.virtualMachines |
Lista odwołań do wszystkich maszyn wirtualnych na dedykowanym hoście. |
|
sku |
Jednostka SKU dedykowanego hosta dla rodziny sprzętu i maszyn wirtualnych. Do ustawienia jest wymagana tylko nazwa. Wyświetl listę jednostek SKU Microsoft.Compute, aby uzyskać listę możliwych wartości. |
|
tags |
object |
Tagi zasobów |
type |
string |
Typ zasobu |
DedicatedHostAllocatableVM
Reprezentuje dedykowaną pojemność nieuprawnionego hosta pod względem określonego rozmiaru maszyny wirtualnej.
Nazwa | Typ | Opis |
---|---|---|
count |
number |
Maksymalna liczba maszyn wirtualnych o rozmiarze vmSize, które mogą mieścić się w pozostałej pojemności dedykowanego hosta. |
vmSize |
string |
Rozmiar maszyny wirtualnej, dla którego jest reprezentowana nieuprawnionej pojemności. |
DedicatedHostAvailableCapacity
Dedykowana pojemność hosta nieuprawnionego.
Nazwa | Typ | Opis |
---|---|---|
allocatableVMs |
Nieuprawnionej pojemności dedykowanego hosta reprezentowanego pod względem każdego rozmiaru maszyny wirtualnej, który może zostać wdrożony na dedykowanym hoście. |
DedicatedHostInstanceView
Widok wystąpienia dedykowanego hosta.
Nazwa | Typ | Opis |
---|---|---|
assetId |
string |
Określa unikatowy identyfikator dedykowanej maszyny fizycznej, na której znajduje się dedykowany host. |
availableCapacity |
Nieuprawnionej pojemności dedykowanego hosta. |
|
statuses |
Informacje o stanie zasobu. |
DedicatedHostLicenseTypes
Określa typ licencji oprogramowania, który zostanie zastosowany do maszyn wirtualnych wdrożonych na dedykowanym hoście. Możliwe wartości to: Brak,Windows_Server_Hybrid,Windows_Server_Perpetual. Wartość domyślna to: Brak.
Nazwa | Typ | Opis |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
DedicatedHostListResult
Lista dedykowana odpowiedź operacji hosta.
Nazwa | Typ | Opis |
---|---|---|
nextLink |
string |
Identyfikator URI do pobrania następnej strony dedykowanych hostów. Wywołaj metodę ListNext() za pomocą tego identyfikatora URI, aby pobrać następną stronę dedykowanych hostów. |
value |
Lista dedykowanych hostów |
InnerError
Szczegóły błędu wewnętrznego.
Nazwa | Typ | Opis |
---|---|---|
errordetail |
string |
Wewnętrzny komunikat o błędzie lub zrzut wyjątku. |
exceptiontype |
string |
Typ wyjątku. |
InstanceViewStatus
Stan widoku wystąpienia.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Kod stanu. |
displayStatus |
string |
Krótka etykieta lokalizowalna dla stanu. |
level |
Kod poziomu. |
|
message |
string |
Szczegółowy komunikat o stanie, w tym alerty i komunikaty o błędach. |
time |
string |
Czas stanu. |
Sku
Opisuje jednostkę SKU zestawu skalowania maszyn wirtualnych. UWAGA: Jeśli nowa jednostka SKU maszyny wirtualnej nie jest obecnie obsługiwana na sprzęcie, zestaw skalowania jest obecnie włączony, należy cofnąć przydział maszyn wirtualnych w zestawie skalowania przed zmodyfikowaniem nazwy jednostki SKU.
Nazwa | Typ | Opis |
---|---|---|
capacity |
integer |
Określa liczbę maszyn wirtualnych w zestawie skalowania. |
name |
string |
Nazwa jednostki SKU. |
tier |
string |
Określa warstwę maszyn wirtualnych w zestawie skalowania. |
StatusLevelTypes
Kod poziomu.
Nazwa | Typ | Opis |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu |