Background

To implement https://github.com/openshift/enhancements/pull/1465, we need to include an `authoritativeAPI` field on Machines, MachineSets, ControlPlaneMachineSets and MachineHealthChecks.

This field will control which version of a resource is considered authoritative, and therefore, which controllers should implement the functionality.

The field details are outlined in the enhancement.

The status of each resource should also be updated to indicate the authority of the API.

APIs should be added behind a ClusterAPIMigration feature gate.

Steps

• Add API fields to the spec of Machine API resources based on the enhancement
• Get API review
• Get API merged

Stakeholders

• Cluster Infra

Definition of Done

• API for authoritative APIs is merged as a feature gated API

• Docs

• <Add docs requirements for this card>

• Testing

• <Explain testing that will be added>