gcloud-help/gcloud/alpha/compute/commitments/update-reservations

NAME
    gcloud alpha compute commitments update-reservations - update the resource
        shape of reservations within the commitment

SYNOPSIS
    gcloud alpha compute commitments update-reservations COMMITMENT
        [--region=REGION]
        [--reservations-from-file=RESERVATIONS_FROM_FILE
          | [--dest-reservation=[machine-type=MACHINE-TYPE],
          [min-cpu-platform=MIN-CPU-PLATFORM],
          [require-specific-reservation=REQUIRE-SPECIFIC-RESERVATION],
          [reservation=RESERVATION],
          [reservation-zone=RESERVATION-ZONE],[vm-count=VM-COUNT]
          --source-reservation=[machine-type=MACHINE-TYPE],
          [min-cpu-platform=MIN-CPU-PLATFORM],
          [require-specific-reservation=REQUIRE-SPECIFIC-RESERVATION],
          [reservation=RESERVATION],
          [reservation-zone=RESERVATION-ZONE],[vm-count=VM-COUNT]
          : --dest-accelerator=[count=COUNT],[type=TYPE]
          --dest-local-ssd=[interface=INTERFACE],[size=SIZE]
          --dest-share-setting=DEST_SHARE_SETTING
          --dest-share-with=SHARE_WITH,[SHARE_WITH,...]
          --source-accelerator=[count=COUNT],[type=TYPE]
          --source-local-ssd=[interface=INTERFACE],[size=SIZE]
          --source-share-setting=SOURCE_SHARE_SETTING
          --source-share-with=SHARE_WITH,[SHARE_WITH,...]]]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Update the resource shape of reservations within the commitment.

EXAMPLES
    To update reservations of the commitment called commitment-1 in the
    us-central1 region with values from reservations.yaml, run:

        $ gcloud alpha compute commitments update-reservations \
            commitment-1 --reservations-from-file=reservations.yaml

    For detailed examples, please refer to
    https://cloud.google.com/compute/docs/instances/reserving-zonal-resources#modifying_reservations_that_are_attached_to_commitments

POSITIONAL ARGUMENTS
     COMMITMENT
        Name of the commitment to update reservation.

FLAGS
     --region=REGION
        Region of the commitment to update reservation. If not specified, you
        might be prompted to select a region (interactive mode only).

        To avoid prompting when this flag is omitted, you can set the
        compute/region property:

            $ gcloud config set compute/region REGION

        A list of regions can be fetched by running:

            $ gcloud compute regions list

        To unset the property, run:

            $ gcloud config unset compute/region

        Alternatively, the region can be stored in the environment variable
        CLOUDSDK_COMPUTE_REGION.

     Manage reservations that are attached to the commitment.

     At most one of these can be specified:

       --reservations-from-file=RESERVATIONS_FROM_FILE
          Path to a YAML file of two reservations' configuration.

       Specify source and destination reservations configuration.

         --dest-reservation=[machine-type=MACHINE-TYPE],[min-cpu-platform=MIN-CPU-PLATFORM],[require-specific-reservation=REQUIRE-SPECIFIC-RESERVATION],[reservation=RESERVATION],[reservation-zone=RESERVATION-ZONE],[vm-count=VM-COUNT]
            destination reservation configuration.
             reservation
                Name of the destination reservation to operate on.
             reservation-zone
                Zone of the destination reservation to operate on.
             vm-count
                The number of VM instances that are allocated to this
                reservation. The value of this field must be an int in the
                range [1, 1000].
             machine-type
                The type of machine (name only) which has a fixed number of
                vCPUs and a fixed amount of memory. This also includes
                specifying custom machine type following
                custom-number_of_CPUs-amount_of_memory pattern, e.g.
                custom-32-29440.
             min-cpu-platform
                Optional minimum CPU platform of the reservation to create.
             require-specific-reservation
                Indicates whether the reservation can be consumed by VMs with
                "any reservation" defined. If enabled, then only VMs that
                target this reservation by name using
                --reservation-affinity=specific can consume from this
                reservation.

                This flag argument must be specified if any of the other
                arguments in this group are specified.

         --source-reservation=[machine-type=MACHINE-TYPE],[min-cpu-platform=MIN-CPU-PLATFORM],[require-specific-reservation=REQUIRE-SPECIFIC-RESERVATION],[reservation=RESERVATION],[reservation-zone=RESERVATION-ZONE],[vm-count=VM-COUNT]
            source reservation configuration.
             reservation
                Name of the source reservation to operate on.
             reservation-zone
                Zone of the source reservation to operate on.
             vm-count
                The number of VM instances that are allocated to this
                reservation. The value of this field must be an int in the
                range [1, 1000].
             machine-type
                The type of machine (name only) which has a fixed number of
                vCPUs and a fixed amount of memory. This also includes
                specifying custom machine type following
                custom-number_of_CPUs-amount_of_memory pattern, e.g.
                custom-32-29440.
             min-cpu-platform
                Optional minimum CPU platform of the reservation to create.
             require-specific-reservation
                Indicates whether the reservation can be consumed by VMs with
                "any reservation" defined. If enabled, then only VMs that
                target this reservation by name using
                --reservation-affinity=specific can consume from this
                reservation.

                This flag argument must be specified if any of the other
                arguments in this group are specified.

         --dest-accelerator=[count=COUNT],[type=TYPE]
            Manage the configuration of the type and number of accelerator
            cards attached.
             count
                The number of accelerators to attach to each instance in the
                reservation.
             type
                The specific type (e.g. nvidia-tesla-k80 for nVidia Tesla K80)
                of accelerator to attach to instances in the reservation. Use
                gcloud compute accelerator-types list to learn about all
                available accelerator types.

         --dest-local-ssd=[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.
             interface
                The kind of disk interface exposed to the VM for this SSD.
                Valid values are scsi and nvme. SCSI is the default and is
                supported by more guest operating systems. NVME may provide
                higher performance.
             size
                The size of the local SSD in base-2 GB.

         --dest-share-setting=DEST_SHARE_SETTING
            Specify if this reservation is shared, and if so, the type of
            sharing. If you omit this flag, this value is local (not shared) by
            default. DEST_SHARE_SETTING must be one of: local, projects,
            folders.

         --dest-share-with=SHARE_WITH,[SHARE_WITH,...]
            If this reservation is shared (--share-setting is not local),
            provide a list of all of the specific projects or folders that this
            reservation is shared with. List must contain project IDs or
            project numbers or folder IDs.

         --source-accelerator=[count=COUNT],[type=TYPE]
            Manage the configuration of the type and number of accelerator
            cards attached.
             count
                The number of accelerators to attach to each instance in the
                reservation.
             type
                The specific type (e.g. nvidia-tesla-k80 for nVidia Tesla K80)
                of accelerator to attach to instances in the reservation. Use
                gcloud compute accelerator-types list to learn about all
                available accelerator types.

         --source-local-ssd=[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.
             interface
                The kind of disk interface exposed to the VM for this SSD.
                Valid values are scsi and nvme. SCSI is the default and is
                supported by more guest operating systems. NVME may provide
                higher performance.
             size
                The size of the local SSD in base-2 GB.

         --source-share-setting=SOURCE_SHARE_SETTING
            Specify if this reservation is shared, and if so, the type of
            sharing. If you omit this flag, this value is local (not shared) by
            default. SOURCE_SHARE_SETTING must be one of: local, projects,
            folders.

         --source-share-with=SHARE_WITH,[SHARE_WITH,...]
            If this reservation is shared (--share-setting is not local),
            provide a list of all of the specific projects or folders that this
            reservation is shared with. List must contain project IDs or
            project numbers or folder IDs.

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. This variant is also available:

        $ gcloud beta compute commitments update-reservations