File: //snap/google-cloud-cli/current/lib/surface/services/vpc_peerings/get_vpc_service_controls.py
# -*- coding: utf-8 -*- #
# Copyright 2023 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.
"""services vpc-peerings get-vpc-service-controls command."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.api_lib.services import peering
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.projects import util as projects_util
from googlecloudsdk.core import properties
@base.DefaultUniverseOnly
@base.ReleaseTracks(
base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
)
class GetVpcServiceControls(base.DescribeCommand):
"""Get VPC state of Service Controls for the peering connection."""
detailed_help = {
'DESCRIPTION': """\
This command provides the state of the VPC Service Controls for a
connection. The state can be enabled or disabled.
When enabled, Google Cloud makes the following route configuration
changes in the service producer VPC network: Google Cloud removes the
IPv4 default route (destination 0.0.0.0/0, next hop default internet
gateway), Google Cloud then creates an IPv4 route for destination
199.36.153.4/30 using the default internet gateway next hop.
When enabled, Google Cloud also creates Cloud DNS managed private
zones and authorizes those zones for the service producer VPC network.
The zones include googleapis.com, gcr.io, pkg.dev,
notebooks.cloud.google.com, kernels.googleusercontent.com,
backupdr.cloud.google.com, and backupdr.googleusercontent.com
as necessary domains or host names for Google APIs and services that are
compatible with VPC Service Controls. Record data in the zones resolves
all host names to 199.36.153.4, 199.36.153.5, 199.36.153.6, and
199.36.153.7.
When disabled, Google Cloud makes the following route configuration
changes in the service producer VPC network: Google Cloud restores a
default route (destination 0.0.0.0/0, next hop default internet
gateway), Google Cloud also deletes the Cloud DNS managed private
zones that provided the host name overrides.
While enabled, the service producer VPC network can still import
static and dynamic routes from the peered customer network if you
enable custom route export. These custom routes can include a default
route. For this reason, this command is not to be used solely as a
means for preventing access to the internet.
""",
'EXAMPLES': """\
To get the status of the VPC Service Controls for a connection peering
a network called `my-network` on the current project to a service called
`your-service`, run:
$ {command} --network=my-network --service=your-service
""",
}
@staticmethod
def Args(parser):
"""Args is called by calliope to gather arguments for this command.
Args:
parser: An argparse parser that can be used to add arguments that go on
the command line after this command. Positional arguments are allowed.
"""
parser.add_argument(
'--network',
metavar='NETWORK',
required=True,
help=(
'The network in the current project that is peered with the'
' service.'
),
)
parser.add_argument(
'--service',
metavar='SERVICE',
default='servicenetworking.googleapis.com',
help='The service to get VPC service controls for.',
)
def Run(self, args):
"""Run 'services vpc-peerings get-vpc-service-controls'.
Args:
args: argparse.Namespace, The arguments that this command was invoked
with.
Returns:
The state of the Vpc Service Controls, that is enabled or disabled.
"""
project = properties.VALUES.core.project.Get(required=True)
project_number = projects_util.GetProjectNumber(project)
return peering.GetVpcServiceControls(
project_number, args.service, args.network
)