你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Machines - List By Resource Group

参考

服务:: Hybrid Compute

API 版本:: 2025-01-13

列出指定资源组中的所有混合计算机。使用响应中的 nextLink 属性获取混合计算机的下一页。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines?api-version=2025-01-13

具有可选参数:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines?api-version=2025-01-13&$expand={$expand}

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。名称不区分大小写。
subscriptionId	path	True	string minLength: 1	目标订阅的 ID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。
$expand	query		string	展开引用的资源。

响应

名称	类型	说明
200 OK	MachineListResult	还行
Other Status Codes	ErrorResponse	描述作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

List Machines by resource group

示例请求

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines?api-version=2025-01-13

示例响应

状态代码:: 200

{
  "value": [
    {
      "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine",
      "name": "myMachine",
      "location": "eastus2euap",
      "tags": null,
      "identity": {
        "type": "SystemAssigned",
        "principalId": "f7a068cc-b0b8-46e8-a203-22f301a62a8f",
        "tenantId": "c4098cc-91b8-46c2-a205-d82ab1a62a8f"
      },
      "type": "Microsoft.HybridCompute/machines",
      "kind": null,
      "properties": {
        "provisioningState": "Succeeded",
        "agentVersion": null,
        "status": null,
        "lastStatusChange": null,
        "errorDetails": null,
        "displayName": null,
        "machineFqdn": null,
        "vmUuid": null,
        "osSku": null,
        "osEdition": "Standard",
        "domainName": null,
        "adFqdn": null,
        "dnsFqdn": null,
        "osVersion": null,
        "osType": null,
        "osProfile": {
          "computerName": null,
          "windowsConfiguration": {
            "patchSettings": {
              "assessmentMode": null,
              "patchMode": null,
              "enableHotpatching": true,
              "status": {
                "hotpatchEnablementStatus": "Enabled",
                "error": null
              }
            }
          },
          "linuxConfiguration": {
            "patchSettings": {
              "assessmentMode": null,
              "patchMode": null
            }
          }
        },
        "licenseProfile": {
          "licenseStatus": "Licensed",
          "licenseChannel": "PSG",
          "softwareAssurance": {
            "softwareAssuranceCustomer": true
          },
          "esuProfile": {
            "licenseAssignmentState": "Assigned",
            "esuEligibility": "Ineligible",
            "serverType": "Standard",
            "esuKeyState": "Inactive",
            "esuKeys": [
              {
                "sku": "skuNumber1",
                "licenseStatus": 1
              },
              {
                "sku": "skuNumber2",
                "licenseStatus": 1
              }
            ]
          },
          "productProfile": {
            "subscriptionStatus": "Enabled",
            "productType": "WindowsServer",
            "enrollmentDate": "2023-10-05T20:36:49.745Z",
            "billingStartDate": "2023-10-05T20:36:49.745Z",
            "disenrollmentDate": "2023-11-05T20:36:49.745Z",
            "billingEndDate": "2023-11-05T20:36:49.745Z",
            "productFeatures": [
              {
                "name": "Hotpatch",
                "subscriptionStatus": "Enabled",
                "enrollmentDate": "2023-10-05T20:36:49.745Z",
                "billingStartDate": "2023-10-05T20:36:49.745Z",
                "disenrollmentDate": "2023-11-05T20:36:49.745Z",
                "billingEndDate": "2023-11-05T20:36:49.745Z"
              }
            ]
          }
        },
        "vmId": "b7a098cc-b0b8-46e8-a205-62f301a62a8f",
        "locationData": {
          "name": "Redmond"
        },
        "clientPublicKey": "string",
        "parentClusterResourceId": null,
        "mssqlDiscovered": "false",
        "detectedProperties": {
          "cloudprovider": "N/A",
          "manufacturer": "Microsoft Corporation",
          "model": "Virtual Machine"
        },
        "agentConfiguration": {
          "proxyUrl": "https://test.test",
          "incomingConnectionsPorts": [
            "22",
            "23"
          ],
          "extensionsAllowList": null,
          "extensionsBlockList": null,
          "proxyBypass": [
            "proxy1",
            "proxy2"
          ],
          "extensionsEnabled": "true",
          "guestConfigurationEnabled": "true",
          "configMode": "full"
        },
        "privateLinkScopeResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/privateLinkScopes/privateLinkScopeName"
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine2",
      "name": "myMachine2",
      "location": "westus2",
      "tags": null,
      "identity": {
        "type": "SystemAssigned",
        "principalId": "e7a068cc-b0b8-46e8-a203-22f301a62a8f",
        "tenantId": "c4098cc-91b8-46c2-a205-d82ab1a62a8f"
      },
      "type": "Microsoft.HybridCompute/machines",
      "kind": null,
      "properties": {
        "provisioningState": "Succeeded",
        "agentVersion": null,
        "status": null,
        "lastStatusChange": null,
        "errorDetails": null,
        "displayName": null,
        "machineFqdn": null,
        "osEdition": "Standard",
        "osVersion": null,
        "osType": null,
        "osProfile": {
          "computerName": null,
          "windowsConfiguration": {
            "patchSettings": {
              "assessmentMode": null,
              "patchMode": null,
              "enableHotpatching": true,
              "status": {
                "hotpatchEnablementStatus": "Enabled",
                "error": null
              }
            }
          },
          "linuxConfiguration": {
            "patchSettings": {
              "assessmentMode": null,
              "patchMode": null
            }
          }
        },
        "licenseProfile": {
          "licenseStatus": "Licensed",
          "licenseChannel": "PSG",
          "softwareAssurance": {
            "softwareAssuranceCustomer": true
          },
          "esuProfile": {
            "licenseAssignmentState": "Assigned",
            "esuEligibility": "Ineligible",
            "serverType": "Standard",
            "esuKeyState": "Inactive",
            "esuKeys": [
              {
                "sku": "skuNumber1",
                "licenseStatus": 1
              },
              {
                "sku": "skuNumber2",
                "licenseStatus": 1
              }
            ]
          },
          "productProfile": {
            "subscriptionStatus": "Enabled",
            "productType": "WindowsServer",
            "enrollmentDate": "2023-10-05T20:36:49.745Z",
            "billingStartDate": "2023-10-05T20:36:49.745Z",
            "disenrollmentDate": "2023-11-05T20:36:49.745Z",
            "billingEndDate": "2023-11-05T20:36:49.745Z",
            "productFeatures": [
              {
                "name": "Hotpatch",
                "subscriptionStatus": "Enabled",
                "enrollmentDate": "2023-10-05T20:36:49.745Z",
                "billingStartDate": "2023-10-05T20:36:49.745Z",
                "disenrollmentDate": "2023-11-05T20:36:49.745Z",
                "billingEndDate": "2023-11-05T20:36:49.745Z"
              }
            ]
          }
        },
        "vmId": "a4a098cc-b0b8-46e8-a205-62f301a62a8f",
        "locationData": {
          "name": "Redmond"
        },
        "clientPublicKey": "string",
        "parentClusterResourceId": "{AzureStackHCIResourceId}",
        "mssqlDiscovered": "true",
        "detectedProperties": {
          "cloudprovider": "N/A",
          "manufacturer": "Microsoft Corporation",
          "model": "Surfacebook"
        },
        "agentConfiguration": {
          "proxyUrl": "https://test.test",
          "incomingConnectionsPorts": [
            "22",
            "23"
          ],
          "extensionsAllowList": null,
          "extensionsBlockList": null,
          "proxyBypass": [
            "proxy1",
            "proxy2"
          ],
          "extensionsEnabled": "true",
          "guestConfigurationEnabled": "true",
          "configMode": "full"
        },
        "privateLinkScopeResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/privateLinkScopes/privateLinkScopeName"
      }
    }
  ],
  "nextLink": null
}

定义

名称	说明
agent configuration mode	要使用的配置模式的名称。模式是Microsoft维护的安全控制、扩展允许列表和来宾配置的预定义配置。
AgentConfiguration	用户可以通过 azcmagent config 命令或通过 ARM 远程设置的可配置属性。
AgentUpgrade	信息 w.r.t 代理升级。
ArcKindEnum	指示本地放置哪个类型的 Arc 计算机，例如 HCI、SCVMM 或 VMware 等。
AssessmentModeTypes	指定评估模式。
CloudMetadata	云环境的元数据（Azure/GCP/AWS/OCI...）。
ConfigurationExtension	描述可以标识扩展的属性。
createdByType	创建资源的标识的类型。
Disk	描述计算机上的磁盘
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
EsuEligibility	ESU 资格。
EsuKey	ESU 密钥
EsuKeyState	ESU 密钥状态。
EsuServerType	Esu 的服务器类型。
FirmwareProfile	描述计算机的固件
HardwareProfile	描述计算机的硬件
HotpatchEnablementStatus	热修补启用或禁用的状态。
Identity	资源的标识。
IdentityKeyStore	指定计算机正在使用的标识密钥存储。
IpAddress	描述 IP 地址的属性。
LastAttemptStatusEnum	指定代理升级的状态。
License	描述混合计算机中的许可证。
licenseAssignmentState	描述许可证分配状态（已分配或未分配）。
LicenseCoreType	描述许可证核心类型（pCore 或 vCore）。
LicenseDetails	描述许可证的属性。
LicenseEdition	描述许可证的版本。这些值为标准或数据中心。
LicenseProfileMachineInstanceView	计算机属性中的许可证配置文件实例视图。
LicenseProfileMachineInstanceViewEsuProperties	计算机 ESU 配置文件的属性。
LicenseProfileProductType	许可证的产品类型。
LicenseProfileSubscriptionStatus	OS 或产品功能的订阅状态。
LicenseState	描述许可证的状态。
LicenseStatus	许可证状态。
LicenseTarget	描述许可证目标服务器。
LicenseType	许可证资源的类型。
LinuxConfiguration	指定用于更新管理的 Linux 配置。
locationData	与资源的地理位置相关的元数据。
Machine	描述混合计算机。
MachineExtension	描述计算机扩展。
MachineExtensionInstanceView	描述计算机扩展实例视图。
MachineExtensionProperties	描述计算机扩展的属性。
MachineListResult	列出混合计算机作响应。
NetworkInterface	描述网络接口。
NetworkProfile	描述此计算机上的网络信息。
OSProfile	指定混合计算机的作系统设置。
PatchModeTypes	指定修补模式。
Processor	描述计算机的固件
ProductFeature	产品功能
ProgramYear	描述批量许可证适用于的计划年份。
ProvisioningState	预配状态，仅出现在响应中。
ResourceIdentityType	标识类型。
ServiceStatus	描述服务的状态和行为。
ServiceStatuses	报告依赖服务的状态和行为。
Status	热修补功能注册或取消注册的状态。
StatusTypes	混合计算机代理的状态。
StorageProfile	描述计算机的存储配置
Subnet	描述子网。
systemData	与创建和上次修改资源相关的元数据。
VolumeLicenseDetails
WindowsConfiguration	指定更新管理的 Windows 配置。

agent configuration mode

枚举

要使用的配置模式的名称。模式是Microsoft维护的安全控制、扩展允许列表和来宾配置的预定义配置。

值	说明
full
monitor

AgentConfiguration

Object

用户可以通过 azcmagent config 命令或通过 ARM 远程设置的可配置属性。

名称	类型	说明
configMode	agent configuration mode	要使用的配置模式的名称。模式是Microsoft维护的安全控制、扩展允许列表和来宾配置的预定义配置。
extensionsAllowList	ConfigurationExtension[]	允许安装或更新的扩展数组。
extensionsBlockList	ConfigurationExtension[]	阻止的扩展数组（无法安装或更新）
extensionsEnabled	string	指定是启用或禁用扩展服务。
guestConfigurationEnabled	string	指定是启用还是禁用来宾配置服务。
incomingConnectionsPorts	string[]	指定代理能够侦听的端口列表。
proxyBypass	string[]	不应使用指定代理服务器的服务名称列表。
proxyUrl	string	指定要使用的代理的 URL。

AgentUpgrade

Object

信息 w.r.t 代理升级。

名称	类型	说明
correlationId	string	与代理升级作关联的关联 ID。
desiredVersion	string	指定计算机的版本信息 w.r.t AgentUpgrade。
enableAutomaticUpgrade	boolean	指定是否应升级计算机的代理
lastAttemptDesiredVersion	string	指定上次尝试的版本
lastAttemptMessage	string	上次升级尝试失败的消息（如果有）。
lastAttemptStatus	LastAttemptStatusEnum	指定代理升级的状态。
lastAttemptTimestamp	string	上次升级尝试的时间戳

ArcKindEnum

枚举

指示本地放置哪个类型的 Arc 计算机，例如 HCI、SCVMM 或 VMware 等。

值	说明
AVS
AWS
EPS
GCP
HCI
SCVMM
VMware

AssessmentModeTypes

枚举

指定评估模式。

值	说明
AutomaticByPlatform
ImageDefault

CloudMetadata

Object

云环境的元数据（Azure/GCP/AWS/OCI...）。

名称	类型	说明
provider	string	指定云提供商（Azure/AWS/GCP...）。

ConfigurationExtension

Object

描述可以标识扩展的属性。

名称	类型	说明
publisher	string	扩展的发布者。
type	string	扩展的类型。

createdByType

枚举

创建资源的标识的类型。

值	说明
Application
Key
ManagedIdentity
User

Disk

Object

描述计算机上的磁盘

名称	类型	说明
diskType	string	磁盘的类型。
generatedId	string	磁盘生成的 ID。
id	string	磁盘的 ID。
maxSizeInBytes	integer (int64)	磁盘的大小（以字节为单位）
name	string	磁盘的名称。
path	string	磁盘的路径。
usedSpaceInBytes	integer (int64)	磁盘上使用的空间量（以字节为单位）

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

EsuEligibility

枚举

ESU 资格。

值	说明
Eligible
Ineligible
Unknown

EsuKey

Object

ESU 密钥

名称	类型	说明
licenseStatus	integer (int32)	许可证配置文件密钥的当前状态。由查询许可证密钥状态时在计算机上本身显示的相同整数值表示。
sku	string	SKU 编号。

EsuKeyState

枚举

ESU 密钥状态。

值	说明
Active
Inactive

EsuServerType

枚举

Esu 的服务器类型。

值	说明
Datacenter
Standard

FirmwareProfile

Object

描述计算机的固件

名称	类型	说明
serialNumber	string	固件的序列号
type	string	固件的类型

HardwareProfile

Object

描述计算机的硬件

名称	类型	说明
numberOfCpuSockets	integer (int32)	计算机上可用的 CPU 套接字总数
processors	Processor[]	计算机的物理处理器。
totalPhysicalMemoryInBytes	integer (int64)	计算机上的物理内存总量

HotpatchEnablementStatus

枚举

热修补启用或禁用的状态。

值	说明
ActionRequired
Disabled
Enabled
PendingEvaluation
Unknown

Identity

Object

资源的标识。

名称	类型	说明
principalId	string	资源标识的主体 ID。
tenantId	string	资源的租户 ID。
type	ResourceIdentityType	标识类型。

IdentityKeyStore

枚举

指定计算机正在使用的标识密钥存储。

值	说明
Default
TPM

IpAddress

Object

描述 IP 地址的属性。

名称	类型	说明
address	string	表示 IP 地址。
ipAddressVersion	string	表示 Ip 地址版本。
subnet	Subnet	此 IP 地址所属的子网。

LastAttemptStatusEnum

枚举

指定代理升级的状态。

值	说明
Failed
Success

License

Object

描述混合计算机中的许可证。

名称	类型	说明
id	string	资源的完全限定资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	资源所在的地理位置
name	string	资源的名称
properties.licenseDetails	LicenseDetails	描述许可证的属性。
properties.licenseType	LicenseType	许可证资源的类型。
properties.provisioningState	ProvisioningState	预配状态，仅出现在响应中。
properties.tenantId	string	描述租户 ID。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源的类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

licenseAssignmentState

枚举

描述许可证分配状态（已分配或未分配）。

值	说明
Assigned
NotAssigned

LicenseCoreType

枚举

描述许可证核心类型（pCore 或 vCore）。

值	说明
pCore
vCore

LicenseDetails

Object

描述许可证的属性。

名称	类型	说明
assignedLicenses	integer (int32)	描述分配的许可证数。
edition	LicenseEdition	描述许可证的版本。这些值为标准或数据中心。
immutableId	string	描述不可变 ID。
processors	integer (int32)	描述处理器数。
state	LicenseState	描述许可证的状态。
target	LicenseTarget	描述许可证目标服务器。
type	LicenseCoreType	描述许可证核心类型（pCore 或 vCore）。
volumeLicenseDetails	VolumeLicenseDetails[]	批量许可证详细信息的列表。

LicenseEdition

枚举

描述许可证的版本。这些值为标准或数据中心。

值	说明
Datacenter
Standard

LicenseProfileMachineInstanceView

Object

计算机属性中的许可证配置文件实例视图。

名称	类型	说明
esuProfile	LicenseProfileMachineInstanceViewEsuProperties	计算机 ESU 配置文件的属性。
licenseChannel	string	指示许可证通道。
licenseStatus	LicenseStatus	指示 OS 的许可证状态。
productProfile.billingEndDate	string (date-time)	计费结束时采用 UTC 格式的时间戳。
productProfile.billingStartDate	string (date-time)	计费开始时采用 UTC 格式的时间戳。
productProfile.disenrollmentDate	string (date-time)	用户取消注册该功能时的 UTC 时间戳。
productProfile.enrollmentDate	string (date-time)	用户注册该功能时采用 UTC 格式的时间戳。
productProfile.error	ErrorDetail	在功能注册或取消注册期间遇到的错误。
productProfile.productFeatures	ProductFeature[]	产品功能列表。
productProfile.productType	LicenseProfileProductType	指示许可证的产品类型。
productProfile.subscriptionStatus	LicenseProfileSubscriptionStatus	指示产品的订阅状态。
softwareAssurance.softwareAssuranceCustomer	boolean	指定此计算机是否作为软件保障协议的一部分获得许可。

LicenseProfileMachineInstanceViewEsuProperties

Object

计算机 ESU 配置文件的属性。

名称	类型	说明
assignedLicense	License	分配的许可证资源。
assignedLicenseImmutableId	string	许可证的 GUID ID。
esuEligibility	EsuEligibility	指示 Esu 的资格状态。
esuKeyState	EsuKeyState	指示计算机当前是否处于活动状态 ESU 密钥。
esuKeys	EsuKey[]	ESU 密钥的列表。
licenseAssignmentState	licenseAssignmentState	描述许可证分配状态（已分配或未分配）。
serverType	EsuServerType	Esu 服务器的类型。

LicenseProfileProductType

枚举

许可证的产品类型。

值	说明
WindowsIoTEnterprise
WindowsServer

LicenseProfileSubscriptionStatus

枚举

OS 或产品功能的订阅状态。

值	说明
Disabled
Disabling
Enabled
Enabling
Failed
Unknown

LicenseState

枚举

描述许可证的状态。

值	说明
Activated
Deactivated

LicenseStatus

枚举

许可证状态。

值	说明
ExtendedGrace
Licensed
NonGenuineGrace
Notification
OOBGrace
OOTGrace
Unlicensed

LicenseTarget

枚举

描述许可证目标服务器。

值	说明
Windows Server 2012
Windows Server 2012 R2

LicenseType

枚举

许可证资源的类型。

值	说明
ESU

LinuxConfiguration

Object

指定用于更新管理的 Linux 配置。

名称	类型	说明
patchSettings.assessmentMode	AssessmentModeTypes	指定评估模式。
patchSettings.enableHotpatching	boolean	捕获客户的热修补功能注册意向，使客户无需重新启动即可修补其 Windows 计算机。
patchSettings.patchMode	PatchModeTypes	指定修补模式。
patchSettings.status	Status	热修补功能注册或取消注册的状态。

locationData

Object

与资源的地理位置相关的元数据。

名称	类型	说明
city	string	资源所在的城市或位置。
countryOrRegion	string	资源所在的国家或地区
district	string	资源所在的地区、州或省。
name	string maxLength: 256	地理或物理位置的规范名称。

Machine

Object

描述混合计算机。

名称	类型	说明
id	string	资源的完全限定资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity	资源的标识。
kind	ArcKindEnum	指示本地放置哪个类型的 Arc 计算机，例如 HCI、SCVMM 或 VMware 等。
location	string	资源所在的地理位置
name	string	资源的名称
properties.adFqdn	string	指定 AD 完全限定的显示名称。
properties.agentConfiguration	AgentConfiguration	用户可以通过 azcmagent config 命令或通过 ARM 远程设置的可配置属性。
properties.agentUpgrade	AgentUpgrade	计算机 w.r.t 代理升级的信息
properties.agentVersion	string	混合计算机代理完整版本。
properties.clientPublicKey	string	客户端在初始资源载入期间提供的公钥
properties.cloudMetadata	CloudMetadata	云环境的元数据（Azure/GCP/AWS/OCI...）。
properties.detectedProperties	object	检测到计算机中的属性。
properties.displayName	string	指定混合计算机显示名称。
properties.dnsFqdn	string	指定 DNS 完全限定的显示名称。
properties.domainName	string	指定 Windows 域名。
properties.errorDetails	ErrorDetail[]	有关错误状态的详细信息。
properties.extensions	MachineExtensionInstanceView[]	计算机扩展信息（已弃用字段）
properties.firmwareProfile	FirmwareProfile	有关计算机的固件的信息
properties.hardwareProfile	HardwareProfile	有关计算机硬件的信息
properties.identityKeyStore	IdentityKeyStore	指定计算机正在使用的标识密钥存储。
properties.lastStatusChange	string (date-time)	上次状态更改的时间。
properties.licenseProfile	LicenseProfileMachineInstanceView	指定计算机的许可证相关属性。
properties.locationData	locationData	与资源的地理位置相关的元数据。
properties.machineFqdn	string	指定混合计算机 FQDN。
properties.mssqlDiscovered	string	指定计算机上是否发现任何 MS SQL 实例。
properties.networkProfile	NetworkProfile	有关计算机所打开的网络的信息。
properties.osEdition	string	作系统的版本。
properties.osName	string	在混合计算机上运行的作系统。
properties.osProfile	OSProfile	指定混合计算机的作系统设置。
properties.osSku	string	指定作系统产品 SKU。
properties.osType	string	作系统的类型（windows/linux）。
properties.osVersion	string	在混合计算机上运行的作系统版本。
properties.parentClusterResourceId	string	此计算机分配到的父群集（Azure HCI）的资源 ID（如果有）。
properties.privateLinkScopeResourceId	string	此计算机分配到的专用链接范围的资源 ID（如果有）。
properties.provisioningState	string	预配状态，仅出现在响应中。
properties.serviceStatuses	ServiceStatuses	报告回 ARM 的依赖服务的状态。
properties.status	StatusTypes	混合计算机代理的状态。
properties.storageProfile	StorageProfile	有关计算机存储的信息
properties.tpmEkCertificate	string	客户端在初始资源载入期间提供的受信任平台模块（TPM）认可密钥证书。
properties.vmId	string	指定混合计算机唯一 ID。
properties.vmUuid	string	指定 Arc Machine 的唯一 SMBIOS ID
resources	MachineExtension[]	与计算机关联的扩展列表
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源的类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

MachineExtension

Object

描述计算机扩展。

名称	类型	说明
id	string	资源的完全限定资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	资源所在的地理位置
name	string	资源的名称
properties	MachineExtensionProperties	描述计算机扩展属性。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源的类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

MachineExtensionInstanceView

Object

描述计算机扩展实例视图。

名称	类型	说明
name	string	计算机扩展名称。
status	Status	实例视图状态。
type	string	指定扩展的类型;例如“CustomScriptExtension”。
typeHandlerVersion	string	指定脚本处理程序的版本。

MachineExtensionProperties

Object

描述计算机扩展的属性。

名称	类型	说明
autoUpgradeMinorVersion	boolean	指示扩展是否应在部署时使用较新的次要版本。但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。
enableAutomaticUpgrade	boolean	指示如果有较新版本可用，平台是否应自动升级扩展。
forceUpdateTag	string	即使扩展配置未更改，扩展处理程序也应强制更新。
instanceView	MachineExtensionInstanceView	计算机扩展实例视图。
protectedSettings		该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。
provisioningState	string	预配状态，仅出现在响应中。
publisher	string	扩展处理程序发布者的名称。
settings		扩展的 Json 格式公共设置。
type	string	指定扩展的类型;例如“CustomScriptExtension”。
typeHandlerVersion	string	指定脚本处理程序的版本。

MachineListResult

Object

列出混合计算机作响应。

名称	类型	说明
nextLink	string	用于提取计算机下一页的 URI。使用此 URI 调用 ListNext（），以提取混合计算机的下一页。
value	Machine[]	混合计算机的列表。

NetworkInterface

Object

描述网络接口。

名称	类型	说明
id	string	表示网络接口的 ID。
ipAddresses	IpAddress[]	此接口中的 IP 地址列表。
macAddress	string	表示网络接口的 MAC 地址。
name	string	表示网络接口的名称。

NetworkProfile

Object

描述此计算机上的网络信息。

名称	类型	说明
networkInterfaces	NetworkInterface[]	网络接口列表。

OSProfile

Object

指定混合计算机的作系统设置。

名称	类型	说明
computerName	string	指定混合计算机的主机 OS 名称。
linuxConfiguration	LinuxConfiguration	指定用于更新管理的 Linux 配置。
windowsConfiguration	WindowsConfiguration	指定更新管理的 Windows 配置。

PatchModeTypes

枚举

指定修补模式。

值	说明
AutomaticByOS
AutomaticByPlatform
ImageDefault
Manual

Processor

Object

描述计算机的固件

名称	类型	说明
name	string	处理器的名称。
numberOfCores	integer (int32)	处理器上的物理核心总数。

ProductFeature

Object

产品功能

名称	类型	说明
billingEndDate	string (date-time)	计费结束时采用 UTC 格式的时间戳。
billingStartDate	string (date-time)	计费开始时采用 UTC 格式的时间戳。
disenrollmentDate	string (date-time)	用户取消注册该功能时的 UTC 时间戳。
enrollmentDate	string (date-time)	用户注册该功能时采用 UTC 格式的时间戳。
error	ErrorDetail	在功能注册或取消注册期间遇到的错误。
name	string	产品名称。
subscriptionStatus	LicenseProfileSubscriptionStatus	指示产品功能的当前状态。

ProgramYear

枚举

描述批量许可证适用于的计划年份。

值	说明
Year 1
Year 2
Year 3

ProvisioningState

枚举

预配状态，仅出现在响应中。

值	说明
Accepted
Canceled
Creating
Deleted
Deleting
Failed
Succeeded
Updating

ResourceIdentityType

枚举

标识类型。

值	说明
SystemAssigned

ServiceStatus

Object

描述服务的状态和行为。

名称	类型	说明
startupType	string	启用 Arc 的计算机启动时服务的行为。
status	string	服务的当前状态。

ServiceStatuses

Object

报告依赖服务的状态和行为。

名称	类型	说明
extensionService	ServiceStatus	已启用 Arc 的计算机上的扩展服务的状态。
guestConfigurationService	ServiceStatus	已启用 Arc 的计算机上的来宾配置服务的状态。

Status

Object

热修补功能注册或取消注册的状态。

名称	类型	说明
error	ErrorDetail	热修补功能注册或取消注册期间遇到的错误。
hotpatchEnablementStatus	HotpatchEnablementStatus	指示正在启用或禁用的热修补的当前状态。

StatusTypes

枚举

混合计算机代理的状态。

值	说明
Connected
Disconnected
Error

StorageProfile

Object

描述计算机的存储配置

名称	类型	说明
disks	Disk[]	计算机上的磁盘。

Subnet

Object

描述子网。

名称	类型	说明
addressPrefix	string	表示地址前缀。

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

VolumeLicenseDetails

Object

名称	类型	说明
invoiceId	string	批量许可证的发票 ID。
programYear	ProgramYear	描述批量许可证适用于的计划年份。

WindowsConfiguration

Object

指定更新管理的 Windows 配置。

名称	类型	说明
patchSettings.assessmentMode	AssessmentModeTypes	指定评估模式。
patchSettings.enableHotpatching	boolean	捕获客户的热修补功能注册意向，使客户无需重新启动即可修补其 Windows 计算机。
patchSettings.patchMode	PatchModeTypes	指定修补模式。
patchSettings.status	Status	热修补功能注册或取消注册的状态。