BareMetalMachine interface

BareMetalMachine represents the physical machine in the rack.

Extends

Properties

actionStates

The current state of any in progress or completed actions. The most recent known instance of each action type is shown.

associatedResourceIds

The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.

bmcConnectionString

The connection string for the baseboard management controller including IP address and protocol.

bmcCredentials

The credentials of the baseboard management controller on this bare metal machine.

bmcIpv4Address

The IPv4 address of the BMC interface for the bare metal machine.

bmcIpv6Address

The IPv6 address of the BMC interface for the bare metal machine.

bmcMacAddress

The MAC address of the BMC device.

bootMacAddress

The MAC address of a NIC connected to the PXE network.

caCertificate

The CA certificate information issued by the platform for connecting to TLS interfaces for the bare metal machine. Callers add this certificate to the trusted CA store on the Kubernetes control plane nodes to allow secure communication with the bare metal machine.

clusterId

The resource ID of the cluster this bare metal machine is associated with.

cordonStatus

The cordon status of the bare metal machine.

detailedStatus

The more detailed status of the bare metal machine.

detailedStatusMessage

The descriptive message about the current detailed status.

etag

"If etag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.")

extendedLocation

The extended location of the resource. This property is required when creating the resource.

hardwareInventory

The hardware inventory, including information acquired from the model/sku information and from the ironic inspector.

hardwareValidationStatus

The details of the latest hardware validation performed for this bare metal machine.

hybridAksClustersAssociatedIds

Field Deprecated. These fields will be empty/omitted. The list of the resource IDs for the HybridAksClusters that have nodes hosted on this bare metal machine.

kubernetesNodeName

The name of this machine represented by the host object in the Cluster's Kubernetes control plane.

kubernetesVersion

The version of Kubernetes running on this machine.

machineClusterVersion

The cluster version that has been applied to this machine during deployment or a version update.

machineDetails

The custom details provided by the customer.

machineName

The OS-level hostname assigned to this machine.

machineRoles

The list of roles that are assigned to the cluster node running on this machine.

machineSkuId

The unique internal identifier of the bare metal machine SKU.

monitoringConfigurationStatus

The monitoring configuration status of the bare metal machine.

oamIpv4Address

The IPv4 address that is assigned to the bare metal machine during the cluster deployment.

oamIpv6Address

The IPv6 address that is assigned to the bare metal machine during the cluster deployment.

osImage

The image that is currently provisioned to the OS disk.

powerState

The power state derived from the baseboard management controller.

provisioningState

The provisioning state of the bare metal machine.

rackId

The resource ID of the rack where this bare metal machine resides.

rackSlot

The rack slot in which this bare metal machine is located, ordered from the bottom up i.e. the lowest slot is 1.

readyState

The indicator of whether the bare metal machine is ready to receive workloads.

runtimeProtectionStatus

The runtime protection status of the bare metal machine.

secretRotationStatus

The list of statuses that represent secret rotation activity.

serialNumber

The serial number of the bare metal machine.

serviceTag

The discovered value of the machine's service tag.

virtualMachinesAssociatedIds

Field Deprecated. These fields will be empty/omitted. The list of the resource IDs for the VirtualMachines that are hosted on this bare metal machine.

Inherited Properties

id

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

The geo-location where the resource lives

name

The name of the resource

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information.

tags

Resource tags.

type

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Property Details

actionStates

The current state of any in progress or completed actions. The most recent known instance of each action type is shown.

actionStates?: ActionState[]

Property Value

associatedResourceIds

The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.

associatedResourceIds?: string[]

Property Value

string[]

bmcConnectionString

The connection string for the baseboard management controller including IP address and protocol.

bmcConnectionString: string

Property Value

string

bmcCredentials

The credentials of the baseboard management controller on this bare metal machine.

bmcCredentials: AdministrativeCredentials

Property Value

bmcIpv4Address

The IPv4 address of the BMC interface for the bare metal machine.

bmcIpv4Address?: string

Property Value

string

bmcIpv6Address

The IPv6 address of the BMC interface for the bare metal machine.

bmcIpv6Address?: string

Property Value

string

bmcMacAddress

The MAC address of the BMC device.

bmcMacAddress: string

Property Value

string

bootMacAddress

The MAC address of a NIC connected to the PXE network.

bootMacAddress: string

Property Value

string

caCertificate

The CA certificate information issued by the platform for connecting to TLS interfaces for the bare metal machine. Callers add this certificate to the trusted CA store on the Kubernetes control plane nodes to allow secure communication with the bare metal machine.

