gcloud: Wed Feb 5 10:43:28 UTC 2025

gcloud/beta/compute/future-reservations/create

@@ -4,7 +4,7 @@ NAME
 
 SYNOPSIS
     gcloud beta compute future-reservations create FUTURE_RESERVATION
-        --[no-]auto-delete-auto-created-reservations --total-count=TOTAL_COUNT
+        --[no-]auto-delete-auto-created-reservations
         (--source-instance-template=SOURCE_INSTANCE_TEMPLATE
           | [--machine-type=MACHINE_TYPE
           : --accelerator=[count=COUNT],[type=TYPE]
@@ -15,8 +15,11 @@ SYNOPSIS
         [--name-prefix=NAME_PREFIX] [--planning-status=PLANNING_STATUS]
         [--[no-]require-specific-reservation]
         [--reservation-name=RESERVATION_NAME]
-        [--scheduling-type=SCHEDULING_TYPE] [--zone=ZONE]
+        [--scheduling-type=SCHEDULING_TYPE] [--total-count=TOTAL_COUNT]
+        [--zone=ZONE]
         [--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME | --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION]
+        [--commitment-name=COMMITMENT_NAME --commitment-plan=COMMITMENT_PLAN
+          --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS]
         [--share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]]
         [GCLOUD_WIDE_FLAG ...]
 
@@ -56,13 +59,10 @@ REQUIRED FLAGS
         Use --auto-delete-auto-created-reservations to enable and
         --no-auto-delete-auto-created-reservations to disable.
 
-     --total-count=TOTAL_COUNT
-        The total number of instances for which capacity assurance is requested
-        at a future time period.
-
-     Manage the instance properties for the auto-created reservations. You must
-     either provide a source instance template or define the instance
-     properties.
+     To create a future reservation request, specify the properties of the
+     resources that you want to reserve and when you want to start using them.
+     After the request is approved, Compute Engine automatically creates
+     reservations for your requested resources at your specified start time.
 
      Exactly one of these must be specified:
 
@@ -197,6 +197,10 @@ OPTIONAL FLAGS
             In INDEPENDENT mode, maintenance is not synchronized for this
             reservation, and each instance has its own maintenance window.
 
+     --total-count=TOTAL_COUNT
+        The total number of instances for which capacity assurance is requested
+        at a future time period.
+
      --zone=ZONE
         Zone of the future reservation to create. If not specified and the
         compute/zone property isn't set, you might be prompted to select a zone
@@ -236,6 +240,28 @@ OPTIONAL FLAGS
           for 30 minutes, or 1d2h3m4s for 1 day, 2 hours, 3 minutes, and 4
           seconds. For more information, see $ gcloud topic datetimes.
 
+     Manage the commitment info properties
+
+       --commitment-name=COMMITMENT_NAME
+          Name of commitment covering the delivered reservation at the time of
+          delivery of future reservations. If not specified, it takes the name
+          of the future reservation.
+
+       --commitment-plan=COMMITMENT_PLAN
+          The plan for this commitment to be created, which determines duration
+          and discount rate. The currently supported plans are TWELVE_MONTH (1
+          year), and THIRTY_SIX_MONTH (3 years). COMMITMENT_PLAN must be one
+          of: TWELVE_MONTH, THIRTY_SIX_MONTH.
+
+       --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS
+          Applicable only if future reservation will deliver to an existing
+          reservation with a ramp plan. When set to EXTEND, all associated
+          parent Committed Used Discount's end-date/term will be extended to
+          the end-time of this future reservation. Default is to extend
+          previous commitment's time to the end_time of the reservation.
+          PREVIOUS_COMMITMENT_TERMS must be (only one value is supported):
+          EXTEND.
+
      Manage the properties of a shared reservation.
 
        --share-setting=SHARE_SETTING