[e2e] add machine helper for status check.

[sedefsavas]

What this PR does / why we need it:
This PR adds a machine status check helper.
Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged):
Fixes #3016

[sedefsavas]

Waiting feedback from @gab-satchi about which checks are relevant here.

[k8s-ci-robot]

@sedefsavas: The following test failed, say /retest to rerun all failed tests:

Test name	Commit	Details	Rerun command
pull-cluster-api-capd-e2e	5c19522	link	/test pull-cluster-api-capd-e2e

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. I understand the commands that are listed here.

[gab-satchi]

Hey @sedefsavas, the CAPA e2e testcase that prompted this issue was asserting that a machine reaches a 'Failed' state if the underlying infrastructure node is deleted. So the status check I'd need for that would be waiting for Machine.Status.Phase to reach the state the test needs.

[fabriziopandini]

@sedefsavas
If I got it right what @gab-satchi is asking for, we need another status check (Status.Phase=Failed) and the possibility to check this and NodeRefAssignedStatus in and

[fabriziopandini]

/approve
@gab-satchi for final lgtm

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: fabriziopandini, sedefsavas

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [fabriziopandini]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[gab-satchi]

/retitle [e2e] add machine helper for status check.

[gab-satchi]

/lgtm