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 Compute Engine
instance might display FAILED_WITH_UNEXPECTED_STATUS or remain in the
REPAIRING state.
Avoid duplicate calls for the same compute instance
If you send a request to the report faulty host API more than once on the same instance 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 instance is unresponsive, then restart the instance before you send another request to the API.
Handle INTERNAL_ERROR during reportHostAsFaulty operation
If you delete a compute instance 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 an instance, 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 compute instance state
This error appears when the instance is in an unsupported state.
Error message:
INSTANCE_SHOULD_BE_RUNNING
Resolution: Verify that the instance is in the
RUNNING state.
Incorrect machine type
This error appears when the instance uses an unsupported machine type.
Error message:
MACHINE_TYPE_NOT_SUPPORTED
Resolution: The report faulty host API supports only instances that use A4X Max, A4X, A4, or A3 Ultra machine types.
Compute instance not in a reservation
This error appears when the instance was created without using a reservation.
Error message:
INSTANCES_WITHOUT_RESERVATION_NOT_SUPPORTED
Resolution: Verify that the instance was created by using the reservation-bound provisioning model. To report a faulty host for an A4X Max, A4X, A4, or A3 Ultra instance 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 instance 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.