Last generated June 29, 2022
AzureMachine
AzureMachine is the Schema for the azuremachines API.
Version v1alpha3
Example CR
apiVersion: infrastructure.cluster.x-k8s.io/v1alpha3
kind: AzureMachine
metadata:
labels:
azure-operator.giantswarm.io/version: 5.3.1
cluster.x-k8s.io/cluster-name: mmh5x
cluster.x-k8s.io/control-plane: "true"
giantswarm.io/cluster: mmh5x
giantswarm.io/organization: giantswarm
release.giantswarm.io/version: 14.1.0
name: mmh5x-master-0
namespace: org-giantswarm
spec:
availabilityZone: {}
failureDomain: "3"
identity: None
image:
marketplace:
offer: flatcar-container-linux-free
publisher: kinvolk
sku: stable
thirdPartyImage: false
version: 2345.3.1
location: westeurope
osDisk:
cachingType: ReadWrite
diskSizeGB: 50
managedDisk:
storageAccountType: Premium_LRS
osType: Linux
sshPublicKey: ""
vmSize: Standard_D4s_v3
Properties
.apiVersion
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
.kind
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
.metadata
.spec
AzureMachineSpec defines the desired state of AzureMachine.
.spec.acceleratedNetworking
AcceleratedNetworking enables or disables Azure accelerated networking. If omitted, it will be set based on whether the requested VMSize supports accelerated networking. If AcceleratedNetworking is set to true with a VMSize that does not support it, Azure will return an error.
.spec.additionalTags
AdditionalTags is an optional set of tags to add to an instance, in addition to the ones added by default by the Azure provider. If both the AzureCluster and the AzureMachine specify the same tag name with different values, the AzureMachine’s value takes precedence.
.spec.allocatePublicIP
AllocatePublicIP allows the ability to create dynamic public ips for machines where this value is true.
.spec.availabilityZone
DEPRECATED: use FailureDomain instead
.spec.availabilityZone.enabled
.spec.availabilityZone.id
.spec.dataDisks
DataDisk specifies the parameters that are used to add one or more data disks to the machine
.spec.dataDisks[*]
DataDisk specifies the parameters that are used to add one or more data disks to the machine.
.spec.dataDisks[*].cachingType
.spec.dataDisks[*].diskSizeGB
DiskSizeGB is the size in GB to assign to the data disk.
.spec.dataDisks[*].lun
Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. The value must be between 0 and 63.
.spec.dataDisks[*].managedDisk
ManagedDisk defines the managed disk options for a VM.
.spec.dataDisks[*].managedDisk.diskEncryptionSet
DiskEncryptionSetParameters defines disk encryption options.
.spec.dataDisks[*].managedDisk.diskEncryptionSet.id
ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription
.spec.dataDisks[*].managedDisk.storageAccountType
.spec.dataDisks[*].nameSuffix
NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format
.spec.enableIPForwarding
EnableIPForwarding enables IP Forwarding in Azure which is required for some CNI’s to send traffic from a pods on one machine to another. This is required for IpV6 with Calico in combination with User Defined Routes (set by the Azure Cloud Controller manager). Default is false for disabled.
.spec.failureDomain
FailureDomain is the failure domain unique identifier this Machine should be attached to, as defined in Cluster API. This relates to an Azure Availability Zone
.spec.identity
Identity is the type of identity used for the virtual machine. The type ‘SystemAssigned’ is an implicitly created identity. The generated identity will be assigned a Subscription contributor role. The type ‘UserAssigned’ is a standalone Azure resource provided by the user and assigned to the VM
.spec.image
Image is used to provide details of an image to use during VM creation. If image details are omitted the image will default the Azure Marketplace “capi” offer, which is based on Ubuntu.
.spec.image.id
ID specifies an image to use by ID
.spec.image.marketplace
Marketplace specifies an image to use from the Azure Marketplace
.spec.image.marketplace.offer
Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer
.spec.image.marketplace.publisher
Publisher is the name of the organization that created the image
.spec.image.marketplace.sku
SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter
.spec.image.marketplace.thirdPartyImage
ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.
.spec.image.marketplace.version
Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.
.spec.image.sharedGallery
SharedGallery specifies an image to use from an Azure Shared Image Gallery
.spec.image.sharedGallery.gallery
Gallery specifies the name of the shared image gallery that contains the image
.spec.image.sharedGallery.name
Name is the name of the image
.spec.image.sharedGallery.resourceGroup
ResourceGroup specifies the resource group containing the shared image gallery
.spec.image.sharedGallery.subscriptionID
SubscriptionID is the identifier of the subscription that contains the shared image gallery
.spec.image.sharedGallery.version
Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.
.spec.location
DEPRECATED: to support old clients, will be removed in v1alpha4/v1beta1
.spec.osDisk
OSDisk specifies the parameters for the operating system disk of the machine
.spec.osDisk.cachingType
.spec.osDisk.diffDiskSettings
DiffDiskSettings describe ephemeral disk settings for the os disk.
.spec.osDisk.diffDiskSettings.option
Option enables ephemeral OS when set to “Local” See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details
.spec.osDisk.diskSizeGB
.spec.osDisk.managedDisk
ManagedDisk defines the managed disk options for a VM.
.spec.osDisk.managedDisk.diskEncryptionSet
DiskEncryptionSetParameters defines disk encryption options.
.spec.osDisk.managedDisk.diskEncryptionSet.id
ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription
.spec.osDisk.managedDisk.storageAccountType
.spec.osDisk.osType
.spec.providerID
ProviderID is the unique identifier as specified by the cloud provider.
.spec.roleAssignmentName
RoleAssignmentName is the name of the role assignment to create for a system assigned identity. It can be any valid GUID. If not specified, a random GUID will be generated.
.spec.securityProfile
SecurityProfile specifies the Security profile settings for a virtual machine.
.spec.securityProfile.encryptionAtHost
This field indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. Default is disabled.
.spec.spotVMOptions
SpotVMOptions allows the ability to specify the Machine should use a Spot VM.
.spec.spotVMOptions.maxPrice
MaxPrice defines the maximum price the user is willing to pay for Spot VM instances
.spec.sshPublicKey
.spec.userAssignedIdentities
UserAssignedIdentities is a list of standalone Azure identities provided by the user The lifecycle of a user-assigned identity is managed separately from the lifecycle of the AzureMachine. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
.spec.userAssignedIdentities[*]
UserAssignedIdentity defines the user-assigned identities provided by the user to be assigned to Azure resources.
.spec.userAssignedIdentities[*].providerID
ProviderID is the identification ID of the user-assigned Identity, the format of an identity is: ‘azure:///subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}’
.spec.vmSize
.status
AzureMachineStatus defines the observed state of AzureMachine.
.status.addresses
Addresses contains the Azure instance associated addresses.
.status.addresses[*]
NodeAddress contains information for the node’s address.
.status.addresses[*].address
The node address.
.status.addresses[*].type
Node address type, one of Hostname, ExternalIP or InternalIP.
.status.conditions
Conditions defines current service state of the AzureMachine.
.status.conditions[*]
Condition defines an observation of a Cluster API resource operational state.
.status.conditions[*].lastTransitionTime
Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
.status.conditions[*].message
A human readable message indicating details about the transition. This field may be empty.
.status.conditions[*].reason
The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.
.status.conditions[*].severity
Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.
.status.conditions[*].status
Status of the condition, one of True, False, Unknown.
.status.conditions[*].type
Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.
.status.failureMessage
ErrorMessage will be set in the event that there is a terminal problem reconciling the Machine and will contain a more verbose string suitable for logging and human consumption. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller’s output.
.status.failureReason
ErrorReason will be set in the event that there is a terminal problem reconciling the Machine and will contain a succinct value suitable for machine interpretation. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller’s output.
.status.ready
Ready is true when the provider resource is ready.
.status.vmState
VMState is the provisioning state of the Azure virtual machine.
Version v1alpha4
Properties
.apiVersion
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
.kind
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
.metadata
.spec
AzureMachineSpec defines the desired state of AzureMachine.
.spec.acceleratedNetworking
AcceleratedNetworking enables or disables Azure accelerated networking. If omitted, it will be set based on whether the requested VMSize supports accelerated networking. If AcceleratedNetworking is set to true with a VMSize that does not support it, Azure will return an error.
.spec.additionalTags
AdditionalTags is an optional set of tags to add to an instance, in addition to the ones added by default by the Azure provider. If both the AzureCluster and the AzureMachine specify the same tag name with different values, the AzureMachine’s value takes precedence.
.spec.allocatePublicIP
AllocatePublicIP allows the ability to create dynamic public ips for machines where this value is true.
.spec.dataDisks
DataDisk specifies the parameters that are used to add one or more data disks to the machine
.spec.dataDisks[*]
DataDisk specifies the parameters that are used to add one or more data disks to the machine.
.spec.dataDisks[*].cachingType
CachingType specifies the caching requirements.
.spec.dataDisks[*].diskSizeGB
DiskSizeGB is the size in GB to assign to the data disk.
.spec.dataDisks[*].lun
Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. The value must be between 0 and 63.
.spec.dataDisks[*].managedDisk
ManagedDisk specifies the Managed Disk parameters for the data disk.
.spec.dataDisks[*].managedDisk.diskEncryptionSet
DiskEncryptionSetParameters defines disk encryption options.
.spec.dataDisks[*].managedDisk.diskEncryptionSet.id
ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription
.spec.dataDisks[*].managedDisk.storageAccountType
.spec.dataDisks[*].nameSuffix
NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format
.spec.enableIPForwarding
EnableIPForwarding enables IP Forwarding in Azure which is required for some CNI’s to send traffic from a pods on one machine to another. This is required for IpV6 with Calico in combination with User Defined Routes (set by the Azure Cloud Controller manager). Default is false for disabled.
.spec.failureDomain
FailureDomain is the failure domain unique identifier this Machine should be attached to, as defined in Cluster API. This relates to an Azure Availability Zone
.spec.identity
Identity is the type of identity used for the virtual machine. The type ‘SystemAssigned’ is an implicitly created identity. The generated identity will be assigned a Subscription contributor role. The type ‘UserAssigned’ is a standalone Azure resource provided by the user and assigned to the VM
.spec.image
Image is used to provide details of an image to use during VM creation. If image details are omitted the image will default the Azure Marketplace “capi” offer, which is based on Ubuntu.
.spec.image.id
ID specifies an image to use by ID
.spec.image.marketplace
Marketplace specifies an image to use from the Azure Marketplace
.spec.image.marketplace.offer
Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer
.spec.image.marketplace.publisher
Publisher is the name of the organization that created the image
.spec.image.marketplace.sku
SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter
.spec.image.marketplace.thirdPartyImage
ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.
.spec.image.marketplace.version
Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.
.spec.image.sharedGallery
SharedGallery specifies an image to use from an Azure Shared Image Gallery
.spec.image.sharedGallery.gallery
Gallery specifies the name of the shared image gallery that contains the image
.spec.image.sharedGallery.name
Name is the name of the image
.spec.image.sharedGallery.offer
Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.
.spec.image.sharedGallery.publisher
Publisher is the name of the organization that created the image. This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.
.spec.image.sharedGallery.resourceGroup
ResourceGroup specifies the resource group containing the shared image gallery
.spec.image.sharedGallery.sku
SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.
.spec.image.sharedGallery.subscriptionID
SubscriptionID is the identifier of the subscription that contains the shared image gallery
.spec.image.sharedGallery.version
Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.
.spec.osDisk
OSDisk specifies the parameters for the operating system disk of the machine
.spec.osDisk.cachingType
CachingType specifies the caching requirements.
.spec.osDisk.diffDiskSettings
DiffDiskSettings describe ephemeral disk settings for the os disk.
.spec.osDisk.diffDiskSettings.option
Option enables ephemeral OS when set to “Local” See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details
.spec.osDisk.diskSizeGB
DiskSizeGB is the size in GB to assign to the OS disk. Will have a default of 30GB if not provided
.spec.osDisk.managedDisk
ManagedDisk specifies the Managed Disk parameters for the OS disk.
.spec.osDisk.managedDisk.diskEncryptionSet
DiskEncryptionSetParameters defines disk encryption options.
.spec.osDisk.managedDisk.diskEncryptionSet.id
ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription
.spec.osDisk.managedDisk.storageAccountType
.spec.osDisk.osType
.spec.providerID
ProviderID is the unique identifier as specified by the cloud provider.
.spec.roleAssignmentName
RoleAssignmentName is the name of the role assignment to create for a system assigned identity. It can be any valid GUID. If not specified, a random GUID will be generated.
.spec.securityProfile
SecurityProfile specifies the Security profile settings for a virtual machine.
.spec.securityProfile.encryptionAtHost
This field indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. Default is disabled.
.spec.spotVMOptions
SpotVMOptions allows the ability to specify the Machine should use a Spot VM
.spec.spotVMOptions.maxPrice
MaxPrice defines the maximum price the user is willing to pay for Spot VM instances
.spec.sshPublicKey
.spec.subnetName
SubnetName selects the Subnet where the VM will be placed
.spec.userAssignedIdentities
UserAssignedIdentities is a list of standalone Azure identities provided by the user The lifecycle of a user-assigned identity is managed separately from the lifecycle of the AzureMachine. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
.spec.userAssignedIdentities[*]
UserAssignedIdentity defines the user-assigned identities provided by the user to be assigned to Azure resources.
.spec.userAssignedIdentities[*].providerID
ProviderID is the identification ID of the user-assigned Identity, the format of an identity is: ‘azure:///subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}’
.spec.vmSize
.status
AzureMachineStatus defines the observed state of AzureMachine.
.status.addresses
Addresses contains the Azure instance associated addresses.
.status.addresses[*]
NodeAddress contains information for the node’s address.
.status.addresses[*].address
The node address.
.status.addresses[*].type
Node address type, one of Hostname, ExternalIP or InternalIP.
.status.conditions
Conditions defines current service state of the AzureMachine.
.status.conditions[*]
Condition defines an observation of a Cluster API resource operational state.
.status.conditions[*].lastTransitionTime
Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
.status.conditions[*].message
A human readable message indicating details about the transition. This field may be empty.
.status.conditions[*].reason
The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.
.status.conditions[*].severity
Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.
.status.conditions[*].status
Status of the condition, one of True, False, Unknown.
.status.conditions[*].type
Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.
.status.failureMessage
ErrorMessage will be set in the event that there is a terminal problem reconciling the Machine and will contain a more verbose string suitable for logging and human consumption. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller’s output.
.status.failureReason
ErrorReason will be set in the event that there is a terminal problem reconciling the Machine and will contain a succinct value suitable for machine interpretation. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller’s output.
.status.longRunningOperationStates
LongRunningOperationStates saves the states for Azure long-running operations so they can be continued on the next reconciliation loop.
.status.longRunningOperationStates[*]
Future contains the data needed for an Azure long-running operation to continue across reconcile loops.
.status.longRunningOperationStates[*].data
Data is the base64 url encoded json Azure AutoRest Future.
.status.longRunningOperationStates[*].name
Name is the name of the Azure resource. Together with the service name, this forms the unique identifier for the future.
.status.longRunningOperationStates[*].resourceGroup
ResourceGroup is the Azure resource group for the resource.
.status.longRunningOperationStates[*].serviceName
ServiceName is the name of the Azure service. Together with the name of the resource, this forms the unique identifier for the future.
.status.longRunningOperationStates[*].type
Type describes the type of future, such as update, create, delete, etc.
.status.ready
Ready is true when the provider resource is ready.
.status.vmState
VMState is the provisioning state of the Azure virtual machine.
Version v1beta1
Properties
.apiVersion
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
.kind
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
.metadata
.spec
AzureMachineSpec defines the desired state of AzureMachine.
.spec.acceleratedNetworking
AcceleratedNetworking enables or disables Azure accelerated networking. If omitted, it will be set based on whether the requested VMSize supports accelerated networking. If AcceleratedNetworking is set to true with a VMSize that does not support it, Azure will return an error.
.spec.additionalTags
AdditionalTags is an optional set of tags to add to an instance, in addition to the ones added by default by the Azure provider. If both the AzureCluster and the AzureMachine specify the same tag name with different values, the AzureMachine’s value takes precedence.
.spec.allocatePublicIP
AllocatePublicIP allows the ability to create dynamic public ips for machines where this value is true.
.spec.dataDisks
DataDisk specifies the parameters that are used to add one or more data disks to the machine
.spec.dataDisks[*]
DataDisk specifies the parameters that are used to add one or more data disks to the machine.
.spec.dataDisks[*].cachingType
CachingType specifies the caching requirements.
.spec.dataDisks[*].diskSizeGB
DiskSizeGB is the size in GB to assign to the data disk.
.spec.dataDisks[*].lun
Lun Specifies the logical unit number of the data disk. This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM. The value must be between 0 and 63.
.spec.dataDisks[*].managedDisk
ManagedDisk specifies the Managed Disk parameters for the data disk.
.spec.dataDisks[*].managedDisk.diskEncryptionSet
DiskEncryptionSetParameters defines disk encryption options.
.spec.dataDisks[*].managedDisk.diskEncryptionSet.id
ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription
.spec.dataDisks[*].managedDisk.storageAccountType
.spec.dataDisks[*].nameSuffix
NameSuffix is the suffix to be appended to the machine name to generate the disk name. Each disk name will be in format
.spec.enableIPForwarding
EnableIPForwarding enables IP Forwarding in Azure which is required for some CNI’s to send traffic from a pods on one machine to another. This is required for IpV6 with Calico in combination with User Defined Routes (set by the Azure Cloud Controller manager). Default is false for disabled.
.spec.failureDomain
FailureDomain is the failure domain unique identifier this Machine should be attached to, as defined in Cluster API. This relates to an Azure Availability Zone
.spec.identity
Identity is the type of identity used for the virtual machine. The type ‘SystemAssigned’ is an implicitly created identity. The generated identity will be assigned a Subscription contributor role. The type ‘UserAssigned’ is a standalone Azure resource provided by the user and assigned to the VM
.spec.image
Image is used to provide details of an image to use during VM creation. If image details are omitted the image will default the Azure Marketplace “capi” offer, which is based on Ubuntu.
.spec.image.id
ID specifies an image to use by ID
.spec.image.marketplace
Marketplace specifies an image to use from the Azure Marketplace
.spec.image.marketplace.offer
Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer
.spec.image.marketplace.publisher
Publisher is the name of the organization that created the image
.spec.image.marketplace.sku
SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter
.spec.image.marketplace.thirdPartyImage
ThirdPartyImage indicates the image is published by a third party publisher and a Plan will be generated for it.
.spec.image.marketplace.version
Version specifies the version of an image sku. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.
.spec.image.sharedGallery
SharedGallery specifies an image to use from an Azure Shared Image Gallery
.spec.image.sharedGallery.gallery
Gallery specifies the name of the shared image gallery that contains the image
.spec.image.sharedGallery.name
Name is the name of the image
.spec.image.sharedGallery.offer
Offer specifies the name of a group of related images created by the publisher. For example, UbuntuServer, WindowsServer This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.
.spec.image.sharedGallery.publisher
Publisher is the name of the organization that created the image. This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.
.spec.image.sharedGallery.resourceGroup
ResourceGroup specifies the resource group containing the shared image gallery
.spec.image.sharedGallery.sku
SKU specifies an instance of an offer, such as a major release of a distribution. For example, 18.04-LTS, 2019-Datacenter This value will be used to add a Plan in the API request when creating the VM/VMSS resource. This is needed when the source image from which this SIG image was built requires the Plan to be used.
.spec.image.sharedGallery.subscriptionID
SubscriptionID is the identifier of the subscription that contains the shared image gallery
.spec.image.sharedGallery.version
Version specifies the version of the marketplace image. The allowed formats are Major.Minor.Build or ‘latest’. Major, Minor, and Build are decimal numbers. Specify ‘latest’ to use the latest version of an image available at deploy time. Even if you use ‘latest’, the VM image will not automatically update after deploy time even if a new version becomes available.
.spec.osDisk
OSDisk specifies the parameters for the operating system disk of the machine
.spec.osDisk.cachingType
CachingType specifies the caching requirements.
.spec.osDisk.diffDiskSettings
DiffDiskSettings describe ephemeral disk settings for the os disk.
.spec.osDisk.diffDiskSettings.option
Option enables ephemeral OS when set to “Local” See https://docs.microsoft.com/en-us/azure/virtual-machines/ephemeral-os-disks for full details
.spec.osDisk.diskSizeGB
DiskSizeGB is the size in GB to assign to the OS disk. Will have a default of 30GB if not provided
.spec.osDisk.managedDisk
ManagedDisk specifies the Managed Disk parameters for the OS disk.
.spec.osDisk.managedDisk.diskEncryptionSet
DiskEncryptionSetParameters defines disk encryption options.
.spec.osDisk.managedDisk.diskEncryptionSet.id
ID defines resourceID for diskEncryptionSet resource. It must be in the same subscription
.spec.osDisk.managedDisk.storageAccountType
.spec.osDisk.osType
.spec.providerID
ProviderID is the unique identifier as specified by the cloud provider.
.spec.roleAssignmentName
RoleAssignmentName is the name of the role assignment to create for a system assigned identity. It can be any valid GUID. If not specified, a random GUID will be generated.
.spec.securityProfile
SecurityProfile specifies the Security profile settings for a virtual machine.
.spec.securityProfile.encryptionAtHost
This field indicates whether Host Encryption should be enabled or disabled for a virtual machine or virtual machine scale set. Default is disabled.
.spec.spotVMOptions
SpotVMOptions allows the ability to specify the Machine should use a Spot VM
.spec.spotVMOptions.maxPrice
MaxPrice defines the maximum price the user is willing to pay for Spot VM instances
.spec.sshPublicKey
.spec.subnetName
SubnetName selects the Subnet where the VM will be placed
.spec.userAssignedIdentities
UserAssignedIdentities is a list of standalone Azure identities provided by the user The lifecycle of a user-assigned identity is managed separately from the lifecycle of the AzureMachine. See https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/how-to-manage-ua-identity-cli
.spec.userAssignedIdentities[*]
UserAssignedIdentity defines the user-assigned identities provided by the user to be assigned to Azure resources.
.spec.userAssignedIdentities[*].providerID
ProviderID is the identification ID of the user-assigned Identity, the format of an identity is: ‘azure:///subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}’
.spec.vmSize
.status
AzureMachineStatus defines the observed state of AzureMachine.
.status.addresses
Addresses contains the Azure instance associated addresses.
.status.addresses[*]
NodeAddress contains information for the node’s address.
.status.addresses[*].address
The node address.
.status.addresses[*].type
Node address type, one of Hostname, ExternalIP or InternalIP.
.status.conditions
Conditions defines current service state of the AzureMachine.
.status.conditions[*]
Condition defines an observation of a Cluster API resource operational state.
.status.conditions[*].lastTransitionTime
Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
.status.conditions[*].message
A human readable message indicating details about the transition. This field may be empty.
.status.conditions[*].reason
The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.
.status.conditions[*].severity
Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.
.status.conditions[*].status
Status of the condition, one of True, False, Unknown.
.status.conditions[*].type
Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.
.status.failureMessage
ErrorMessage will be set in the event that there is a terminal problem reconciling the Machine and will contain a more verbose string suitable for logging and human consumption. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller’s output.
.status.failureReason
ErrorReason will be set in the event that there is a terminal problem reconciling the Machine and will contain a succinct value suitable for machine interpretation. This field should not be set for transitive errors that a controller faces that are expected to be fixed automatically over time (like service outages), but instead indicate that something is fundamentally wrong with the Machine’s spec or the configuration of the controller, and that manual intervention is required. Examples of terminal errors would be invalid combinations of settings in the spec, values that are unsupported by the controller, or the responsible controller itself being critically misconfigured. Any transient errors that occur during the reconciliation of Machines can be added as events to the Machine object and/or logged in the controller’s output.
.status.longRunningOperationStates
LongRunningOperationStates saves the states for Azure long-running operations so they can be continued on the next reconciliation loop.
.status.longRunningOperationStates[*]
Future contains the data needed for an Azure long-running operation to continue across reconcile loops.
.status.longRunningOperationStates[*].data
Data is the base64 url encoded json Azure AutoRest Future.
.status.longRunningOperationStates[*].name
Name is the name of the Azure resource. Together with the service name, this forms the unique identifier for the future.
.status.longRunningOperationStates[*].resourceGroup
ResourceGroup is the Azure resource group for the resource.
.status.longRunningOperationStates[*].serviceName
ServiceName is the name of the Azure service. Together with the name of the resource, this forms the unique identifier for the future.
.status.longRunningOperationStates[*].type
Type describes the type of future, such as update, create, delete, etc.
.status.ready
Ready is true when the provider resource is ready.
.status.vmState
VMState is the provisioning state of the Azure virtual machine.
This documentation page shows information based on apiextensions v5.0.0.
Need help with the Management API?
We listen in your Slack support channel. And of course, we welcome your pull requests to improve these docs!
