gcloud: Wed Mar 19 10:42:21 UTC 2025

gcloud/compute/disks/convert

@@ -16,11 +16,11 @@ DESCRIPTION
     https://cloud.google.com/sdk/gcloud/reference/compute/disks/convert.
 
 EXAMPLES
-    The following command converts a PD Standard disk to a Hyperdisk
-    Throughput:
+    The following command converts a Persistent Disk volume to a Hyperdisk
+    Balanced volume:
 
         $ gcloud compute disks convert my-disk-1 --zone=ZONE \
-        --target-disk-type=hyperdisk-throughput
+        --target-disk-type=hyperdisk-balanced
 
 POSITIONAL ARGUMENTS
      DISK_NAME

gcloud/compute/instances/help

@@ -130,6 +130,9 @@ COMMANDS
      remove-tags
         Remove tags from Compute Engine virtual machine instances.
 
+     report-host-as-faulty
+        Report a host as faulty to start the repair process.
+
      reset
         Reset a virtual machine instance.
 

gcloud/compute/instances/report-host-as-faulty

@@ -0,0 +1,79 @@
+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-faulty INSTANCE_NAME
+        --disruption-schedule=DISRUPTION_SCHEDULE
+        --fault-reasons=[behavior=BEHAVIOR],[description=DESCRIPTION]
+        [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    gcloud compute instances report-host-as-faulty is used to report a host as
+    faulty to start the repair process.
+
+EXAMPLES
+    To report a host as faulty for an instance named test-instance, run:
+
+        $ gcloud 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_SCHEDULE must be (only one value is supported): IMMEDIATE.
+
+     --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']. This helps categorize the nature of the
+        fault being reported.
+
+OPTIONAL FLAGS
+     --zone=ZONE
+        Zone of the instance to operate on. If not specified, you might be
+        prompted to select a zone (interactive mode only). gcloud attempts to
+        identify the appropriate zone by searching for resources in your
+        currently active project. If the zone cannot be determined, gcloud
+        prompts 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/zone property:
+
+            $ 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
+    These variants are also available:
+
+        $ gcloud alpha compute instances report-host-as-faulty
+
+        $ gcloud beta compute instances report-host-as-faulty
+

gcloud/compute/networks/subnets/create

@@ -5,7 +5,7 @@ NAME
 SYNOPSIS
     gcloud compute networks subnets create NAME --network=NETWORK
         [--description=DESCRIPTION] [--enable-flow-logs]
-        [--enable-private-ip-google-access]
+        [--enable-private-ip-google-access] [--ip-collection=IP_COLLECTION]
         [--ipv6-access-type=IPV6_ACCESS_TYPE]
         [--logging-aggregation-interval=LOGGING_AGGREGATION_INTERVAL]
         [--logging-filter-expr=LOGGING_FILTER_EXPR]
@@ -51,6 +51,11 @@ OPTIONAL FLAGS
         Enable/disable access to Google Cloud APIs from this subnet for
         instances without a public ip address.
 
+     --ip-collection=IP_COLLECTION
+        Resource reference to a public delegated prefix. The
+        PublicDelegatedPrefix must be a sub-prefix in
+        EXTERNAL_IPV6_SUBNETWORK_CREATION mode.
+
      --ipv6-access-type=IPV6_ACCESS_TYPE
         IPv6 access type can be specified only when the subnet is created, or
         when the subnet is first updated to have a stack type of IPV4_IPV6.

gcloud/compute/networks/subnets/update

@@ -6,7 +6,7 @@ SYNOPSIS
     gcloud compute networks subnets update NAME
         [--add-secondary-ranges-with-reserved-internal-range=RANGE_NAME=INTERNAL_RANGE_URL,
           [...]] [--drain-timeout=DRAIN_TIMEOUT; default="0s"]
-        [--ipv6-access-type=IPV6_ACCESS_TYPE]
+        [--ip-collection=IP_COLLECTION] [--ipv6-access-type=IPV6_ACCESS_TYPE]
         [--logging-aggregation-interval=LOGGING_AGGREGATION_INTERVAL]
         [--logging-filter-expr=LOGGING_FILTER_EXPR]
         [--logging-flow-sampling=LOGGING_FLOW_SAMPLING]
@@ -56,6 +56,11 @@ FLAGS
         availability of proxies for load balancing. The drain timeout is only
         applicable when the [--role=ACTIVE] flag is being used.
 
+     --ip-collection=IP_COLLECTION
+        Resource reference to a public delegated prefix. The
+        PublicDelegatedPrefix must be a sub-prefix in
+        EXTERNAL_IPV6_SUBNETWORK_CREATION mode.
+
      --ipv6-access-type=IPV6_ACCESS_TYPE
         IPv6 access type can be specified only when the subnet is created, or
         when the subnet is first updated to have a stack type of IPV4_IPV6.

gcloud/compute/public-delegated-prefixes/create

@@ -48,7 +48,8 @@ OPTIONAL FLAGS
 
      --mode=MODE
         Specifies the mode of this IPv6 PDP. MODE must be one of: delegation,
-        external-ipv6-forwarding-rule-creation.
+        external-ipv6-forwarding-rule-creation,
+        external-ipv6-subnetwork-creation.
 
      At most one of these can be specified:
 

gcloud/compute/public-delegated-prefixes/delegated-sub-prefixes/create

@@ -56,7 +56,8 @@ OPTIONAL FLAGS
 
      --mode=MODE
         Specifies the mode of this IPv6 PDP. MODE must be one of: delegation,
-        external-ipv6-forwarding-rule-creation.
+        external-ipv6-forwarding-rule-creation,
+        external-ipv6-subnetwork-creation.
 
      --range=RANGE
         IPv4 range from this public delegated prefix that should be delegated,

gcloud/compute/reservations/create

@@ -7,7 +7,7 @@ SYNOPSIS
           (--source-instance-template=SOURCE_INSTANCE_TEMPLATE
           | [--machine-type=MACHINE_TYPE
           : --accelerator=[count=COUNT],[type=TYPE]
-          --local-ssd=[interface=INTERFACE],[size=SIZE]
+          --local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE]
           --min-cpu-platform=MIN_CPU_PLATFORM])
           : --require-specific-reservation --resource-policies=[KEY=VALUE,...])
         [--description=DESCRIPTION]
@@ -96,7 +96,7 @@ REQUIRED FLAGS
                   reservation. Use gcloud compute accelerator-types list to
                   learn about all available accelerator types.
 
-           --local-ssd=[interface=INTERFACE],[size=SIZE]
+           --local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE]
               Manage the size and the interface of local SSD to use. See
               https://cloud.google.com/compute/docs/disks/local-ssd for more
               information.
@@ -107,6 +107,9 @@ REQUIRED FLAGS
                   higher performance.
                size
                   The size of the local SSD in base-2 GB.
+               count
+                  The number of local SSD to use per VM. If you don't specify
+                  this argument, then the default value is 1.
 
            --min-cpu-platform=MIN_CPU_PLATFORM
               Optional minimum CPU platform of the reservation to create.