caCertificate?: CertificateInfo

Property Value

clusterId

The resource ID of the cluster this bare metal machine is associated with.

clusterId?: string

Property Value

string

cordonStatus

The cordon status of the bare metal machine.

cordonStatus?: string

Property Value

string

detailedStatus

The more detailed status of the bare metal machine.

detailedStatus?: string

Property Value

string

detailedStatusMessage

The descriptive message about the current detailed status.

detailedStatusMessage?: string

Property Value

string

etag

"If etag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.")

etag?: string

Property Value

string

extendedLocation

The extended location of the resource. This property is required when creating the resource.

extendedLocation: ExtendedLocation

Property Value

hardwareInventory

The hardware inventory, including information acquired from the model/sku information and from the ironic inspector.

hardwareInventory?: HardwareInventory

Property Value

hardwareValidationStatus

The details of the latest hardware validation performed for this bare metal machine.

hardwareValidationStatus?: HardwareValidationStatus

Property Value

hybridAksClustersAssociatedIds

Field Deprecated. These fields will be empty/omitted. The list of the resource IDs for the HybridAksClusters that have nodes hosted on this bare metal machine.

hybridAksClustersAssociatedIds?: string[]

Property Value

string[]

kubernetesNodeName

The name of this machine represented by the host object in the Cluster's Kubernetes control plane.

kubernetesNodeName?: string

Property Value

string

kubernetesVersion

The version of Kubernetes running on this machine.

kubernetesVersion?: string

Property Value

string

machineClusterVersion

The cluster version that has been applied to this machine during deployment or a version update.

machineClusterVersion?: string

Property Value

string

machineDetails

The custom details provided by the customer.

machineDetails: string

Property Value

string

machineName

The OS-level hostname assigned to this machine.

machineName: string

Property Value

string

machineRoles

The list of roles that are assigned to the cluster node running on this machine.

machineRoles?: string[]

Property Value

string[]

machineSkuId

The unique internal identifier of the bare metal machine SKU.

machineSkuId: string

Property Value

string

monitoringConfigurationStatus

The monitoring configuration status of the bare metal machine.

monitoringConfigurationStatus?: BareMetalMachineMonitoringConfigurationStatus

Property Value

oamIpv4Address

The IPv4 address that is assigned to the bare metal machine during the cluster deployment.

oamIpv4Address?: string

Property Value

string

oamIpv6Address

The IPv6 address that is assigned to the bare metal machine during the cluster deployment.

oamIpv6Address?: string

Property Value

string

osImage

The image that is currently provisioned to the OS disk.

osImage?: string

Property Value

string

powerState

The power state derived from the baseboard management controller.

powerState?: string

Property Value

string

provisioningState

The provisioning state of the bare metal machine.

provisioningState?: string

Property Value

string

rackId

The resource ID of the rack where this bare metal machine resides.

rackId: string

Property Value

string

rackSlot

The rack slot in which this bare metal machine is located, ordered from the bottom up i.e. the lowest slot is 1.

rackSlot: number

Property Value

number

readyState

The indicator of whether the bare metal machine is ready to receive workloads.

readyState?: string

Property Value

string

runtimeProtectionStatus

The runtime protection status of the bare metal machine.

runtimeProtectionStatus?: RuntimeProtectionStatus

Property Value

secretRotationStatus

The list of statuses that represent secret rotation activity.

secretRotationStatus?: SecretRotationStatus[]

Property Value

serialNumber

The serial number of the bare metal machine.

serialNumber: string

Property Value

string

serviceTag

The discovered value of the machine's service tag.

serviceTag?: string

Property Value

string

virtualMachinesAssociatedIds

Field Deprecated. These fields will be empty/omitted. The list of the resource IDs for the VirtualMachines that are hosted on this bare metal machine.

virtualMachinesAssociatedIds?: string[]

Property Value

string[]

Inherited Property Details

id

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

id?: string

Property Value

string

Inherited From TrackedResource.id

location

The geo-location where the resource lives

location: string

Property Value

string

Inherited From TrackedResource.location

name

The name of the resource

name?: string

Property Value

string

Inherited From TrackedResource.name

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information.

systemData?: SystemData

Property Value

Inherited From TrackedResource.systemData

tags

Resource tags.

tags?: Record<string, string>

Property Value

Record<string, string>

Inherited From TrackedResource.tags

type

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

type?: string

Property Value

string

Inherited From TrackedResource.type