This document explains how to resolve issues that you might encounter when you make a call to the report a faulty host API, as well as the known issues for this API.
Review known issues
When a problem occurs during a repair operation, your virtual machine (VM)
instance might display FAILED_WITH_UNEXPECTED_STATUS or remain in the
REPAIRING state.
Avoid duplicate calls for the same VM
If you send a request to the report faulty host API more than once on the same VM before the previous operation completes, then Compute Engine rejects the extra requests.
Workaround: Wait until the first report faulty host operation completes before you send another request to the API. If the VM is unresponsive, then restart the VM before you send another request to the API.
Handle INTERNAL_ERROR during reportHostAsFaulty operation
If you delete a VM while the reportHostAsFaulty operation is in progress, then
an INTERNAL_ERROR might occur and the reportHostAsFaulty operation fails.
Workaround: No workaround is available. Before you delete a VM, you must
verify that the
reportHostAsFaulty operation has completed.
Error messages
The report faulty host API might display one of the following error messages.
Unsupported VM state
This error appears when the VM is in an unsupported state.
Error message:
INSTANCE_SHOULD_BE_RUNNING
Resolution: Verify that the VM is in the
RUNNING state.
Incorrect machine type
This error appears when the VM uses an unsupported machine type.
Error message:
MACHINE_TYPE_NOT_SUPPORTED
Resolution: The report faulty host API supports only VMs that use A4X, A4, or A3 Ultra machine types.
VM not in a reservation
This error appears when the VM was created without using a reservation.
Error message:
INSTANCES_WITHOUT_RESERVATION_NOT_SUPPORTED
Resolution: Verify that the VM was created by using the reservation-bound provisioning model. To report a faulty host for an A4X, A4, or A3 Ultra VM that uses the flex-start or spot provisioning model, contact your account team.
Fault reason is missing
This error appears when you don't specify the faultReasons field in a report
faulty host request.
Error message:
FAULT_REASONS_EMPTY_SHOULD_BE_SPECIFIED
Resolution: The faultReasons field is required. To resolve this issue,
restart the VM and specify the
faultReasons field
when you make a new report faulty host request.
Rate limit exceeded
Error message:
RATE_LIMIT_EXCEEDED
Reason: You have exceeded the allowed limits of requests to the
instances.reportHostAsFaulty method, or Google lacks sufficient capacity to
fulfill your request.