Dedicated Hosts - Update
Aktualizujte vyhrazeného hostitele .
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?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. |
Text požadavku
Name | Typ | Description |
---|---|---|
properties.autoReplaceOnFailure |
boolean |
Určuje, jestli má být vyhrazený hostitel v případě selhání automaticky nahrazen. Pokud není hodnota zadaná, nastaví se jako výchozí hodnota true. |
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: None,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ů |
sku |
[Uveďte všechny dostupné velikosti vyhrazených hostitelů pro změnu velikosti.] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes). Změna velikosti se dá použít jenom k vertikálnímu navýšení kapacity DedicatedHost. Je nutné nastavit pouze název. |
|
tags |
object |
Značky prostředků |
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
Dedicated |
Dedicated |
Dedicated |
DedicatedHost_Update_MaximumSet_Gen
Sample Request
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"
}
}
Sample Response
{
"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
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aa/hosts/aaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
{}
Sample Response
{
"location": "westus",
"sku": {}
}
DedicatedHost_Update_Resize
Sample Request
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"
}
}
Sample Response
{
"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"
}
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: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Výchozí hodnota je: Žádná. |
Dedicated |
Určuje informace o vyhrazeném hostiteli. Je možné aktualizovat pouze značky, autoReplaceOnFailure a licenseType. |
Inner |
Podrobnosti o vnitřní chybě. |
Instance |
Stav zobrazení instance. |
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. Pokud není hodnota zadaná, nastaví se jako výchozí hodnota true. |
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í instance vyhrazeného 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: None,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 vyhrazeného hostitele. Minimální verze api:2021-11-01. |
properties.virtualMachines |
Seznam odkazů na všechny virtuální počítače ve vyhrazeném hostiteli. |
|
sku |
SKU 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 jednotlivých velikostí virtuálních počítačů, které je možné na vyhrazeného hostitele nasadit. |
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 zdroje. |
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: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Výchozí hodnota je: Žádná.
Name | Typ | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
DedicatedHostUpdate
Určuje informace o vyhrazeném hostiteli. Je možné aktualizovat pouze značky, autoReplaceOnFailure a licenseType.
Name | Typ | Description |
---|---|---|
properties.autoReplaceOnFailure |
boolean |
Určuje, jestli má být vyhrazený hostitel v případě selhání automaticky nahrazen. Pokud není hodnota zadaná, nastaví se jako výchozí hodnota true. |
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í instance vyhrazeného 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: None,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 vyhrazeného hostitele. Minimální verze api:2021-11-01. |
properties.virtualMachines |
Seznam odkazů na všechny virtuální počítače ve vyhrazeném hostiteli. |
|
sku |
[Uveďte všechny dostupné velikosti vyhrazených hostitelů pro změnu velikosti.] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes). Změna velikosti se dá použít jenom k vertikálnímu navýšení kapacity DedicatedHost. Je nutné nastavit pouze název. |
|
tags |
object |
Značky prostředků |
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ě výstrah a chybových zpráv. |
time |
string |
Čas stavu. |
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 |