feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/commitments/__init__.py

@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Commands for managing Compute Engine commitments."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA)
+class Commitments(base.Group):
+  """Manage Compute Engine commitments."""
+
+
+Commitments.category = base.INSTANCES_CATEGORY
+
+Commitments.detailed_help = {
+    'DESCRIPTION': """
+        Manage Compute Engine commitments.
+
+        For more information about commitments, see the
+        [commitments documentation](https://cloud.google.com/compute/docs/instances/signing-up-committed-use-discounts).
+
+        See also: [Commitments API](https://cloud.google.com/compute/docs/reference/rest/v1/regionCommitments).
+    """,
+}
+

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/commitments/create.py

@@ -0,0 +1,273 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command for creating Compute Engine commitments."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import re
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.api_lib.compute import request_helper
+from googlecloudsdk.api_lib.compute import utils
+from googlecloudsdk.api_lib.util import apis
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute.commitments import flags
+from googlecloudsdk.command_lib.compute.commitments import reservation_helper
+from googlecloudsdk.core import properties
+
+
+_MISSING_COMMITMENTS_QUOTA_REGEX = r'Quota .COMMITMENTS. exceeded.+'
+
+
+def _CommonArgs(track, parser):
+  """Add common flags."""
+  flags.MakeCommitmentArg(False).AddArgument(parser, operation_type='create')
+  flags.AddAutoRenew(parser)
+  messages = apis.GetMessagesModule('compute', track)
+  flags.GetTypeMapperFlag(messages).choice_arg.AddToParser(parser)
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Create(base.Command):
+  """Create Compute Engine commitments."""
+
+  _support_share_setting = True
+  _support_stable_fleet = False
+  _support_existing_reservation = True
+  _support_reservation_sharing_policy = False
+  _support_60_month_plan = False
+  _support_24_month_plan = False
+
+  detailed_help = {'EXAMPLES': """
+        To create a commitment called ``commitment-1'' in the ``us-central1''
+        region, with a ``12-month'' plan, ``9GB'' of memory and 4 vcpu cores,
+        run:
+
+          $ {command} commitment-1 --plan=12-month --resources=memory=9GB,vcpu=4 --region=us-central1
+      """}
+
+  @classmethod
+  def Args(cls, parser):
+    _CommonArgs('v1', parser)
+    flags.AddCreateFlags(
+        parser,
+        support_share_setting=cls._support_share_setting,
+        support_stable_fleet=cls._support_stable_fleet,
+        support_existing_reservation=cls._support_existing_reservation,
+        support_reservation_sharing_policy=cls._support_reservation_sharing_policy,
+        support_60_month_plan=cls._support_60_month_plan,
+        support_24_month_plan=cls._support_24_month_plan,
+    )
+
+  def _MakeCreateRequest(
+      self,
+      args,
+      messages,
+      project,
+      region,
+      commitment_ref,
+      existing_reservations,
+      holder,
+  ):
+
+    if (
+        args.split_source_commitment is not None
+        and args.merge_source_commitments is not None
+    ):
+      raise exceptions.ConflictingArgumentsException(
+          "It's not possible to merge and split in one request"
+      )
+
+    commitment_type_flag = flags.GetTypeMapperFlag(messages)
+    commitment_type = commitment_type_flag.GetEnumForChoice(args.type)
+    commitment = messages.Commitment(
+        reservations=reservation_helper.MakeReservations(
+            args, messages, holder
+        ),
+        name=commitment_ref.Name(),
+        plan=flags.TranslatePlanArg(messages, args.plan),
+        resources=flags.TranslateResourcesArgGroup(messages, args),
+        type=commitment_type,
+        autoRenew=flags.TranslateAutoRenewArgForCreate(args),
+        splitSourceCommitment=args.split_source_commitment,
+        mergeSourceCommitments=flags.TranslateMergeArg(
+            args.merge_source_commitments,
+        ),
+        existingReservations=existing_reservations,
+    )
+    commitment.customEndTimestamp = flags.TranslateCustomEndTimeArg(args)
+    return messages.ComputeRegionCommitmentsInsertRequest(
+        commitment=commitment,
+        project=project,
+        region=commitment_ref.region,
+    )
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    resources = holder.resources
+    commitment_ref = flags.MakeCommitmentArg(False).ResolveAsResource(
+        args,
+        resources,
+        scope_lister=compute_flags.GetDefaultScopeLister(holder.client),
+    )
+    existing_reservations = flags.ResolveExistingReservationArgs(
+        args, resources
+    )
+    messages = holder.client.messages
+    region = properties.VALUES.compute.region.Get()
+    project = properties.VALUES.core.project.Get()
+    create_request = self._MakeCreateRequest(
+        args,
+        messages,
+        project,
+        region,
+        commitment_ref,
+        existing_reservations,
+        holder,
+    )
+
+    service = holder.client.apitools_client.regionCommitments
+    batch_url = holder.client.batch_url
+    http = holder.client.apitools_client.http
+    errors = []
+    result = list(
+        request_helper.MakeRequests(
+            requests=[(service, 'Insert', create_request)],
+            http=http,
+            batch_url=batch_url,
+            errors=errors,
+        )
+    )
+    for i, error in enumerate(errors):
+      if hasattr(error[1], 'message') and isinstance(error[1].message, str):
+        err_msg = error[1].message
+      else:
+        err_msg = error[1]
+
+      if re.match(_MISSING_COMMITMENTS_QUOTA_REGEX, err_msg):
+        errors[i] = (
+            error[0],
+            err_msg
+            + (
+                ' You can request commitments quota on '
+                'https://cloud.google.com/compute/docs/instances/'
+                'signing-up-committed-use-discounts#quota'
+            ),
+        )
+
+    if errors:
+      utils.RaiseToolException(errors)
+    return result
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class CreateBeta(Create):
+  """Create Compute Engine commitments."""
+
+  _support_share_setting = True
+  _support_stable_fleet = True
+  _support_existing_reservation = True
+  _support_reservation_sharing_policy = True
+  _support_60_month_plan = False
+  _support_24_month_plan = False
+
+  @classmethod
+  def Args(cls, parser):
+    _CommonArgs('beta', parser)
+    flags.AddCreateFlags(
+        parser,
+        support_share_setting=cls._support_share_setting,
+        support_stable_fleet=cls._support_stable_fleet,
+        support_existing_reservation=cls._support_existing_reservation,
+        support_reservation_sharing_policy=cls._support_reservation_sharing_policy,
+        support_60_month_plan=cls._support_60_month_plan,
+        support_24_month_plan=cls._support_24_month_plan,
+    )
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class CreateAlpha(CreateBeta):
+  """Create Compute Engine commitments."""
+
+  _support_share_setting = True
+  _support_stable_fleet = True
+  _support_existing_reservation = True
+  _support_reservation_sharing_policy = True
+  _support_60_month_plan = True
+  _support_24_month_plan = True
+
+  @classmethod
+  def Args(cls, parser):
+    _CommonArgs('alpha', parser)
+    flags.AddCreateFlags(
+        parser,
+        support_share_setting=cls._support_share_setting,
+        support_stable_fleet=cls._support_stable_fleet,
+        support_existing_reservation=cls._support_existing_reservation,
+        support_reservation_sharing_policy=cls._support_reservation_sharing_policy,
+        support_60_month_plan=cls._support_60_month_plan,
+        support_24_month_plan=cls._support_24_month_plan,
+    )
+
+  def _MakeCreateRequest(
+      self,
+      args,
+      messages,
+      project,
+      region,
+      commitment_ref,
+      existing_reservations,
+      holder,
+  ):
+
+    if (
+        args.split_source_commitment is not None
+        and args.merge_source_commitments is not None
+    ):
+      raise exceptions.ConflictingArgumentsException(
+          "It's not possible to merge and split in one request"
+      )
+
+    commitment_type_flag = flags.GetTypeMapperFlag(messages)
+    commitment_type = commitment_type_flag.GetEnumForChoice(args.type)
+    commitment = messages.Commitment(
+        reservations=reservation_helper.MakeReservations(
+            args, messages, holder
+        ),
+        name=commitment_ref.Name(),
+        plan=flags.TranslatePlanArg(messages, args.plan),
+        resources=flags.TranslateResourcesArgGroup(messages, args),
+        type=commitment_type,
+        autoRenew=flags.TranslateAutoRenewArgForCreate(args),
+        splitSourceCommitment=args.split_source_commitment,
+        mergeSourceCommitments=flags.TranslateMergeArg(
+            args.merge_source_commitments
+        ),
+        existingReservations=existing_reservations,
+    )
+
+    commitment.customEndTimestamp = flags.TranslateCustomEndTimeArg(args)
+    return messages.ComputeRegionCommitmentsInsertRequest(
+        commitment=commitment,
+        project=project,
+        region=commitment_ref.region,
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/commitments/create_license.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command for creating Compute Engine license-based commitments."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute.commitments import flags
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA)
+class Create(base.Command):
+  """Create Compute Engine license-based commitments."""
+  detailed_help = {
+      'EXAMPLES': '''
+        To create a commitment called ``commitment-1'' in the ``us-central1''
+        region with 36-month plan, sles-sap-12 license, 1-2 cores, run:
+
+          $ {command} commitment-1 --plan=36-month --license=https://www.googleapis.com/compute/v1/projects/suse-sap-cloud/global/licenses/sles-sap-12 --region=us-central1 --amount=1 --cores-per-license=1-2
+      '''
+  }
+
+  @classmethod
+  def Args(cls, parser):
+    flags.MakeCommitmentArg(False).AddArgument(parser, operation_type='create')
+    flags.AddLicenceBasedFlags(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    resources = holder.resources
+    client = holder.client
+    commitment_ref = flags.MakeCommitmentArg(False).ResolveAsResource(
+        args,
+        resources,
+        scope_lister=compute_flags.GetDefaultScopeLister(holder.client))
+
+    messages = holder.client.messages
+
+    commitment = messages.Commitment(
+        name=commitment_ref.Name(),
+        plan=flags.TranslatePlanArg(messages, args.plan),
+        category=messages.Commitment.CategoryValueValuesEnum.LICENSE,
+        licenseResource=messages.LicenseResourceCommitment(
+            amount=args.amount,
+            coresPerLicense=args.cores_per_license,
+            license=args.license
+        ))
+    request = (messages.ComputeRegionCommitmentsInsertRequest(
+        commitment=commitment,
+        project=commitment_ref.project,
+        region=commitment_ref.region))
+    return client.MakeRequests([(client.apitools_client.regionCommitments,
+                                 'Insert', request)])
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class CreateAlpha(Create):
+  """Create Compute Engine license-based commitments."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/commitments/describe.py

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Describing Compute Engine commitments."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute.commitments import flags
+
+
+class Describe(base.DescribeCommand):
+  """Describe a Compute Engine commitment."""
+  detailed_help = {
+      'EXAMPLES': '''
+        To describe the commitment called ``commitment-1'' in the ``us-central1''
+        region, run:
+
+          $ {command} commitment-1 --region=us-central1
+      '''
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.MakeCommitmentArg(False).AddArgument(
+        parser, operation_type='describe')
+
+  def Collection(self):
+    return 'compute.commitments'
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    resources = holder.resources
+    commitment_ref = flags.MakeCommitmentArg(False).ResolveAsResource(
+        args,
+        resources,
+        scope_lister=compute_flags.GetDefaultScopeLister(holder.client))
+
+    service = holder.client.apitools_client.regionCommitments
+    messages = holder.client.messages
+    request = messages.ComputeRegionCommitmentsGetRequest(
+        commitment=commitment_ref.Name(),
+        project=commitment_ref.project,
+        region=commitment_ref.region,
+    )
+    return service.Get(request)

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/commitments/list.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Listing Compute Engine commitments."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.api_lib.compute import lister
+from googlecloudsdk.api_lib.compute import utils
+from googlecloudsdk.calliope import base
+
+
+class List(base.ListCommand):
+  """List Compute Engine commitments."""
+
+  detailed_help = {
+      'EXAMPLES': '''
+        To list commitments, run:
+
+          $ {command}
+      '''
+  }
+
+  @staticmethod
+  def Args(parser):
+    parser.display_info.AddFormat("""\
+        table(name,
+              region.basename(),
+              endTimestamp,
+              status)
+        """)
+    parser.display_info.AddUriFunc(utils.MakeGetUriFunc())
+    lister.AddRegionsArg(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+
+    request_data = lister.ParseRegionalFlags(args, holder.resources)
+
+    list_implementation = lister.RegionalLister(
+        client, client.apitools_client.regionCommitments)
+
+    return lister.Invoke(request_data, list_implementation)

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/commitments/update.py

@@ -0,0 +1,166 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command for creating Compute Engine commitments."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import re
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.api_lib.compute import request_helper
+from googlecloudsdk.api_lib.compute import utils
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute.commitments import flags
+
+_MISSING_COMMITMENTS_QUOTA_REGEX = r'Quota .COMMITMENTS. exceeded.+'
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Update(base.UpdateCommand):
+  """Update Compute Engine commitments."""
+
+  detailed_help = {'EXAMPLES': """
+        To enable auto renewal on a commitment called ``commitment-1'' in the ``us-central1''
+        region, run:
+
+          $ {command} commitment-1 --auto-renew --region=us-central1
+
+        To disable auto renewal on a commitment called ``commitment-1''
+        in the ``us-central1'' region, run:
+
+          $ {command} commitment-1 --no-auto-renew --region=us-central1
+
+        To upgrade the term of a commitment called ``commitment-1''
+        from  12-month to 36-month, in the ``us-central1'' region, run:
+
+          $ {command} commitment-1 --plan=36-month --region=us-central1
+      """}
+
+  _support_60_month_plan = False
+  _support_24_month_plan = False
+
+  @classmethod
+  def Args(cls, parser):
+    flags.MakeCommitmentArg(plural=False).AddArgument(
+        parser, operation_type='update'
+    )
+    flags.AddUpdateFlags(
+        parser, support_60_month_plan=cls._support_60_month_plan,
+        support_24_month_plan=cls._support_24_month_plan,
+    )
+    flags.AddCustomEndTime(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    resources = holder.resources
+    commitment_ref = self._CreateReference(client, resources, args)
+
+    messages = holder.client.messages
+    service = holder.client.apitools_client.regionCommitments
+
+    commitment_resource = messages.Commitment(name=commitment_ref.Name())
+
+    commitment_resource.autoRenew = flags.TranslateAutoRenewArgForUpdate(args)
+    commitment_resource.plan = self._TranslatePlanArgForUpdate(
+        messages=messages, plan=args.plan
+    )
+
+    commitment_resource.customEndTimestamp = flags.TranslateCustomEndTimeArg(
+        args
+    )
+    commitment_update_request = self._GetUpdateRequest(
+        messages, commitment_ref, commitment_resource
+    )
+
+    batch_url = holder.client.batch_url
+    http = holder.client.apitools_client.http
+    errors = []
+    result = list(
+        request_helper.MakeRequests(
+            requests=[(service, 'Update', commitment_update_request)],
+            http=http,
+            batch_url=batch_url,
+            errors=errors,
+        )
+    )
+    for i, error in enumerate(errors):
+      if re.match(_MISSING_COMMITMENTS_QUOTA_REGEX, error[1]):
+        errors[i] = (
+            error[0],
+            error[1]
+            + (
+                ' You can request commitments quota on '
+                'https://cloud.google.com/compute/docs/instances/'
+                'signing-up-committed-use-discounts#quota'
+            ),
+        )
+    if errors:
+      utils.RaiseToolException(errors)
+    return result
+
+  def _CreateReference(self, client, resources, args):
+    return flags.MakeCommitmentArg(False).ResolveAsResource(
+        args,
+        resources,
+        scope_lister=compute_flags.GetDefaultScopeLister(client),
+    )
+
+  def _GetUpdateRequest(self, messages, commitment_ref, commitment_resource):
+    return messages.ComputeRegionCommitmentsUpdateRequest(
+        commitment=commitment_ref.Name(),
+        commitmentResource=commitment_resource,
+        paths=self._GetPaths(commitment_resource),
+        project=commitment_ref.project,
+        region=commitment_ref.region,
+    )
+
+  def _GetPaths(self, commitment_resource):
+    paths = []
+    if commitment_resource.autoRenew is not None:
+      paths.append('autoRenew')
+    if commitment_resource.plan is not None:
+      paths.append('plan')
+    if commitment_resource.customEndTimestamp is not None:
+      paths.append('customEndTimestamp')
+    return paths
+
+  def _TranslatePlanArgForUpdate(self, messages=None, plan=None):
+    if plan is None:
+      return None
+    else:
+      return flags.TranslatePlanArg(messages, plan)
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class UpdateBeta(Update):
+  """Update Compute Engine commitments."""
+
+  _support_60_month_plan = False
+  _support_24_month_plan = False
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class UpdateAlpha(UpdateBeta):
+  """Update Compute Engine commitments."""
+
+  _support_60_month_plan = True
+  _support_24_month_plan = True

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/commitments/update_reservations.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 Google LLC. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Command for updating the reservations in Compute Engine commitments."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute import flags as compute_flags
+from googlecloudsdk.command_lib.compute.commitments import flags
+from googlecloudsdk.command_lib.compute.commitments import reservation_helper
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class UpdateReservationsAlpha(base.UpdateCommand):
+  """Update the resource shape of reservations within the commitment."""
+  detailed_help = {
+      'EXAMPLES': '''
+        To update reservations of the commitment called ``commitment-1'' in
+        the ``us-central1'' region with values from ``reservations.yaml'', run:
+
+          $ {command} 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)
+      '''
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.MakeCommitmentArg(False).AddArgument(
+        parser, operation_type='update reservation')
+    flags.AddUpdateReservationGroup(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    resources = holder.resources
+    commitment_ref = flags.MakeCommitmentArg(False).ResolveAsResource(
+        args,
+        resources,
+        scope_lister=compute_flags.GetDefaultScopeLister(client))
+    service = client.apitools_client.regionCommitments
+    messages = client.messages
+    update_reservation_request = messages.RegionCommitmentsUpdateReservationsRequest(
+        reservations=reservation_helper.MakeUpdateReservations(
+            args, messages, resources))
+    request = messages.ComputeRegionCommitmentsUpdateReservationsRequest(
+        commitment=commitment_ref.Name(),
+        project=commitment_ref.project,
+        region=commitment_ref.region,
+        regionCommitmentsUpdateReservationsRequest=update_reservation_request)
+    return client.MakeRequests([(service, 'UpdateReservations', request)])