Machines - Get
Retrieves information about the model view or the instance view of a hybrid machine.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}?api-version=2024-07-10
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}?api-version=2024-07-10&$expand=instanceView
Name | In | Required | Type | Description |
---|---|---|---|---|
machine
|
path | True |
string |
The name of the hybrid machine. Regex pattern: |
resource
|
path | True |
string |
The name of the resource group. The name is case insensitive. |
subscription
|
path | True |
string |
The ID of the target subscription. |
api-version
|
query | True |
string |
The API version to use for this operation. |
$expand
|
query |
The expand expression to apply on the operation. |
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Error response describing why the operation failed. |
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Sample request
Sample response
{
"id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine",
"name": "myMachine",
"location": "eastus2euap",
"tags": null,
"identity": {
"type": "SystemAssigned",
"principalId": "string",
"tenantId": "string"
},
"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",
"city": "redmond",
"district": null,
"countryOrRegion": "usa"
},
"clientPublicKey": "string",
"parentClusterResourceId": "{AzureStackHCIResourceId}",
"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"
},
"serviceStatuses": {
"extensionService": {
"status": "Running",
"startupType": "Automatic"
},
"guestConfigurationService": {
"status": "Running",
"startupType": "Automatic"
}
},
"privateLinkScopeResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/privateLinkScopes/privateLinkScopeName",
"networkProfile": {
"networkInterfaces": [
{
"ipAddresses": [
{
"address": "192.168.12.345",
"ipAddressVersion": "IPv4",
"subnet": {
"addressPrefix": "192.168.12.0/24"
}
}
]
},
{
"ipAddresses": [
{
"address": "1001:0:34aa:5000:1234:aaaa:bbbb:cccc",
"ipAddressVersion": "IPv6",
"subnet": {
"addressPrefix": "1001:0:34aa:5000::/64"
}
}
]
}
]
}
},
"resources": []
}
Sample request
Sample response
{
"id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine",
"name": "myMachine",
"location": "eastus2euap",
"tags": null,
"identity": {
"type": "SystemAssigned",
"principalId": "string",
"tenantId": "string"
},
"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": {
"assignedLicense": {
"id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/Licenses/{licenseName}",
"name": "{licenseName}",
"type": "Microsoft.HybridCompute/licenses",
"location": "eastus2euap",
"tags": null,
"properties": {
"tenantId": "{tenandId}",
"licenseType": "ESU",
"licenseDetails": {
"state": "Activated",
"target": "Windows Server 2012",
"edition": "Datacenter",
"type": "pCore",
"processors": 6,
"assignedLicenses": 8,
"immutableId": "<generated Guid>"
}
}
},
"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",
"city": "redmond",
"district": null,
"countryOrRegion": "usa"
},
"clientPublicKey": "string",
"parentClusterResourceId": "{AzureStackHCIResourceId}",
"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"
},
"serviceStatuses": {
"extensionService": {
"status": "Running",
"startupType": "Automatic"
},
"guestConfigurationService": {
"status": "Running",
"startupType": "Automatic"
}
},
"privateLinkScopeResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/privateLinkScopes/privateLinkScopeName",
"networkProfile": {
"networkInterfaces": [
{
"ipAddresses": [
{
"address": "192.168.12.345",
"ipAddressVersion": "IPv4",
"subnet": {
"addressPrefix": "192.168.12.0/24"
}
}
]
},
{
"ipAddresses": [
{
"address": "1001:0:34aa:5000:1234:aaaa:bbbb:cccc",
"ipAddressVersion": "IPv6",
"subnet": {
"addressPrefix": "1001:0:34aa:5000::/64"
}
}
]
}
]
}
},
"resources": []
}
Name | Description |
---|---|
agent configuration mode |
Name of configuration mode to use. Modes are pre-defined configurations of security controls, extension allowlists and guest configuration, maintained by Microsoft. |
Agent |
Configurable properties that the user can set locally via the azcmagent config command, or remotely via ARM. |
Agent |
The info w.r.t Agent Upgrade. |
Arc |
Indicates which kind of Arc machine placement on-premises, such as HCI, SCVMM or VMware etc. |
Assessment |
Specifies the assessment mode. |
Cloud |
The metadata of the cloud environment (Azure/GCP/AWS/OCI...). |
Configuration |
Describes properties that can identify extensions. |
created |
The type of identity that created the resource. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Esu |
The ESU eligibility. |
Esu |
ESU key |
Esu |
The ESU key state. |
Esu |
The server types for Esu. |
Hotpatch |
Status of hotpatch enablement or disablement. |
Identity |
Identity for the resource. |
Instance |
The expand expression to apply on the operation. |
Ip |
Describes properties of the IP address. |
Last |
Specifies the status of Agent Upgrade. |
License |
Describes a license in a hybrid machine. |
license |
Describes the license assignment state (Assigned or NotAssigned). |
License |
Describes the license core type (pCore or vCore). |
License |
Describes the properties of a License. |
License |
Describes the edition of the license. The values are either Standard or Datacenter. |
License |
License Profile Instance View in Machine Properties. |
License |
Properties for the Machine ESU profile. |
License |
The product type of the license. |
License |
Subscription status of the OS or Product feature. |
License |
Describes the state of the license. |
License |
The license status. |
License |
Describes the license target server. |
License |
The type of the license resource. |
Linux |
Specifies the linux configuration for update management. |
location |
Metadata pertaining to the geographic location of the resource. |
Machine |
Describes a hybrid machine. |
Machine |
Describes a Machine Extension. |
Machine |
Describes the Machine Extension Instance View. |
Machine |
Describes the properties of a Machine Extension. |
Network |
Describes a network interface. |
Network |
Describes the network information on this machine. |
OSProfile |
Specifies the operating system settings for the hybrid machine. |
Patch |
Specifies the patch mode. |
Product |
Product Feature |
Program |
Describes the program year the volume license is for. |
Provisioning |
The provisioning state, which only appears in the response. |
Resource |
The identity type. |
Service |
Describes the status and behavior of a service. |
Service |
Reports the state and behavior of dependent services. |
Status |
Status of the hotpatch capability enrollment or disenrollment. |
Status |
The status of the hybrid machine agent. |
Subnet |
Describes the subnet. |
system |
Metadata pertaining to creation and last modification of the resource. |
Volume |
|
Windows |
Specifies the windows configuration for update management. |
Name of configuration mode to use. Modes are pre-defined configurations of security controls, extension allowlists and guest configuration, maintained by Microsoft.
Name | Type | Description |
---|---|---|
full |
string |
|
monitor |
string |
Configurable properties that the user can set locally via the azcmagent config command, or remotely via ARM.
Name | Type | Description |
---|---|---|
configMode |
Name of configuration mode to use. Modes are pre-defined configurations of security controls, extension allowlists and guest configuration, maintained by Microsoft. |
|
extensionsAllowList |
Array of extensions that are allowed to be installed or updated. |
|
extensionsBlockList |
Array of extensions that are blocked (cannot be installed or updated) |
|
extensionsEnabled |
string |
Specifies whether the extension service is enabled or disabled. |
guestConfigurationEnabled |
string |
Specified whether the guest configuration service is enabled or disabled. |
incomingConnectionsPorts |
string[] |
Specifies the list of ports that the agent will be able to listen on. |
proxyBypass |
string[] |
List of service names which should not use the specified proxy server. |
proxyUrl |
string |
Specifies the URL of the proxy to be used. |
The info w.r.t Agent Upgrade.
Name | Type | Description |
---|---|---|
correlationId |
string |
The correlation ID passed in from RSM per upgrade. |
desiredVersion |
string |
Specifies the version info w.r.t AgentUpgrade for the machine. |
enableAutomaticUpgrade |
boolean |
Specifies if RSM should try to upgrade this machine |
lastAttemptDesiredVersion |
string |
Specifies the version of the last attempt |
lastAttemptMessage |
string |
Failure message of last upgrade attempt if any. |
lastAttemptStatus |
Specifies the status of Agent Upgrade. |
|
lastAttemptTimestamp |
string |
Timestamp of last upgrade attempt |
Indicates which kind of Arc machine placement on-premises, such as HCI, SCVMM or VMware etc.
Name | Type | Description |
---|---|---|
AVS |
string |
|
AWS |
string |
|
EPS |
string |
|
GCP |
string |
|
HCI |
string |
|
SCVMM |
string |
|
VMware |
string |
Specifies the assessment mode.
Name | Type | Description |
---|---|---|
AutomaticByPlatform |
string |
|
ImageDefault |
string |
The metadata of the cloud environment (Azure/GCP/AWS/OCI...).
Name | Type | Description |
---|---|---|
provider |
string |
Specifies the cloud provider (Azure/AWS/GCP...). |
Describes properties that can identify extensions.
Name | Type | Description |
---|---|---|
publisher |
string |
Publisher of the extension. |
type |
string |
Type of the extension. |
The type of identity that created the resource.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
The ESU eligibility.
Name | Type | Description |
---|---|---|
Eligible |
string |
|
Ineligible |
string |
|
Unknown |
string |
ESU key
Name | Type | Description |
---|---|---|
licenseStatus |
integer |
The current status of the license profile key. Represented by the same integer value that is presented on the machine itself when querying the license key status. |
sku |
string |
SKU number. |
The ESU key state.
Name | Type | Description |
---|---|---|
Active |
string |
|
Inactive |
string |
The server types for Esu.
Name | Type | Description |
---|---|---|
Datacenter |
string |
|
Standard |
string |
Status of hotpatch enablement or disablement.
Name | Type | Description |
---|---|---|
ActionRequired |
string |
|
Disabled |
string |
|
Enabled |
string |
|
PendingEvaluation |
string |
|
Unknown |
string |
Identity for the resource.
Name | Type | Description |
---|---|---|
principalId |
string |
The principal ID of resource identity. The value must be an UUID. |
tenantId |
string |
The tenant ID of resource. The value must be an UUID. |
type |
The identity type. |
The expand expression to apply on the operation.
Name | Type | Description |
---|---|---|
instanceView |
string |
Describes properties of the IP address.
Name | Type | Description |
---|---|---|
address |
string |
Represents the IP Address. |
ipAddressVersion |
string |
Represents the Ip Address Version. |
subnet |
The subnet to which this IP address belongs. |
Specifies the status of Agent Upgrade.
Name | Type | Description |
---|---|---|
Failed |
string |
|
Success |
string |
Describes a license in a hybrid machine.
Name | Type | Description |
---|---|---|
id |
string |
Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
The geo-location where the resource lives |
name |
string |
The name of the resource |
properties.licenseDetails |
Describes the properties of a License. |
|
properties.licenseType |
The type of the license resource. |
|
properties.provisioningState |
The provisioning state, which only appears in the response. |
|
properties.tenantId |
string |
Describes the tenant id. |
systemData |
Azure Resource Manager metadata containing createdBy and modifiedBy information. |
|
tags |
object |
Resource tags. |
type |
string |
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
Describes the license assignment state (Assigned or NotAssigned).
Name | Type | Description |
---|---|---|
Assigned |
string |
|
NotAssigned |
string |
Describes the license core type (pCore or vCore).
Name | Type | Description |
---|---|---|
pCore |
string |
|
vCore |
string |
Describes the properties of a License.
Name | Type | Description |
---|---|---|
assignedLicenses |
integer |
Describes the number of assigned licenses. |
edition |
Describes the edition of the license. The values are either Standard or Datacenter. |
|
immutableId |
string |
Describes the immutable id. |
processors |
integer |
Describes the number of processors. |
state |
Describes the state of the license. |
|
target |
Describes the license target server. |
|
type |
Describes the license core type (pCore or vCore). |
|
volumeLicenseDetails |
A list of volume license details. |
Describes the edition of the license. The values are either Standard or Datacenter.
Name | Type | Description |
---|---|---|
Datacenter |
string |
|
Standard |
string |
License Profile Instance View in Machine Properties.
Name | Type | Description |
---|---|---|
esuProfile |
Properties for the Machine ESU profile. |
|
licenseChannel |
string |
Indicates the license channel. |
licenseStatus |
Indicates the license status of the OS. |
|
productProfile.billingEndDate |
string |
The timestamp in UTC when the billing ends. |
productProfile.billingStartDate |
string |
The timestamp in UTC when the billing starts. |
productProfile.disenrollmentDate |
string |
The timestamp in UTC when the user disenrolled the feature. |
productProfile.enrollmentDate |
string |
The timestamp in UTC when the user enrolls the feature. |
productProfile.error |
The errors that were encountered during the feature enrollment or disenrollment. |
|
productProfile.productFeatures |
The list of product features. |
|
productProfile.productType |
Indicates the product type of the license. |
|
productProfile.subscriptionStatus |
Indicates the subscription status of the product. |
|
softwareAssurance.softwareAssuranceCustomer |
boolean |
Specifies if this machine is licensed as part of a Software Assurance agreement. |
Properties for the Machine ESU profile.
Name | Type | Description |
---|---|---|
assignedLicense |
The assigned license resource. |
|
assignedLicenseImmutableId |
string |
The guid id of the license. |
esuEligibility |
Indicates the eligibility state of Esu. |
|
esuKeyState |
Indicates whether there is an ESU Key currently active for the machine. |
|
esuKeys |
Esu |
The list of ESU keys. |
licenseAssignmentState |
Describes the license assignment state (Assigned or NotAssigned). |
|
serverType |
The type of the Esu servers. |
The product type of the license.
Name | Type | Description |
---|---|---|
WindowsIoTEnterprise |
string |
|
WindowsServer |
string |
Subscription status of the OS or Product feature.
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Disabling |
string |
|
Enabled |
string |
|
Enabling |
string |
|
Failed |
string |
|
Unknown |
string |
Describes the state of the license.
Name | Type | Description |
---|---|---|
Activated |
string |
|
Deactivated |
string |
The license status.
Name | Type | Description |
---|---|---|
ExtendedGrace |
string |
|
Licensed |
string |
|
NonGenuineGrace |
string |
|
Notification |
string |
|
OOBGrace |
string |
|
OOTGrace |
string |
|
Unlicensed |
string |
Describes the license target server.
Name | Type | Description |
---|---|---|
Windows Server 2012 |
string |
|
Windows Server 2012 R2 |
string |
The type of the license resource.
Name | Type | Description |
---|---|---|
ESU |
string |
Specifies the linux configuration for update management.
Name | Type | Description |
---|---|---|
patchSettings.assessmentMode |
Specifies the assessment mode. |
|
patchSettings.enableHotpatching |
boolean |
Captures the hotpatch capability enrollment intent of the customers, which enables customers to patch their Windows machines without requiring a reboot. |
patchSettings.patchMode |
Specifies the patch mode. |
|
patchSettings.status |
Status of the hotpatch capability enrollment or disenrollment. |
Metadata pertaining to the geographic location of the resource.
Name | Type | Description |
---|---|---|
city |
string |
The city or locality where the resource is located. |
countryOrRegion |
string |
The country or region where the resource is located |
district |
string |
The district, state, or province where the resource is located. |
name |
string |
A canonical name for the geographic or physical location. |
Describes a hybrid machine.
Name | Type | Description |
---|---|---|
id |
string |
Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
identity |
Identity for the resource. |
|
kind |
Indicates which kind of Arc machine placement on-premises, such as HCI, SCVMM or VMware etc. |
|
location |
string |
The geo-location where the resource lives |
name |
string |
The name of the resource |
properties.adFqdn |
string |
Specifies the AD fully qualified display name. |
properties.agentConfiguration |
Configurable properties that the user can set locally via the azcmagent config command, or remotely via ARM. |
|
properties.agentUpgrade |
The info of the machine w.r.t Agent Upgrade |
|
properties.agentVersion |
string |
The hybrid machine agent full version. |
properties.clientPublicKey |
string |
Public Key that the client provides to be used during initial resource onboarding |
properties.cloudMetadata |
The metadata of the cloud environment (Azure/GCP/AWS/OCI...). |
|
properties.detectedProperties |
object |
Detected properties from the machine. |
properties.displayName |
string |
Specifies the hybrid machine display name. |
properties.dnsFqdn |
string |
Specifies the DNS fully qualified display name. |
properties.domainName |
string |
Specifies the Windows domain name. |
properties.errorDetails |
Details about the error state. |
|
properties.extensions |
Machine Extensions information (deprecated field) |
|
properties.lastStatusChange |
string |
The time of the last status change. |
properties.licenseProfile |
Specifies the License related properties for a machine. |
|
properties.locationData |
Metadata pertaining to the geographic location of the resource. |
|
properties.machineFqdn |
string |
Specifies the hybrid machine FQDN. |
properties.mssqlDiscovered |
string |
Specifies whether any MS SQL instance is discovered on the machine. |
properties.networkProfile |
Information about the network the machine is on. |
|
properties.osEdition |
string |
The edition of the Operating System. |
properties.osName |
string |
The Operating System running on the hybrid machine. |
properties.osProfile |
Specifies the operating system settings for the hybrid machine. |
|
properties.osSku |
string |
Specifies the Operating System product SKU. |
properties.osType |
string |
The type of Operating System (windows/linux). |
properties.osVersion |
string |
The version of Operating System running on the hybrid machine. |
properties.parentClusterResourceId |
string |
The resource id of the parent cluster (Azure HCI) this machine is assigned to, if any. |
properties.privateLinkScopeResourceId |
string |
The resource id of the private link scope this machine is assigned to, if any. |
properties.provisioningState |
string |
The provisioning state, which only appears in the response. |
properties.serviceStatuses |
Statuses of dependent services that are reported back to ARM. |
|
properties.status |
The status of the hybrid machine agent. |
|
properties.vmId |
string |
Specifies the hybrid machine unique ID. |
properties.vmUuid |
string |
Specifies the Arc Machine's unique SMBIOS ID |
resources |
The list of extensions affiliated to the machine |
|
systemData |
Azure Resource Manager metadata containing createdBy and modifiedBy information. |
|
tags |
object |
Resource tags. |
type |
string |
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
Describes a Machine Extension.
Name | Type | Description |
---|---|---|
id |
string |
Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
The geo-location where the resource lives |
name |
string |
The name of the resource |
properties |
Describes Machine Extension Properties. |
|
systemData |
Azure Resource Manager metadata containing createdBy and modifiedBy information. |
|
tags |
object |
Resource tags. |
type |
string |
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
Describes the Machine Extension Instance View.
Name | Type | Description |
---|---|---|
name |
string |
The machine extension name. |
status |
Instance view status. |
|
type |
string |
Specifies the type of the extension; an example is "CustomScriptExtension". |
typeHandlerVersion |
string |
Specifies the version of the script handler. |
Describes the properties of a Machine Extension.
Name | Type | Description |
---|---|---|
autoUpgradeMinorVersion |
boolean |
Indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension will not upgrade minor versions unless redeployed, even with this property set to true. |
enableAutomaticUpgrade |
boolean |
Indicates whether the extension should be automatically upgraded by the platform if there is a newer version available. |
forceUpdateTag |
string |
How the extension handler should be forced to update even if the extension configuration has not changed. |
instanceView |
The machine extension instance view. |
|
protectedSettings |
|
The extension can contain either protectedSettings or protectedSettingsFromKeyVault or no protected settings at all. |
provisioningState |
string |
The provisioning state, which only appears in the response. |
publisher |
string |
The name of the extension handler publisher. |
settings |
|
Json formatted public settings for the extension. |
type |
string |
Specifies the type of the extension; an example is "CustomScriptExtension". |
typeHandlerVersion |
string |
Specifies the version of the script handler. |
Describes a network interface.
Name | Type | Description |
---|---|---|
ipAddresses |
The list of IP addresses in this interface. |
Describes the network information on this machine.
Name | Type | Description |
---|---|---|
networkInterfaces |
The list of network interfaces. |
Specifies the operating system settings for the hybrid machine.
Name | Type | Description |
---|---|---|
computerName |
string |
Specifies the host OS name of the hybrid machine. |
linuxConfiguration |
Specifies the linux configuration for update management. |
|
windowsConfiguration |
Specifies the windows configuration for update management. |
Specifies the patch mode.
Name | Type | Description |
---|---|---|
AutomaticByOS |
string |
|
AutomaticByPlatform |
string |
|
ImageDefault |
string |
|
Manual |
string |
Product Feature
Name | Type | Description |
---|---|---|
billingEndDate |
string |
The timestamp in UTC when the billing ends. |
billingStartDate |
string |
The timestamp in UTC when the billing starts. |
disenrollmentDate |
string |
The timestamp in UTC when the user disenrolled the feature. |
enrollmentDate |
string |
The timestamp in UTC when the user enrolls the feature. |
error |
The errors that were encountered during the feature enrollment or disenrollment. |
|
name |
string |
Product feature name. |
subscriptionStatus |
Indicates the current status of the product features. |
Describes the program year the volume license is for.
Name | Type | Description |
---|---|---|
Year 1 |
string |
|
Year 2 |
string |
|
Year 3 |
string |
The provisioning state, which only appears in the response.
Name | Type | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
The identity type.
Name | Type | Description |
---|---|---|
SystemAssigned |
string |
Describes the status and behavior of a service.
Name | Type | Description |
---|---|---|
startupType |
string |
The behavior of the service when the Arc-enabled machine starts up. |
status |
string |
The current status of the service. |
Reports the state and behavior of dependent services.
Name | Type | Description |
---|---|---|
extensionService |
The state of the extension service on the Arc-enabled machine. |
|
guestConfigurationService |
The state of the guest configuration service on the Arc-enabled machine. |
Status of the hotpatch capability enrollment or disenrollment.
Name | Type | Description |
---|---|---|
error |
The errors that were encountered during the hotpatch capability enrollment or disenrollment. |
|
hotpatchEnablementStatus |
Indicates the current status of the hotpatch being enabled or disabled. |
The status of the hybrid machine agent.
Name | Type | Description |
---|---|---|
Connected |
string |
|
Disconnected |
string |
|
Error |
string |
Describes the subnet.
Name | Type | Description |
---|---|---|
addressPrefix |
string |
Represents address prefix. |
Metadata pertaining to creation and last modification of the resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
The timestamp of resource creation (UTC). |
createdBy |
string |
The identity that created the resource. |
createdByType |
The type of identity that created the resource. |
|
lastModifiedAt |
string |
The timestamp of resource last modification (UTC) |
lastModifiedBy |
string |
The identity that last modified the resource. |
lastModifiedByType |
The type of identity that last modified the resource. |
Name | Type | Description |
---|---|---|
invoiceId |
string |
The invoice id for the volume license. |
programYear |
Describes the program year the volume license is for. |
Specifies the windows configuration for update management.
Name | Type | Description |
---|---|---|
patchSettings.assessmentMode |
Specifies the assessment mode. |
|
patchSettings.enableHotpatching |
boolean |
Captures the hotpatch capability enrollment intent of the customers, which enables customers to patch their Windows machines without requiring a reboot. |
patchSettings.patchMode |
Specifies the patch mode. |
|
patchSettings.status |
Status of the hotpatch capability enrollment or disenrollment. |