Dedicated Hosts - Get
Hämtar information om en dedikerad värd.
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
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
host
|
path | True |
string |
Namnet på den dedikerade värdgruppen. |
host
|
path | True |
string |
Namnet på den dedikerade värden. |
resource
|
path | True |
string |
Namnet på resursgruppen. |
subscription
|
path | True |
string |
Autentiseringsuppgifter för prenumeration som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop. |
api-version
|
query | True |
string |
Klient-API-version. |
$expand
|
query |
Expanderingsuttrycket som ska tillämpas på åtgärden. "InstanceView" hämtar listan över instansvyer för den dedikerade värden. UserData stöds inte för dedikerad värd. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
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"
}
Definitioner
Name | Description |
---|---|
Api |
API-fel. |
Api |
Api-felbas. |
Cloud |
Ett felsvar från Beräkningstjänsten. |
Dedicated |
Anger information om den dedikerade värden. |
Dedicated |
Representerar den dedikerade värdkapaciteten som inte används i termer av en specifik VM-storlek. |
Dedicated |
Ej utnyttjad kapacitet för dedikerad värd. |
Dedicated |
Instansvyn för en dedikerad värd. |
Dedicated |
Anger vilken typ av programvarulicens som ska tillämpas på de virtuella datorer som distribueras på den dedikerade värden. Möjliga värden är: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Standardvärdet är: Ingen. |
Inner |
Inre felinformation. |
Instance |
Status för instansvyn. |
Instance |
Expanderingsuttrycket som ska tillämpas på åtgärden. "InstanceView" hämtar listan över instansvyer för den dedikerade värden. UserData stöds inte för dedikerad värd. |
Sku |
Beskriver en SKU för VM-skalningsuppsättningar. Obs! Om den nya VM-SKU:n inte stöds på maskinvaran som skalningsuppsättningen för närvarande är på, måste du frigöra de virtuella datorerna i skalningsuppsättningen innan du ändrar SKU-namnet. |
Status |
Nivåkoden. |
Sub |
ApiError
API-fel.
Name | Typ | Description |
---|---|---|
code |
string |
Felkoden. |
details |
Api-felinformationen |
|
innererror |
Api:ets inre fel |
|
message |
string |
Felmeddelandet. |
target |
string |
Målet för det specifika felet. |
ApiErrorBase
Api-felbas.
Name | Typ | Description |
---|---|---|
code |
string |
Felkoden. |
message |
string |
Felmeddelandet. |
target |
string |
Målet för det specifika felet. |
CloudError
Ett felsvar från Beräkningstjänsten.
Name | Typ | Description |
---|---|---|
error |
API-fel. |
DedicatedHost
Anger information om den dedikerade värden.
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID |
location |
string |
Resursplats |
name |
string |
Resursnamn |
properties.autoReplaceOnFailure |
boolean |
Anger om den dedikerade värden ska ersättas automatiskt vid fel. Värdet är som standard "true" när det inte anges. |
properties.hostId |
string |
Ett unikt ID som genereras och tilldelas till den dedikerade värden av plattformen. Ändras inte under värdens livslängd. |
properties.instanceView |
Vyn för den dedikerade värdinstansen. |
|
properties.licenseType |
Anger vilken typ av programvarulicens som ska tillämpas på de virtuella datorer som distribueras på den dedikerade värden. Möjliga värden är: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Standardvärdet är: Ingen. |
|
properties.platformFaultDomain |
integer |
Feldomän för den dedikerade värden i en dedikerad värdgrupp. |
properties.provisioningState |
string |
Etableringstillståndet, som bara visas i svaret. |
properties.provisioningTime |
string |
Det datum då värden först etablerades. |
properties.timeCreated |
string |
Anger den tidpunkt då den dedikerade värdresursen skapades. Lägsta API-version: 2021-11-01. |
properties.virtualMachines |
En lista med referenser till alla virtuella datorer i den dedikerade värden. |
|
sku |
SKU för den dedikerade värden för maskinvarugenerering och VM-familj. Endast namn krävs för att anges. Lista Microsoft.Compute-SKU:er för en lista över möjliga värden. |
|
tags |
object |
Resurstaggar |
type |
string |
Resurstyp |
DedicatedHostAllocatableVM
Representerar den dedikerade värdkapaciteten som inte används i termer av en specifik VM-storlek.
Name | Typ | Description |
---|---|---|
count |
number |
Maximalt antal virtuella datorer av storlek vmSize som får plats i den dedikerade värdens återstående kapacitet. |
vmSize |
string |
Vm-storlek som den outnyttvända kapaciteten representeras av. |
DedicatedHostAvailableCapacity
Ej utnyttjad kapacitet för dedikerad värd.
Name | Typ | Description |
---|---|---|
allocatableVMs |
Den outnyttvända kapaciteten för den dedikerade värden representeras av varje VM-storlek som tillåts distribueras till den dedikerade värden. |
DedicatedHostInstanceView
Instansvyn för en dedikerad värd.
Name | Typ | Description |
---|---|---|
assetId |
string |
Anger det unika ID:t för den dedikerade fysiska dator där den dedikerade värden finns. |
availableCapacity |
Outnyttkommen kapacitet för den dedikerade värden. |
|
statuses |
Resursstatusinformationen. |
DedicatedHostLicenseTypes
Anger vilken typ av programvarulicens som ska tillämpas på de virtuella datorer som distribueras på den dedikerade värden. Möjliga värden är: None,Windows_Server_Hybrid,Windows_Server_Perpetual. Standardvärdet är: Ingen.
Name | Typ | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
InnerError
Inre felinformation.
Name | Typ | Description |
---|---|---|
errordetail |
string |
Det interna felmeddelandet eller undantagsdumpen. |
exceptiontype |
string |
Undantagstypen. |
InstanceViewStatus
Status för instansvyn.
Name | Typ | Description |
---|---|---|
code |
string |
Statuskoden. |
displayStatus |
string |
Den korta localizable-etiketten för statusen. |
level |
Nivåkoden. |
|
message |
string |
Det detaljerade statusmeddelandet, inklusive för aviseringar och felmeddelanden. |
time |
string |
Tidpunkten för statusen. |
InstanceViewTypes
Expanderingsuttrycket som ska tillämpas på åtgärden. "InstanceView" hämtar listan över instansvyer för den dedikerade värden. UserData stöds inte för dedikerad värd.
Name | Typ | Description |
---|---|---|
instanceView |
string |
|
userData |
string |
Sku
Beskriver en SKU för VM-skalningsuppsättningar. Obs! Om den nya VM-SKU:n inte stöds på maskinvaran som skalningsuppsättningen för närvarande är på, måste du frigöra de virtuella datorerna i skalningsuppsättningen innan du ändrar SKU-namnet.
Name | Typ | Description |
---|---|---|
capacity |
integer |
Anger antalet virtuella datorer i skalningsuppsättningen. |
name |
string |
SKU-namnet. |
tier |
string |
Anger nivån för virtuella datorer i en skalningsuppsättning. |
StatusLevelTypes
Nivåkoden.
Name | Typ | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID |