gcloud: Wed Dec 20 10:06:06 UTC 2023

2026-07-18 14:56:05 +00:00 · 2023-12-20 10:06:06 +00:00 · 2023-12-20 10:06:06 +00:00 · 94c3362cff
commit 94c3362cff
parent a990278fb3
127 changed files with 1438 additions and 194 deletions
--- a/gcloud/alpha/compute/disks/create
+++ b/gcloud/alpha/compute/disks/create
@ -73,8 +73,8 @@ FLAGS
        be one of: ARM64, X86_64.

     --confidential-compute
-        Create the disk in confidential compute mode, CMEK layer is required
-        and only applicable to HyperDisk series.
+        Creates the disk with confidential compute mode enabled. Encryption
+        with a Cloud KMS key is required to enable this option.

     --csek-key-file=FILE
        Path to a Customer-Supplied Encryption Key (CSEK) key file that maps
--- a/gcloud/alpha/compute/health-checks/create/http
+++ b/gcloud/alpha/compute/health-checks/create/http
@ -9,7 +9,7 @@ SYNOPSIS
        [--healthy-threshold=HEALTHY_THRESHOLD; default=2] [--host=HOST]
        [--proxy-header=PROXY_HEADER; default="NONE"]
        [--request-path=REQUEST_PATH; default="/"] [--response=RESPONSE]
-        [--timeout=TIMEOUT; default="5s"]
+        [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT; default="5s"]
        [--unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2]
        [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION]
        [--port=PORT; default=80 --port-name=PORT_NAME --use-serving-port]
@ -69,6 +69,16 @@ FLAGS
        empty, presence of specified string in first 1024 characters of
        response body determines health. Only ASCII characters allowed.

+     --source-regions=REGION,...,[...]
+        Defines the list of cloud regions from which health checks are
+        performed. This option can be specified only for health checks used
+        with DNS Routing Policies. If specified, --check-interval should be at
+        least 30 seconds. --proxy-header field and --request field (for TCP)
+        are not supported with this option. source-regions is only allowed for
+        global health checks. If this option is specified, then the health
+        check cannot be used with BackendService nor with managed instance
+        group autohealing.
+
     --timeout=TIMEOUT; default="5s"
        If Google Compute Engine doesn't receive a healthy response from the
        instance by the time specified by the value of this flag, the health
--- a/gcloud/alpha/compute/health-checks/create/https
+++ b/gcloud/alpha/compute/health-checks/create/https
@ -9,7 +9,7 @@ SYNOPSIS
        [--healthy-threshold=HEALTHY_THRESHOLD; default=2] [--host=HOST]
        [--proxy-header=PROXY_HEADER; default="NONE"]
        [--request-path=REQUEST_PATH; default="/"] [--response=RESPONSE]
-        [--timeout=TIMEOUT; default="5s"]
+        [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT; default="5s"]
        [--unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2]
        [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION]
        [--port=PORT; default=80 --port-name=PORT_NAME --use-serving-port]
@ -69,6 +69,16 @@ FLAGS
        empty, presence of specified string in first 1024 characters of
        response body determines health. Only ASCII characters allowed.

+     --source-regions=REGION,...,[...]
+        Defines the list of cloud regions from which health checks are
+        performed. This option can be specified only for health checks used
+        with DNS Routing Policies. If specified, --check-interval should be at
+        least 30 seconds. --proxy-header field and --request field (for TCP)
+        are not supported with this option. source-regions is only allowed for
+        global health checks. If this option is specified, then the health
+        check cannot be used with BackendService nor with managed instance
+        group autohealing.
+
     --timeout=TIMEOUT; default="5s"
        If Google Compute Engine doesn't receive a healthy response from the
        instance by the time specified by the value of this flag, the health
--- a/gcloud/alpha/compute/health-checks/create/tcp
+++ b/gcloud/alpha/compute/health-checks/create/tcp
@ -8,7 +8,8 @@ SYNOPSIS
        [--description=DESCRIPTION] [--enable-logging]
        [--healthy-threshold=HEALTHY_THRESHOLD; default=2]
        [--proxy-header=PROXY_HEADER; default="NONE"] [--request=REQUEST]
