Dedicated Hosts - Get
Načte informace o vyhrazeném hostiteli.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?$expand={$expand}&api-version=2024-03-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
host
|
path | True |
string |
Název vyhrazené skupiny hostitelů. |
host
|
path | True |
string |
Název vyhrazeného hostitele. |
resource
|
path | True |
string |
Název skupiny prostředků. |
subscription
|
path | True |
string |
Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
$expand
|
query |
Výraz rozbalení, který se má použít na operaci. InstanceView načte seznam zobrazení instancí vyhrazeného hostitele. U vyhrazeného hostitele není podporována hodnota UserData. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Get a dedicated host.
Sample Request
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myDedicatedHostGroup/hosts/myHost?$expand=instanceView&api-version=2024-03-01
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myHost",
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}",
"provisioningTime": "2019-06-27T01:02:38.3138469+00:00",
"virtualMachines": [
{
"id": "/subscriptions/subId/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/vm1"
}
],
"provisioningState": "Succeeded",
"instanceView": {
"assetId": "eb3f58b8-b4e8-4882-b69f-301a01812407",
"availableCapacity": {
"allocatableVMs": [
{
"vmSize": "Standard_A1",
"count": 10
}
]
},
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded"
},
{
"code": "HealthState/available",
"level": "Info",
"displayStatus": "Host available"
}
]
},
"timeCreated": "2019-06-27T01:02:38.3138469+00:00"
},
"location": "westus",
"tags": {
"department": "HR"
},
"sku": {
"name": "DSv3-Type1"
},
"name": "myHost"
}
Definice
Name | Description |
---|---|
Api |
Chyba rozhraní API |
Api |
Základ chyb rozhraní API. |
Cloud |
Chybová odpověď ze služby Compute. |
Dedicated |
Určuje informace o vyhrazeném hostiteli. |
Dedicated |
Představuje nevyužitou kapacitu vyhrazeného hostitele z hlediska konkrétní velikosti virtuálního počítače. |
Dedicated |
Nevyužitá kapacita vyhrazeného hostitele |
Dedicated |
Zobrazení instance vyhrazeného hostitele. |
Dedicated |
Určuje typ softwarové licence, která se použije na virtuální počítače nasazené na vyhrazeném hostiteli. Možné hodnoty jsou: Žádné,Windows_Server_Hybrid,Windows_Server_Perpetual. Výchozí hodnota je: Žádný. |
Inner |
Podrobnosti o vnitřní chybě. |
Instance |
Stav zobrazení instance. |
Instance |
Výraz rozbalení, který se má použít na operaci. InstanceView načte seznam zobrazení instancí vyhrazeného hostitele. U vyhrazeného hostitele není podporována hodnota UserData. |
Sku |
Popisuje skladovou položku škálovací sady virtuálních počítačů. POZNÁMKA: Pokud se nová skladová položka virtuálního počítače nepodporuje na hardwaru, na který se škálovací sada aktuálně nachází, musíte před úpravou názvu skladové položky uvolnit virtuální počítače ve škálovací sadě. |
Status |
Kód úrovně. |
Sub |
ApiError
Chyba rozhraní API
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě rozhraní API |
|
innererror |
Vnitřní chyba rozhraní API |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl konkrétní chyby. |
ApiErrorBase
Základ chyb rozhraní API.
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
message |
string |
Chybová zpráva |
target |
string |
Cíl konkrétní chyby. |
CloudError
Chybová odpověď ze služby Compute.
Name | Typ | Description |
---|---|---|
error |
Chyba rozhraní API |
DedicatedHost
Určuje informace o vyhrazeném hostiteli.
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku |
location |
string |
Umístění prostředku |
name |
string |
Název prostředku |
properties.autoReplaceOnFailure |
boolean |
Určuje, jestli má být vyhrazený hostitel v případě selhání automaticky nahrazen. Hodnota je ve výchozím nastavení true, pokud není zadaná. |
properties.hostId |
string |
Jedinečné ID vygenerované a přiřazené vyhrazenému hostiteli platformou. Nemění se po celou dobu životnosti hostitele. |
properties.instanceView |
Zobrazení vyhrazené instance hostitele |
|
properties.licenseType |
Určuje typ softwarové licence, která se použije na virtuální počítače nasazené na vyhrazeném hostiteli. Možné hodnoty jsou: Žádné,Windows_Server_Hybrid,Windows_Server_Perpetual. Výchozí hodnota je: Žádný. |
|
properties.platformFaultDomain |
integer |
Doména selhání vyhrazeného hostitele v rámci vyhrazené skupiny hostitelů |
properties.provisioningState |
string |
Stav zřizování, který se zobrazí pouze v odpovědi. |
properties.provisioningTime |
string |
Datum, kdy byl hostitel poprvé zřízen. |
properties.timeCreated |
string |
Určuje čas vytvoření prostředku Dedicated Host. Minimální verze rozhraní API: 2021-11-01. |
properties.virtualMachines |
Seznam odkazů na všechny virtuální počítače ve vyhrazeném hostiteli. |
|
sku |
Skladová položka vyhrazeného hostitele pro generaci hardwaru a řadu virtuálních počítačů. Je nutné nastavit pouze název. Seznam možných hodnot zobrazí seznam skladových položek Microsoft.Compute. |
|
tags |
object |
Značky prostředků |
type |
string |
Typ prostředku |
DedicatedHostAllocatableVM
Představuje nevyužitou kapacitu vyhrazeného hostitele z hlediska konkrétní velikosti virtuálního počítače.
Name | Typ | Description |
---|---|---|
count |
number |
Maximální počet virtuálních počítačů o velikosti vmSize, které se vejdou do zbývající kapacity vyhrazeného hostitele. |
vmSize |
string |
Velikost virtuálního počítače, ve které je vyjádřena nevyužitá kapacita. |
DedicatedHostAvailableCapacity
Nevyužitá kapacita vyhrazeného hostitele
Name | Typ | Description |
---|---|---|
allocatableVMs |
Nevyužitá kapacita vyhrazeného hostitele vyjádřená z hlediska velikosti jednotlivých virtuálních počítačů, které je možné nasadit na vyhrazeného hostitele. |
DedicatedHostInstanceView
Zobrazení instance vyhrazeného hostitele.
Name | Typ | Description |
---|---|---|
assetId |
string |
Určuje jedinečné ID vyhrazeného fyzického počítače, na kterém se nachází vyhrazený hostitel. |
availableCapacity |
Nevyužitá kapacita vyhrazeného hostitele. |
|
statuses |
Informace o stavu prostředku. |
DedicatedHostLicenseTypes
Určuje typ softwarové licence, která se použije na virtuální počítače nasazené na vyhrazeném hostiteli. Možné hodnoty jsou: Žádné,Windows_Server_Hybrid,Windows_Server_Perpetual. Výchozí hodnota je: Žádný.
Name | Typ | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
InnerError
Podrobnosti o vnitřní chybě.
Name | Typ | Description |
---|---|---|
errordetail |
string |
Vnitřní chybová zpráva nebo výpis výjimky. |
exceptiontype |
string |
Typ výjimky. |
InstanceViewStatus
Stav zobrazení instance.
Name | Typ | Description |
---|---|---|
code |
string |
Stavový kód. |
displayStatus |
string |
Krátký lokalizovatelný popisek stavu. |
level |
Kód úrovně. |
|
message |
string |
Podrobná stavová zpráva, včetně upozornění a chybových zpráv. |
time |
string |
Čas stavu. |
InstanceViewTypes
Výraz rozbalení, který se má použít na operaci. InstanceView načte seznam zobrazení instancí vyhrazeného hostitele. U vyhrazeného hostitele není podporována hodnota UserData.
Name | Typ | Description |
---|---|---|
instanceView |
string |
|
userData |
string |
Sku
Popisuje skladovou položku škálovací sady virtuálních počítačů. POZNÁMKA: Pokud se nová skladová položka virtuálního počítače nepodporuje na hardwaru, na který se škálovací sada aktuálně nachází, musíte před úpravou názvu skladové položky uvolnit virtuální počítače ve škálovací sadě.
Name | Typ | Description |
---|---|---|
capacity |
integer |
Určuje počet virtuálních počítačů ve škálovací sadě. |
name |
string |
Název skladové položky. |
tier |
string |
Určuje úroveň virtuálních počítačů ve škálovací sadě. |
StatusLevelTypes
Kód úrovně.
Name | Typ | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku |