- NAME
-
- gcloud alpha compute reservations sub-blocks report-subblock-as-faulty - report a faulty reservation sub block
- SYNOPSIS
-
-
gcloud alpha compute reservations sub-blocks report-subblock-as-faulty
RESERVATION
--block-name
=BLOCK_NAME
--disruption-schedule
=DISRUPTION_SCHEDULE
--failure-component
=FAILURE_COMPONENT
--fault-reasons
=[behavior
=BEHAVIOR
],[description
=DESCRIPTION
]--sub-block-name
=SUB_BLOCK_NAME
[--zone
=ZONE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
Report a faulty reservation sub block. - EXAMPLES
-
To report reservation exr-1 in ZONE with block name block-1 and sub block name
sub-block-1 as faulty, run:
gcloud alpha compute reservations sub-blocks report-subblock-as-faulty exr-1 --zone=ZONE --block-name=block-1 --sub-block-name=sub-block-1 --disruption-schedule=IMMEDIATE --fault-reasons=behavior=PERFORMANCE,description="performance issues" --failure-component=NVLINK_SWITCH
- POSITIONAL ARGUMENTS
-
RESERVATION
- Name of the reservation to report-subblock-as-faulty.
- REQUIRED FLAGS
-
--block-name
=BLOCK_NAME
- The name of the reservation block.
--disruption-schedule
=DISRUPTION_SCHEDULE
-
The disruption schedule for the sub-block.
DISRUPTION_SCHEDULE
must be (only one value is supported):IMMEDIATE
- All VMs will be disrupted immediately.
--failure-component
=FAILURE_COMPONENT
-
The component that experienced the fault.
FAILURE_COMPONENT
must be one of:MULTIPLE_FAULTY_HOSTS
- Multiple hosts experienced the fault.
NVLINK_SWITCH
- The NVLink switch experienced the fault.
--fault-reasons
=[behavior
=BEHAVIOR
],[description
=DESCRIPTION
]- The reasons for the fault experienced with the sub-block. This flag can be repeated. Each instance should specify a "behavior" and an optional "description". The possible values for "behavior" are: PERFORMANCE, SWITCH_FAILURE, GPU_ERROR.
--sub-block-name
=SUB_BLOCK_NAME
- The name of the reservation sub block.
- OPTIONAL FLAGS
-
--zone
=ZONE
-
Zone of the reservation to report-subblock-as-faulty. If not specified and the
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zone
To avoid prompting when this flag is omitted, you can set the
property:compute/zone
gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
gcloud compute zones list
To unset the property, run:
gcloud config unset compute/zone
Alternatively, 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 help
for details. - NOTES
- This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.
gcloud alpha compute reservations sub-blocks report-subblock-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 2025-09-03 UTC.