File: //snap/google-cloud-cli/current/lib/surface/compute/interconnects/create.py
# -*- coding: utf-8 -*- #
# Copyright 2025 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 interconnects."""
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.interconnects import client
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.compute.interconnects import flags
from googlecloudsdk.command_lib.compute.interconnects.locations import flags as location_flags
from googlecloudsdk.command_lib.compute.interconnects.remote_locations import flags as remote_location_flags
from googlecloudsdk.core import log
DETAILED_HELP = {
'DESCRIPTION':
"""\
*{command}* is used to create interconnects. An interconnect represents
a single specific connection between Google and the customer.
For an example, refer to the *EXAMPLES* section below.
""",
# pylint: disable=line-too-long
'EXAMPLES':
"""\
To create an interconnect of type DEDICATED, run:
$ {command} example-interconnect --customer-name="Example Customer Name" --interconnect-type=DEDICATED --link-type=LINK_TYPE_ETHERNET_10G_LR --location=example-zone1-1 --requested-link-count=1 --noc-contact-email=noc@example.com --description="Example interconnect"
To create a Cross-Cloud Interconnect, run:
$ {command} example-cc-interconnect --interconnect-type=DEDICATED --link-type=LINK_TYPE_ETHERNET_10G_LR --location=example-zone1-1 --requested-link-count=1 --remote-location=example-remote-location --noc-contact-email=noc@example.com --description="Example Cross-Cloud Interconnect"
""",
# pylint: enable=line-too-long
}
_LOCATION_FLAG_MSG = (
'The location for the interconnect. The locations can be listed by using '
'the `{parent_command} locations list` command to find '
'the appropriate location to use when creating an interconnect.')
_REMOTE_LOCATION_FLAG_MSG = (
'The remote location for a Cross-Cloud Interconnect. The remote locations '
'can be listed by using the `{parent_command} remote-locations list` '
'command to find the appropriate remote location to use when creating a '
'Cross-Cloud Interconnect.')
_DOCUMENTATION_LINK = 'https://cloud.google.com/interconnect/docs/how-to/dedicated/retrieving-loas'
_CCI_DOCUMENTATION_LINK = 'https://cloud.google.com/network-connectivity/docs/interconnect/concepts/cci-overview'
@base.UniverseCompatible
@base.ReleaseTracks(
base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
)
class Create(base.CreateCommand):
"""Create a Compute Engine interconnect.
*{command}* is used to create interconnects. An interconnect represents a
single specific connection between Google and the customer.
"""
INTERCONNECT_ARG = None
LOCATION_ARG = None
REMOTE_LOCATION_ARG = None
is_cci = False
@classmethod
def Args(cls, parser):
cls.LOCATION_ARG = (
location_flags.InterconnectLocationArgumentForOtherResource(
_LOCATION_FLAG_MSG))
cls.LOCATION_ARG.AddArgument(parser)
cls.REMOTE_LOCATION_ARG = remote_location_flags.InterconnectRemoteLocationArgumentForOtherResource(
_REMOTE_LOCATION_FLAG_MSG
)
cls.REMOTE_LOCATION_ARG.AddArgument(parser)
cls.INTERCONNECT_ARG = flags.InterconnectArgument()
cls.INTERCONNECT_ARG.AddArgument(parser, operation_type='create')
flags.AddCreateArgs(parser, cls.ReleaseTrack())
parser.display_info.AddCacheUpdater(flags.InterconnectsCompleter)
def Collection(self):
return 'compute.interconnects'
def Run(self, args):
holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
ref = self.INTERCONNECT_ARG.ResolveAsResource(args, holder.resources)
interconnect = client.Interconnect(ref, compute_client=holder.client)
location_ref = self.LOCATION_ARG.ResolveAsResource(args, holder.resources)
remote_location_ref = self.REMOTE_LOCATION_ARG.ResolveAsResource(
args, holder.resources
)
messages = holder.client.messages
interconnect_type = flags.GetInterconnectType(
messages, args.interconnect_type
)
link_type = flags.GetLinkType(messages, args.link_type)
remote_location = None
if remote_location_ref:
remote_location = remote_location_ref.SelfLink()
self.is_cci = True
return interconnect.Create(
description=args.description,
interconnect_type=interconnect_type,
requested_link_count=args.requested_link_count,
link_type=link_type,
admin_enabled=args.admin_enabled,
noc_contact_email=args.noc_contact_email,
location=location_ref.SelfLink(),
subzone=flags.GetSubzone(messages, args.subzone),
customer_name=args.customer_name,
remote_location=remote_location,
requested_features=flags.GetRequestedFeatures(
messages, args.requested_features
),
resource_manager_tags=getattr(args, 'resource_manager_tags', None),
)
def Epilog(self, resources_were_displayed):
documentation_link = (
_CCI_DOCUMENTATION_LINK if self.is_cci else _DOCUMENTATION_LINK
)
message = (
'Please check the provided contact email for further '
'instructions on how to activate your Interconnect. See also '
'{} for more detailed help.'.format(documentation_link)
)
log.status.Print(message)
Create.detailed_help = DETAILED_HELP