你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Dedicated Hosts - List By Host Group
Lists指定专用主机组中的所有专用主机。 在响应中使用 nextLink 属性获取专用主机的下一页。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts?api-version=2024-03-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
host
|
path | True |
string |
专用主机组的名称。 |
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Dedicated |
Dedicated |
DedicatedHost_ListByHostGroup_MaximumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/hosts?api-version=2024-03-01
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
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaa/hosts?api-version=2024-03-01
Sample Response
{
"value": [
{
"location": "westus",
"sku": {},
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myHost"
}
]
}
定义
名称 | 说明 |
---|---|
Api |
Api 错误。 |
Api |
Api 错误基。 |
Cloud |
来自计算服务的错误响应。 |
Dedicated |
指定有关专用主机的信息。 |
Dedicated |
表示特定 VM 大小的专用主机未使用容量。 |
Dedicated |
专用主机未使用容量。 |
Dedicated |
专用主机的实例视图。 |
Dedicated |
指定将应用于部署在专用主机上的 VM 的软件许可证类型。 可能的值为: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默认值为: None。 |
Dedicated |
列表专用主机操作响应。 |
Inner |
内部错误详细信息。 |
Instance |
实例视图状态。 |
Sku |
介绍虚拟机规模集 SKU。 注意:如果规模集当前使用的硬件不支持新的 VM SKU,则需要在修改 SKU 名称之前解除分配规模集中的 VM。 |
Status |
级别代码。 |
Sub |
ApiError
Api 错误。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
details |
Api 错误详细信息 |
|
innererror |
Api 内部错误 |
|
message |
string |
错误消息。 |
target |
string |
特定错误的目标。 |
ApiErrorBase
Api 错误基。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
message |
string |
错误消息。 |
target |
string |
特定错误的目标。 |
CloudError
来自计算服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
Api 错误。 |
DedicatedHost
指定有关专用主机的信息。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID |
location |
string |
资源位置 |
name |
string |
资源名称 |
properties.autoReplaceOnFailure |
boolean |
指定在发生故障时是否应自动替换专用主机。 如果未提供该值,则该值默认为“true”。 |
properties.hostId |
string |
由平台生成并分配给专用主机的唯一 ID。 在主机的整个生存期内不会更改。 |
properties.instanceView |
专用主机实例视图。 |
|
properties.licenseType |
指定将应用于部署在专用主机上的 VM 的软件许可证类型。 可能的值为: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默认值为: None。 |
|
properties.platformFaultDomain |
integer |
专用主机组中专用主机的容错域。 |
properties.provisioningState |
string |
预配状态,仅显示在响应中。 |
properties.provisioningTime |
string |
首次预配主机的日期。 |
properties.timeCreated |
string |
指定创建专用主机资源的时间。 最低 API 版本:2021-11-01。 |
properties.virtualMachines |
对专用主机中所有虚拟机的引用列表。 |
|
sku |
硬件代系和 VM 系列的专用主机的 SKU。 只需设置名称。 列出 Microsoft.Compute SKU 以获取可能值的列表。 |
|
tags |
object |
资源标记 |
type |
string |
资源类型 |
DedicatedHostAllocatableVM
表示特定 VM 大小的专用主机未使用容量。
名称 | 类型 | 说明 |
---|---|---|
count |
number |
可以容纳专用主机剩余容量的 vmSize 大小的最大 VM 数。 |
vmSize |
string |
表示未使用的容量的 VM 大小。 |
DedicatedHostAvailableCapacity
专用主机未使用容量。
名称 | 类型 | 说明 |
---|---|---|
allocatableVMs |
专用主机的未使用容量表示为允许部署到专用主机的每个 VM 大小。 |
DedicatedHostInstanceView
专用主机的实例视图。
名称 | 类型 | 说明 |
---|---|---|
assetId |
string |
指定专用主机所在的专用物理计算机的唯一 ID。 |
availableCapacity |
专用主机的未使用容量。 |
|
statuses |
资源状态信息。 |
DedicatedHostLicenseTypes
指定将应用于部署在专用主机上的 VM 的软件许可证类型。 可能的值为: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默认值为: None。
名称 | 类型 | 说明 |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
DedicatedHostListResult
列表专用主机操作响应。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
用于提取专用主机的下一页的 URI。 使用此 URI 调用 ListNext () 来提取专用主机的下一页。 |
value |
专用主机列表 |
InnerError
内部错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
errordetail |
string |
内部错误消息或异常转储。 |
exceptiontype |
string |
异常类型。 |
InstanceViewStatus
实例视图状态。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
状态代码。 |
displayStatus |
string |
状态的简短可本地化标签。 |
level |
级别代码。 |
|
message |
string |
详细状态消息,包括警报和错误消息。 |
time |
string |
状态的时间。 |
Sku
介绍虚拟机规模集 SKU。 注意:如果规模集当前使用的硬件不支持新的 VM SKU,则需要在修改 SKU 名称之前解除分配规模集中的 VM。
名称 | 类型 | 说明 |
---|---|---|
capacity |
integer |
指定规模集中的虚拟机数。 |
name |
string |
SKU 名称。 |
tier |
string |
指定规模集中虚拟机的层。 |
StatusLevelTypes
级别代码。
名称 | 类型 | 说明 |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID |