- NAME
-
- gcloud compute instances report-host-as-faulty - report a host as faulty to start the repair process
- SYNOPSIS
-
-
gcloud compute instances report-host-as-faultyINSTANCE_NAME--disruption-schedule=DISRUPTION_SCHEDULE--fault-reasons= [behavior=BEHAVIOR] , [description=DESCRIPTION] [--async] [--zone=ZONE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
gcloud compute instances report-host-as-faultyis used to report a host as faulty to start the repair process. - EXAMPLES
- To report a host as faulty for an instance named
test-instancegcloud compute instances report-host-as-faulty test-instance --fault-reasons = behavior = SILENT_DATA_CORRUPTION,description = "affecting our ML job" --disruption-schedule = IMMEDIATE - POSITIONAL ARGUMENTS
-
-
INSTANCE_NAME - Name of the instance to operate on. For details on valid instance names, refer to the criteria documented under the field 'name' at: https://cloud.google.com/compute/docs/reference/rest/v1/instances
-
- REQUIRED FLAGS
-
-
--disruption-schedule=DISRUPTION_SCHEDULE - Specifies the timing for initiating the fault reporting process. The default
value is IMMEDIATE which initiates the process right away.
DISRUPTION_SCHEDULEmust be one of:IMMEDIATE,FUTURE. -
--fault-reasons=[behavior=BEHAVIOR],[description=DESCRIPTION] - Specified and can include one or more of the following types: ['BEHAVIOR_UNSPECIFIED', 'PERFORMANCE', 'SILENT_DATA_CORRUPTION', 'UNRECOVERABLE_GPU_ERROR', 'CHIP_ERROR']. This helps categorize the nature of the fault being reported.
-
- OPTIONAL FLAGS
-
-
--async - Return immediately, without waiting for the operation in progress to complete.
-
--zone=ZONE - Zone of the instance to operate on. If not specified, you might be prompted to
select a zone (interactive mode only).
gcloudattempts to identify the appropriate zone by searching for resources in your currently active project. If the zone cannot be determined,gcloudprompts you for a selection with all available Google Cloud Platform zones.To avoid prompting when this flag is omitted, the user can set the
compute/zonegcloud config set compute/zone ZONEA list of zones can be fetched by running:
gcloud compute zones listTo unset the property, run:
gcloud config unset compute/zoneAlternatively, the zone can be stored in the environment variable
CLOUDSDK_COMPUTE_ZONE
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
- These variants are also available:
gcloud alpha compute instances report-host-as-faultygcloud beta compute instances report-host-as-faultygcloud preview compute instances report-host-as-faulty
gcloud compute instances report-host-as-faulty
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.
