HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: //snap/google-cloud-cli/394/lib/surface/compute/backend_buckets/create.py
# -*- coding: utf-8 -*- #
# Copyright 2015 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 backend buckets."""

from googlecloudsdk.api_lib.compute import base_classes
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.compute import cdn_flags_utils as cdn_flags
from googlecloudsdk.command_lib.compute import exceptions as compute_exceptions
from googlecloudsdk.command_lib.compute import flags as compute_flags
from googlecloudsdk.command_lib.compute import resource_manager_tags_utils
from googlecloudsdk.command_lib.compute import scope as compute_scope
from googlecloudsdk.command_lib.compute import signed_url_flags
from googlecloudsdk.command_lib.compute.backend_buckets import backend_buckets_utils
from googlecloudsdk.command_lib.compute.backend_buckets import flags as backend_buckets_flags


@base.ReleaseTracks(base.ReleaseTrack.GA)
@base.DefaultUniverseOnly
class Create(base.CreateCommand):
  """Create a backend bucket.

  *{command}* is used to create backend buckets. Backend buckets
  define Google Cloud Storage buckets that can serve content. URL
  maps define which requests are sent to which backend buckets.
  """

  BACKEND_BUCKET_ARG = None
  _support_regional_statera_load_balancers = False

  @classmethod
  def Args(cls, parser):
    """Set up arguments for this command."""
    parser.display_info.AddFormat(backend_buckets_flags.DEFAULT_LIST_FORMAT)
    backend_buckets_flags.AddUpdatableArgs(
        cls, parser, 'create', cls._support_regional_statera_load_balancers
    )
    backend_buckets_flags.REQUIRED_GCS_BUCKET_ARG.AddArgument(parser)
    parser.display_info.AddCacheUpdater(
        backend_buckets_flags.BackendBucketsCompleter)
    signed_url_flags.AddSignedUrlCacheMaxAge(parser, required=False)

    cdn_flags.AddCdnPolicyArgs(parser, 'backend bucket')

    backend_buckets_flags.AddCacheKeyExtendedCachingArgs(parser)
    backend_buckets_flags.AddCompressionMode(parser)
    backend_buckets_flags.AddLoadBalancingScheme(
        parser, cls._support_regional_statera_load_balancers
    )
    backend_buckets_flags.AddResourceManagerTags(parser)

  def CreateBackendBucket(self, args):
    """Creates and returns the backend bucket."""
    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
    client = holder.client

    backend_buckets_ref = self.BACKEND_BUCKET_ARG.ResolveAsResource(
        args, holder.resources, default_scope=compute_scope.ScopeEnum.GLOBAL)

    enable_cdn = args.enable_cdn or False

    backend_bucket = client.messages.BackendBucket(
        description=args.description,
        name=backend_buckets_ref.Name(),
        bucketName=args.gcs_bucket_name,
        enableCdn=enable_cdn,
    )

    backend_buckets_utils.ApplyCdnPolicyArgs(client, args, backend_bucket)

    if args.custom_response_header is not None:
      backend_bucket.customResponseHeaders = args.custom_response_header
    if (
        backend_bucket.cdnPolicy is not None
        and backend_bucket.cdnPolicy.cacheMode
        and args.enable_cdn is not False  # pylint: disable=g-bool-id-comparison
    ):
      backend_bucket.enableCdn = True

    if args.compression_mode is not None:
      backend_bucket.compressionMode = (
          client.messages.BackendBucket.CompressionModeValueValuesEnum(
              args.compression_mode
          )
      )

    if args.load_balancing_scheme is not None:
      backend_bucket.loadBalancingScheme = (
          client.messages.BackendBucket.LoadBalancingSchemeValueValuesEnum(
              args.load_balancing_scheme
          )
      )

    return backend_bucket

  def Run(self, args):
    """Issues the request necessary for creating a backend bucket."""
    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
    client = holder.client

    backend_bucket = self.CreateBackendBucket(args)

    if self._support_regional_statera_load_balancers:
      ref = backend_buckets_flags.GLOBAL_REGIONAL_BACKEND_BUCKET_ARG.ResolveAsResource(
          args,
          holder.resources,
          scope_lister=compute_flags.GetDefaultScopeLister(client),
          default_scope=compute_scope.ScopeEnum.GLOBAL
      )
      if ref.Collection() == 'compute.backendBuckets':
        requests = self._CreateGlobalRequests(backend_bucket, ref)
      elif ref.Collection() == 'compute.regionBackendBuckets':
        requests = self._CreateRegionalRequests(args, backend_bucket, ref)

      self._ApplyResourceManagerTags(args, backend_bucket, ref, client)

      return client.MakeRequests(requests)

    if args.resource_manager_tags is not None:
      backend_bucket.params = self._CreateBackendBucketParams(
          client.messages, args.resource_manager_tags
      )

    backend_buckets_ref = self.BACKEND_BUCKET_ARG.ResolveAsResource(
        args, holder.resources)
    return client.MakeRequests(
        self._CreateGlobalRequests(backend_bucket, backend_buckets_ref)
    )

  def _ApplyResourceManagerTags(self, args, backend_bucket, ref, client):
    if args.resource_manager_tags is None:
      return
    if ref.Collection() == 'compute.backendBuckets':
      backend_bucket.params = self._CreateBackendBucketParams(
          client.messages, args.resource_manager_tags
      )
    elif ref.Collection() == 'compute.regionBackendBuckets':
      raise compute_exceptions.ArgumentError(
          '--resource-manager-tags',
          'Resource Manager tags are not supported for regional backend'
          ' buckets.',
      )

  def _CreateBackendBucketParams(self, messages, resource_manager_tags):
    resource_manager_tags_map = (
        resource_manager_tags_utils.GetResourceManagerTags(
            resource_manager_tags
        )
    )
    params = messages.BackendBucketParams
    additional_properties = [
        params.ResourceManagerTagsValue.AdditionalProperty(key=key, value=value)
        for key, value in sorted(resource_manager_tags_map.items())
    ]
    return params(
        resourceManagerTags=params.ResourceManagerTagsValue(
            additionalProperties=additional_properties
        )
    )

  def _CreateGlobalRequests(self, backend_bucket, backend_buckets_ref):
    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
    client = holder.client
    request = client.messages.ComputeBackendBucketsInsertRequest(
        backendBucket=backend_bucket, project=backend_buckets_ref.project
    )
    return [(client.apitools_client.backendBuckets, 'Insert', request)]

  def _CreateRegionalRequests(self, args, backend_bucket, backend_buckets_ref):
    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
    client = holder.client
    request = client.messages.ComputeRegionBackendBucketsInsertRequest(
        backendBucket=backend_bucket,
        project=backend_buckets_ref.project,
        region=args.region,
    )
    return [(client.apitools_client.regionBackendBuckets, 'Insert', request)]


@base.ReleaseTracks(base.ReleaseTrack.BETA)
@base.DefaultUniverseOnly
class CreateBeta(Create):
  """Create a backend bucket.

  *{command}* is used to create backend buckets. Backend buckets
  define Google Cloud Storage buckets that can serve content. URL
  maps define which requests are sent to which backend buckets.
  """

  _support_regional_statera_load_balancers = False


@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
@base.DefaultUniverseOnly
class CreateAlpha(CreateBeta):
  """Create a backend bucket.

  *{command}* is used to create backend buckets. Backend buckets
  define Google Cloud Storage buckets that can serve content. URL
  maps define which requests are sent to which backend buckets.
  """
  _support_regional_statera_load_balancers = True