-        [--response=RESPONSE] [--timeout=TIMEOUT; default="5s"]
+        [--response=RESPONSE] [--source-regions=REGION,...,[...]]
+        [--timeout=TIMEOUT; default="5s"]
        [--unhealthy-threshold=UNHEALTHY_THRESHOLD; default=2]
        [--global | --region=REGION]
        [--port=PORT; default=80 --port-name=PORT_NAME --use-serving-port]
@ -72,6 +73,16 @@ FLAGS
        successful handshake, only configure --response to match an explicit
        --request.

+     --source-regions=REGION,...,[...]
+        Defines the list of cloud regions from which health checks are
+        performed. This option can be specified only for health checks used
+        with DNS Routing Policies. If specified, --check-interval should be at
+        least 30 seconds. --proxy-header field and --request field (for TCP)
+        are not supported with this option. source-regions is only allowed for
+        global health checks. If this option is specified, then the health
+        check cannot be used with BackendService nor with managed instance
+        group autohealing.
+
     --timeout=TIMEOUT; default="5s"
        If Google Compute Engine doesn't receive a healthy response from the
        instance by the time specified by the value of this flag, the health
--- a/gcloud/alpha/compute/health-checks/update/http
+++ b/gcloud/alpha/compute/health-checks/update/http
@ -6,7 +6,8 @@ SYNOPSIS
        [--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION]
        [--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD]
        [--host=HOST] [--proxy-header=PROXY_HEADER]
-        [--request-path=REQUEST_PATH] [--response=RESPONSE] [--timeout=TIMEOUT]
+        [--request-path=REQUEST_PATH] [--response=RESPONSE]
+        [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT]
        [--unhealthy-threshold=UNHEALTHY_THRESHOLD]
        [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION]
        [--port=PORT --port-name=PORT_NAME --use-serving-port]
@ -66,6 +67,16 @@ FLAGS
        empty, presence of specified string in first 1024 characters of
        response body determines health. Only ASCII characters allowed.

+     --source-regions=REGION,...,[...]
+        Defines the list of cloud regions from which health checks are
+        performed. This option can be specified only for health checks used
+        with DNS Routing Policies. If specified, --check-interval should be at
+        least 30 seconds. --proxy-header field and --request field (for TCP)
+        are not supported with this option. source-regions is only allowed for
+        global health checks. If this option is specified, then the health
+        check cannot be used with BackendService nor with managed instance
+        group autohealing.
+
     --timeout=TIMEOUT
        If Google Compute Engine doesn't receive a healthy response from the
        instance by the time specified by the value of this flag, the health
--- a/gcloud/alpha/compute/health-checks/update/https
+++ b/gcloud/alpha/compute/health-checks/update/https
@ -7,7 +7,8 @@ SYNOPSIS
        [--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION]
        [--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD]
        [--host=HOST] [--proxy-header=PROXY_HEADER]
-        [--request-path=REQUEST_PATH] [--response=RESPONSE] [--timeout=TIMEOUT]
+        [--request-path=REQUEST_PATH] [--response=RESPONSE]
+        [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT]
        [--unhealthy-threshold=UNHEALTHY_THRESHOLD]
        [--weight-report-mode=WEIGHT_REPORT_MODE] [--global | --region=REGION]
        [--port=PORT --port-name=PORT_NAME --use-serving-port]
@ -67,6 +68,16 @@ FLAGS
        empty, presence of specified string in first 1024 characters of
        response body determines health. Only ASCII characters allowed.

+     --source-regions=REGION,...,[...]
+        Defines the list of cloud regions from which health checks are
+        performed. This option can be specified only for health checks used
+        with DNS Routing Policies. If specified, --check-interval should be at
+        least 30 seconds. --proxy-header field and --request field (for TCP)
+        are not supported with this option. source-regions is only allowed for
+        global health checks. If this option is specified, then the health
+        check cannot be used with BackendService nor with managed instance
+        group autohealing.
+
     --timeout=TIMEOUT
        If Google Compute Engine doesn't receive a healthy response from the
        instance by the time specified by the value of this flag, the health
--- a/gcloud/alpha/compute/health-checks/update/tcp
+++ b/gcloud/alpha/compute/health-checks/update/tcp
@ -6,7 +6,8 @@ SYNOPSIS
        [--check-interval=CHECK_INTERVAL] [--description=DESCRIPTION]
        [--enable-logging] [--healthy-threshold=HEALTHY_THRESHOLD]
        [--proxy-header=PROXY_HEADER] [--request=REQUEST] [--response=RESPONSE]
-        [--timeout=TIMEOUT] [--unhealthy-threshold=UNHEALTHY_THRESHOLD]
+        [--source-regions=REGION,...,[...]] [--timeout=TIMEOUT]
+        [--unhealthy-threshold=UNHEALTHY_THRESHOLD]
        [--global | --region=REGION]
        [--port=PORT --port-name=PORT_NAME --use-serving-port]
        [GCLOUD_WIDE_FLAG ...]
@ -70,6 +71,16 @@ FLAGS
        --request. Setting this to an empty string will clear any existing
        response value.

+     --source-regions=REGION,...,[...]
+        Defines the list of cloud regions from which health checks are
+        performed. This option can be specified only for health checks used
+        with DNS Routing Policies. If specified, --check-interval should be at
+        least 30 seconds. --proxy-header field and --request field (for TCP)
+        are not supported with this option. source-regions is only allowed for
+        global health checks. If this option is specified, then the health
+        check cannot be used with BackendService nor with managed instance
+        group autohealing.
+
     --timeout=TIMEOUT
        If Google Compute Engine doesn't receive a healthy response from the
        instance by the time specified by the value of this flag, the health
--- a/gcloud/alpha/compute/instance-templates/create
+++ b/gcloud/alpha/compute/instance-templates/create
@ -665,9 +665,9 @@ FLAGS
         queue-count
            Specifies the networking queue count for this interface. Both Rx
            and Tx queues will be set to this number. If it's not specified, a
-            default queue count will be assigned. For Virtio-net, each
-            interface will get min(floor(#vCPU / #vNIC), 32) queues. For gVNIC,
-            each interface will get min(floor(#vCPU / #vNIC / 2), 16) qeueus.
+            default queue count will be assigned. See
+            https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for
+            more details.

         stack-type
            Specifies whether IPv6 is enabled on the interface. STACK_TYPE must
--- a/gcloud/alpha/compute/instances/create
+++ b/gcloud/alpha/compute/instances/create
@ -416,7 +416,8 @@ FLAGS

         confidential-compute
            If yes, the disk is created in confidential mode. The default value
-            is no.
+            is no. Encryption with a Cloud KMS key is required to enable this
+            option.

         replica-zones
            Required for each regional disk associated with the instance.
@ -1278,10 +1279,9 @@ FLAGS
           queue-count
              Specifies the networking queue count for this interface. Both Rx
              and Tx queues will be set to this number. If it's not specified,
-              a default queue count will be assigned. For Virtio-net, each
-              interface will get min(floor(#vCPU / #vNIC), 32) queues. For
-              gVNIC, each interface will get min(floor(#vCPU / #vNIC / 2), 16)
-              qeueus.
+              a default queue count will be assigned. See
+              https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for
+              more details.

           stack-type
              Specifies whether IPv6 is enabled on the interface. STACK_TYPE
--- a/gcloud/alpha/compute/instances/perform-maintenance
+++ b/gcloud/alpha/compute/instances/perform-maintenance
@ -59,5 +59,9 @@ 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.
+    access allowlist. These variants are also available:
+
+        $ gcloud compute instances perform-maintenance
+
+        $ gcloud beta compute instances perform-maintenance