From aefc92e8e748bf0e3fd4deb52e9905bdaf2cd76d Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Tue, 25 Feb 2020 09:45:57 -0800 Subject: [PATCH 1/4] chore: change docstring line breaks (via synth) (#9) --- .../datacatalog_v1beta1/proto/search_pb2.py | 4 ++-- synth.metadata | 22 ++++--------------- 2 files changed, 6 insertions(+), 20 deletions(-) diff --git a/google/cloud/datacatalog_v1beta1/proto/search_pb2.py b/google/cloud/datacatalog_v1beta1/proto/search_pb2.py index 1b5411f6..f5cde2e1 100644 --- a/google/cloud/datacatalog_v1beta1/proto/search_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/search_pb2.py @@ -180,8 +180,8 @@ dict( DESCRIPTOR=_SEARCHCATALOGRESULT, __module__="google.cloud.datacatalog_v1beta1.proto.search_pb2", - __doc__="""A result that appears in the response of a search request. Each result - captures details of one entry that matches the search. + __doc__="""A result that appears in the response of a search request. + Each result captures details of one entry that matches the search. Attributes: diff --git a/synth.metadata b/synth.metadata index 1bf57cd2..1acc7732 100644 --- a/synth.metadata +++ b/synth.metadata @@ -1,5 +1,5 @@ { - "updateTime": "2020-02-24T13:13:52.458686Z", + "updateTime": "2020-02-25T13:14:24.965186Z", "sources": [ { "generator": { @@ -8,27 +8,13 @@ "dockerImage": "googleapis/artman@sha256:36956ca6a4dc70a59de5d5d0fd35061b050bb56884516f0898f46d8220f25738" } }, - { - "git": { - "name": ".", - "remote": "https://github.com/googleapis/python-datacatalog.git", - "sha": "b51902e26d590f52c9412756a178265850b7d516" - } - }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "7f910bcc4fc4704947ccfd3ceed015d16b9e00c2", - "internalRef": "296451205", - "log": "7f910bcc4fc4704947ccfd3ceed015d16b9e00c2\nUpdate Dataproc v1beta2 client.\n\nPiperOrigin-RevId: 296451205\n\nde287524405a3dce124d301634731584fc0432d7\nFix: Reinstate method signatures that had been missed off some RPCs\nFix: Correct resource types for two fields\n\nPiperOrigin-RevId: 296435091\n\ne5bc9566ae057fb4c92f8b7e047f1c8958235b53\nDeprecate the endpoint_uris field, as it is unused.\n\nPiperOrigin-RevId: 296357191\n\n8c12e2b4dca94e12bff9f538bdac29524ff7ef7a\nUpdate Dataproc v1 client.\n\nPiperOrigin-RevId: 296336662\n\n17567c4a1ef0a9b50faa87024d66f8acbb561089\nRemoving erroneous comment, a la https://github.com/googleapis/java-speech/pull/103\n\nPiperOrigin-RevId: 296332968\n\n3eaaaf8626ce5b0c0bc7eee05e143beffa373b01\nAdd BUILD.bazel for v1 secretmanager.googleapis.com\n\nPiperOrigin-RevId: 296274723\n\ne76149c3d992337f85eeb45643106aacae7ede82\nMove securitycenter v1 to use generate from annotations.\n\nPiperOrigin-RevId: 296266862\n\n203740c78ac69ee07c3bf6be7408048751f618f8\nAdd StackdriverLoggingConfig field to Cloud Tasks v2 API.\n\nPiperOrigin-RevId: 296256388\n\ne4117d5e9ed8bbca28da4a60a94947ca51cb2083\nCreate a Bazel BUILD file for the google.actions.type export.\n\nPiperOrigin-RevId: 296212567\n\na9639a0a9854fd6e1be08bba1ac3897f4f16cb2f\nAdd secretmanager.googleapis.com v1 protos\n\nPiperOrigin-RevId: 295983266\n\n" - } - }, - { - "git": { - "name": "synthtool", - "remote": "rpc://devrel/cloud/libraries/tools/autosynth", - "sha": "706a38c26db42299845396cdae55db635c38794a" + "sha": "0b1876b35e98f560f9c9ca9797955f020238a092", + "internalRef": "296986742", + "log": "0b1876b35e98f560f9c9ca9797955f020238a092\nUse an older version of protoc-docs-plugin that is compatible with the specified gapic-generator and protobuf versions.\n\nprotoc-docs-plugin >=0.4.0 (see commit https://github.com/googleapis/protoc-docs-plugin/commit/979f03ede6678c487337f3d7e88bae58df5207af) is incompatible with protobuf 3.9.1.\n\nPiperOrigin-RevId: 296986742\n\n1e47e676cddbbd8d93f19ba0665af15b5532417e\nFix: Restore a method signature for UpdateCluster\n\nPiperOrigin-RevId: 296901854\n\n" } }, { From 21629fed1f86bb1a2800b5213f59acc5d862e2f5 Mon Sep 17 00:00:00 2001 From: Bu Sun Kim <8822365+busunkim96@users.noreply.github.com> Date: Wed, 8 Apr 2020 16:21:57 -0700 Subject: [PATCH 2/4] feat: add v1 (#13) --- docs/gapic/v1/api.rst | 6 + docs/gapic/v1/types.rst | 5 + docs/index.rst | 13 +- google/cloud/datacatalog_v1/__init__.py | 41 + google/cloud/datacatalog_v1/gapic/__init__.py | 0 .../gapic/data_catalog_client.py | 2717 ++++++++++++ .../gapic/data_catalog_client_config.py | 158 + google/cloud/datacatalog_v1/gapic/enums.py | 110 + .../gapic/transports/__init__.py | 0 .../transports/data_catalog_grpc_transport.py | 593 +++ google/cloud/datacatalog_v1/proto/__init__.py | 0 .../cloud/datacatalog_v1/proto/common_pb2.py | 62 + .../datacatalog_v1/proto/common_pb2_grpc.py | 2 + .../datacatalog_v1/proto/datacatalog_pb2.py | 3708 +++++++++++++++++ .../proto/datacatalog_pb2_grpc.py | 623 +++ .../proto/gcs_fileset_spec_pb2.py | 248 ++ .../proto/gcs_fileset_spec_pb2_grpc.py | 2 + .../cloud/datacatalog_v1/proto/schema_pb2.py | 243 ++ .../datacatalog_v1/proto/schema_pb2_grpc.py | 2 + .../cloud/datacatalog_v1/proto/search_pb2.py | 280 ++ .../datacatalog_v1/proto/search_pb2_grpc.py | 2 + .../datacatalog_v1/proto/table_spec_pb2.py | 427 ++ .../proto/table_spec_pb2_grpc.py | 2 + google/cloud/datacatalog_v1/proto/tags_pb2.py | 1157 +++++ .../datacatalog_v1/proto/tags_pb2_grpc.py | 2 + .../datacatalog_v1/proto/timestamps_pb2.py | 145 + .../proto/timestamps_pb2_grpc.py | 2 + google/cloud/datacatalog_v1/types.py | 72 + google/cloud/datacatalog_v1beta1/__init__.py | 14 +- .../gapic/data_catalog_client.py | 150 +- .../gapic/policy_tag_manager_client.py | 24 +- .../transports/data_catalog_grpc_transport.py | 66 +- .../datacatalog_v1beta1/proto/common_pb2.py | 11 +- .../proto/datacatalog_pb2.py | 795 ++-- .../proto/gcs_fileset_spec_pb2.py | 47 +- .../proto/policytagmanager_pb2.py | 339 +- .../policytagmanagerserialization_pb2.py | 123 +- .../datacatalog_v1beta1/proto/schema_pb2.py | 53 +- .../datacatalog_v1beta1/proto/search_pb2.py | 37 +- .../proto/table_spec_pb2.py | 73 +- .../datacatalog_v1beta1/proto/tags_pb2.py | 201 +- .../proto/timestamps_pb2.py | 24 +- synth.metadata | 27 +- synth.py | 47 +- .../gapic/v1/test_data_catalog_client_v1.py | 1268 ++++++ 45 files changed, 12798 insertions(+), 1123 deletions(-) create mode 100644 docs/gapic/v1/api.rst create mode 100644 docs/gapic/v1/types.rst create mode 100644 google/cloud/datacatalog_v1/__init__.py create mode 100644 google/cloud/datacatalog_v1/gapic/__init__.py create mode 100644 google/cloud/datacatalog_v1/gapic/data_catalog_client.py create mode 100644 google/cloud/datacatalog_v1/gapic/data_catalog_client_config.py create mode 100644 google/cloud/datacatalog_v1/gapic/enums.py create mode 100644 google/cloud/datacatalog_v1/gapic/transports/__init__.py create mode 100644 google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py create mode 100644 google/cloud/datacatalog_v1/proto/__init__.py create mode 100644 google/cloud/datacatalog_v1/proto/common_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/common_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/proto/datacatalog_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/datacatalog_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/proto/schema_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/schema_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/proto/search_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/search_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/proto/table_spec_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/table_spec_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/proto/tags_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/tags_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/proto/timestamps_pb2.py create mode 100644 google/cloud/datacatalog_v1/proto/timestamps_pb2_grpc.py create mode 100644 google/cloud/datacatalog_v1/types.py create mode 100644 tests/unit/gapic/v1/test_data_catalog_client_v1.py diff --git a/docs/gapic/v1/api.rst b/docs/gapic/v1/api.rst new file mode 100644 index 00000000..c9dfa5cf --- /dev/null +++ b/docs/gapic/v1/api.rst @@ -0,0 +1,6 @@ +Client for Google Cloud Data Catalog API +======================================== + +.. automodule:: google.cloud.datacatalog_v1 + :members: + :inherited-members: \ No newline at end of file diff --git a/docs/gapic/v1/types.rst b/docs/gapic/v1/types.rst new file mode 100644 index 00000000..98c3a90a --- /dev/null +++ b/docs/gapic/v1/types.rst @@ -0,0 +1,5 @@ +Types for Google Cloud Data Catalog API Client +============================================== + +.. automodule:: google.cloud.datacatalog_v1.types + :members: \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst index 3964113d..92a7ab29 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,7 +1,18 @@ .. include:: README.rst -API Reference + +v1 +------------- + +.. toctree:: + :maxdepth: 2 + + gapic/v1/api + gapic/v1/types + + +v1beta1 ------------- .. toctree:: diff --git a/google/cloud/datacatalog_v1/__init__.py b/google/cloud/datacatalog_v1/__init__.py new file mode 100644 index 00000000..c30e64d2 --- /dev/null +++ b/google/cloud/datacatalog_v1/__init__.py @@ -0,0 +1,41 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + + +from __future__ import absolute_import +import sys +import warnings + +from google.cloud.datacatalog_v1 import types +from google.cloud.datacatalog_v1.gapic import data_catalog_client +from google.cloud.datacatalog_v1.gapic import enums + + +if sys.version_info[:2] == (2, 7): + message = ( + "A future version of this library will drop support for Python 2.7." + "More details about Python 2 support for Google Cloud Client Libraries" + "can be found at https://cloud.google.com/python/docs/python2-sunset/" + ) + warnings.warn(message, DeprecationWarning) + + +class DataCatalogClient(data_catalog_client.DataCatalogClient): + __doc__ = data_catalog_client.DataCatalogClient.__doc__ + enums = enums + + +__all__ = ("enums", "types", "DataCatalogClient") diff --git a/google/cloud/datacatalog_v1/gapic/__init__.py b/google/cloud/datacatalog_v1/gapic/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/google/cloud/datacatalog_v1/gapic/data_catalog_client.py b/google/cloud/datacatalog_v1/gapic/data_catalog_client.py new file mode 100644 index 00000000..dbecb79a --- /dev/null +++ b/google/cloud/datacatalog_v1/gapic/data_catalog_client.py @@ -0,0 +1,2717 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + +"""Accesses the google.cloud.datacatalog.v1 DataCatalog API.""" + +import functools +import pkg_resources +import warnings + +from google.oauth2 import service_account +import google.api_core.client_options +import google.api_core.gapic_v1.client_info +import google.api_core.gapic_v1.config +import google.api_core.gapic_v1.method +import google.api_core.gapic_v1.routing_header +import google.api_core.grpc_helpers +import google.api_core.page_iterator +import google.api_core.path_template +import google.api_core.protobuf_helpers +import grpc + +from google.cloud.datacatalog_v1.gapic import data_catalog_client_config +from google.cloud.datacatalog_v1.gapic import enums +from google.cloud.datacatalog_v1.gapic.transports import data_catalog_grpc_transport +from google.cloud.datacatalog_v1.proto import datacatalog_pb2 +from google.cloud.datacatalog_v1.proto import datacatalog_pb2_grpc +from google.cloud.datacatalog_v1.proto import tags_pb2 +from google.iam.v1 import iam_policy_pb2 +from google.iam.v1 import options_pb2 +from google.iam.v1 import policy_pb2 +from google.protobuf import empty_pb2 +from google.protobuf import field_mask_pb2 + + +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution( + "google-cloud-datacatalog" +).version + + +class DataCatalogClient(object): + """ + Data Catalog API service allows clients to discover, understand, and manage + their data. + """ + + SERVICE_ADDRESS = "datacatalog.googleapis.com:443" + """The default address of the service.""" + + # The name of the interface for this client. This is the key used to + # find the method configuration in the client_config dictionary. + _INTERFACE_NAME = "google.cloud.datacatalog.v1.DataCatalog" + + @classmethod + def from_service_account_file(cls, filename, *args, **kwargs): + """Creates an instance of this client using the provided credentials + file. + + Args: + filename (str): The path to the service account private key json + file. + args: Additional arguments to pass to the constructor. + kwargs: Additional arguments to pass to the constructor. + + Returns: + DataCatalogClient: The constructed client. + """ + credentials = service_account.Credentials.from_service_account_file(filename) + kwargs["credentials"] = credentials + return cls(*args, **kwargs) + + from_service_account_json = from_service_account_file + + @classmethod + def entry_path(cls, project, location, entry_group, entry): + """Return a fully-qualified entry string.""" + return google.api_core.path_template.expand( + "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}", + project=project, + location=location, + entry_group=entry_group, + entry=entry, + ) + + @classmethod + def entry_group_path(cls, project, location, entry_group): + """Return a fully-qualified entry_group string.""" + return google.api_core.path_template.expand( + "projects/{project}/locations/{location}/entryGroups/{entry_group}", + project=project, + location=location, + entry_group=entry_group, + ) + + @classmethod + def location_path(cls, project, location): + """Return a fully-qualified location string.""" + return google.api_core.path_template.expand( + "projects/{project}/locations/{location}", + project=project, + location=location, + ) + + @classmethod + def tag_path(cls, project, location, entry_group, entry, tag): + """Return a fully-qualified tag string.""" + return google.api_core.path_template.expand( + "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}", + project=project, + location=location, + entry_group=entry_group, + entry=entry, + tag=tag, + ) + + @classmethod + def tag_template_path(cls, project, location, tag_template): + """Return a fully-qualified tag_template string.""" + return google.api_core.path_template.expand( + "projects/{project}/locations/{location}/tagTemplates/{tag_template}", + project=project, + location=location, + tag_template=tag_template, + ) + + @classmethod + def tag_template_field_path(cls, project, location, tag_template, field): + """Return a fully-qualified tag_template_field string.""" + return google.api_core.path_template.expand( + "projects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}", + project=project, + location=location, + tag_template=tag_template, + field=field, + ) + + def __init__( + self, + transport=None, + channel=None, + credentials=None, + client_config=None, + client_info=None, + client_options=None, + ): + """Constructor. + + Args: + transport (Union[~.DataCatalogGrpcTransport, + Callable[[~.Credentials, type], ~.DataCatalogGrpcTransport]): A transport + instance, responsible for actually making the API calls. + The default transport uses the gRPC protocol. + This argument may also be a callable which returns a + transport instance. Callables will be sent the credentials + as the first argument and the default transport class as + the second argument. + channel (grpc.Channel): DEPRECATED. A ``Channel`` instance + through which to make calls. This argument is mutually exclusive + with ``credentials``; providing both will raise an exception. + credentials (google.auth.credentials.Credentials): The + authorization credentials to attach to requests. These + credentials identify this application to the service. If none + are specified, the client will attempt to ascertain the + credentials from the environment. + This argument is mutually exclusive with providing a + transport instance to ``transport``; doing so will raise + an exception. + client_config (dict): DEPRECATED. A dictionary of call options for + each method. If not specified, the default configuration is used. + client_info (google.api_core.gapic_v1.client_info.ClientInfo): + The client info used to send a user-agent string along with + API requests. If ``None``, then default info will be used. + Generally, you only need to set this if you're developing + your own client library. + client_options (Union[dict, google.api_core.client_options.ClientOptions]): + Client options used to set user options on the client. API Endpoint + should be set through client_options. + """ + # Raise deprecation warnings for things we want to go away. + if client_config is not None: + warnings.warn( + "The `client_config` argument is deprecated.", + PendingDeprecationWarning, + stacklevel=2, + ) + else: + client_config = data_catalog_client_config.config + + if channel: + warnings.warn( + "The `channel` argument is deprecated; use " "`transport` instead.", + PendingDeprecationWarning, + stacklevel=2, + ) + + api_endpoint = self.SERVICE_ADDRESS + if client_options: + if type(client_options) == dict: + client_options = google.api_core.client_options.from_dict( + client_options + ) + if client_options.api_endpoint: + api_endpoint = client_options.api_endpoint + + # Instantiate the transport. + # The transport is responsible for handling serialization and + # deserialization and actually sending data to the service. + if transport: + if callable(transport): + self.transport = transport( + credentials=credentials, + default_class=data_catalog_grpc_transport.DataCatalogGrpcTransport, + address=api_endpoint, + ) + else: + if credentials: + raise ValueError( + "Received both a transport instance and " + "credentials; these are mutually exclusive." + ) + self.transport = transport + else: + self.transport = data_catalog_grpc_transport.DataCatalogGrpcTransport( + address=api_endpoint, channel=channel, credentials=credentials + ) + + if client_info is None: + client_info = google.api_core.gapic_v1.client_info.ClientInfo( + gapic_version=_GAPIC_LIBRARY_VERSION + ) + else: + client_info.gapic_version = _GAPIC_LIBRARY_VERSION + self._client_info = client_info + + # Parse out the default settings for retry and timeout for each RPC + # from the client configuration. + # (Ordinarily, these are the defaults specified in the `*_config.py` + # file next to this one.) + self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( + client_config["interfaces"][self._INTERFACE_NAME] + ) + + # Save a dictionary of cached API call functions. + # These are the actual callables which invoke the proper + # transport methods, wrapped with `wrap_method` to add retry, + # timeout, and the like. + self._inner_api_calls = {} + + # Service calls + def search_catalog( + self, + scope, + query, + page_size=None, + order_by=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Searches Data Catalog for multiple resources like entries, tags that + match a query. + + This is a custom method + (https://cloud.google.com/apis/design/custom_methods) and does not + return the complete resource, only the resource identifier and high + level fields. Clients can subsequentally call ``Get`` methods. + + Note that Data Catalog search queries do not guarantee full recall. + Query results that match your query may not be returned, even in + subsequent result pages. Also note that results returned (and not + returned) can vary across repeated search queries. + + See `Data Catalog Search + Syntax `__ + for more information. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `scope`: + >>> scope = {} + >>> + >>> # TODO: Initialize `query`: + >>> query = '' + >>> + >>> # Iterate over all results + >>> for element in client.search_catalog(scope, query): + ... # process element + ... pass + >>> + >>> + >>> # Alternatively: + >>> + >>> # Iterate over results one page at a time + >>> for page in client.search_catalog(scope, query).pages: + ... for element in page: + ... # process element + ... pass + + Args: + scope (Union[dict, ~google.cloud.datacatalog_v1.types.Scope]): Required. The scope of this search request. A ``scope`` that has + empty ``include_org_ids``, ``include_project_ids`` AND false + ``include_gcp_public_datasets`` is considered invalid. Data Catalog will + return an error in such a case. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.Scope` + query (str): Required. The query string in search query syntax. The query must be + non-empty. + + Query strings can be simple as "x" or more qualified as: + + - name:x + - column:x + - description:y + + Note: Query tokens need to have a minimum of 3 characters for substring + matching to work correctly. See `Data Catalog Search + Syntax `__ + for more information. + page_size (int): The maximum number of resources contained in the + underlying API response. If page streaming is performed per- + resource, this parameter does not affect the return value. If page + streaming is performed per-page, this determines the maximum number + of resources in a page. + order_by (str): Specifies the ordering of results, currently supported + case-sensitive choices are: + + - ``relevance``, only supports descending + - ``last_modified_timestamp [asc|desc]``, defaults to descending if not + specified + + If not specified, defaults to ``relevance`` descending. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.api_core.page_iterator.PageIterator` instance. + An iterable of :class:`~google.cloud.datacatalog_v1.types.SearchCatalogResult` instances. + You can also iterate over the pages of the response + using its `pages` property. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "search_catalog" not in self._inner_api_calls: + self._inner_api_calls[ + "search_catalog" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.search_catalog, + default_retry=self._method_configs["SearchCatalog"].retry, + default_timeout=self._method_configs["SearchCatalog"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.SearchCatalogRequest( + scope=scope, query=query, page_size=page_size, order_by=order_by + ) + iterator = google.api_core.page_iterator.GRPCIterator( + client=None, + method=functools.partial( + self._inner_api_calls["search_catalog"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), + request=request, + items_field="results", + request_token_field="page_token", + response_token_field="next_page_token", + ) + return iterator + + def create_entry_group( + self, + parent, + entry_group_id, + entry_group=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Creates an EntryGroup. + + An entry group contains logically related entries together with Cloud + Identity and Access Management policies that specify the users who can + create, edit, and view entries within the entry group. + + Data Catalog automatically creates an entry group for BigQuery entries + ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own + entry group to contain Cloud Storage fileset entries or custom type + entries, and the IAM policies associated with those entries. Entry + groups, like entries, can be searched. + + A maximum of 10,000 entry groups may be created per organization across + all locations. + + Users should enable the Data Catalog API in the project identified by + the ``parent`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.location_path('[PROJECT]', '[LOCATION]') + >>> + >>> # TODO: Initialize `entry_group_id`: + >>> entry_group_id = '' + >>> + >>> response = client.create_entry_group(parent, entry_group_id) + + Args: + parent (str): Required. The name of the project this entry group is in. Example: + + - projects/{project_id}/locations/{location} + + Note that this EntryGroup and its child resources may not actually be + stored in the location in this name. + entry_group_id (str): Required. The id of the entry group to create. + The id must begin with a letter or underscore, contain only English + letters, numbers and underscores, and be at most 64 characters. + entry_group (Union[dict, ~google.cloud.datacatalog_v1.types.EntryGroup]): The entry group to create. Defaults to an empty entry group. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.EntryGroup` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.EntryGroup` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "create_entry_group" not in self._inner_api_calls: + self._inner_api_calls[ + "create_entry_group" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.create_entry_group, + default_retry=self._method_configs["CreateEntryGroup"].retry, + default_timeout=self._method_configs["CreateEntryGroup"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.CreateEntryGroupRequest( + parent=parent, entry_group_id=entry_group_id, entry_group=entry_group + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["create_entry_group"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def get_entry_group( + self, + name, + read_mask=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Gets an EntryGroup. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.entry_group_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]') + >>> + >>> response = client.get_entry_group(name) + + Args: + name (str): Required. The name of the entry group. For example, + ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. + read_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to return. If not set or empty, all fields are returned. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.FieldMask` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.EntryGroup` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "get_entry_group" not in self._inner_api_calls: + self._inner_api_calls[ + "get_entry_group" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.get_entry_group, + default_retry=self._method_configs["GetEntryGroup"].retry, + default_timeout=self._method_configs["GetEntryGroup"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.GetEntryGroupRequest(name=name, read_mask=read_mask) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["get_entry_group"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def update_entry_group( + self, + entry_group, + update_mask=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Updates an EntryGroup. The user should enable the Data Catalog API + in the project identified by the ``entry_group.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `entry_group`: + >>> entry_group = {} + >>> + >>> response = client.update_entry_group(entry_group) + + Args: + entry_group (Union[dict, ~google.cloud.datacatalog_v1.types.EntryGroup]): Required. The updated entry group. "name" field must be set. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.EntryGroup` + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to update on the entry group. If absent or empty, all modifiable + fields are updated. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.FieldMask` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.EntryGroup` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "update_entry_group" not in self._inner_api_calls: + self._inner_api_calls[ + "update_entry_group" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.update_entry_group, + default_retry=self._method_configs["UpdateEntryGroup"].retry, + default_timeout=self._method_configs["UpdateEntryGroup"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.UpdateEntryGroupRequest( + entry_group=entry_group, update_mask=update_mask + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("entry_group.name", entry_group.name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["update_entry_group"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def delete_entry_group( + self, + name, + force=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Deletes an EntryGroup. Only entry groups that do not contain entries + can be deleted. Users should enable the Data Catalog API in the project + identified by the ``name`` parameter (see [Data Catalog Resource + Project] (/data-catalog/docs/concepts/resource-project) for more + information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.entry_group_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]') + >>> + >>> client.delete_entry_group(name) + + Args: + name (str): Required. The name of the entry group. For example, + ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. + force (bool): Optional. If true, deletes all entries in the entry group. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "delete_entry_group" not in self._inner_api_calls: + self._inner_api_calls[ + "delete_entry_group" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.delete_entry_group, + default_retry=self._method_configs["DeleteEntryGroup"].retry, + default_timeout=self._method_configs["DeleteEntryGroup"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.DeleteEntryGroupRequest(name=name, force=force) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + self._inner_api_calls["delete_entry_group"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def list_entry_groups( + self, + parent, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Lists entry groups. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.entry_group_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]') + >>> + >>> # Iterate over all results + >>> for element in client.list_entry_groups(parent): + ... # process element + ... pass + >>> + >>> + >>> # Alternatively: + >>> + >>> # Iterate over results one page at a time + >>> for page in client.list_entry_groups(parent).pages: + ... for element in page: + ... # process element + ... pass + + Args: + parent (str): Required. The name of the location that contains the entry groups, + which can be provided in URL format. Example: + + - projects/{project_id}/locations/{location} + page_size (int): The maximum number of resources contained in the + underlying API response. If page streaming is performed per- + resource, this parameter does not affect the return value. If page + streaming is performed per-page, this determines the maximum number + of resources in a page. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.api_core.page_iterator.PageIterator` instance. + An iterable of :class:`~google.cloud.datacatalog_v1.types.EntryGroup` instances. + You can also iterate over the pages of the response + using its `pages` property. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "list_entry_groups" not in self._inner_api_calls: + self._inner_api_calls[ + "list_entry_groups" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.list_entry_groups, + default_retry=self._method_configs["ListEntryGroups"].retry, + default_timeout=self._method_configs["ListEntryGroups"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.ListEntryGroupsRequest( + parent=parent, page_size=page_size + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + iterator = google.api_core.page_iterator.GRPCIterator( + client=None, + method=functools.partial( + self._inner_api_calls["list_entry_groups"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), + request=request, + items_field="entry_groups", + request_token_field="page_token", + response_token_field="next_page_token", + ) + return iterator + + def create_entry( + self, + parent, + entry_id, + entry, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Creates an entry. Only entries of 'FILESET' type or user-specified + type can be created. + + Users should enable the Data Catalog API in the project identified by + the ``parent`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + A maximum of 100,000 entries may be created per entry group. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.entry_group_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]') + >>> + >>> # TODO: Initialize `entry_id`: + >>> entry_id = '' + >>> + >>> # TODO: Initialize `entry`: + >>> entry = {} + >>> + >>> response = client.create_entry(parent, entry_id, entry) + + Args: + parent (str): Required. The name of the entry group this entry is in. Example: + + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + + Note that this Entry and its child resources may not actually be stored + in the location in this name. + entry_id (str): Required. The id of the entry to create. + entry (Union[dict, ~google.cloud.datacatalog_v1.types.Entry]): Required. The entry to create. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.Entry` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Entry` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "create_entry" not in self._inner_api_calls: + self._inner_api_calls[ + "create_entry" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.create_entry, + default_retry=self._method_configs["CreateEntry"].retry, + default_timeout=self._method_configs["CreateEntry"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.CreateEntryRequest( + parent=parent, entry_id=entry_id, entry=entry + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["create_entry"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def update_entry( + self, + entry, + update_mask=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Updates an existing entry. Users should enable the Data Catalog API + in the project identified by the ``entry.name`` parameter (see [Data + Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) + for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `entry`: + >>> entry = {} + >>> + >>> response = client.update_entry(entry) + + Args: + entry (Union[dict, ~google.cloud.datacatalog_v1.types.Entry]): Required. The updated entry. The "name" field must be set. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.Entry` + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to update on the entry. If absent or empty, all + modifiable fields are updated. + + The following fields are modifiable: + + - For entries with type ``DATA_STREAM``: + + - ``schema`` + + - For entries with type ``FILESET`` + + - ``schema`` + - ``display_name`` + - ``description`` + - ``gcs_fileset_spec`` + - ``gcs_fileset_spec.file_patterns`` + + - For entries with ``user_specified_type`` + + - ``schema`` + - ``display_name`` + - ``description`` + - user_specified_type + - user_specified_system + - linked_resource + - source_system_timestamps + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.FieldMask` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Entry` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "update_entry" not in self._inner_api_calls: + self._inner_api_calls[ + "update_entry" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.update_entry, + default_retry=self._method_configs["UpdateEntry"].retry, + default_timeout=self._method_configs["UpdateEntry"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.UpdateEntryRequest( + entry=entry, update_mask=update_mask + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("entry.name", entry.name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["update_entry"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def delete_entry( + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Deletes an existing entry. Only entries created through + ``CreateEntry`` method can be deleted. Users should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.entry_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]') + >>> + >>> client.delete_entry(name) + + Args: + name (str): Required. The name of the entry. Example: + + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "delete_entry" not in self._inner_api_calls: + self._inner_api_calls[ + "delete_entry" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.delete_entry, + default_retry=self._method_configs["DeleteEntry"].retry, + default_timeout=self._method_configs["DeleteEntry"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.DeleteEntryRequest(name=name) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + self._inner_api_calls["delete_entry"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def get_entry( + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Gets an entry. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.entry_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]') + >>> + >>> response = client.get_entry(name) + + Args: + name (str): Required. The name of the entry. Example: + + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Entry` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "get_entry" not in self._inner_api_calls: + self._inner_api_calls[ + "get_entry" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.get_entry, + default_retry=self._method_configs["GetEntry"].retry, + default_timeout=self._method_configs["GetEntry"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.GetEntryRequest(name=name) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["get_entry"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def lookup_entry( + self, + linked_resource=None, + sql_resource=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Get an entry by target resource name. This method allows clients to use + the resource name from the source Google Cloud Platform service to get the + Data Catalog Entry. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> response = client.lookup_entry() + + Args: + linked_resource (str): The full name of the Google Cloud Platform resource the Data Catalog + entry represents. See: + https://cloud.google.com/apis/design/resource_names#full_resource_name. + Full names are case-sensitive. + + Examples: + + - //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + - //pubsub.googleapis.com/projects/projectId/topics/topicId + sql_resource (str): The SQL name of the entry. SQL names are case-sensitive. + + Examples: + + - ``cloud_pubsub.project_id.topic_id`` + - :literal:`pubsub.project_id.`topic.id.with.dots\`` + - ``bigquery.table.project_id.dataset_id.table_id`` + - ``bigquery.dataset.project_id.dataset_id`` + - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` + + ``*_id``\ s shoud satisfy the standard SQL rules for identifiers. + https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Entry` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "lookup_entry" not in self._inner_api_calls: + self._inner_api_calls[ + "lookup_entry" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.lookup_entry, + default_retry=self._method_configs["LookupEntry"].retry, + default_timeout=self._method_configs["LookupEntry"].timeout, + client_info=self._client_info, + ) + + # Sanity check: We have some fields which are mutually exclusive; + # raise ValueError if more than one is sent. + google.api_core.protobuf_helpers.check_oneof( + linked_resource=linked_resource, sql_resource=sql_resource + ) + + request = datacatalog_pb2.LookupEntryRequest( + linked_resource=linked_resource, sql_resource=sql_resource + ) + return self._inner_api_calls["lookup_entry"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def list_entries( + self, + parent, + page_size=None, + read_mask=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Lists entries. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.entry_group_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]') + >>> + >>> # Iterate over all results + >>> for element in client.list_entries(parent): + ... # process element + ... pass + >>> + >>> + >>> # Alternatively: + >>> + >>> # Iterate over results one page at a time + >>> for page in client.list_entries(parent).pages: + ... for element in page: + ... # process element + ... pass + + Args: + parent (str): Required. The name of the entry group that contains the entries, + which can be provided in URL format. Example: + + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + page_size (int): The maximum number of resources contained in the + underlying API response. If page streaming is performed per- + resource, this parameter does not affect the return value. If page + streaming is performed per-page, this determines the maximum number + of resources in a page. + read_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to return for each Entry. If not set or empty, all fields + are returned. For example, setting read_mask to contain only one path + "name" will cause ListEntries to return a list of Entries with only + "name" field. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.FieldMask` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.api_core.page_iterator.PageIterator` instance. + An iterable of :class:`~google.cloud.datacatalog_v1.types.Entry` instances. + You can also iterate over the pages of the response + using its `pages` property. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "list_entries" not in self._inner_api_calls: + self._inner_api_calls[ + "list_entries" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.list_entries, + default_retry=self._method_configs["ListEntries"].retry, + default_timeout=self._method_configs["ListEntries"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.ListEntriesRequest( + parent=parent, page_size=page_size, read_mask=read_mask + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + iterator = google.api_core.page_iterator.GRPCIterator( + client=None, + method=functools.partial( + self._inner_api_calls["list_entries"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), + request=request, + items_field="entries", + request_token_field="page_token", + response_token_field="next_page_token", + ) + return iterator + + def create_tag_template( + self, + parent, + tag_template_id, + tag_template, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Creates a tag template. The user should enable the Data Catalog API + in the project identified by the ``parent`` parameter (see `Data Catalog + Resource + Project `__ + for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.location_path('[PROJECT]', '[LOCATION]') + >>> + >>> # TODO: Initialize `tag_template_id`: + >>> tag_template_id = '' + >>> + >>> # TODO: Initialize `tag_template`: + >>> tag_template = {} + >>> + >>> response = client.create_tag_template(parent, tag_template_id, tag_template) + + Args: + parent (str): Required. The name of the project and the template location + `region `__. + NOTE: Currently, only the ``us-central1 region`` is supported. + + Example: + + - projects/{project_id}/locations/us-central1 + tag_template_id (str): Required. The id of the tag template to create. + tag_template (Union[dict, ~google.cloud.datacatalog_v1.types.TagTemplate]): Required. The tag template to create. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.TagTemplate` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.TagTemplate` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "create_tag_template" not in self._inner_api_calls: + self._inner_api_calls[ + "create_tag_template" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.create_tag_template, + default_retry=self._method_configs["CreateTagTemplate"].retry, + default_timeout=self._method_configs["CreateTagTemplate"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.CreateTagTemplateRequest( + parent=parent, tag_template_id=tag_template_id, tag_template=tag_template + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["create_tag_template"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def get_tag_template( + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Gets a tag template. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]') + >>> + >>> response = client.get_tag_template(name) + + Args: + name (str): Required. The name of the tag template. Example: + + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.TagTemplate` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "get_tag_template" not in self._inner_api_calls: + self._inner_api_calls[ + "get_tag_template" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.get_tag_template, + default_retry=self._method_configs["GetTagTemplate"].retry, + default_timeout=self._method_configs["GetTagTemplate"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.GetTagTemplateRequest(name=name) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["get_tag_template"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def update_tag_template( + self, + tag_template, + update_mask=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Updates a tag template. This method cannot be used to update the + fields of a template. The tag template fields are represented as + separate resources and should be updated using their own + create/update/delete methods. Users should enable the Data Catalog API + in the project identified by the ``tag_template.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `tag_template`: + >>> tag_template = {} + >>> + >>> response = client.update_tag_template(tag_template) + + Args: + tag_template (Union[dict, ~google.cloud.datacatalog_v1.types.TagTemplate]): Required. The template to update. The "name" field must be set. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.TagTemplate` + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The field mask specifies the parts of the template to overwrite. + + Allowed fields: + + - ``display_name`` + + If absent or empty, all of the allowed fields above will be updated. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.FieldMask` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.TagTemplate` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "update_tag_template" not in self._inner_api_calls: + self._inner_api_calls[ + "update_tag_template" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.update_tag_template, + default_retry=self._method_configs["UpdateTagTemplate"].retry, + default_timeout=self._method_configs["UpdateTagTemplate"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.UpdateTagTemplateRequest( + tag_template=tag_template, update_mask=update_mask + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("tag_template.name", tag_template.name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["update_tag_template"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def delete_tag_template( + self, + name, + force, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Deletes a tag template and all tags using the template. Users should + enable the Data Catalog API in the project identified by the ``name`` + parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]') + >>> + >>> # TODO: Initialize `force`: + >>> force = False + >>> + >>> client.delete_tag_template(name, force) + + Args: + name (str): Required. The name of the tag template to delete. Example: + + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + force (bool): Required. Currently, this field must always be set to ``true``. This + confirms the deletion of any possible tags using this template. + ``force = false`` will be supported in the future. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "delete_tag_template" not in self._inner_api_calls: + self._inner_api_calls[ + "delete_tag_template" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.delete_tag_template, + default_retry=self._method_configs["DeleteTagTemplate"].retry, + default_timeout=self._method_configs["DeleteTagTemplate"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.DeleteTagTemplateRequest(name=name, force=force) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + self._inner_api_calls["delete_tag_template"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def create_tag_template_field( + self, + parent, + tag_template_field_id, + tag_template_field, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Creates a field in a tag template. The user should enable the Data + Catalog API in the project identified by the ``parent`` parameter (see + `Data Catalog Resource + Project `__ + for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]') + >>> + >>> # TODO: Initialize `tag_template_field_id`: + >>> tag_template_field_id = '' + >>> + >>> # TODO: Initialize `tag_template_field`: + >>> tag_template_field = {} + >>> + >>> response = client.create_tag_template_field(parent, tag_template_field_id, tag_template_field) + + Args: + parent (str): Required. The name of the project and the template location + `region `__. + NOTE: Currently, only the ``us-central1 region`` is supported. + + Example: + + - projects/{project_id}/locations/us-central1/tagTemplates/{tag_template_id} + tag_template_field_id (str): Required. The ID of the tag template field to create. Field ids can + contain letters (both uppercase and lowercase), numbers (0-9), + underscores (_) and dashes (-). Field IDs must be at least 1 character + long and at most 128 characters long. Field IDs must also be unique + within their template. + tag_template_field (Union[dict, ~google.cloud.datacatalog_v1.types.TagTemplateField]): Required. The tag template field to create. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.TagTemplateField` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.TagTemplateField` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "create_tag_template_field" not in self._inner_api_calls: + self._inner_api_calls[ + "create_tag_template_field" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.create_tag_template_field, + default_retry=self._method_configs["CreateTagTemplateField"].retry, + default_timeout=self._method_configs["CreateTagTemplateField"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.CreateTagTemplateFieldRequest( + parent=parent, + tag_template_field_id=tag_template_field_id, + tag_template_field=tag_template_field, + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["create_tag_template_field"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def update_tag_template_field( + self, + name, + tag_template_field, + update_mask=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Updates a field in a tag template. This method cannot be used to + update the field type. Users should enable the Data Catalog API in the + project identified by the ``name`` parameter (see [Data Catalog Resource + Project] (/data-catalog/docs/concepts/resource-project) for more + information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.tag_template_field_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]', '[FIELD]') + >>> + >>> # TODO: Initialize `tag_template_field`: + >>> tag_template_field = {} + >>> + >>> response = client.update_tag_template_field(name, tag_template_field) + + Args: + name (str): Required. The name of the tag template field. Example: + + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + tag_template_field (Union[dict, ~google.cloud.datacatalog_v1.types.TagTemplateField]): Required. The template to update. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.TagTemplateField` + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): Optional. The field mask specifies the parts of the template to be + updated. Allowed fields: + + - ``display_name`` + - ``type.enum_type`` + - ``is_required`` + + If ``update_mask`` is not set or empty, all of the allowed fields above + will be updated. + + When updating an enum type, the provided values will be merged with the + existing values. Therefore, enum values can only be added, existing enum + values cannot be deleted nor renamed. Updating a template field from + optional to required is NOT allowed. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.FieldMask` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.TagTemplateField` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "update_tag_template_field" not in self._inner_api_calls: + self._inner_api_calls[ + "update_tag_template_field" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.update_tag_template_field, + default_retry=self._method_configs["UpdateTagTemplateField"].retry, + default_timeout=self._method_configs["UpdateTagTemplateField"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.UpdateTagTemplateFieldRequest( + name=name, tag_template_field=tag_template_field, update_mask=update_mask + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["update_tag_template_field"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def rename_tag_template_field( + self, + name, + new_tag_template_field_id, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Renames a field in a tag template. The user should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + `Data Catalog Resource + Project `__ + for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.tag_template_field_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]', '[FIELD]') + >>> + >>> # TODO: Initialize `new_tag_template_field_id`: + >>> new_tag_template_field_id = '' + >>> + >>> response = client.rename_tag_template_field(name, new_tag_template_field_id) + + Args: + name (str): Required. The name of the tag template. Example: + + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + new_tag_template_field_id (str): Required. The new ID of this tag template field. For example, + ``my_new_field``. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.TagTemplateField` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "rename_tag_template_field" not in self._inner_api_calls: + self._inner_api_calls[ + "rename_tag_template_field" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.rename_tag_template_field, + default_retry=self._method_configs["RenameTagTemplateField"].retry, + default_timeout=self._method_configs["RenameTagTemplateField"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.RenameTagTemplateFieldRequest( + name=name, new_tag_template_field_id=new_tag_template_field_id + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["rename_tag_template_field"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def delete_tag_template_field( + self, + name, + force, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Deletes a field in a tag template and all uses of that field. Users + should enable the Data Catalog API in the project identified by the + ``name`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.tag_template_field_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]', '[FIELD]') + >>> + >>> # TODO: Initialize `force`: + >>> force = False + >>> + >>> client.delete_tag_template_field(name, force) + + Args: + name (str): Required. The name of the tag template field to delete. Example: + + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + force (bool): Required. Currently, this field must always be set to ``true``. This + confirms the deletion of this field from any tags using this field. + ``force = false`` will be supported in the future. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "delete_tag_template_field" not in self._inner_api_calls: + self._inner_api_calls[ + "delete_tag_template_field" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.delete_tag_template_field, + default_retry=self._method_configs["DeleteTagTemplateField"].retry, + default_timeout=self._method_configs["DeleteTagTemplateField"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.DeleteTagTemplateFieldRequest(name=name, force=force) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + self._inner_api_calls["delete_tag_template_field"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def create_tag( + self, + parent, + tag, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Creates a tag on an ``Entry``. Note: The project identified by the + ``parent`` parameter for the + `tag `__ + and the `tag + template `__ + used to create the tag must be from the same organization. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.tag_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]', '[TAG]') + >>> + >>> # TODO: Initialize `tag`: + >>> tag = {} + >>> + >>> response = client.create_tag(parent, tag) + + Args: + parent (str): Required. The name of the resource to attach this tag to. Tags can + be attached to Entries. Example: + + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + + Note that this Tag and its child resources may not actually be stored in + the location in this name. + tag (Union[dict, ~google.cloud.datacatalog_v1.types.Tag]): Required. The tag to create. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.Tag` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Tag` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "create_tag" not in self._inner_api_calls: + self._inner_api_calls[ + "create_tag" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.create_tag, + default_retry=self._method_configs["CreateTag"].retry, + default_timeout=self._method_configs["CreateTag"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.CreateTagRequest(parent=parent, tag=tag) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["create_tag"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def update_tag( + self, + tag, + update_mask=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Updates an existing tag. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `tag`: + >>> tag = {} + >>> + >>> response = client.update_tag(tag) + + Args: + tag (Union[dict, ~google.cloud.datacatalog_v1.types.Tag]): Required. The updated tag. The "name" field must be set. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.Tag` + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to update on the Tag. If absent or empty, all modifiable + fields are updated. Currently the only modifiable field is the field + ``fields``. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.FieldMask` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Tag` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "update_tag" not in self._inner_api_calls: + self._inner_api_calls[ + "update_tag" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.update_tag, + default_retry=self._method_configs["UpdateTag"].retry, + default_timeout=self._method_configs["UpdateTag"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.UpdateTagRequest(tag=tag, update_mask=update_mask) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("tag.name", tag.name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["update_tag"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def delete_tag( + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Deletes a tag. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> name = client.entry_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]') + >>> + >>> client.delete_tag(name) + + Args: + name (str): Required. The name of the tag to delete. Example: + + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "delete_tag" not in self._inner_api_calls: + self._inner_api_calls[ + "delete_tag" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.delete_tag, + default_retry=self._method_configs["DeleteTag"].retry, + default_timeout=self._method_configs["DeleteTag"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.DeleteTagRequest(name=name) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("name", name)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + self._inner_api_calls["delete_tag"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def list_tags( + self, + parent, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Lists the tags on an ``Entry``. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> parent = client.entry_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]') + >>> + >>> # Iterate over all results + >>> for element in client.list_tags(parent): + ... # process element + ... pass + >>> + >>> + >>> # Alternatively: + >>> + >>> # Iterate over results one page at a time + >>> for page in client.list_tags(parent).pages: + ... for element in page: + ... # process element + ... pass + + Args: + parent (str): Required. The name of the Data Catalog resource to list the tags of. + The resource could be an ``Entry`` or an ``EntryGroup``. + + Examples: + + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + page_size (int): The maximum number of resources contained in the + underlying API response. If page streaming is performed per- + resource, this parameter does not affect the return value. If page + streaming is performed per-page, this determines the maximum number + of resources in a page. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.api_core.page_iterator.PageIterator` instance. + An iterable of :class:`~google.cloud.datacatalog_v1.types.Tag` instances. + You can also iterate over the pages of the response + using its `pages` property. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "list_tags" not in self._inner_api_calls: + self._inner_api_calls[ + "list_tags" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.list_tags, + default_retry=self._method_configs["ListTags"].retry, + default_timeout=self._method_configs["ListTags"].timeout, + client_info=self._client_info, + ) + + request = datacatalog_pb2.ListTagsRequest(parent=parent, page_size=page_size) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + iterator = google.api_core.page_iterator.GRPCIterator( + client=None, + method=functools.partial( + self._inner_api_calls["list_tags"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), + request=request, + items_field="tags", + request_token_field="page_token", + response_token_field="next_page_token", + ) + return iterator + + def set_iam_policy( + self, + resource, + policy, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Sets the access control policy for a resource. Replaces any existing + policy. Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Pub/Sub and any external Google Cloud Platform resources + synced to Data Catalog. + + Callers must have following Google IAM permission + + - ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag + templates. + - ``datacatalog.entries.setIamPolicy`` to set policies on entries. + - ``datacatalog.entryGroups.setIamPolicy`` to set policies on entry + groups. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `resource`: + >>> resource = '' + >>> + >>> # TODO: Initialize `policy`: + >>> policy = {} + >>> + >>> response = client.set_iam_policy(resource, policy) + + Args: + resource (str): REQUIRED: The resource for which the policy is being specified. + See the operation documentation for the appropriate value for this field. + policy (Union[dict, ~google.cloud.datacatalog_v1.types.Policy]): REQUIRED: The complete policy to be applied to the ``resource``. The + size of the policy is limited to a few 10s of KB. An empty policy is a + valid policy but certain Cloud Platform services (such as Projects) + might reject them. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.Policy` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Policy` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "set_iam_policy" not in self._inner_api_calls: + self._inner_api_calls[ + "set_iam_policy" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.set_iam_policy, + default_retry=self._method_configs["SetIamPolicy"].retry, + default_timeout=self._method_configs["SetIamPolicy"].timeout, + client_info=self._client_info, + ) + + request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("resource", resource)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["set_iam_policy"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def get_iam_policy( + self, + resource, + options_=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Gets the access control policy for a resource. A ``NOT_FOUND`` error + is returned if the resource does not exist. An empty policy is returned + if the resource exists but does not have a policy set on it. + + Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Pub/Sub and any external Google Cloud Platform resources + synced to Data Catalog. + + Callers must have following Google IAM permission + + - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag + templates. + - ``datacatalog.entries.getIamPolicy`` to get policies on entries. + - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry + groups. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `resource`: + >>> resource = '' + >>> + >>> response = client.get_iam_policy(resource) + + Args: + resource (str): REQUIRED: The resource for which the policy is being requested. + See the operation documentation for the appropriate value for this field. + options_ (Union[dict, ~google.cloud.datacatalog_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to + ``GetIamPolicy``. This field is only used by Cloud IAM. + + If a dict is provided, it must be of the same form as the protobuf + message :class:`~google.cloud.datacatalog_v1.types.GetPolicyOptions` + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.Policy` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "get_iam_policy" not in self._inner_api_calls: + self._inner_api_calls[ + "get_iam_policy" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.get_iam_policy, + default_retry=self._method_configs["GetIamPolicy"].retry, + default_timeout=self._method_configs["GetIamPolicy"].timeout, + client_info=self._client_info, + ) + + request = iam_policy_pb2.GetIamPolicyRequest( + resource=resource, options=options_ + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("resource", resource)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["get_iam_policy"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) + + def test_iam_permissions( + self, + resource, + permissions, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Returns the caller's permissions on a resource. If the resource does + not exist, an empty set of permissions is returned (We don't return a + ``NOT_FOUND`` error). + + Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Pub/Sub and any external Google Cloud Platform resources + synced to Data Catalog. + + A caller is not required to have Google IAM permission to make this + request. + + Example: + >>> from google.cloud import datacatalog_v1 + >>> + >>> client = datacatalog_v1.DataCatalogClient() + >>> + >>> # TODO: Initialize `resource`: + >>> resource = '' + >>> + >>> # TODO: Initialize `permissions`: + >>> permissions = [] + >>> + >>> response = client.test_iam_permissions(resource, permissions) + + Args: + resource (str): REQUIRED: The resource for which the policy detail is being requested. + See the operation documentation for the appropriate value for this field. + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more + information see `IAM + Overview `__. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.cloud.datacatalog_v1.types.TestIamPermissionsResponse` instance. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "test_iam_permissions" not in self._inner_api_calls: + self._inner_api_calls[ + "test_iam_permissions" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.test_iam_permissions, + default_retry=self._method_configs["TestIamPermissions"].retry, + default_timeout=self._method_configs["TestIamPermissions"].timeout, + client_info=self._client_info, + ) + + request = iam_policy_pb2.TestIamPermissionsRequest( + resource=resource, permissions=permissions + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("resource", resource)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + return self._inner_api_calls["test_iam_permissions"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) diff --git a/google/cloud/datacatalog_v1/gapic/data_catalog_client_config.py b/google/cloud/datacatalog_v1/gapic/data_catalog_client_config.py new file mode 100644 index 00000000..2f91f586 --- /dev/null +++ b/google/cloud/datacatalog_v1/gapic/data_catalog_client_config.py @@ -0,0 +1,158 @@ +config = { + "interfaces": { + "google.cloud.datacatalog.v1.DataCatalog": { + "retry_codes": { + "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"], + "non_idempotent": [], + }, + "retry_params": { + "default": { + "initial_retry_delay_millis": 100, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 60000, + "initial_rpc_timeout_millis": 20000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 20000, + "total_timeout_millis": 600000, + } + }, + "methods": { + "SearchCatalog": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "CreateEntryGroup": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "GetEntryGroup": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, + "UpdateEntryGroup": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "DeleteEntryGroup": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "ListEntryGroups": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, + "CreateEntry": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "UpdateEntry": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "DeleteEntry": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "GetEntry": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, + "LookupEntry": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, + "ListEntries": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, + "CreateTagTemplate": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "GetTagTemplate": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, + "UpdateTagTemplate": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "DeleteTagTemplate": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "CreateTagTemplateField": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "UpdateTagTemplateField": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "RenameTagTemplateField": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "DeleteTagTemplateField": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "CreateTag": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "UpdateTag": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "DeleteTag": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "ListTags": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, + "SetIamPolicy": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "GetIamPolicy": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + "TestIamPermissions": { + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", + "retry_params_name": "default", + }, + }, + } + } +} diff --git a/google/cloud/datacatalog_v1/gapic/enums.py b/google/cloud/datacatalog_v1/gapic/enums.py new file mode 100644 index 00000000..b5c584ba --- /dev/null +++ b/google/cloud/datacatalog_v1/gapic/enums.py @@ -0,0 +1,110 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + +"""Wrappers for protocol buffer enum types.""" + +import enum + + +class EntryType(enum.IntEnum): + """ + Entry resources in Data Catalog can be of different types e.g. a + BigQuery Table entry is of type ``TABLE``. This enum describes all the + possible types Data Catalog contains. + + Attributes: + ENTRY_TYPE_UNSPECIFIED (int): Default unknown type. + TABLE (int): Output only. The type of entry that has a GoogleSQL schema, including + logical views. + MODEL (int): Output only. The type of models, examples include + https://cloud.google.com/bigquery-ml/docs/bigqueryml-intro + DATA_STREAM (int): Output only. An entry type which is used for streaming entries. Example: + Pub/Sub topic. + FILESET (int): An entry type which is a set of files or objects. Example: + Cloud Storage fileset. + """ + + ENTRY_TYPE_UNSPECIFIED = 0 + TABLE = 2 + MODEL = 5 + DATA_STREAM = 3 + FILESET = 4 + + +class IntegratedSystem(enum.IntEnum): + """ + This enum describes all the possible systems that Data Catalog integrates + with. + + Attributes: + INTEGRATED_SYSTEM_UNSPECIFIED (int): Default unknown system. + BIGQUERY (int): BigQuery. + CLOUD_PUBSUB (int): Cloud Pub/Sub. + """ + + INTEGRATED_SYSTEM_UNSPECIFIED = 0 + BIGQUERY = 1 + CLOUD_PUBSUB = 2 + + +class SearchResultType(enum.IntEnum): + """ + The different types of resources that can be returned in search. + + Attributes: + SEARCH_RESULT_TYPE_UNSPECIFIED (int): Default unknown type. + ENTRY (int): An ``Entry``. + TAG_TEMPLATE (int): A ``TagTemplate``. + ENTRY_GROUP (int): An ``EntryGroup``. + """ + + SEARCH_RESULT_TYPE_UNSPECIFIED = 0 + ENTRY = 1 + TAG_TEMPLATE = 2 + ENTRY_GROUP = 3 + + +class TableSourceType(enum.IntEnum): + """ + Table source type. + + Attributes: + TABLE_SOURCE_TYPE_UNSPECIFIED (int): Default unknown type. + BIGQUERY_VIEW (int): Table view. + BIGQUERY_TABLE (int): BigQuery native table. + """ + + TABLE_SOURCE_TYPE_UNSPECIFIED = 0 + BIGQUERY_VIEW = 2 + BIGQUERY_TABLE = 5 + + +class FieldType(object): + class PrimitiveType(enum.IntEnum): + """ + Attributes: + PRIMITIVE_TYPE_UNSPECIFIED (int): This is the default invalid value for a type. + DOUBLE (int): A double precision number. + STRING (int): An UTF-8 string. + BOOL (int): A boolean value. + TIMESTAMP (int): A timestamp. + """ + + PRIMITIVE_TYPE_UNSPECIFIED = 0 + DOUBLE = 1 + STRING = 2 + BOOL = 3 + TIMESTAMP = 4 diff --git a/google/cloud/datacatalog_v1/gapic/transports/__init__.py b/google/cloud/datacatalog_v1/gapic/transports/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py b/google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py new file mode 100644 index 00000000..0f626a90 --- /dev/null +++ b/google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py @@ -0,0 +1,593 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + + +import google.api_core.grpc_helpers + +from google.cloud.datacatalog_v1.proto import datacatalog_pb2_grpc + + +class DataCatalogGrpcTransport(object): + """gRPC transport class providing stubs for + google.cloud.datacatalog.v1 DataCatalog API. + + The transport provides access to the raw gRPC stubs, + which can be used to take advantage of advanced + features of gRPC. + """ + + # The scopes needed to make gRPC calls to all of the methods defined + # in this service. + _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",) + + def __init__( + self, channel=None, credentials=None, address="datacatalog.googleapis.com:443" + ): + """Instantiate the transport class. + + Args: + channel (grpc.Channel): A ``Channel`` instance through + which to make calls. This argument is mutually exclusive + with ``credentials``; providing both will raise an exception. + credentials (google.auth.credentials.Credentials): The + authorization credentials to attach to requests. These + credentials identify this application to the service. If none + are specified, the client will attempt to ascertain the + credentials from the environment. + address (str): The address where the service is hosted. + """ + # If both `channel` and `credentials` are specified, raise an + # exception (channels come with credentials baked in already). + if channel is not None and credentials is not None: + raise ValueError( + "The `channel` and `credentials` arguments are mutually " "exclusive." + ) + + # Create the channel. + if channel is None: + channel = self.create_channel( + address=address, + credentials=credentials, + options={ + "grpc.max_send_message_length": -1, + "grpc.max_receive_message_length": -1, + }.items(), + ) + + self._channel = channel + + # gRPC uses objects called "stubs" that are bound to the + # channel and provide a basic method for each RPC. + self._stubs = { + "data_catalog_stub": datacatalog_pb2_grpc.DataCatalogStub(channel) + } + + @classmethod + def create_channel( + cls, address="datacatalog.googleapis.com:443", credentials=None, **kwargs + ): + """Create and return a gRPC channel object. + + Args: + address (str): The host for the channel to use. + credentials (~.Credentials): The + authorization credentials to attach to requests. These + credentials identify this application to the service. If + none are specified, the client will attempt to ascertain + the credentials from the environment. + kwargs (dict): Keyword arguments, which are passed to the + channel creation. + + Returns: + grpc.Channel: A gRPC channel object. + """ + return google.api_core.grpc_helpers.create_channel( + address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs + ) + + @property + def channel(self): + """The gRPC channel used by the transport. + + Returns: + grpc.Channel: A gRPC channel object. + """ + return self._channel + + @property + def search_catalog(self): + """Return the gRPC stub for :meth:`DataCatalogClient.search_catalog`. + + Searches Data Catalog for multiple resources like entries, tags that + match a query. + + This is a custom method + (https://cloud.google.com/apis/design/custom_methods) and does not + return the complete resource, only the resource identifier and high + level fields. Clients can subsequentally call ``Get`` methods. + + Note that Data Catalog search queries do not guarantee full recall. + Query results that match your query may not be returned, even in + subsequent result pages. Also note that results returned (and not + returned) can vary across repeated search queries. + + See `Data Catalog Search + Syntax `__ + for more information. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].SearchCatalog + + @property + def create_entry_group(self): + """Return the gRPC stub for :meth:`DataCatalogClient.create_entry_group`. + + Creates an EntryGroup. + + An entry group contains logically related entries together with Cloud + Identity and Access Management policies that specify the users who can + create, edit, and view entries within the entry group. + + Data Catalog automatically creates an entry group for BigQuery entries + ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own + entry group to contain Cloud Storage fileset entries or custom type + entries, and the IAM policies associated with those entries. Entry + groups, like entries, can be searched. + + A maximum of 10,000 entry groups may be created per organization across + all locations. + + Users should enable the Data Catalog API in the project identified by + the ``parent`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].CreateEntryGroup + + @property + def get_entry_group(self): + """Return the gRPC stub for :meth:`DataCatalogClient.get_entry_group`. + + Gets an EntryGroup. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].GetEntryGroup + + @property + def update_entry_group(self): + """Return the gRPC stub for :meth:`DataCatalogClient.update_entry_group`. + + Updates an EntryGroup. The user should enable the Data Catalog API + in the project identified by the ``entry_group.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].UpdateEntryGroup + + @property + def delete_entry_group(self): + """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry_group`. + + Deletes an EntryGroup. Only entry groups that do not contain entries + can be deleted. Users should enable the Data Catalog API in the project + identified by the ``name`` parameter (see [Data Catalog Resource + Project] (/data-catalog/docs/concepts/resource-project) for more + information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].DeleteEntryGroup + + @property + def list_entry_groups(self): + """Return the gRPC stub for :meth:`DataCatalogClient.list_entry_groups`. + + Lists entry groups. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].ListEntryGroups + + @property + def create_entry(self): + """Return the gRPC stub for :meth:`DataCatalogClient.create_entry`. + + Creates an entry. Only entries of 'FILESET' type or user-specified + type can be created. + + Users should enable the Data Catalog API in the project identified by + the ``parent`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + A maximum of 100,000 entries may be created per entry group. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].CreateEntry + + @property + def update_entry(self): + """Return the gRPC stub for :meth:`DataCatalogClient.update_entry`. + + Updates an existing entry. Users should enable the Data Catalog API + in the project identified by the ``entry.name`` parameter (see [Data + Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) + for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].UpdateEntry + + @property + def delete_entry(self): + """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry`. + + Deletes an existing entry. Only entries created through + ``CreateEntry`` method can be deleted. Users should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].DeleteEntry + + @property + def get_entry(self): + """Return the gRPC stub for :meth:`DataCatalogClient.get_entry`. + + Gets an entry. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].GetEntry + + @property + def lookup_entry(self): + """Return the gRPC stub for :meth:`DataCatalogClient.lookup_entry`. + + Get an entry by target resource name. This method allows clients to use + the resource name from the source Google Cloud Platform service to get the + Data Catalog Entry. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].LookupEntry + + @property + def list_entries(self): + """Return the gRPC stub for :meth:`DataCatalogClient.list_entries`. + + Lists entries. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].ListEntries + + @property + def create_tag_template(self): + """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template`. + + Creates a tag template. The user should enable the Data Catalog API + in the project identified by the ``parent`` parameter (see `Data Catalog + Resource + Project `__ + for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].CreateTagTemplate + + @property + def get_tag_template(self): + """Return the gRPC stub for :meth:`DataCatalogClient.get_tag_template`. + + Gets a tag template. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].GetTagTemplate + + @property + def update_tag_template(self): + """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template`. + + Updates a tag template. This method cannot be used to update the + fields of a template. The tag template fields are represented as + separate resources and should be updated using their own + create/update/delete methods. Users should enable the Data Catalog API + in the project identified by the ``tag_template.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].UpdateTagTemplate + + @property + def delete_tag_template(self): + """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template`. + + Deletes a tag template and all tags using the template. Users should + enable the Data Catalog API in the project identified by the ``name`` + parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].DeleteTagTemplate + + @property + def create_tag_template_field(self): + """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template_field`. + + Creates a field in a tag template. The user should enable the Data + Catalog API in the project identified by the ``parent`` parameter (see + `Data Catalog Resource + Project `__ + for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].CreateTagTemplateField + + @property + def update_tag_template_field(self): + """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template_field`. + + Updates a field in a tag template. This method cannot be used to + update the field type. Users should enable the Data Catalog API in the + project identified by the ``name`` parameter (see [Data Catalog Resource + Project] (/data-catalog/docs/concepts/resource-project) for more + information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].UpdateTagTemplateField + + @property + def rename_tag_template_field(self): + """Return the gRPC stub for :meth:`DataCatalogClient.rename_tag_template_field`. + + Renames a field in a tag template. The user should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + `Data Catalog Resource + Project `__ + for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].RenameTagTemplateField + + @property + def delete_tag_template_field(self): + """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template_field`. + + Deletes a field in a tag template and all uses of that field. Users + should enable the Data Catalog API in the project identified by the + ``name`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].DeleteTagTemplateField + + @property + def create_tag(self): + """Return the gRPC stub for :meth:`DataCatalogClient.create_tag`. + + Creates a tag on an ``Entry``. Note: The project identified by the + ``parent`` parameter for the + `tag `__ + and the `tag + template `__ + used to create the tag must be from the same organization. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].CreateTag + + @property + def update_tag(self): + """Return the gRPC stub for :meth:`DataCatalogClient.update_tag`. + + Updates an existing tag. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].UpdateTag + + @property + def delete_tag(self): + """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag`. + + Deletes a tag. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].DeleteTag + + @property + def list_tags(self): + """Return the gRPC stub for :meth:`DataCatalogClient.list_tags`. + + Lists the tags on an ``Entry``. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].ListTags + + @property + def set_iam_policy(self): + """Return the gRPC stub for :meth:`DataCatalogClient.set_iam_policy`. + + Sets the access control policy for a resource. Replaces any existing + policy. Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Pub/Sub and any external Google Cloud Platform resources + synced to Data Catalog. + + Callers must have following Google IAM permission + + - ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag + templates. + - ``datacatalog.entries.setIamPolicy`` to set policies on entries. + - ``datacatalog.entryGroups.setIamPolicy`` to set policies on entry + groups. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].SetIamPolicy + + @property + def get_iam_policy(self): + """Return the gRPC stub for :meth:`DataCatalogClient.get_iam_policy`. + + Gets the access control policy for a resource. A ``NOT_FOUND`` error + is returned if the resource does not exist. An empty policy is returned + if the resource exists but does not have a policy set on it. + + Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Pub/Sub and any external Google Cloud Platform resources + synced to Data Catalog. + + Callers must have following Google IAM permission + + - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag + templates. + - ``datacatalog.entries.getIamPolicy`` to get policies on entries. + - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry + groups. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].GetIamPolicy + + @property + def test_iam_permissions(self): + """Return the gRPC stub for :meth:`DataCatalogClient.test_iam_permissions`. + + Returns the caller's permissions on a resource. If the resource does + not exist, an empty set of permissions is returned (We don't return a + ``NOT_FOUND`` error). + + Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Pub/Sub and any external Google Cloud Platform resources + synced to Data Catalog. + + A caller is not required to have Google IAM permission to make this + request. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["data_catalog_stub"].TestIamPermissions diff --git a/google/cloud/datacatalog_v1/proto/__init__.py b/google/cloud/datacatalog_v1/proto/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/google/cloud/datacatalog_v1/proto/common_pb2.py b/google/cloud/datacatalog_v1/proto/common_pb2.py new file mode 100644 index 00000000..805f2327 --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/common_pb2.py @@ -0,0 +1,62 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/common.proto + +from google.protobuf.internal import enum_type_wrapper +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/common.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b"\n.google/cloud/datacatalog_v1/proto/common.proto\x12\x1bgoogle.cloud.datacatalog.v1*U\n\x10IntegratedSystem\x12!\n\x1dINTEGRATED_SYSTEM_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x42IGQUERY\x10\x01\x12\x10\n\x0c\x43LOUD_PUBSUB\x10\x02\x42\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3", +) + +_INTEGRATEDSYSTEM = _descriptor.EnumDescriptor( + name="IntegratedSystem", + full_name="google.cloud.datacatalog.v1.IntegratedSystem", + filename=None, + file=DESCRIPTOR, + values=[ + _descriptor.EnumValueDescriptor( + name="INTEGRATED_SYSTEM_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + ), + _descriptor.EnumValueDescriptor( + name="BIGQUERY", index=1, number=1, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="CLOUD_PUBSUB", index=2, number=2, serialized_options=None, type=None + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=79, + serialized_end=164, +) +_sym_db.RegisterEnumDescriptor(_INTEGRATEDSYSTEM) + +IntegratedSystem = enum_type_wrapper.EnumTypeWrapper(_INTEGRATEDSYSTEM) +INTEGRATED_SYSTEM_UNSPECIFIED = 0 +BIGQUERY = 1 +CLOUD_PUBSUB = 2 + + +DESCRIPTOR.enum_types_by_name["IntegratedSystem"] = _INTEGRATEDSYSTEM +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + + +DESCRIPTOR._options = None +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/common_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/common_pb2_grpc.py new file mode 100644 index 00000000..07cb78fe --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/common_pb2_grpc.py @@ -0,0 +1,2 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc diff --git a/google/cloud/datacatalog_v1/proto/datacatalog_pb2.py b/google/cloud/datacatalog_v1/proto/datacatalog_pb2.py new file mode 100644 index 00000000..8c9990e5 --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/datacatalog_pb2.py @@ -0,0 +1,3708 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/datacatalog.proto + +from google.protobuf.internal import enum_type_wrapper +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 +from google.cloud.datacatalog_v1.proto import ( + common_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_common__pb2, +) +from google.cloud.datacatalog_v1.proto import ( + gcs_fileset_spec_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_gcs__fileset__spec__pb2, +) +from google.cloud.datacatalog_v1.proto import ( + schema_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_schema__pb2, +) +from google.cloud.datacatalog_v1.proto import ( + search_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_search__pb2, +) +from google.cloud.datacatalog_v1.proto import ( + table_spec_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_table__spec__pb2, +) +from google.cloud.datacatalog_v1.proto import ( + tags_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2, +) +from google.cloud.datacatalog_v1.proto import ( + timestamps_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_timestamps__pb2, +) +from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2 +from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2 +from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 +from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/datacatalog.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b'\n3google/cloud/datacatalog_v1/proto/datacatalog.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a.google/cloud/datacatalog_v1/proto/common.proto\x1a\x38google/cloud/datacatalog_v1/proto/gcs_fileset_spec.proto\x1a.google/cloud/datacatalog_v1/proto/schema.proto\x1a.google/cloud/datacatalog_v1/proto/search.proto\x1a\x32google/cloud/datacatalog_v1/proto/table_spec.proto\x1a,google/cloud/datacatalog_v1/proto/tags.proto\x1a\x32google/cloud/datacatalog_v1/proto/timestamps.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x99\x02\n\x14SearchCatalogRequest\x12K\n\x05scope\x18\x06 \x01(\x0b\x32\x37.google.cloud.datacatalog.v1.SearchCatalogRequest.ScopeB\x03\xe0\x41\x02\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x10\n\x08order_by\x18\x05 \x01(\t\x1a\x62\n\x05Scope\x12\x17\n\x0finclude_org_ids\x18\x02 \x03(\t\x12\x1b\n\x13include_project_ids\x18\x03 \x03(\t\x12#\n\x1binclude_gcp_public_datasets\x18\x07 \x01(\x08"s\n\x15SearchCatalogResponse\x12\x41\n\x07results\x18\x01 \x03(\x0b\x32\x30.google.cloud.datacatalog.v1.SearchCatalogResult\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"\xb3\x01\n\x17\x43reateEntryGroupRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\x12%datacatalog.googleapis.com/EntryGroup\x12\x1b\n\x0e\x65ntry_group_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12<\n\x0b\x65ntry_group\x18\x02 \x01(\x0b\x32\'.google.cloud.datacatalog.v1.EntryGroup"\x8d\x01\n\x17UpdateEntryGroupRequest\x12\x41\n\x0b\x65ntry_group\x18\x01 \x01(\x0b\x32\'.google.cloud.datacatalog.v1.EntryGroupB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x82\x01\n\x14GetEntryGroupRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12-\n\tread_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"j\n\x17\x44\x65leteEntryGroupRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x01"\x88\x01\n\x16ListEntryGroupsRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01"q\n\x17ListEntryGroupsResponse\x12=\n\x0c\x65ntry_groups\x18\x01 \x03(\x0b\x32\'.google.cloud.datacatalog.v1.EntryGroup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa2\x01\n\x12\x43reateEntryRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x15\n\x08\x65ntry_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\x36\n\x05\x65ntry\x18\x02 \x01(\x0b\x32".google.cloud.datacatalog.v1.EntryB\x03\xe0\x41\x02"}\n\x12UpdateEntryRequest\x12\x36\n\x05\x65ntry\x18\x01 \x01(\x0b\x32".google.cloud.datacatalog.v1.EntryB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"L\n\x12\x44\x65leteEntryRequest\x12\x36\n\x04name\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41"\n datacatalog.googleapis.com/Entry"I\n\x0fGetEntryRequest\x12\x36\n\x04name\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41"\n datacatalog.googleapis.com/Entry"V\n\x12LookupEntryRequest\x12\x19\n\x0flinked_resource\x18\x01 \x01(\tH\x00\x12\x16\n\x0csql_resource\x18\x03 \x01(\tH\x00\x42\r\n\x0btarget_name"\xe7\x06\n\x05\x45ntry\x12\x38\n\x04name\x18\x01 \x01(\tB*\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x17\n\x0flinked_resource\x18\t \x01(\t\x12\x36\n\x04type\x18\x02 \x01(\x0e\x32&.google.cloud.datacatalog.v1.EntryTypeH\x00\x12\x1d\n\x13user_specified_type\x18\x10 \x01(\tH\x00\x12O\n\x11integrated_system\x18\x11 \x01(\x0e\x32-.google.cloud.datacatalog.v1.IntegratedSystemB\x03\xe0\x41\x03H\x01\x12\x1f\n\x15user_specified_system\x18\x12 \x01(\tH\x01\x12G\n\x10gcs_fileset_spec\x18\x06 \x01(\x0b\x32+.google.cloud.datacatalog.v1.GcsFilesetSpecH\x02\x12M\n\x13\x62igquery_table_spec\x18\x0c \x01(\x0b\x32..google.cloud.datacatalog.v1.BigQueryTableSpecH\x02\x12Z\n\x1a\x62igquery_date_sharded_spec\x18\x0f \x01(\x0b\x32\x34.google.cloud.datacatalog.v1.BigQueryDateShardedSpecH\x02\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x33\n\x06schema\x18\x05 \x01(\x0b\x32#.google.cloud.datacatalog.v1.Schema\x12O\n\x18source_system_timestamps\x18\x07 \x01(\x0b\x32-.google.cloud.datacatalog.v1.SystemTimestamps:x\xea\x41u\n datacatalog.googleapis.com/Entry\x12Qprojects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}B\x0c\n\nentry_typeB\x08\n\x06systemB\x0b\n\ttype_spec"\x89\x02\n\nEntryGroup\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12S\n\x17\x64\x61ta_catalog_timestamps\x18\x04 \x01(\x0b\x32-.google.cloud.datacatalog.v1.SystemTimestampsB\x03\xe0\x41\x03:m\xea\x41j\n%datacatalog.googleapis.com/EntryGroup\x12\x41projects/{project}/locations/{location}/entryGroups/{entry_group}"\xbd\x01\n\x18\x43reateTagTemplateRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\x12&datacatalog.googleapis.com/TagTemplate\x12\x1c\n\x0ftag_template_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\x43\n\x0ctag_template\x18\x02 \x01(\x0b\x32(.google.cloud.datacatalog.v1.TagTemplateB\x03\xe0\x41\x02"U\n\x15GetTagTemplateRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate"\x90\x01\n\x18UpdateTagTemplateRequest\x12\x43\n\x0ctag_template\x18\x01 \x01(\x0b\x32(.google.cloud.datacatalog.v1.TagTemplateB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"l\n\x18\x44\x65leteTagTemplateRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02"~\n\x10\x43reateTagRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\x32\n\x03tag\x18\x02 \x01(\x0b\x32 .google.cloud.datacatalog.v1.TagB\x03\xe0\x41\x02"w\n\x10UpdateTagRequest\x12\x32\n\x03tag\x18\x01 \x01(\x0b\x32 .google.cloud.datacatalog.v1.TagB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"H\n\x10\x44\x65leteTagRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x64\x61tacatalog.googleapis.com/Tag"\xd3\x01\n\x1d\x43reateTagTemplateFieldRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate\x12"\n\x15tag_template_field_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12N\n\x12tag_template_field\x18\x03 \x01(\x0b\x32-.google.cloud.datacatalog.v1.TagTemplateFieldB\x03\xe0\x41\x02"\xe8\x01\n\x1dUpdateTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12N\n\x12tag_template_field\x18\x02 \x01(\x0b\x32-.google.cloud.datacatalog.v1.TagTemplateFieldB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x01"\x8a\x01\n\x1dRenameTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12&\n\x19new_tag_template_field_id\x18\x02 \x01(\tB\x03\xe0\x41\x02"v\n\x1d\x44\x65leteTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02"p\n\x0fListTagsRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"[\n\x10ListTagsResponse\x12.\n\x04tags\x18\x01 \x03(\x0b\x32 .google.cloud.datacatalog.v1.Tag\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa9\x01\n\x12ListEntriesRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12-\n\tread_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"c\n\x13ListEntriesResponse\x12\x33\n\x07\x65ntries\x18\x01 \x03(\x0b\x32".google.cloud.datacatalog.v1.Entry\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t*[\n\tEntryType\x12\x1a\n\x16\x45NTRY_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05TABLE\x10\x02\x12\t\n\x05MODEL\x10\x05\x12\x0f\n\x0b\x44\x41TA_STREAM\x10\x03\x12\x0b\n\x07\x46ILESET\x10\x04\x32\x90/\n\x0b\x44\x61taCatalog\x12\xa3\x01\n\rSearchCatalog\x12\x31.google.cloud.datacatalog.v1.SearchCatalogRequest\x1a\x32.google.cloud.datacatalog.v1.SearchCatalogResponse"+\x82\xd3\xe4\x93\x02\x17"\x12/v1/catalog:search:\x01*\xda\x41\x0bscope,query\x12\xdb\x01\n\x10\x43reateEntryGroup\x12\x34.google.cloud.datacatalog.v1.CreateEntryGroupRequest\x1a\'.google.cloud.datacatalog.v1.EntryGroup"h\x82\xd3\xe4\x93\x02>"//v1/{parent=projects/*/locations/*}/entryGroups:\x0b\x65ntry_group\xda\x41!parent,entry_group_id,entry_group\x12\xbc\x01\n\rGetEntryGroup\x12\x31.google.cloud.datacatalog.v1.GetEntryGroupRequest\x1a\'.google.cloud.datacatalog.v1.EntryGroup"O\x82\xd3\xe4\x93\x02\x31\x12//v1/{name=projects/*/locations/*/entryGroups/*}\xda\x41\x04name\xda\x41\x0ename,read_mask\x12\xeb\x01\n\x10UpdateEntryGroup\x12\x34.google.cloud.datacatalog.v1.UpdateEntryGroupRequest\x1a\'.google.cloud.datacatalog.v1.EntryGroup"x\x82\xd3\xe4\x93\x02J2;/v1/{entry_group.name=projects/*/locations/*/entryGroups/*}:\x0b\x65ntry_group\xda\x41\x0b\x65ntry_group\xda\x41\x17\x65ntry_group,update_mask\x12\xa0\x01\n\x10\x44\x65leteEntryGroup\x12\x34.google.cloud.datacatalog.v1.DeleteEntryGroupRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v1/{name=projects/*/locations/*/entryGroups/*}\xda\x41\x04name\x12\xbe\x01\n\x0fListEntryGroups\x12\x33.google.cloud.datacatalog.v1.ListEntryGroupsRequest\x1a\x34.google.cloud.datacatalog.v1.ListEntryGroupsResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v1/{parent=projects/*/locations/*}/entryGroups\xda\x41\x06parent\x12\xc4\x01\n\x0b\x43reateEntry\x12/.google.cloud.datacatalog.v1.CreateEntryRequest\x1a".google.cloud.datacatalog.v1.Entry"`\x82\xd3\xe4\x93\x02\x42"9/v1/{parent=projects/*/locations/*/entryGroups/*}/entries:\x05\x65ntry\xda\x41\x15parent,entry_id,entry\x12\xce\x01\n\x0bUpdateEntry\x12/.google.cloud.datacatalog.v1.UpdateEntryRequest\x1a".google.cloud.datacatalog.v1.Entry"j\x82\xd3\xe4\x93\x02H2?/v1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\x05\x65ntry\xda\x41\x05\x65ntry\xda\x41\x11\x65ntry,update_mask\x12\xa0\x01\n\x0b\x44\x65leteEntry\x12/.google.cloud.datacatalog.v1.DeleteEntryRequest\x1a\x16.google.protobuf.Empty"H\x82\xd3\xe4\x93\x02;*9/v1/{name=projects/*/locations/*/entryGroups/*/entries/*}\xda\x41\x04name\x12\xa6\x01\n\x08GetEntry\x12,.google.cloud.datacatalog.v1.GetEntryRequest\x1a".google.cloud.datacatalog.v1.Entry"H\x82\xd3\xe4\x93\x02;\x12\x39/v1/{name=projects/*/locations/*/entryGroups/*/entries/*}\xda\x41\x04name\x12~\n\x0bLookupEntry\x12/.google.cloud.datacatalog.v1.LookupEntryRequest\x1a".google.cloud.datacatalog.v1.Entry"\x1a\x82\xd3\xe4\x93\x02\x14\x12\x12/v1/entries:lookup\x12\xbc\x01\n\x0bListEntries\x12/.google.cloud.datacatalog.v1.ListEntriesRequest\x1a\x30.google.cloud.datacatalog.v1.ListEntriesResponse"J\x82\xd3\xe4\x93\x02;\x12\x39/v1/{parent=projects/*/locations/*/entryGroups/*}/entries\xda\x41\x06parent\x12\xe2\x01\n\x11\x43reateTagTemplate\x12\x35.google.cloud.datacatalog.v1.CreateTagTemplateRequest\x1a(.google.cloud.datacatalog.v1.TagTemplate"l\x82\xd3\xe4\x93\x02@"0/v1/{parent=projects/*/locations/*}/tagTemplates:\x0ctag_template\xda\x41#parent,tag_template_id,tag_template\x12\xaf\x01\n\x0eGetTagTemplate\x12\x32.google.cloud.datacatalog.v1.GetTagTemplateRequest\x1a(.google.cloud.datacatalog.v1.TagTemplate"?\x82\xd3\xe4\x93\x02\x32\x12\x30/v1/{name=projects/*/locations/*/tagTemplates/*}\xda\x41\x04name\x12\xf3\x01\n\x11UpdateTagTemplate\x12\x35.google.cloud.datacatalog.v1.UpdateTagTemplateRequest\x1a(.google.cloud.datacatalog.v1.TagTemplate"}\x82\xd3\xe4\x93\x02M2=/v1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\x0ctag_template\xda\x41\x0ctag_template\xda\x41\x18tag_template,update_mask\x12\xa9\x01\n\x11\x44\x65leteTagTemplate\x12\x35.google.cloud.datacatalog.v1.DeleteTagTemplateRequest\x1a\x16.google.protobuf.Empty"E\x82\xd3\xe4\x93\x02\x32*0/v1/{name=projects/*/locations/*/tagTemplates/*}\xda\x41\nname,force\x12\x8d\x02\n\x16\x43reateTagTemplateField\x12:.google.cloud.datacatalog.v1.CreateTagTemplateFieldRequest\x1a-.google.cloud.datacatalog.v1.TagTemplateField"\x87\x01\x82\xd3\xe4\x93\x02O"9/v1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\x12tag_template_field\xda\x41/parent,tag_template_field_id,tag_template_field\x12\x9b\x02\n\x16UpdateTagTemplateField\x12:.google.cloud.datacatalog.v1.UpdateTagTemplateFieldRequest\x1a-.google.cloud.datacatalog.v1.TagTemplateField"\x95\x01\x82\xd3\xe4\x93\x02O29/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\x12tag_template_field\xda\x41\x17name,tag_template_field\xda\x41#name,tag_template_field,update_mask\x12\xf1\x01\n\x16RenameTagTemplateField\x12:.google.cloud.datacatalog.v1.RenameTagTemplateFieldRequest\x1a-.google.cloud.datacatalog.v1.TagTemplateField"l\x82\xd3\xe4\x93\x02\x45"@/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\x01*\xda\x41\x1ename,new_tag_template_field_id\x12\xbc\x01\n\x16\x44\x65leteTagTemplateField\x12:.google.cloud.datacatalog.v1.DeleteTagTemplateFieldRequest\x1a\x16.google.protobuf.Empty"N\x82\xd3\xe4\x93\x02;*9/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}\xda\x41\nname,force\x12\xf9\x01\n\tCreateTag\x12-.google.cloud.datacatalog.v1.CreateTagRequest\x1a .google.cloud.datacatalog.v1.Tag"\x9a\x01\x82\xd3\xe4\x93\x02\x86\x01"@/v1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\x03tagZ="6/v1/{parent=projects/*/locations/*/entryGroups/*}/tags:\x03tag\xda\x41\nparent,tag\x12\x8c\x02\n\tUpdateTag\x12-.google.cloud.datacatalog.v1.UpdateTagRequest\x1a .google.cloud.datacatalog.v1.Tag"\xad\x01\x82\xd3\xe4\x93\x02\x8e\x01\x32\x44/v1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\x03tagZA2:/v1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}:\x03tag\xda\x41\x03tag\xda\x41\x0ftag,update_mask\x12\xde\x01\n\tDeleteTag\x12-.google.cloud.datacatalog.v1.DeleteTagRequest\x1a\x16.google.protobuf.Empty"\x89\x01\x82\xd3\xe4\x93\x02|*@/v1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}Z8*6/v1/{name=projects/*/locations/*/entryGroups/*/tags/*}\xda\x41\x04name\x12\xf5\x01\n\x08ListTags\x12,.google.cloud.datacatalog.v1.ListTagsRequest\x1a-.google.cloud.datacatalog.v1.ListTagsResponse"\x8b\x01\x82\xd3\xe4\x93\x02|\x12@/v1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tagsZ8\x12\x36/v1/{parent=projects/*/locations/*/entryGroups/*}/tags\xda\x41\x06parent\x12\xe0\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x94\x01\x82\xd3\xe4\x93\x02\x8d\x01"A/v1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\x01*ZE"@/v1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy:\x01*\x12\xb1\x02\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\xe5\x01\x82\xd3\xe4\x93\x02\xde\x01"A/v1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\x01*ZE"@/v1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy:\x01*ZO"J/v1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy:\x01*\x12\xe3\x02\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"\xf7\x01\x82\xd3\xe4\x93\x02\xf0\x01"G/v1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\x01*ZK"F/v1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions:\x01*ZU"P/v1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions:\x01*\x1aN\xca\x41\x1a\x64\x61tacatalog.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3', + dependencies=[ + google_dot_api_dot_annotations__pb2.DESCRIPTOR, + google_dot_api_dot_client__pb2.DESCRIPTOR, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_common__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_gcs__fileset__spec__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_schema__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_search__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_table__spec__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_timestamps__pb2.DESCRIPTOR, + google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR, + google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR, + google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, + google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, + ], +) + +_ENTRYTYPE = _descriptor.EnumDescriptor( + name="EntryType", + full_name="google.cloud.datacatalog.v1.EntryType", + filename=None, + file=DESCRIPTOR, + values=[ + _descriptor.EnumValueDescriptor( + name="ENTRY_TYPE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + ), + _descriptor.EnumValueDescriptor( + name="TABLE", index=1, number=2, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="MODEL", index=2, number=5, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="DATA_STREAM", index=3, number=3, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="FILESET", index=4, number=4, serialized_options=None, type=None + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=5620, + serialized_end=5711, +) +_sym_db.RegisterEnumDescriptor(_ENTRYTYPE) + +EntryType = enum_type_wrapper.EnumTypeWrapper(_ENTRYTYPE) +ENTRY_TYPE_UNSPECIFIED = 0 +TABLE = 2 +MODEL = 5 +DATA_STREAM = 3 +FILESET = 4 + + +_SEARCHCATALOGREQUEST_SCOPE = _descriptor.Descriptor( + name="Scope", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.Scope", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="include_org_ids", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.Scope.include_org_ids", + index=0, + number=2, + type=9, + cpp_type=9, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="include_project_ids", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.Scope.include_project_ids", + index=1, + number=3, + type=9, + cpp_type=9, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="include_gcp_public_datasets", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.Scope.include_gcp_public_datasets", + index=2, + number=7, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=858, + serialized_end=956, +) + +_SEARCHCATALOGREQUEST = _descriptor.Descriptor( + name="SearchCatalogRequest", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="scope", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.scope", + index=0, + number=6, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="query", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.query", + index=1, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_size", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.page_size", + index=2, + number=2, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_token", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.page_token", + index=3, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="order_by", + full_name="google.cloud.datacatalog.v1.SearchCatalogRequest.order_by", + index=4, + number=5, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[_SEARCHCATALOGREQUEST_SCOPE], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=675, + serialized_end=956, +) + + +_SEARCHCATALOGRESPONSE = _descriptor.Descriptor( + name="SearchCatalogResponse", + full_name="google.cloud.datacatalog.v1.SearchCatalogResponse", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="results", + full_name="google.cloud.datacatalog.v1.SearchCatalogResponse.results", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="next_page_token", + full_name="google.cloud.datacatalog.v1.SearchCatalogResponse.next_page_token", + index=1, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=958, + serialized_end=1073, +) + + +_CREATEENTRYGROUPREQUEST = _descriptor.Descriptor( + name="CreateEntryGroupRequest", + full_name="google.cloud.datacatalog.v1.CreateEntryGroupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.CreateEntryGroupRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A'\022%datacatalog.googleapis.com/EntryGroup", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="entry_group_id", + full_name="google.cloud.datacatalog.v1.CreateEntryGroupRequest.entry_group_id", + index=1, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="entry_group", + full_name="google.cloud.datacatalog.v1.CreateEntryGroupRequest.entry_group", + index=2, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1076, + serialized_end=1255, +) + + +_UPDATEENTRYGROUPREQUEST = _descriptor.Descriptor( + name="UpdateEntryGroupRequest", + full_name="google.cloud.datacatalog.v1.UpdateEntryGroupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="entry_group", + full_name="google.cloud.datacatalog.v1.UpdateEntryGroupRequest.entry_group", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="update_mask", + full_name="google.cloud.datacatalog.v1.UpdateEntryGroupRequest.update_mask", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1258, + serialized_end=1399, +) + + +_GETENTRYGROUPREQUEST = _descriptor.Descriptor( + name="GetEntryGroupRequest", + full_name="google.cloud.datacatalog.v1.GetEntryGroupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.GetEntryGroupRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="read_mask", + full_name="google.cloud.datacatalog.v1.GetEntryGroupRequest.read_mask", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1402, + serialized_end=1532, +) + + +_DELETEENTRYGROUPREQUEST = _descriptor.Descriptor( + name="DeleteEntryGroupRequest", + full_name="google.cloud.datacatalog.v1.DeleteEntryGroupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.DeleteEntryGroupRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="force", + full_name="google.cloud.datacatalog.v1.DeleteEntryGroupRequest.force", + index=1, + number=2, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1534, + serialized_end=1640, +) + + +_LISTENTRYGROUPSREQUEST = _descriptor.Descriptor( + name="ListEntryGroupsRequest", + full_name="google.cloud.datacatalog.v1.ListEntryGroupsRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.ListEntryGroupsRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_size", + full_name="google.cloud.datacatalog.v1.ListEntryGroupsRequest.page_size", + index=1, + number=2, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_token", + full_name="google.cloud.datacatalog.v1.ListEntryGroupsRequest.page_token", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1643, + serialized_end=1779, +) + + +_LISTENTRYGROUPSRESPONSE = _descriptor.Descriptor( + name="ListEntryGroupsResponse", + full_name="google.cloud.datacatalog.v1.ListEntryGroupsResponse", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="entry_groups", + full_name="google.cloud.datacatalog.v1.ListEntryGroupsResponse.entry_groups", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="next_page_token", + full_name="google.cloud.datacatalog.v1.ListEntryGroupsResponse.next_page_token", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1781, + serialized_end=1894, +) + + +_CREATEENTRYREQUEST = _descriptor.Descriptor( + name="CreateEntryRequest", + full_name="google.cloud.datacatalog.v1.CreateEntryRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.CreateEntryRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="entry_id", + full_name="google.cloud.datacatalog.v1.CreateEntryRequest.entry_id", + index=1, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="entry", + full_name="google.cloud.datacatalog.v1.CreateEntryRequest.entry", + index=2, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1897, + serialized_end=2059, +) + + +_UPDATEENTRYREQUEST = _descriptor.Descriptor( + name="UpdateEntryRequest", + full_name="google.cloud.datacatalog.v1.UpdateEntryRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="entry", + full_name="google.cloud.datacatalog.v1.UpdateEntryRequest.entry", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="update_mask", + full_name="google.cloud.datacatalog.v1.UpdateEntryRequest.update_mask", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=2061, + serialized_end=2186, +) + + +_DELETEENTRYREQUEST = _descriptor.Descriptor( + name="DeleteEntryRequest", + full_name="google.cloud.datacatalog.v1.DeleteEntryRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.DeleteEntryRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b'\340A\002\372A"\n datacatalog.googleapis.com/Entry', + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=2188, + serialized_end=2264, +) + + +_GETENTRYREQUEST = _descriptor.Descriptor( + name="GetEntryRequest", + full_name="google.cloud.datacatalog.v1.GetEntryRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.GetEntryRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b'\340A\002\372A"\n datacatalog.googleapis.com/Entry', + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=2266, + serialized_end=2339, +) + + +_LOOKUPENTRYREQUEST = _descriptor.Descriptor( + name="LookupEntryRequest", + full_name="google.cloud.datacatalog.v1.LookupEntryRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="linked_resource", + full_name="google.cloud.datacatalog.v1.LookupEntryRequest.linked_resource", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="sql_resource", + full_name="google.cloud.datacatalog.v1.LookupEntryRequest.sql_resource", + index=1, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="target_name", + full_name="google.cloud.datacatalog.v1.LookupEntryRequest.target_name", + index=0, + containing_type=None, + fields=[], + ) + ], + serialized_start=2341, + serialized_end=2427, +) + + +_ENTRY = _descriptor.Descriptor( + name="Entry", + full_name="google.cloud.datacatalog.v1.Entry", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.Entry.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\372A'\n%datacatalog.googleapis.com/EntryGroup", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="linked_resource", + full_name="google.cloud.datacatalog.v1.Entry.linked_resource", + index=1, + number=9, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="type", + full_name="google.cloud.datacatalog.v1.Entry.type", + index=2, + number=2, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="user_specified_type", + full_name="google.cloud.datacatalog.v1.Entry.user_specified_type", + index=3, + number=16, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="integrated_system", + full_name="google.cloud.datacatalog.v1.Entry.integrated_system", + index=4, + number=17, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="user_specified_system", + full_name="google.cloud.datacatalog.v1.Entry.user_specified_system", + index=5, + number=18, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="gcs_fileset_spec", + full_name="google.cloud.datacatalog.v1.Entry.gcs_fileset_spec", + index=6, + number=6, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="bigquery_table_spec", + full_name="google.cloud.datacatalog.v1.Entry.bigquery_table_spec", + index=7, + number=12, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="bigquery_date_sharded_spec", + full_name="google.cloud.datacatalog.v1.Entry.bigquery_date_sharded_spec", + index=8, + number=15, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.cloud.datacatalog.v1.Entry.display_name", + index=9, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="description", + full_name="google.cloud.datacatalog.v1.Entry.description", + index=10, + number=4, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="schema", + full_name="google.cloud.datacatalog.v1.Entry.schema", + index=11, + number=5, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="source_system_timestamps", + full_name="google.cloud.datacatalog.v1.Entry.source_system_timestamps", + index=12, + number=7, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=b"\352Au\n datacatalog.googleapis.com/Entry\022Qprojects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="entry_type", + full_name="google.cloud.datacatalog.v1.Entry.entry_type", + index=0, + containing_type=None, + fields=[], + ), + _descriptor.OneofDescriptor( + name="system", + full_name="google.cloud.datacatalog.v1.Entry.system", + index=1, + containing_type=None, + fields=[], + ), + _descriptor.OneofDescriptor( + name="type_spec", + full_name="google.cloud.datacatalog.v1.Entry.type_spec", + index=2, + containing_type=None, + fields=[], + ), + ], + serialized_start=2430, + serialized_end=3301, +) + + +_ENTRYGROUP = _descriptor.Descriptor( + name="EntryGroup", + full_name="google.cloud.datacatalog.v1.EntryGroup", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.EntryGroup.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.cloud.datacatalog.v1.EntryGroup.display_name", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="description", + full_name="google.cloud.datacatalog.v1.EntryGroup.description", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="data_catalog_timestamps", + full_name="google.cloud.datacatalog.v1.EntryGroup.data_catalog_timestamps", + index=3, + number=4, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=b"\352Aj\n%datacatalog.googleapis.com/EntryGroup\022Aprojects/{project}/locations/{location}/entryGroups/{entry_group}", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=3304, + serialized_end=3569, +) + + +_CREATETAGTEMPLATEREQUEST = _descriptor.Descriptor( + name="CreateTagTemplateRequest", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A(\022&datacatalog.googleapis.com/TagTemplate", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="tag_template_id", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateRequest.tag_template_id", + index=1, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="tag_template", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateRequest.tag_template", + index=2, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=3572, + serialized_end=3761, +) + + +_GETTAGTEMPLATEREQUEST = _descriptor.Descriptor( + name="GetTagTemplateRequest", + full_name="google.cloud.datacatalog.v1.GetTagTemplateRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.GetTagTemplateRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate", + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=3763, + serialized_end=3848, +) + + +_UPDATETAGTEMPLATEREQUEST = _descriptor.Descriptor( + name="UpdateTagTemplateRequest", + full_name="google.cloud.datacatalog.v1.UpdateTagTemplateRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="tag_template", + full_name="google.cloud.datacatalog.v1.UpdateTagTemplateRequest.tag_template", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="update_mask", + full_name="google.cloud.datacatalog.v1.UpdateTagTemplateRequest.update_mask", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=3851, + serialized_end=3995, +) + + +_DELETETAGTEMPLATEREQUEST = _descriptor.Descriptor( + name="DeleteTagTemplateRequest", + full_name="google.cloud.datacatalog.v1.DeleteTagTemplateRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.DeleteTagTemplateRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="force", + full_name="google.cloud.datacatalog.v1.DeleteTagTemplateRequest.force", + index=1, + number=2, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=3997, + serialized_end=4105, +) + + +_CREATETAGREQUEST = _descriptor.Descriptor( + name="CreateTagRequest", + full_name="google.cloud.datacatalog.v1.CreateTagRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.CreateTagRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A \n\036datacatalog.googleapis.com/Tag", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="tag", + full_name="google.cloud.datacatalog.v1.CreateTagRequest.tag", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=4107, + serialized_end=4233, +) + + +_UPDATETAGREQUEST = _descriptor.Descriptor( + name="UpdateTagRequest", + full_name="google.cloud.datacatalog.v1.UpdateTagRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="tag", + full_name="google.cloud.datacatalog.v1.UpdateTagRequest.tag", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="update_mask", + full_name="google.cloud.datacatalog.v1.UpdateTagRequest.update_mask", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=4235, + serialized_end=4354, +) + + +_DELETETAGREQUEST = _descriptor.Descriptor( + name="DeleteTagRequest", + full_name="google.cloud.datacatalog.v1.DeleteTagRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.DeleteTagRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A \022\036datacatalog.googleapis.com/Tag", + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=4356, + serialized_end=4428, +) + + +_CREATETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor( + name="CreateTagTemplateFieldRequest", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateFieldRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateFieldRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="tag_template_field_id", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateFieldRequest.tag_template_field_id", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="tag_template_field", + full_name="google.cloud.datacatalog.v1.CreateTagTemplateFieldRequest.tag_template_field", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=4431, + serialized_end=4642, +) + + +_UPDATETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor( + name="UpdateTagTemplateFieldRequest", + full_name="google.cloud.datacatalog.v1.UpdateTagTemplateFieldRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.UpdateTagTemplateFieldRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="tag_template_field", + full_name="google.cloud.datacatalog.v1.UpdateTagTemplateFieldRequest.tag_template_field", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="update_mask", + full_name="google.cloud.datacatalog.v1.UpdateTagTemplateFieldRequest.update_mask", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=4645, + serialized_end=4877, +) + + +_RENAMETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor( + name="RenameTagTemplateFieldRequest", + full_name="google.cloud.datacatalog.v1.RenameTagTemplateFieldRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.RenameTagTemplateFieldRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="new_tag_template_field_id", + full_name="google.cloud.datacatalog.v1.RenameTagTemplateFieldRequest.new_tag_template_field_id", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=4880, + serialized_end=5018, +) + + +_DELETETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor( + name="DeleteTagTemplateFieldRequest", + full_name="google.cloud.datacatalog.v1.DeleteTagTemplateFieldRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.DeleteTagTemplateFieldRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="force", + full_name="google.cloud.datacatalog.v1.DeleteTagTemplateFieldRequest.force", + index=1, + number=2, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=5020, + serialized_end=5138, +) + + +_LISTTAGSREQUEST = _descriptor.Descriptor( + name="ListTagsRequest", + full_name="google.cloud.datacatalog.v1.ListTagsRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.ListTagsRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A \022\036datacatalog.googleapis.com/Tag", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_size", + full_name="google.cloud.datacatalog.v1.ListTagsRequest.page_size", + index=1, + number=2, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_token", + full_name="google.cloud.datacatalog.v1.ListTagsRequest.page_token", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=5140, + serialized_end=5252, +) + + +_LISTTAGSRESPONSE = _descriptor.Descriptor( + name="ListTagsResponse", + full_name="google.cloud.datacatalog.v1.ListTagsResponse", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="tags", + full_name="google.cloud.datacatalog.v1.ListTagsResponse.tags", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="next_page_token", + full_name="google.cloud.datacatalog.v1.ListTagsResponse.next_page_token", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=5254, + serialized_end=5345, +) + + +_LISTENTRIESREQUEST = _descriptor.Descriptor( + name="ListEntriesRequest", + full_name="google.cloud.datacatalog.v1.ListEntriesRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.cloud.datacatalog.v1.ListEntriesRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_size", + full_name="google.cloud.datacatalog.v1.ListEntriesRequest.page_size", + index=1, + number=2, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="page_token", + full_name="google.cloud.datacatalog.v1.ListEntriesRequest.page_token", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="read_mask", + full_name="google.cloud.datacatalog.v1.ListEntriesRequest.read_mask", + index=3, + number=4, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=5348, + serialized_end=5517, +) + + +_LISTENTRIESRESPONSE = _descriptor.Descriptor( + name="ListEntriesResponse", + full_name="google.cloud.datacatalog.v1.ListEntriesResponse", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="entries", + full_name="google.cloud.datacatalog.v1.ListEntriesResponse.entries", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="next_page_token", + full_name="google.cloud.datacatalog.v1.ListEntriesResponse.next_page_token", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=5519, + serialized_end=5618, +) + +_SEARCHCATALOGREQUEST_SCOPE.containing_type = _SEARCHCATALOGREQUEST +_SEARCHCATALOGREQUEST.fields_by_name["scope"].message_type = _SEARCHCATALOGREQUEST_SCOPE +_SEARCHCATALOGRESPONSE.fields_by_name[ + "results" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_search__pb2._SEARCHCATALOGRESULT +) +_CREATEENTRYGROUPREQUEST.fields_by_name["entry_group"].message_type = _ENTRYGROUP +_UPDATEENTRYGROUPREQUEST.fields_by_name["entry_group"].message_type = _ENTRYGROUP +_UPDATEENTRYGROUPREQUEST.fields_by_name[ + "update_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_GETENTRYGROUPREQUEST.fields_by_name[ + "read_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_LISTENTRYGROUPSRESPONSE.fields_by_name["entry_groups"].message_type = _ENTRYGROUP +_CREATEENTRYREQUEST.fields_by_name["entry"].message_type = _ENTRY +_UPDATEENTRYREQUEST.fields_by_name["entry"].message_type = _ENTRY +_UPDATEENTRYREQUEST.fields_by_name[ + "update_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_LOOKUPENTRYREQUEST.oneofs_by_name["target_name"].fields.append( + _LOOKUPENTRYREQUEST.fields_by_name["linked_resource"] +) +_LOOKUPENTRYREQUEST.fields_by_name[ + "linked_resource" +].containing_oneof = _LOOKUPENTRYREQUEST.oneofs_by_name["target_name"] +_LOOKUPENTRYREQUEST.oneofs_by_name["target_name"].fields.append( + _LOOKUPENTRYREQUEST.fields_by_name["sql_resource"] +) +_LOOKUPENTRYREQUEST.fields_by_name[ + "sql_resource" +].containing_oneof = _LOOKUPENTRYREQUEST.oneofs_by_name["target_name"] +_ENTRY.fields_by_name["type"].enum_type = _ENTRYTYPE +_ENTRY.fields_by_name[ + "integrated_system" +].enum_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_common__pb2._INTEGRATEDSYSTEM +) +_ENTRY.fields_by_name[ + "gcs_fileset_spec" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_gcs__fileset__spec__pb2._GCSFILESETSPEC +) +_ENTRY.fields_by_name[ + "bigquery_table_spec" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_table__spec__pb2._BIGQUERYTABLESPEC +) +_ENTRY.fields_by_name[ + "bigquery_date_sharded_spec" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_table__spec__pb2._BIGQUERYDATESHARDEDSPEC +) +_ENTRY.fields_by_name[ + "schema" +].message_type = google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_schema__pb2._SCHEMA +_ENTRY.fields_by_name[ + "source_system_timestamps" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_timestamps__pb2._SYSTEMTIMESTAMPS +) +_ENTRY.oneofs_by_name["entry_type"].fields.append(_ENTRY.fields_by_name["type"]) +_ENTRY.fields_by_name["type"].containing_oneof = _ENTRY.oneofs_by_name["entry_type"] +_ENTRY.oneofs_by_name["entry_type"].fields.append( + _ENTRY.fields_by_name["user_specified_type"] +) +_ENTRY.fields_by_name["user_specified_type"].containing_oneof = _ENTRY.oneofs_by_name[ + "entry_type" +] +_ENTRY.oneofs_by_name["system"].fields.append( + _ENTRY.fields_by_name["integrated_system"] +) +_ENTRY.fields_by_name["integrated_system"].containing_oneof = _ENTRY.oneofs_by_name[ + "system" +] +_ENTRY.oneofs_by_name["system"].fields.append( + _ENTRY.fields_by_name["user_specified_system"] +) +_ENTRY.fields_by_name["user_specified_system"].containing_oneof = _ENTRY.oneofs_by_name[ + "system" +] +_ENTRY.oneofs_by_name["type_spec"].fields.append( + _ENTRY.fields_by_name["gcs_fileset_spec"] +) +_ENTRY.fields_by_name["gcs_fileset_spec"].containing_oneof = _ENTRY.oneofs_by_name[ + "type_spec" +] +_ENTRY.oneofs_by_name["type_spec"].fields.append( + _ENTRY.fields_by_name["bigquery_table_spec"] +) +_ENTRY.fields_by_name["bigquery_table_spec"].containing_oneof = _ENTRY.oneofs_by_name[ + "type_spec" +] +_ENTRY.oneofs_by_name["type_spec"].fields.append( + _ENTRY.fields_by_name["bigquery_date_sharded_spec"] +) +_ENTRY.fields_by_name[ + "bigquery_date_sharded_spec" +].containing_oneof = _ENTRY.oneofs_by_name["type_spec"] +_ENTRYGROUP.fields_by_name[ + "data_catalog_timestamps" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_timestamps__pb2._SYSTEMTIMESTAMPS +) +_CREATETAGTEMPLATEREQUEST.fields_by_name[ + "tag_template" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATE +) +_UPDATETAGTEMPLATEREQUEST.fields_by_name[ + "tag_template" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATE +) +_UPDATETAGTEMPLATEREQUEST.fields_by_name[ + "update_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_CREATETAGREQUEST.fields_by_name[ + "tag" +].message_type = google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAG +_UPDATETAGREQUEST.fields_by_name[ + "tag" +].message_type = google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAG +_UPDATETAGREQUEST.fields_by_name[ + "update_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_CREATETAGTEMPLATEFIELDREQUEST.fields_by_name[ + "tag_template_field" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD +) +_UPDATETAGTEMPLATEFIELDREQUEST.fields_by_name[ + "tag_template_field" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD +) +_UPDATETAGTEMPLATEFIELDREQUEST.fields_by_name[ + "update_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_LISTTAGSRESPONSE.fields_by_name[ + "tags" +].message_type = google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAG +_LISTENTRIESREQUEST.fields_by_name[ + "read_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_LISTENTRIESRESPONSE.fields_by_name["entries"].message_type = _ENTRY +DESCRIPTOR.message_types_by_name["SearchCatalogRequest"] = _SEARCHCATALOGREQUEST +DESCRIPTOR.message_types_by_name["SearchCatalogResponse"] = _SEARCHCATALOGRESPONSE +DESCRIPTOR.message_types_by_name["CreateEntryGroupRequest"] = _CREATEENTRYGROUPREQUEST +DESCRIPTOR.message_types_by_name["UpdateEntryGroupRequest"] = _UPDATEENTRYGROUPREQUEST +DESCRIPTOR.message_types_by_name["GetEntryGroupRequest"] = _GETENTRYGROUPREQUEST +DESCRIPTOR.message_types_by_name["DeleteEntryGroupRequest"] = _DELETEENTRYGROUPREQUEST +DESCRIPTOR.message_types_by_name["ListEntryGroupsRequest"] = _LISTENTRYGROUPSREQUEST +DESCRIPTOR.message_types_by_name["ListEntryGroupsResponse"] = _LISTENTRYGROUPSRESPONSE +DESCRIPTOR.message_types_by_name["CreateEntryRequest"] = _CREATEENTRYREQUEST +DESCRIPTOR.message_types_by_name["UpdateEntryRequest"] = _UPDATEENTRYREQUEST +DESCRIPTOR.message_types_by_name["DeleteEntryRequest"] = _DELETEENTRYREQUEST +DESCRIPTOR.message_types_by_name["GetEntryRequest"] = _GETENTRYREQUEST +DESCRIPTOR.message_types_by_name["LookupEntryRequest"] = _LOOKUPENTRYREQUEST +DESCRIPTOR.message_types_by_name["Entry"] = _ENTRY +DESCRIPTOR.message_types_by_name["EntryGroup"] = _ENTRYGROUP +DESCRIPTOR.message_types_by_name["CreateTagTemplateRequest"] = _CREATETAGTEMPLATEREQUEST +DESCRIPTOR.message_types_by_name["GetTagTemplateRequest"] = _GETTAGTEMPLATEREQUEST +DESCRIPTOR.message_types_by_name["UpdateTagTemplateRequest"] = _UPDATETAGTEMPLATEREQUEST +DESCRIPTOR.message_types_by_name["DeleteTagTemplateRequest"] = _DELETETAGTEMPLATEREQUEST +DESCRIPTOR.message_types_by_name["CreateTagRequest"] = _CREATETAGREQUEST +DESCRIPTOR.message_types_by_name["UpdateTagRequest"] = _UPDATETAGREQUEST +DESCRIPTOR.message_types_by_name["DeleteTagRequest"] = _DELETETAGREQUEST +DESCRIPTOR.message_types_by_name[ + "CreateTagTemplateFieldRequest" +] = _CREATETAGTEMPLATEFIELDREQUEST +DESCRIPTOR.message_types_by_name[ + "UpdateTagTemplateFieldRequest" +] = _UPDATETAGTEMPLATEFIELDREQUEST +DESCRIPTOR.message_types_by_name[ + "RenameTagTemplateFieldRequest" +] = _RENAMETAGTEMPLATEFIELDREQUEST +DESCRIPTOR.message_types_by_name[ + "DeleteTagTemplateFieldRequest" +] = _DELETETAGTEMPLATEFIELDREQUEST +DESCRIPTOR.message_types_by_name["ListTagsRequest"] = _LISTTAGSREQUEST +DESCRIPTOR.message_types_by_name["ListTagsResponse"] = _LISTTAGSRESPONSE +DESCRIPTOR.message_types_by_name["ListEntriesRequest"] = _LISTENTRIESREQUEST +DESCRIPTOR.message_types_by_name["ListEntriesResponse"] = _LISTENTRIESRESPONSE +DESCRIPTOR.enum_types_by_name["EntryType"] = _ENTRYTYPE +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + +SearchCatalogRequest = _reflection.GeneratedProtocolMessageType( + "SearchCatalogRequest", + (_message.Message,), + { + "Scope": _reflection.GeneratedProtocolMessageType( + "Scope", + (_message.Message,), + { + "DESCRIPTOR": _SEARCHCATALOGREQUEST_SCOPE, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """The criteria that select the subspace used for query + matching. + + + Attributes: + include_org_ids: + The list of organization IDs to search within. To find your + organization ID, follow instructions in + https://cloud.google.com/resource-manager/docs/creating- + managing-organization. + include_project_ids: + The list of project IDs to search within. To learn more about + the distinction between project names/IDs/numbers, go to + https://cloud.google.com/docs/overview/#projects. + include_gcp_public_datasets: + If ``true``, include Google Cloud Platform (GCP) public + datasets in the search results. Info on GCP public datasets is + available at https://cloud.google.com/public-datasets/. By + default, GCP public datasets are excluded. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.SearchCatalogRequest.Scope) + }, + ), + "DESCRIPTOR": _SEARCHCATALOGREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. + + + Attributes: + scope: + Required. The scope of this search request. A ``scope`` that + has empty ``include_org_ids``, ``include_project_ids`` AND + false ``include_gcp_public_datasets`` is considered invalid. + Data Catalog will return an error in such a case. + query: + Required. The query string in search query syntax. The query + must be non-empty. Query strings can be simple as “x” or more + qualified as: - name:x - column:x - description:y Note: + Query tokens need to have a minimum of 3 characters for + substring matching to work correctly. See `Data Catalog Search + Syntax `__ for + more information. + page_size: + Number of results in the search page. If <=0 then defaults to + 10. Max limit for page_size is 1000. Throws an invalid + argument for page_size > 1000. + page_token: + Optional. Pagination token returned in an earlier [SearchCatal + ogResponse.next_page_token][google.cloud.datacatalog.v1.Search + CatalogResponse.next_page_token], which indicates that this is + a continuation of a prior [SearchCatalogRequest][google.cloud. + datacatalog.v1.DataCatalog.SearchCatalog] call, and that the + system should return the next page of data. If empty, the + first page is returned. + order_by: + Specifies the ordering of results, currently supported case- + sensitive choices are: - ``relevance``, only supports + descending - ``last_modified_timestamp [asc|desc]``, defaults + to descending if not specified If not specified, defaults + to ``relevance`` descending. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.SearchCatalogRequest) + }, +) +_sym_db.RegisterMessage(SearchCatalogRequest) +_sym_db.RegisterMessage(SearchCatalogRequest.Scope) + +SearchCatalogResponse = _reflection.GeneratedProtocolMessageType( + "SearchCatalogResponse", + (_message.Message,), + { + "DESCRIPTOR": _SEARCHCATALOGRESPONSE, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Response message for + [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. + + + Attributes: + results: + Search results. + next_page_token: + The token that can be used to retrieve the next page of + results. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.SearchCatalogResponse) + }, +) +_sym_db.RegisterMessage(SearchCatalogResponse) + +CreateEntryGroupRequest = _reflection.GeneratedProtocolMessageType( + "CreateEntryGroupRequest", + (_message.Message,), + { + "DESCRIPTOR": _CREATEENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [CreateEntryGroup][google.cloud.datacatalog.v1.DataCatalog.CreateEntryGroup]. + + + Attributes: + parent: + Required. The name of the project this entry group is in. + Example: - projects/{project_id}/locations/{location} Note + that this EntryGroup and its child resources may not actually + be stored in the location in this name. + entry_group_id: + Required. The id of the entry group to create. The id must + begin with a letter or underscore, contain only English + letters, numbers and underscores, and be at most 64 + characters. + entry_group: + The entry group to create. Defaults to an empty entry group. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.CreateEntryGroupRequest) + }, +) +_sym_db.RegisterMessage(CreateEntryGroupRequest) + +UpdateEntryGroupRequest = _reflection.GeneratedProtocolMessageType( + "UpdateEntryGroupRequest", + (_message.Message,), + { + "DESCRIPTOR": _UPDATEENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [UpdateEntryGroup][google.cloud.datacatalog.v1.DataCatalog.UpdateEntryGroup]. + + + Attributes: + entry_group: + Required. The updated entry group. “name” field must be set. + update_mask: + The fields to update on the entry group. If absent or empty, + all modifiable fields are updated. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.UpdateEntryGroupRequest) + }, +) +_sym_db.RegisterMessage(UpdateEntryGroupRequest) + +GetEntryGroupRequest = _reflection.GeneratedProtocolMessageType( + "GetEntryGroupRequest", + (_message.Message,), + { + "DESCRIPTOR": _GETENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [GetEntryGroup][google.cloud.datacatalog.v1.DataCatalog.GetEntryGroup]. + + + Attributes: + name: + Required. The name of the entry group. For example, ``projects + /{project_id}/locations/{location}/entryGroups/{entry_group_id + }``. + read_mask: + The fields to return. If not set or empty, all fields are + returned. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.GetEntryGroupRequest) + }, +) +_sym_db.RegisterMessage(GetEntryGroupRequest) + +DeleteEntryGroupRequest = _reflection.GeneratedProtocolMessageType( + "DeleteEntryGroupRequest", + (_message.Message,), + { + "DESCRIPTOR": _DELETEENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [DeleteEntryGroup][google.cloud.datacatalog.v1.DataCatalog.DeleteEntryGroup]. + + + Attributes: + name: + Required. The name of the entry group. For example, ``projects + /{project_id}/locations/{location}/entryGroups/{entry_group_id + }``. + force: + Optional. If true, deletes all entries in the entry group. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.DeleteEntryGroupRequest) + }, +) +_sym_db.RegisterMessage(DeleteEntryGroupRequest) + +ListEntryGroupsRequest = _reflection.GeneratedProtocolMessageType( + "ListEntryGroupsRequest", + (_message.Message,), + { + "DESCRIPTOR": _LISTENTRYGROUPSREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [ListEntryGroups][google.cloud.datacatalog.v1.DataCatalog.ListEntryGroups]. + + + Attributes: + parent: + Required. The name of the location that contains the entry + groups, which can be provided in URL format. Example: - + projects/{project_id}/locations/{location} + page_size: + Optional. The maximum number of items to return. Default is + 10. Max limit is 1000. Throws an invalid argument for + ``page_size > 1000``. + page_token: + Optional. Token that specifies which page is requested. If + empty, the first page is returned. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ListEntryGroupsRequest) + }, +) +_sym_db.RegisterMessage(ListEntryGroupsRequest) + +ListEntryGroupsResponse = _reflection.GeneratedProtocolMessageType( + "ListEntryGroupsResponse", + (_message.Message,), + { + "DESCRIPTOR": _LISTENTRYGROUPSRESPONSE, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Response message for + [ListEntryGroups][google.cloud.datacatalog.v1.DataCatalog.ListEntryGroups]. + + + Attributes: + entry_groups: + EntryGroup details. + next_page_token: + Token to retrieve the next page of results. It is set to empty + if no items remain in results. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ListEntryGroupsResponse) + }, +) +_sym_db.RegisterMessage(ListEntryGroupsResponse) + +CreateEntryRequest = _reflection.GeneratedProtocolMessageType( + "CreateEntryRequest", + (_message.Message,), + { + "DESCRIPTOR": _CREATEENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [CreateEntry][google.cloud.datacatalog.v1.DataCatalog.CreateEntry]. + + + Attributes: + parent: + Required. The name of the entry group this entry is in. + Example: - projects/{project_id}/locations/{location}/entryG + roups/{entry_group_id} Note that this Entry and its child + resources may not actually be stored in the location in this + name. + entry_id: + Required. The id of the entry to create. + entry: + Required. The entry to create. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.CreateEntryRequest) + }, +) +_sym_db.RegisterMessage(CreateEntryRequest) + +UpdateEntryRequest = _reflection.GeneratedProtocolMessageType( + "UpdateEntryRequest", + (_message.Message,), + { + "DESCRIPTOR": _UPDATEENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [UpdateEntry][google.cloud.datacatalog.v1.DataCatalog.UpdateEntry]. + + + Attributes: + entry: + Required. The updated entry. The “name” field must be set. + update_mask: + The fields to update on the entry. If absent or empty, all + modifiable fields are updated. The following fields are + modifiable: \* For entries with type ``DATA_STREAM``: \* + ``schema`` \* For entries with type ``FILESET`` \* ``schema`` + \* ``display_name`` \* ``description`` \* ``gcs_fileset_spec`` + \* ``gcs_fileset_spec.file_patterns`` \* For entries with + ``user_specified_type`` \* ``schema`` \* ``display_name`` \* + ``description`` \* user_specified_type \* + user_specified_system \* linked_resource \* + source_system_timestamps + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.UpdateEntryRequest) + }, +) +_sym_db.RegisterMessage(UpdateEntryRequest) + +DeleteEntryRequest = _reflection.GeneratedProtocolMessageType( + "DeleteEntryRequest", + (_message.Message,), + { + "DESCRIPTOR": _DELETEENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [DeleteEntry][google.cloud.datacatalog.v1.DataCatalog.DeleteEntry]. + + + Attributes: + name: + Required. The name of the entry. Example: - projects/{projec + t_id}/locations/{location}/entryGroups/{entry_group_id}/entrie + s/{entry_id} + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.DeleteEntryRequest) + }, +) +_sym_db.RegisterMessage(DeleteEntryRequest) + +GetEntryRequest = _reflection.GeneratedProtocolMessageType( + "GetEntryRequest", + (_message.Message,), + { + "DESCRIPTOR": _GETENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [GetEntry][google.cloud.datacatalog.v1.DataCatalog.GetEntry]. + + + Attributes: + name: + Required. The name of the entry. Example: - projects/{projec + t_id}/locations/{location}/entryGroups/{entry_group_id}/entrie + s/{entry_id} + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.GetEntryRequest) + }, +) +_sym_db.RegisterMessage(GetEntryRequest) + +LookupEntryRequest = _reflection.GeneratedProtocolMessageType( + "LookupEntryRequest", + (_message.Message,), + { + "DESCRIPTOR": _LOOKUPENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [LookupEntry][google.cloud.datacatalog.v1.DataCatalog.LookupEntry]. + + + Attributes: + target_name: + Required. Represents either the Google Cloud Platform resource + or SQL name for a Google Cloud Platform resource. + linked_resource: + The full name of the Google Cloud Platform resource the Data + Catalog entry represents. See: https://cloud.google.com/apis/d + esign/resource_names#full_resource_name. Full names are case- + sensitive. Examples: - //bigquery.googleapis.com/projects/p + rojectId/datasets/datasetId/tables/tableId - + //pubsub.googleapis.com/projects/projectId/topics/topicId + sql_resource: + The SQL name of the entry. SQL names are case-sensitive. + Examples: - ``cloud_pubsub.project_id.topic_id`` - + :literal:`pubsub.project_id.`topic.id.with.dots\`` - + ``bigquery.table.project_id.dataset_id.table_id`` - + ``bigquery.dataset.project_id.dataset_id`` - ``datacatalog.en + try.project_id.location_id.entry_group_id.entry_id`` + ``*_id``\ s shoud satisfy the standard SQL rules for + identifiers. + https://cloud.google.com/bigquery/docs/reference/standard- + sql/lexical. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.LookupEntryRequest) + }, +) +_sym_db.RegisterMessage(LookupEntryRequest) + +Entry = _reflection.GeneratedProtocolMessageType( + "Entry", + (_message.Message,), + { + "DESCRIPTOR": _ENTRY, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Entry Metadata. A Data Catalog Entry resource represents + another resource in Google Cloud Platform (such as a BigQuery dataset or + a Pub/Sub topic) or outside of Google Cloud Platform. Clients can use + the ``linked_resource`` field in the Entry resource to refer to the + original resource ID of the source system. + + An Entry resource contains resource details, such as its schema. An + Entry can also be used to attach flexible metadata, such as a + [Tag][google.cloud.datacatalog.v1.Tag]. + + + Attributes: + name: + The Data Catalog resource name of the entry in URL format. + Example: - projects/{project_id}/locations/{location}/entryG + roups/{entry_group_id}/entries/{entry_id} Note that this + Entry and its child resources may not actually be stored in + the location in this name. + linked_resource: + The resource this metadata entry refers to. For Google Cloud + Platform resources, ``linked_resource`` is the `full name of + the resource `__. For example, the + ``linked_resource`` for a table resource from BigQuery is: - + //bigquery.googleapis.com/projects/projectId/datasets/datasetI + d/tables/tableId Output only when Entry is of type in the + EntryType enum. For entries with user_specified_type, this + field is optional and defaults to an empty string. + entry_type: + Required. Entry type. + type: + The type of the entry. Only used for Entries with types in the + EntryType enum. + user_specified_type: + Entry type if it does not fit any of the input-allowed values + listed in ``EntryType`` enum above. When creating an entry, + users should check the enum values first, if nothing matches + the entry to be created, then provide a custom value, for + example “my_special_type”. ``user_specified_type`` strings + must begin with a letter or underscore and can only contain + letters, numbers, and underscores; are case insensitive; must + be at least 1 character and at most 64 characters long. + Currently, only FILESET enum value is allowed. All other + entries created through Data Catalog must use + ``user_specified_type``. + system: + The source system of the entry. + integrated_system: + Output only. This field indicates the entry’s source system + that Data Catalog integrates with, such as BigQuery or + Pub/Sub. + user_specified_system: + This field indicates the entry’s source system that Data + Catalog does not integrate with. ``user_specified_system`` + strings must begin with a letter or underscore and can only + contain letters, numbers, and underscores; are case + insensitive; must be at least 1 character and at most 64 + characters long. + type_spec: + Type specification information. + gcs_fileset_spec: + Specification that applies to a Cloud Storage fileset. This is + only valid on entries of type FILESET. + bigquery_table_spec: + Specification that applies to a BigQuery table. This is only + valid on entries of type ``TABLE``. + bigquery_date_sharded_spec: + Specification for a group of BigQuery tables with name pattern + ``[prefix]YYYYMMDD``. Context: + https://cloud.google.com/bigquery/docs/partitioned- + tables#partitioning_versus_sharding. + display_name: + Display information such as title and description. A short + name to identify the entry, for example, “Analytics Data - Jan + 2011”. Default value is an empty string. + description: + Entry description, which can consist of several sentences or + paragraphs that describe entry contents. Default value is an + empty string. + schema: + Schema of the entry. An entry might not have any schema + attached to it. + source_system_timestamps: + Timestamps about the underlying resource, not about this Data + Catalog entry. Output only when Entry is of type in the + EntryType enum. For entries with user_specified_type, this + field is optional and defaults to an empty timestamp. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.Entry) + }, +) +_sym_db.RegisterMessage(Entry) + +EntryGroup = _reflection.GeneratedProtocolMessageType( + "EntryGroup", + (_message.Message,), + { + "DESCRIPTOR": _ENTRYGROUP, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """EntryGroup Metadata. An EntryGroup resource represents a + logical grouping of zero or more Data Catalog + [Entry][google.cloud.datacatalog.v1.Entry] resources. + + + Attributes: + name: + The resource name of the entry group in URL format. Example: + - projects/{project_id}/locations/{location}/entryGroups/{ent + ry_group_id} Note that this EntryGroup and its child + resources may not actually be stored in the location in this + name. + display_name: + A short name to identify the entry group, for example, + “analytics data - jan 2011”. Default value is an empty string. + description: + Entry group description, which can consist of several + sentences or paragraphs that describe entry group contents. + Default value is an empty string. + data_catalog_timestamps: + Output only. Timestamps about this EntryGroup. Default value + is empty timestamps. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.EntryGroup) + }, +) +_sym_db.RegisterMessage(EntryGroup) + +CreateTagTemplateRequest = _reflection.GeneratedProtocolMessageType( + "CreateTagTemplateRequest", + (_message.Message,), + { + "DESCRIPTOR": _CREATETAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [CreateTagTemplate][google.cloud.datacatalog.v1.DataCatalog.CreateTagTemplate]. + + + Attributes: + parent: + Required. The name of the project and the template location + `region `__. NOTE: + Currently, only the ``us-central1 region`` is supported. + Example: - projects/{project_id}/locations/us-central1 + tag_template_id: + Required. The id of the tag template to create. + tag_template: + Required. The tag template to create. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.CreateTagTemplateRequest) + }, +) +_sym_db.RegisterMessage(CreateTagTemplateRequest) + +GetTagTemplateRequest = _reflection.GeneratedProtocolMessageType( + "GetTagTemplateRequest", + (_message.Message,), + { + "DESCRIPTOR": _GETTAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [GetTagTemplate][google.cloud.datacatalog.v1.DataCatalog.GetTagTemplate]. + + + Attributes: + name: + Required. The name of the tag template. Example: - projects/ + {project_id}/locations/{location}/tagTemplates/{tag_template_i + d} + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.GetTagTemplateRequest) + }, +) +_sym_db.RegisterMessage(GetTagTemplateRequest) + +UpdateTagTemplateRequest = _reflection.GeneratedProtocolMessageType( + "UpdateTagTemplateRequest", + (_message.Message,), + { + "DESCRIPTOR": _UPDATETAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [UpdateTagTemplate][google.cloud.datacatalog.v1.DataCatalog.UpdateTagTemplate]. + + + Attributes: + tag_template: + Required. The template to update. The “name” field must be + set. + update_mask: + The field mask specifies the parts of the template to + overwrite. Allowed fields: - ``display_name`` If absent or + empty, all of the allowed fields above will be updated. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.UpdateTagTemplateRequest) + }, +) +_sym_db.RegisterMessage(UpdateTagTemplateRequest) + +DeleteTagTemplateRequest = _reflection.GeneratedProtocolMessageType( + "DeleteTagTemplateRequest", + (_message.Message,), + { + "DESCRIPTOR": _DELETETAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [DeleteTagTemplate][google.cloud.datacatalog.v1.DataCatalog.DeleteTagTemplate]. + + + Attributes: + name: + Required. The name of the tag template to delete. Example: - + projects/{project_id}/locations/{location}/tagTemplates/{tag_t + emplate_id} + force: + Required. Currently, this field must always be set to + ``true``. This confirms the deletion of any possible tags + using this template. ``force = false`` will be supported in + the future. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.DeleteTagTemplateRequest) + }, +) +_sym_db.RegisterMessage(DeleteTagTemplateRequest) + +CreateTagRequest = _reflection.GeneratedProtocolMessageType( + "CreateTagRequest", + (_message.Message,), + { + "DESCRIPTOR": _CREATETAGREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [CreateTag][google.cloud.datacatalog.v1.DataCatalog.CreateTag]. + + + Attributes: + parent: + Required. The name of the resource to attach this tag to. Tags + can be attached to Entries. Example: - projects/{project_id} + /locations/{location}/entryGroups/{entry_group_id}/entries/{en + try_id} Note that this Tag and its child resources may not + actually be stored in the location in this name. + tag: + Required. The tag to create. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.CreateTagRequest) + }, +) +_sym_db.RegisterMessage(CreateTagRequest) + +UpdateTagRequest = _reflection.GeneratedProtocolMessageType( + "UpdateTagRequest", + (_message.Message,), + { + "DESCRIPTOR": _UPDATETAGREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [UpdateTag][google.cloud.datacatalog.v1.DataCatalog.UpdateTag]. + + + Attributes: + tag: + Required. The updated tag. The “name” field must be set. + update_mask: + The fields to update on the Tag. If absent or empty, all + modifiable fields are updated. Currently the only modifiable + field is the field ``fields``. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.UpdateTagRequest) + }, +) +_sym_db.RegisterMessage(UpdateTagRequest) + +DeleteTagRequest = _reflection.GeneratedProtocolMessageType( + "DeleteTagRequest", + (_message.Message,), + { + "DESCRIPTOR": _DELETETAGREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [DeleteTag][google.cloud.datacatalog.v1.DataCatalog.DeleteTag]. + + + Attributes: + name: + Required. The name of the tag to delete. Example: - projects + /{project_id}/locations/{location}/entryGroups/{entry_group_id + }/entries/{entry_id}/tags/{tag_id} + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.DeleteTagRequest) + }, +) +_sym_db.RegisterMessage(DeleteTagRequest) + +CreateTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( + "CreateTagTemplateFieldRequest", + (_message.Message,), + { + "DESCRIPTOR": _CREATETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [CreateTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.CreateTagTemplateField]. + + + Attributes: + parent: + Required. The name of the project and the template location + `region `__. NOTE: + Currently, only the ``us-central1 region`` is supported. + Example: - projects/{project_id}/locations/us- + central1/tagTemplates/{tag_template_id} + tag_template_field_id: + Required. The ID of the tag template field to create. Field + ids can contain letters (both uppercase and lowercase), + numbers (0-9), underscores (_) and dashes (-). Field IDs must + be at least 1 character long and at most 128 characters long. + Field IDs must also be unique within their template. + tag_template_field: + Required. The tag template field to create. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.CreateTagTemplateFieldRequest) + }, +) +_sym_db.RegisterMessage(CreateTagTemplateFieldRequest) + +UpdateTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( + "UpdateTagTemplateFieldRequest", + (_message.Message,), + { + "DESCRIPTOR": _UPDATETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [UpdateTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.UpdateTagTemplateField]. + + + Attributes: + name: + Required. The name of the tag template field. Example: - pro + jects/{project_id}/locations/{location}/tagTemplates/{tag_temp + late_id}/fields/{tag_template_field_id} + tag_template_field: + Required. The template to update. + update_mask: + Optional. The field mask specifies the parts of the template + to be updated. Allowed fields: - ``display_name`` - + ``type.enum_type`` - ``is_required`` If ``update_mask`` is + not set or empty, all of the allowed fields above will be + updated. When updating an enum type, the provided values will + be merged with the existing values. Therefore, enum values can + only be added, existing enum values cannot be deleted nor + renamed. Updating a template field from optional to required + is NOT allowed. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.UpdateTagTemplateFieldRequest) + }, +) +_sym_db.RegisterMessage(UpdateTagTemplateFieldRequest) + +RenameTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( + "RenameTagTemplateFieldRequest", + (_message.Message,), + { + "DESCRIPTOR": _RENAMETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField]. + + + Attributes: + name: + Required. The name of the tag template. Example: - projects/ + {project_id}/locations/{location}/tagTemplates/{tag_template_i + d}/fields/{tag_template_field_id} + new_tag_template_field_id: + Required. The new ID of this tag template field. For example, + ``my_new_field``. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.RenameTagTemplateFieldRequest) + }, +) +_sym_db.RegisterMessage(RenameTagTemplateFieldRequest) + +DeleteTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( + "DeleteTagTemplateFieldRequest", + (_message.Message,), + { + "DESCRIPTOR": _DELETETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [DeleteTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.DeleteTagTemplateField]. + + + Attributes: + name: + Required. The name of the tag template field to delete. + Example: - projects/{project_id}/locations/{location}/tagTem + plates/{tag_template_id}/fields/{tag_template_field_id} + force: + Required. Currently, this field must always be set to + ``true``. This confirms the deletion of this field from any + tags using this field. ``force = false`` will be supported in + the future. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.DeleteTagTemplateFieldRequest) + }, +) +_sym_db.RegisterMessage(DeleteTagTemplateFieldRequest) + +ListTagsRequest = _reflection.GeneratedProtocolMessageType( + "ListTagsRequest", + (_message.Message,), + { + "DESCRIPTOR": _LISTTAGSREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [ListTags][google.cloud.datacatalog.v1.DataCatalog.ListTags]. + + + Attributes: + parent: + Required. The name of the Data Catalog resource to list the + tags of. The resource could be an + [Entry][google.cloud.datacatalog.v1.Entry] or an + [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]. + Examples: - projects/{project_id}/locations/{location}/entry + Groups/{entry_group_id} - projects/{project_id}/locations/{lo + cation}/entryGroups/{entry_group_id}/entries/{entry_id} + page_size: + The maximum number of tags to return. Default is 10. Max limit + is 1000. + page_token: + Token that specifies which page is requested. If empty, the + first page is returned. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ListTagsRequest) + }, +) +_sym_db.RegisterMessage(ListTagsRequest) + +ListTagsResponse = _reflection.GeneratedProtocolMessageType( + "ListTagsResponse", + (_message.Message,), + { + "DESCRIPTOR": _LISTTAGSRESPONSE, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Response message for + [ListTags][google.cloud.datacatalog.v1.DataCatalog.ListTags]. + + + Attributes: + tags: + [Tag][google.cloud.datacatalog.v1.Tag] details. + next_page_token: + Token to retrieve the next page of results. It is set to empty + if no items remain in results. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ListTagsResponse) + }, +) +_sym_db.RegisterMessage(ListTagsResponse) + +ListEntriesRequest = _reflection.GeneratedProtocolMessageType( + "ListEntriesRequest", + (_message.Message,), + { + "DESCRIPTOR": _LISTENTRIESREQUEST, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Request message for + [ListEntries][google.cloud.datacatalog.v1.DataCatalog.ListEntries]. + + + Attributes: + parent: + Required. The name of the entry group that contains the + entries, which can be provided in URL format. Example: - pro + jects/{project_id}/locations/{location}/entryGroups/{entry_gro + up_id} + page_size: + The maximum number of items to return. Default is 10. Max + limit is 1000. Throws an invalid argument for ``page_size > + 1000``. + page_token: + Token that specifies which page is requested. If empty, the + first page is returned. + read_mask: + The fields to return for each Entry. If not set or empty, all + fields are returned. For example, setting read_mask to contain + only one path “name” will cause ListEntries to return a list + of Entries with only “name” field. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ListEntriesRequest) + }, +) +_sym_db.RegisterMessage(ListEntriesRequest) + +ListEntriesResponse = _reflection.GeneratedProtocolMessageType( + "ListEntriesResponse", + (_message.Message,), + { + "DESCRIPTOR": _LISTENTRIESRESPONSE, + "__module__": "google.cloud.datacatalog_v1.proto.datacatalog_pb2", + "__doc__": """Response message for + [ListEntries][google.cloud.datacatalog.v1.DataCatalog.ListEntries]. + + + Attributes: + entries: + Entry details. + next_page_token: + Token to retrieve the next page of results. It is set to empty + if no items remain in results. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ListEntriesResponse) + }, +) +_sym_db.RegisterMessage(ListEntriesResponse) + + +DESCRIPTOR._options = None +_SEARCHCATALOGREQUEST.fields_by_name["scope"]._options = None +_SEARCHCATALOGREQUEST.fields_by_name["query"]._options = None +_SEARCHCATALOGREQUEST.fields_by_name["page_token"]._options = None +_CREATEENTRYGROUPREQUEST.fields_by_name["parent"]._options = None +_CREATEENTRYGROUPREQUEST.fields_by_name["entry_group_id"]._options = None +_UPDATEENTRYGROUPREQUEST.fields_by_name["entry_group"]._options = None +_GETENTRYGROUPREQUEST.fields_by_name["name"]._options = None +_DELETEENTRYGROUPREQUEST.fields_by_name["name"]._options = None +_DELETEENTRYGROUPREQUEST.fields_by_name["force"]._options = None +_LISTENTRYGROUPSREQUEST.fields_by_name["parent"]._options = None +_LISTENTRYGROUPSREQUEST.fields_by_name["page_size"]._options = None +_LISTENTRYGROUPSREQUEST.fields_by_name["page_token"]._options = None +_CREATEENTRYREQUEST.fields_by_name["parent"]._options = None +_CREATEENTRYREQUEST.fields_by_name["entry_id"]._options = None +_CREATEENTRYREQUEST.fields_by_name["entry"]._options = None +_UPDATEENTRYREQUEST.fields_by_name["entry"]._options = None +_DELETEENTRYREQUEST.fields_by_name["name"]._options = None +_GETENTRYREQUEST.fields_by_name["name"]._options = None +_ENTRY.fields_by_name["name"]._options = None +_ENTRY.fields_by_name["integrated_system"]._options = None +_ENTRY._options = None +_ENTRYGROUP.fields_by_name["data_catalog_timestamps"]._options = None +_ENTRYGROUP._options = None +_CREATETAGTEMPLATEREQUEST.fields_by_name["parent"]._options = None +_CREATETAGTEMPLATEREQUEST.fields_by_name["tag_template_id"]._options = None +_CREATETAGTEMPLATEREQUEST.fields_by_name["tag_template"]._options = None +_GETTAGTEMPLATEREQUEST.fields_by_name["name"]._options = None +_UPDATETAGTEMPLATEREQUEST.fields_by_name["tag_template"]._options = None +_DELETETAGTEMPLATEREQUEST.fields_by_name["name"]._options = None +_DELETETAGTEMPLATEREQUEST.fields_by_name["force"]._options = None +_CREATETAGREQUEST.fields_by_name["parent"]._options = None +_CREATETAGREQUEST.fields_by_name["tag"]._options = None +_UPDATETAGREQUEST.fields_by_name["tag"]._options = None +_DELETETAGREQUEST.fields_by_name["name"]._options = None +_CREATETAGTEMPLATEFIELDREQUEST.fields_by_name["parent"]._options = None +_CREATETAGTEMPLATEFIELDREQUEST.fields_by_name["tag_template_field_id"]._options = None +_CREATETAGTEMPLATEFIELDREQUEST.fields_by_name["tag_template_field"]._options = None +_UPDATETAGTEMPLATEFIELDREQUEST.fields_by_name["name"]._options = None +_UPDATETAGTEMPLATEFIELDREQUEST.fields_by_name["tag_template_field"]._options = None +_UPDATETAGTEMPLATEFIELDREQUEST.fields_by_name["update_mask"]._options = None +_RENAMETAGTEMPLATEFIELDREQUEST.fields_by_name["name"]._options = None +_RENAMETAGTEMPLATEFIELDREQUEST.fields_by_name[ + "new_tag_template_field_id" +]._options = None +_DELETETAGTEMPLATEFIELDREQUEST.fields_by_name["name"]._options = None +_DELETETAGTEMPLATEFIELDREQUEST.fields_by_name["force"]._options = None +_LISTTAGSREQUEST.fields_by_name["parent"]._options = None +_LISTENTRIESREQUEST.fields_by_name["parent"]._options = None + +_DATACATALOG = _descriptor.ServiceDescriptor( + name="DataCatalog", + full_name="google.cloud.datacatalog.v1.DataCatalog", + file=DESCRIPTOR, + index=0, + serialized_options=b"\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform", + serialized_start=5714, + serialized_end=11746, + methods=[ + _descriptor.MethodDescriptor( + name="SearchCatalog", + full_name="google.cloud.datacatalog.v1.DataCatalog.SearchCatalog", + index=0, + containing_service=None, + input_type=_SEARCHCATALOGREQUEST, + output_type=_SEARCHCATALOGRESPONSE, + serialized_options=b'\202\323\344\223\002\027"\022/v1/catalog:search:\001*\332A\013scope,query', + ), + _descriptor.MethodDescriptor( + name="CreateEntryGroup", + full_name="google.cloud.datacatalog.v1.DataCatalog.CreateEntryGroup", + index=1, + containing_service=None, + input_type=_CREATEENTRYGROUPREQUEST, + output_type=_ENTRYGROUP, + serialized_options=b'\202\323\344\223\002>"//v1/{parent=projects/*/locations/*}/entryGroups:\013entry_group\332A!parent,entry_group_id,entry_group', + ), + _descriptor.MethodDescriptor( + name="GetEntryGroup", + full_name="google.cloud.datacatalog.v1.DataCatalog.GetEntryGroup", + index=2, + containing_service=None, + input_type=_GETENTRYGROUPREQUEST, + output_type=_ENTRYGROUP, + serialized_options=b"\202\323\344\223\0021\022//v1/{name=projects/*/locations/*/entryGroups/*}\332A\004name\332A\016name,read_mask", + ), + _descriptor.MethodDescriptor( + name="UpdateEntryGroup", + full_name="google.cloud.datacatalog.v1.DataCatalog.UpdateEntryGroup", + index=3, + containing_service=None, + input_type=_UPDATEENTRYGROUPREQUEST, + output_type=_ENTRYGROUP, + serialized_options=b"\202\323\344\223\002J2;/v1/{entry_group.name=projects/*/locations/*/entryGroups/*}:\013entry_group\332A\013entry_group\332A\027entry_group,update_mask", + ), + _descriptor.MethodDescriptor( + name="DeleteEntryGroup", + full_name="google.cloud.datacatalog.v1.DataCatalog.DeleteEntryGroup", + index=4, + containing_service=None, + input_type=_DELETEENTRYGROUPREQUEST, + output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, + serialized_options=b"\202\323\344\223\0021*//v1/{name=projects/*/locations/*/entryGroups/*}\332A\004name", + ), + _descriptor.MethodDescriptor( + name="ListEntryGroups", + full_name="google.cloud.datacatalog.v1.DataCatalog.ListEntryGroups", + index=5, + containing_service=None, + input_type=_LISTENTRYGROUPSREQUEST, + output_type=_LISTENTRYGROUPSRESPONSE, + serialized_options=b"\202\323\344\223\0021\022//v1/{parent=projects/*/locations/*}/entryGroups\332A\006parent", + ), + _descriptor.MethodDescriptor( + name="CreateEntry", + full_name="google.cloud.datacatalog.v1.DataCatalog.CreateEntry", + index=6, + containing_service=None, + input_type=_CREATEENTRYREQUEST, + output_type=_ENTRY, + serialized_options=b'\202\323\344\223\002B"9/v1/{parent=projects/*/locations/*/entryGroups/*}/entries:\005entry\332A\025parent,entry_id,entry', + ), + _descriptor.MethodDescriptor( + name="UpdateEntry", + full_name="google.cloud.datacatalog.v1.DataCatalog.UpdateEntry", + index=7, + containing_service=None, + input_type=_UPDATEENTRYREQUEST, + output_type=_ENTRY, + serialized_options=b"\202\323\344\223\002H2?/v1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\005entry\332A\005entry\332A\021entry,update_mask", + ), + _descriptor.MethodDescriptor( + name="DeleteEntry", + full_name="google.cloud.datacatalog.v1.DataCatalog.DeleteEntry", + index=8, + containing_service=None, + input_type=_DELETEENTRYREQUEST, + output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, + serialized_options=b"\202\323\344\223\002;*9/v1/{name=projects/*/locations/*/entryGroups/*/entries/*}\332A\004name", + ), + _descriptor.MethodDescriptor( + name="GetEntry", + full_name="google.cloud.datacatalog.v1.DataCatalog.GetEntry", + index=9, + containing_service=None, + input_type=_GETENTRYREQUEST, + output_type=_ENTRY, + serialized_options=b"\202\323\344\223\002;\0229/v1/{name=projects/*/locations/*/entryGroups/*/entries/*}\332A\004name", + ), + _descriptor.MethodDescriptor( + name="LookupEntry", + full_name="google.cloud.datacatalog.v1.DataCatalog.LookupEntry", + index=10, + containing_service=None, + input_type=_LOOKUPENTRYREQUEST, + output_type=_ENTRY, + serialized_options=b"\202\323\344\223\002\024\022\022/v1/entries:lookup", + ), + _descriptor.MethodDescriptor( + name="ListEntries", + full_name="google.cloud.datacatalog.v1.DataCatalog.ListEntries", + index=11, + containing_service=None, + input_type=_LISTENTRIESREQUEST, + output_type=_LISTENTRIESRESPONSE, + serialized_options=b"\202\323\344\223\002;\0229/v1/{parent=projects/*/locations/*/entryGroups/*}/entries\332A\006parent", + ), + _descriptor.MethodDescriptor( + name="CreateTagTemplate", + full_name="google.cloud.datacatalog.v1.DataCatalog.CreateTagTemplate", + index=12, + containing_service=None, + input_type=_CREATETAGTEMPLATEREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATE, + serialized_options=b'\202\323\344\223\002@"0/v1/{parent=projects/*/locations/*}/tagTemplates:\014tag_template\332A#parent,tag_template_id,tag_template', + ), + _descriptor.MethodDescriptor( + name="GetTagTemplate", + full_name="google.cloud.datacatalog.v1.DataCatalog.GetTagTemplate", + index=13, + containing_service=None, + input_type=_GETTAGTEMPLATEREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATE, + serialized_options=b"\202\323\344\223\0022\0220/v1/{name=projects/*/locations/*/tagTemplates/*}\332A\004name", + ), + _descriptor.MethodDescriptor( + name="UpdateTagTemplate", + full_name="google.cloud.datacatalog.v1.DataCatalog.UpdateTagTemplate", + index=14, + containing_service=None, + input_type=_UPDATETAGTEMPLATEREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATE, + serialized_options=b"\202\323\344\223\002M2=/v1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\014tag_template\332A\014tag_template\332A\030tag_template,update_mask", + ), + _descriptor.MethodDescriptor( + name="DeleteTagTemplate", + full_name="google.cloud.datacatalog.v1.DataCatalog.DeleteTagTemplate", + index=15, + containing_service=None, + input_type=_DELETETAGTEMPLATEREQUEST, + output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, + serialized_options=b"\202\323\344\223\0022*0/v1/{name=projects/*/locations/*/tagTemplates/*}\332A\nname,force", + ), + _descriptor.MethodDescriptor( + name="CreateTagTemplateField", + full_name="google.cloud.datacatalog.v1.DataCatalog.CreateTagTemplateField", + index=16, + containing_service=None, + input_type=_CREATETAGTEMPLATEFIELDREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD, + serialized_options=b'\202\323\344\223\002O"9/v1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\022tag_template_field\332A/parent,tag_template_field_id,tag_template_field', + ), + _descriptor.MethodDescriptor( + name="UpdateTagTemplateField", + full_name="google.cloud.datacatalog.v1.DataCatalog.UpdateTagTemplateField", + index=17, + containing_service=None, + input_type=_UPDATETAGTEMPLATEFIELDREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD, + serialized_options=b"\202\323\344\223\002O29/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\022tag_template_field\332A\027name,tag_template_field\332A#name,tag_template_field,update_mask", + ), + _descriptor.MethodDescriptor( + name="RenameTagTemplateField", + full_name="google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField", + index=18, + containing_service=None, + input_type=_RENAMETAGTEMPLATEFIELDREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD, + serialized_options=b'\202\323\344\223\002E"@/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\001*\332A\036name,new_tag_template_field_id', + ), + _descriptor.MethodDescriptor( + name="DeleteTagTemplateField", + full_name="google.cloud.datacatalog.v1.DataCatalog.DeleteTagTemplateField", + index=19, + containing_service=None, + input_type=_DELETETAGTEMPLATEFIELDREQUEST, + output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, + serialized_options=b"\202\323\344\223\002;*9/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}\332A\nname,force", + ), + _descriptor.MethodDescriptor( + name="CreateTag", + full_name="google.cloud.datacatalog.v1.DataCatalog.CreateTag", + index=20, + containing_service=None, + input_type=_CREATETAGREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAG, + serialized_options=b'\202\323\344\223\002\206\001"@/v1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\003tagZ="6/v1/{parent=projects/*/locations/*/entryGroups/*}/tags:\003tag\332A\nparent,tag', + ), + _descriptor.MethodDescriptor( + name="UpdateTag", + full_name="google.cloud.datacatalog.v1.DataCatalog.UpdateTag", + index=21, + containing_service=None, + input_type=_UPDATETAGREQUEST, + output_type=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2._TAG, + serialized_options=b"\202\323\344\223\002\216\0012D/v1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\003tagZA2:/v1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}:\003tag\332A\003tag\332A\017tag,update_mask", + ), + _descriptor.MethodDescriptor( + name="DeleteTag", + full_name="google.cloud.datacatalog.v1.DataCatalog.DeleteTag", + index=22, + containing_service=None, + input_type=_DELETETAGREQUEST, + output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, + serialized_options=b"\202\323\344\223\002|*@/v1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}Z8*6/v1/{name=projects/*/locations/*/entryGroups/*/tags/*}\332A\004name", + ), + _descriptor.MethodDescriptor( + name="ListTags", + full_name="google.cloud.datacatalog.v1.DataCatalog.ListTags", + index=23, + containing_service=None, + input_type=_LISTTAGSREQUEST, + output_type=_LISTTAGSRESPONSE, + serialized_options=b"\202\323\344\223\002|\022@/v1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tagsZ8\0226/v1/{parent=projects/*/locations/*/entryGroups/*}/tags\332A\006parent", + ), + _descriptor.MethodDescriptor( + name="SetIamPolicy", + full_name="google.cloud.datacatalog.v1.DataCatalog.SetIamPolicy", + index=24, + containing_service=None, + input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, + output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, + serialized_options=b'\202\323\344\223\002\215\001"A/v1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\001*ZE"@/v1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy:\001*', + ), + _descriptor.MethodDescriptor( + name="GetIamPolicy", + full_name="google.cloud.datacatalog.v1.DataCatalog.GetIamPolicy", + index=25, + containing_service=None, + input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, + output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, + serialized_options=b'\202\323\344\223\002\336\001"A/v1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\001*ZE"@/v1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy:\001*ZO"J/v1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy:\001*', + ), + _descriptor.MethodDescriptor( + name="TestIamPermissions", + full_name="google.cloud.datacatalog.v1.DataCatalog.TestIamPermissions", + index=26, + containing_service=None, + input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, + output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, + serialized_options=b'\202\323\344\223\002\360\001"G/v1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\001*ZK"F/v1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions:\001*ZU"P/v1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions:\001*', + ), + ], +) +_sym_db.RegisterServiceDescriptor(_DATACATALOG) + +DESCRIPTOR.services_by_name["DataCatalog"] = _DATACATALOG + +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/datacatalog_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/datacatalog_pb2_grpc.py new file mode 100644 index 00000000..feae38f5 --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/datacatalog_pb2_grpc.py @@ -0,0 +1,623 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc + +from google.cloud.datacatalog_v1.proto import ( + datacatalog_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2, +) +from google.cloud.datacatalog_v1.proto import ( + tags_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2, +) +from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2 +from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2 +from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 + + +class DataCatalogStub(object): + """Data Catalog API service allows clients to discover, understand, and manage + their data. + """ + + def __init__(self, channel): + """Constructor. + + Args: + channel: A grpc.Channel. + """ + self.SearchCatalog = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/SearchCatalog", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.SearchCatalogRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.SearchCatalogResponse.FromString, + ) + self.CreateEntryGroup = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/CreateEntryGroup", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateEntryGroupRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.EntryGroup.FromString, + ) + self.GetEntryGroup = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/GetEntryGroup", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.GetEntryGroupRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.EntryGroup.FromString, + ) + self.UpdateEntryGroup = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/UpdateEntryGroup", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateEntryGroupRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.EntryGroup.FromString, + ) + self.DeleteEntryGroup = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/DeleteEntryGroup", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteEntryGroupRequest.SerializeToString, + response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, + ) + self.ListEntryGroups = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/ListEntryGroups", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntryGroupsRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntryGroupsResponse.FromString, + ) + self.CreateEntry = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/CreateEntry", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateEntryRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.FromString, + ) + self.UpdateEntry = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/UpdateEntry", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateEntryRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.FromString, + ) + self.DeleteEntry = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/DeleteEntry", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteEntryRequest.SerializeToString, + response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, + ) + self.GetEntry = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/GetEntry", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.GetEntryRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.FromString, + ) + self.LookupEntry = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/LookupEntry", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.LookupEntryRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.FromString, + ) + self.ListEntries = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/ListEntries", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntriesRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntriesResponse.FromString, + ) + self.CreateTagTemplate = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/CreateTagTemplate", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplate.FromString, + ) + self.GetTagTemplate = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/GetTagTemplate", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.GetTagTemplateRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplate.FromString, + ) + self.UpdateTagTemplate = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/UpdateTagTemplate", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplate.FromString, + ) + self.DeleteTagTemplate = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/DeleteTagTemplate", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateRequest.SerializeToString, + response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, + ) + self.CreateTagTemplateField = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/CreateTagTemplateField", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateFieldRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplateField.FromString, + ) + self.UpdateTagTemplateField = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/UpdateTagTemplateField", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateFieldRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplateField.FromString, + ) + self.RenameTagTemplateField = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/RenameTagTemplateField", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.RenameTagTemplateFieldRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplateField.FromString, + ) + self.DeleteTagTemplateField = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/DeleteTagTemplateField", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateFieldRequest.SerializeToString, + response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, + ) + self.CreateTag = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/CreateTag", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateTagRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.Tag.FromString, + ) + self.UpdateTag = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/UpdateTag", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateTagRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.Tag.FromString, + ) + self.DeleteTag = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/DeleteTag", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteTagRequest.SerializeToString, + response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, + ) + self.ListTags = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/ListTags", + request_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListTagsRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListTagsResponse.FromString, + ) + self.SetIamPolicy = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/SetIamPolicy", + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + ) + self.GetIamPolicy = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/GetIamPolicy", + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + ) + self.TestIamPermissions = channel.unary_unary( + "/google.cloud.datacatalog.v1.DataCatalog/TestIamPermissions", + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, + ) + + +class DataCatalogServicer(object): + """Data Catalog API service allows clients to discover, understand, and manage + their data. + """ + + def SearchCatalog(self, request, context): + """Searches Data Catalog for multiple resources like entries, tags that + match a query. + + This is a custom method + (https://cloud.google.com/apis/design/custom_methods) and does not return + the complete resource, only the resource identifier and high level + fields. Clients can subsequentally call `Get` methods. + + Note that Data Catalog search queries do not guarantee full recall. Query + results that match your query may not be returned, even in subsequent + result pages. Also note that results returned (and not returned) can vary + across repeated search queries. + + See [Data Catalog Search + Syntax](/data-catalog/docs/how-to/search-reference) for more information. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def CreateEntryGroup(self, request, context): + """Creates an EntryGroup. + + An entry group contains logically related entries together with Cloud + Identity and Access Management policies that specify the users who can + create, edit, and view entries within the entry group. + + Data Catalog automatically creates an entry group for BigQuery entries + ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own entry + group to contain Cloud Storage fileset entries or custom type entries, + and the IAM policies associated with those entries. Entry groups, like + entries, can be searched. + + A maximum of 10,000 entry groups may be created per organization across all + locations. + + Users should enable the Data Catalog API in the project identified by + the `parent` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def GetEntryGroup(self, request, context): + """Gets an EntryGroup. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def UpdateEntryGroup(self, request, context): + """Updates an EntryGroup. The user should enable the Data Catalog API in the + project identified by the `entry_group.name` parameter (see [Data Catalog + Resource Project] (/data-catalog/docs/concepts/resource-project) for more + information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def DeleteEntryGroup(self, request, context): + """Deletes an EntryGroup. Only entry groups that do not contain entries can be + deleted. Users should enable the Data Catalog API in the project + identified by the `name` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def ListEntryGroups(self, request, context): + """Lists entry groups. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def CreateEntry(self, request, context): + """Creates an entry. Only entries of 'FILESET' type or user-specified type can + be created. + + Users should enable the Data Catalog API in the project identified by + the `parent` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + A maximum of 100,000 entries may be created per entry group. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def UpdateEntry(self, request, context): + """Updates an existing entry. + Users should enable the Data Catalog API in the project identified by + the `entry.name` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def DeleteEntry(self, request, context): + """Deletes an existing entry. Only entries created through + [CreateEntry][google.cloud.datacatalog.v1.DataCatalog.CreateEntry] + method can be deleted. + Users should enable the Data Catalog API in the project identified by + the `name` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def GetEntry(self, request, context): + """Gets an entry. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def LookupEntry(self, request, context): + """Get an entry by target resource name. This method allows clients to use + the resource name from the source Google Cloud Platform service to get the + Data Catalog Entry. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def ListEntries(self, request, context): + """Lists entries. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def CreateTagTemplate(self, request, context): + """Creates a tag template. The user should enable the Data Catalog API in + the project identified by the `parent` parameter (see [Data Catalog + Resource Project](/data-catalog/docs/concepts/resource-project) for more + information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def GetTagTemplate(self, request, context): + """Gets a tag template. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def UpdateTagTemplate(self, request, context): + """Updates a tag template. This method cannot be used to update the fields of + a template. The tag template fields are represented as separate resources + and should be updated using their own create/update/delete methods. + Users should enable the Data Catalog API in the project identified by + the `tag_template.name` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def DeleteTagTemplate(self, request, context): + """Deletes a tag template and all tags using the template. + Users should enable the Data Catalog API in the project identified by + the `name` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def CreateTagTemplateField(self, request, context): + """Creates a field in a tag template. The user should enable the Data Catalog + API in the project identified by the `parent` parameter (see + [Data Catalog Resource + Project](/data-catalog/docs/concepts/resource-project) for more + information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def UpdateTagTemplateField(self, request, context): + """Updates a field in a tag template. This method cannot be used to update the + field type. Users should enable the Data Catalog API in the project + identified by the `name` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def RenameTagTemplateField(self, request, context): + """Renames a field in a tag template. The user should enable the Data Catalog + API in the project identified by the `name` parameter (see [Data Catalog + Resource Project](/data-catalog/docs/concepts/resource-project) for more + information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def DeleteTagTemplateField(self, request, context): + """Deletes a field in a tag template and all uses of that field. + Users should enable the Data Catalog API in the project identified by + the `name` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def CreateTag(self, request, context): + """Creates a tag on an [Entry][google.cloud.datacatalog.v1.Entry]. + Note: The project identified by the `parent` parameter for the + [tag](/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters) + and the + [tag + template](/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters) + used to create the tag must be from the same organization. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def UpdateTag(self, request, context): + """Updates an existing tag. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def DeleteTag(self, request, context): + """Deletes a tag. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def ListTags(self, request, context): + """Lists the tags on an [Entry][google.cloud.datacatalog.v1.Entry]. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def SetIamPolicy(self, request, context): + """Sets the access control policy for a resource. Replaces any existing + policy. + Supported resources are: + - Tag templates. + - Entries. + - Entry groups. + Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + and any external Google Cloud Platform resources synced to Data Catalog. + + Callers must have following Google IAM permission + - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag + templates. + - `datacatalog.entries.setIamPolicy` to set policies on entries. + - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def GetIamPolicy(self, request, context): + """Gets the access control policy for a resource. A `NOT_FOUND` error + is returned if the resource does not exist. An empty policy is returned + if the resource exists but does not have a policy set on it. + + Supported resources are: + - Tag templates. + - Entries. + - Entry groups. + Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + and any external Google Cloud Platform resources synced to Data Catalog. + + Callers must have following Google IAM permission + - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag + templates. + - `datacatalog.entries.getIamPolicy` to get policies on entries. + - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + def TestIamPermissions(self, request, context): + """Returns the caller's permissions on a resource. + If the resource does not exist, an empty set of permissions is returned + (We don't return a `NOT_FOUND` error). + + Supported resources are: + - Tag templates. + - Entries. + - Entry groups. + Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + and any external Google Cloud Platform resources synced to Data Catalog. + + A caller is not required to have Google IAM permission to make this + request. + """ + context.set_code(grpc.StatusCode.UNIMPLEMENTED) + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") + + +def add_DataCatalogServicer_to_server(servicer, server): + rpc_method_handlers = { + "SearchCatalog": grpc.unary_unary_rpc_method_handler( + servicer.SearchCatalog, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.SearchCatalogRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.SearchCatalogResponse.SerializeToString, + ), + "CreateEntryGroup": grpc.unary_unary_rpc_method_handler( + servicer.CreateEntryGroup, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateEntryGroupRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.EntryGroup.SerializeToString, + ), + "GetEntryGroup": grpc.unary_unary_rpc_method_handler( + servicer.GetEntryGroup, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.GetEntryGroupRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.EntryGroup.SerializeToString, + ), + "UpdateEntryGroup": grpc.unary_unary_rpc_method_handler( + servicer.UpdateEntryGroup, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateEntryGroupRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.EntryGroup.SerializeToString, + ), + "DeleteEntryGroup": grpc.unary_unary_rpc_method_handler( + servicer.DeleteEntryGroup, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteEntryGroupRequest.FromString, + response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, + ), + "ListEntryGroups": grpc.unary_unary_rpc_method_handler( + servicer.ListEntryGroups, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntryGroupsRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntryGroupsResponse.SerializeToString, + ), + "CreateEntry": grpc.unary_unary_rpc_method_handler( + servicer.CreateEntry, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateEntryRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.SerializeToString, + ), + "UpdateEntry": grpc.unary_unary_rpc_method_handler( + servicer.UpdateEntry, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateEntryRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.SerializeToString, + ), + "DeleteEntry": grpc.unary_unary_rpc_method_handler( + servicer.DeleteEntry, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteEntryRequest.FromString, + response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, + ), + "GetEntry": grpc.unary_unary_rpc_method_handler( + servicer.GetEntry, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.GetEntryRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.SerializeToString, + ), + "LookupEntry": grpc.unary_unary_rpc_method_handler( + servicer.LookupEntry, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.LookupEntryRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.Entry.SerializeToString, + ), + "ListEntries": grpc.unary_unary_rpc_method_handler( + servicer.ListEntries, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntriesRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListEntriesResponse.SerializeToString, + ), + "CreateTagTemplate": grpc.unary_unary_rpc_method_handler( + servicer.CreateTagTemplate, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplate.SerializeToString, + ), + "GetTagTemplate": grpc.unary_unary_rpc_method_handler( + servicer.GetTagTemplate, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.GetTagTemplateRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplate.SerializeToString, + ), + "UpdateTagTemplate": grpc.unary_unary_rpc_method_handler( + servicer.UpdateTagTemplate, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplate.SerializeToString, + ), + "DeleteTagTemplate": grpc.unary_unary_rpc_method_handler( + servicer.DeleteTagTemplate, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateRequest.FromString, + response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, + ), + "CreateTagTemplateField": grpc.unary_unary_rpc_method_handler( + servicer.CreateTagTemplateField, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateFieldRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplateField.SerializeToString, + ), + "UpdateTagTemplateField": grpc.unary_unary_rpc_method_handler( + servicer.UpdateTagTemplateField, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateFieldRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplateField.SerializeToString, + ), + "RenameTagTemplateField": grpc.unary_unary_rpc_method_handler( + servicer.RenameTagTemplateField, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.RenameTagTemplateFieldRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.TagTemplateField.SerializeToString, + ), + "DeleteTagTemplateField": grpc.unary_unary_rpc_method_handler( + servicer.DeleteTagTemplateField, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateFieldRequest.FromString, + response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, + ), + "CreateTag": grpc.unary_unary_rpc_method_handler( + servicer.CreateTag, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.CreateTagRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.Tag.SerializeToString, + ), + "UpdateTag": grpc.unary_unary_rpc_method_handler( + servicer.UpdateTag, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.UpdateTagRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_tags__pb2.Tag.SerializeToString, + ), + "DeleteTag": grpc.unary_unary_rpc_method_handler( + servicer.DeleteTag, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.DeleteTagRequest.FromString, + response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, + ), + "ListTags": grpc.unary_unary_rpc_method_handler( + servicer.ListTags, + request_deserializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListTagsRequest.FromString, + response_serializer=google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_datacatalog__pb2.ListTagsResponse.SerializeToString, + ), + "SetIamPolicy": grpc.unary_unary_rpc_method_handler( + servicer.SetIamPolicy, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, + ), + "GetIamPolicy": grpc.unary_unary_rpc_method_handler( + servicer.GetIamPolicy, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, + ), + "TestIamPermissions": grpc.unary_unary_rpc_method_handler( + servicer.TestIamPermissions, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString, + ), + } + generic_handler = grpc.method_handlers_generic_handler( + "google.cloud.datacatalog.v1.DataCatalog", rpc_method_handlers + ) + server.add_generic_rpc_handlers((generic_handler,)) diff --git a/google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2.py b/google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2.py new file mode 100644 index 00000000..64e385fd --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2.py @@ -0,0 +1,248 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/gcs_fileset_spec.proto + +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.cloud.datacatalog_v1.proto import ( + timestamps_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_timestamps__pb2, +) + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/gcs_fileset_spec.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b'\n8google/cloud/datacatalog_v1/proto/gcs_fileset_spec.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x32google/cloud/datacatalog_v1/proto/timestamps.proto"z\n\x0eGcsFilesetSpec\x12\x1a\n\rfile_patterns\x18\x01 \x03(\tB\x03\xe0\x41\x02\x12L\n\x15sample_gcs_file_specs\x18\x02 \x03(\x0b\x32(.google.cloud.datacatalog.v1.GcsFileSpecB\x03\xe0\x41\x03"\x8a\x01\n\x0bGcsFileSpec\x12\x16\n\tfile_path\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12J\n\x0egcs_timestamps\x18\x02 \x01(\x0b\x32-.google.cloud.datacatalog.v1.SystemTimestampsB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x04 \x01(\x03\x42\x03\xe0\x41\x03\x42\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3', + dependencies=[ + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_timestamps__pb2.DESCRIPTOR, + ], +) + + +_GCSFILESETSPEC = _descriptor.Descriptor( + name="GcsFilesetSpec", + full_name="google.cloud.datacatalog.v1.GcsFilesetSpec", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="file_patterns", + full_name="google.cloud.datacatalog.v1.GcsFilesetSpec.file_patterns", + index=0, + number=1, + type=9, + cpp_type=9, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="sample_gcs_file_specs", + full_name="google.cloud.datacatalog.v1.GcsFilesetSpec.sample_gcs_file_specs", + index=1, + number=2, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=174, + serialized_end=296, +) + + +_GCSFILESPEC = _descriptor.Descriptor( + name="GcsFileSpec", + full_name="google.cloud.datacatalog.v1.GcsFileSpec", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="file_path", + full_name="google.cloud.datacatalog.v1.GcsFileSpec.file_path", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="gcs_timestamps", + full_name="google.cloud.datacatalog.v1.GcsFileSpec.gcs_timestamps", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="size_bytes", + full_name="google.cloud.datacatalog.v1.GcsFileSpec.size_bytes", + index=2, + number=4, + type=3, + cpp_type=2, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=299, + serialized_end=437, +) + +_GCSFILESETSPEC.fields_by_name["sample_gcs_file_specs"].message_type = _GCSFILESPEC +_GCSFILESPEC.fields_by_name[ + "gcs_timestamps" +].message_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_timestamps__pb2._SYSTEMTIMESTAMPS +) +DESCRIPTOR.message_types_by_name["GcsFilesetSpec"] = _GCSFILESETSPEC +DESCRIPTOR.message_types_by_name["GcsFileSpec"] = _GCSFILESPEC +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + +GcsFilesetSpec = _reflection.GeneratedProtocolMessageType( + "GcsFilesetSpec", + (_message.Message,), + { + "DESCRIPTOR": _GCSFILESETSPEC, + "__module__": "google.cloud.datacatalog_v1.proto.gcs_fileset_spec_pb2", + "__doc__": """Describes a Cloud Storage fileset entry. + + + Attributes: + file_patterns: + Required. Patterns to identify a set of files in Google Cloud + Storage. See `Cloud Storage documentation + `__ for more + information. Note that bucket wildcards are currently not + supported. Examples of valid file_patterns: - + ``gs://bucket_name/dir/*``: matches all files within + ``bucket_name/dir`` directory. - ``gs://bucket_name/dir/**``: + matches all files in ``bucket_name/dir`` spanning all + subdirectories. - ``gs://bucket_name/file*``: matches files + prefixed by ``file`` in ``bucket_name`` - + ``gs://bucket_name/??.txt``: matches files with two characters + followed by ``.txt`` in ``bucket_name`` - + ``gs://bucket_name/[aeiou].txt``: matches files that contain a + single vowel character followed by ``.txt`` in + ``bucket_name`` - ``gs://bucket_name/[a-m].txt``: matches + files that contain ``a``, ``b``, … or ``m`` followed by + ``.txt`` in ``bucket_name`` - ``gs://bucket_name/a/*/b``: + matches all files in ``bucket_name`` that match ``a/*/b`` + pattern, such as ``a/c/b``, ``a/d/b`` - + ``gs://another_bucket/a.txt``: matches + ``gs://another_bucket/a.txt`` You can combine wildcards to + provide more powerful matches, for example: - + ``gs://bucket_name/[a-m]??.j*g`` + sample_gcs_file_specs: + Output only. Sample files contained in this fileset, not all + files contained in this fileset are represented here. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.GcsFilesetSpec) + }, +) +_sym_db.RegisterMessage(GcsFilesetSpec) + +GcsFileSpec = _reflection.GeneratedProtocolMessageType( + "GcsFileSpec", + (_message.Message,), + { + "DESCRIPTOR": _GCSFILESPEC, + "__module__": "google.cloud.datacatalog_v1.proto.gcs_fileset_spec_pb2", + "__doc__": """Specifications of a single file in Cloud Storage. + + + Attributes: + file_path: + Required. The full file path. Example: + ``gs://bucket_name/a/b.txt``. + gcs_timestamps: + Output only. Timestamps about the Cloud Storage file. + size_bytes: + Output only. The size of the file, in bytes. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.GcsFileSpec) + }, +) +_sym_db.RegisterMessage(GcsFileSpec) + + +DESCRIPTOR._options = None +_GCSFILESETSPEC.fields_by_name["file_patterns"]._options = None +_GCSFILESETSPEC.fields_by_name["sample_gcs_file_specs"]._options = None +_GCSFILESPEC.fields_by_name["file_path"]._options = None +_GCSFILESPEC.fields_by_name["gcs_timestamps"]._options = None +_GCSFILESPEC.fields_by_name["size_bytes"]._options = None +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2_grpc.py new file mode 100644 index 00000000..07cb78fe --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/gcs_fileset_spec_pb2_grpc.py @@ -0,0 +1,2 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc diff --git a/google/cloud/datacatalog_v1/proto/schema_pb2.py b/google/cloud/datacatalog_v1/proto/schema_pb2.py new file mode 100644 index 00000000..216fa17c --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/schema_pb2.py @@ -0,0 +1,243 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/schema.proto + +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/schema.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b'\n.google/cloud/datacatalog_v1/proto/schema.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto"I\n\x06Schema\x12?\n\x07\x63olumns\x18\x02 \x03(\x0b\x32).google.cloud.datacatalog.v1.ColumnSchemaB\x03\xe0\x41\x02"\xa7\x01\n\x0c\x43olumnSchema\x12\x13\n\x06\x63olumn\x18\x06 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\x04type\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x18\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x11\n\x04mode\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x42\n\nsubcolumns\x18\x07 \x03(\x0b\x32).google.cloud.datacatalog.v1.ColumnSchemaB\x03\xe0\x41\x01\x42\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3', + dependencies=[google_dot_api_dot_field__behavior__pb2.DESCRIPTOR], +) + + +_SCHEMA = _descriptor.Descriptor( + name="Schema", + full_name="google.cloud.datacatalog.v1.Schema", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="columns", + full_name="google.cloud.datacatalog.v1.Schema.columns", + index=0, + number=2, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=112, + serialized_end=185, +) + + +_COLUMNSCHEMA = _descriptor.Descriptor( + name="ColumnSchema", + full_name="google.cloud.datacatalog.v1.ColumnSchema", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="column", + full_name="google.cloud.datacatalog.v1.ColumnSchema.column", + index=0, + number=6, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="type", + full_name="google.cloud.datacatalog.v1.ColumnSchema.type", + index=1, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="description", + full_name="google.cloud.datacatalog.v1.ColumnSchema.description", + index=2, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="mode", + full_name="google.cloud.datacatalog.v1.ColumnSchema.mode", + index=3, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="subcolumns", + full_name="google.cloud.datacatalog.v1.ColumnSchema.subcolumns", + index=4, + number=7, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\001", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=188, + serialized_end=355, +) + +_SCHEMA.fields_by_name["columns"].message_type = _COLUMNSCHEMA +_COLUMNSCHEMA.fields_by_name["subcolumns"].message_type = _COLUMNSCHEMA +DESCRIPTOR.message_types_by_name["Schema"] = _SCHEMA +DESCRIPTOR.message_types_by_name["ColumnSchema"] = _COLUMNSCHEMA +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + +Schema = _reflection.GeneratedProtocolMessageType( + "Schema", + (_message.Message,), + { + "DESCRIPTOR": _SCHEMA, + "__module__": "google.cloud.datacatalog_v1.proto.schema_pb2", + "__doc__": """Represents a schema (e.g. BigQuery, GoogleSQL, Avro + schema). + + + Attributes: + columns: + Required. Schema of columns. A maximum of 10,000 columns and + sub-columns can be specified. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.Schema) + }, +) +_sym_db.RegisterMessage(Schema) + +ColumnSchema = _reflection.GeneratedProtocolMessageType( + "ColumnSchema", + (_message.Message,), + { + "DESCRIPTOR": _COLUMNSCHEMA, + "__module__": "google.cloud.datacatalog_v1.proto.schema_pb2", + "__doc__": """Representation of a column within a schema. Columns could + be nested inside other columns. + + + Attributes: + column: + Required. Name of the column. + type: + Required. Type of the column. + description: + Optional. Description of the column. Default value is an empty + string. + mode: + Optional. A column’s mode indicates whether the values in this + column are required, nullable, etc. Only ``NULLABLE``, + ``REQUIRED`` and ``REPEATED`` are supported. Default mode is + ``NULLABLE``. + subcolumns: + Optional. Schema of sub-columns. A column can have zero or + more sub-columns. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ColumnSchema) + }, +) +_sym_db.RegisterMessage(ColumnSchema) + + +DESCRIPTOR._options = None +_SCHEMA.fields_by_name["columns"]._options = None +_COLUMNSCHEMA.fields_by_name["column"]._options = None +_COLUMNSCHEMA.fields_by_name["type"]._options = None +_COLUMNSCHEMA.fields_by_name["description"]._options = None +_COLUMNSCHEMA.fields_by_name["mode"]._options = None +_COLUMNSCHEMA.fields_by_name["subcolumns"]._options = None +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/schema_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/schema_pb2_grpc.py new file mode 100644 index 00000000..07cb78fe --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/schema_pb2_grpc.py @@ -0,0 +1,2 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc diff --git a/google/cloud/datacatalog_v1/proto/search_pb2.py b/google/cloud/datacatalog_v1/proto/search_pb2.py new file mode 100644 index 00000000..19283264 --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/search_pb2.py @@ -0,0 +1,280 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/search.proto + +from google.protobuf.internal import enum_type_wrapper +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.cloud.datacatalog_v1.proto import ( + common_pb2 as google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_common__pb2, +) +from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/search.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b'\n.google/cloud/datacatalog_v1/proto/search.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a.google/cloud/datacatalog_v1/proto/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xb4\x02\n\x13SearchCatalogResult\x12I\n\x12search_result_type\x18\x01 \x01(\x0e\x32-.google.cloud.datacatalog.v1.SearchResultType\x12\x1d\n\x15search_result_subtype\x18\x02 \x01(\t\x12\x1e\n\x16relative_resource_name\x18\x03 \x01(\t\x12\x17\n\x0flinked_resource\x18\x04 \x01(\t\x12O\n\x11integrated_system\x18\x08 \x01(\x0e\x32-.google.cloud.datacatalog.v1.IntegratedSystemB\x03\xe0\x41\x03H\x00\x12\x1f\n\x15user_specified_system\x18\t \x01(\tH\x00\x42\x08\n\x06system*d\n\x10SearchResultType\x12"\n\x1eSEARCH_RESULT_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x45NTRY\x10\x01\x12\x10\n\x0cTAG_TEMPLATE\x10\x02\x12\x0f\n\x0b\x45NTRY_GROUP\x10\x03\x42\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3', + dependencies=[ + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_common__pb2.DESCRIPTOR, + google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, + ], +) + +_SEARCHRESULTTYPE = _descriptor.EnumDescriptor( + name="SearchResultType", + full_name="google.cloud.datacatalog.v1.SearchResultType", + filename=None, + file=DESCRIPTOR, + values=[ + _descriptor.EnumValueDescriptor( + name="SEARCH_RESULT_TYPE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + ), + _descriptor.EnumValueDescriptor( + name="ENTRY", index=1, number=1, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="TAG_TEMPLATE", index=2, number=2, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="ENTRY_GROUP", index=3, number=3, serialized_options=None, type=None + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=504, + serialized_end=604, +) +_sym_db.RegisterEnumDescriptor(_SEARCHRESULTTYPE) + +SearchResultType = enum_type_wrapper.EnumTypeWrapper(_SEARCHRESULTTYPE) +SEARCH_RESULT_TYPE_UNSPECIFIED = 0 +ENTRY = 1 +TAG_TEMPLATE = 2 +ENTRY_GROUP = 3 + + +_SEARCHCATALOGRESULT = _descriptor.Descriptor( + name="SearchCatalogResult", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="search_result_type", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult.search_result_type", + index=0, + number=1, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="search_result_subtype", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult.search_result_subtype", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="relative_resource_name", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult.relative_resource_name", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="linked_resource", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult.linked_resource", + index=3, + number=4, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="integrated_system", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult.integrated_system", + index=4, + number=8, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="user_specified_system", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult.user_specified_system", + index=5, + number=9, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="system", + full_name="google.cloud.datacatalog.v1.SearchCatalogResult.system", + index=0, + containing_type=None, + fields=[], + ) + ], + serialized_start=194, + serialized_end=502, +) + +_SEARCHCATALOGRESULT.fields_by_name["search_result_type"].enum_type = _SEARCHRESULTTYPE +_SEARCHCATALOGRESULT.fields_by_name[ + "integrated_system" +].enum_type = ( + google_dot_cloud_dot_datacatalog__v1_dot_proto_dot_common__pb2._INTEGRATEDSYSTEM +) +_SEARCHCATALOGRESULT.oneofs_by_name["system"].fields.append( + _SEARCHCATALOGRESULT.fields_by_name["integrated_system"] +) +_SEARCHCATALOGRESULT.fields_by_name[ + "integrated_system" +].containing_oneof = _SEARCHCATALOGRESULT.oneofs_by_name["system"] +_SEARCHCATALOGRESULT.oneofs_by_name["system"].fields.append( + _SEARCHCATALOGRESULT.fields_by_name["user_specified_system"] +) +_SEARCHCATALOGRESULT.fields_by_name[ + "user_specified_system" +].containing_oneof = _SEARCHCATALOGRESULT.oneofs_by_name["system"] +DESCRIPTOR.message_types_by_name["SearchCatalogResult"] = _SEARCHCATALOGRESULT +DESCRIPTOR.enum_types_by_name["SearchResultType"] = _SEARCHRESULTTYPE +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + +SearchCatalogResult = _reflection.GeneratedProtocolMessageType( + "SearchCatalogResult", + (_message.Message,), + { + "DESCRIPTOR": _SEARCHCATALOGRESULT, + "__module__": "google.cloud.datacatalog_v1.proto.search_pb2", + "__doc__": """A result that appears in the response of a search request. + Each result captures details of one entry that matches the search. + + + Attributes: + search_result_type: + Type of the search result. This field can be used to determine + which Get method to call to fetch the full resource. + search_result_subtype: + Sub-type of the search result. This is a dot-delimited + description of the resource’s full type, and is the same as + the value callers would provide in the “type” search facet. + Examples: ``entry.table``, ``entry.dataStream``, + ``tagTemplate``. + relative_resource_name: + The relative resource name of the resource in URL format. + Examples: - ``projects/{project_id}/locations/{location_id}/ + entryGroups/{entry_group_id}/entries/{entry_id}`` - + ``projects/{project_id}/tagTemplates/{tag_template_id}`` + linked_resource: + The full name of the cloud resource the entry belongs to. See: + https://cloud.google.com/apis/design/resource_names#full_resou + rce_name. Example: - ``//bigquery.googleapis.com/projects/pr + ojectId/datasets/datasetId/tables/tableId`` + system: + The source system of the entry. Only applicable when + ``search_result_type`` is ENTRY. + integrated_system: + Output only. This field indicates the entry’s source system + that Data Catalog integrates with, such as BigQuery or Cloud + Pub/Sub. + user_specified_system: + This field indicates the entry’s source system that Data + Catalog does not integrate with. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.SearchCatalogResult) + }, +) +_sym_db.RegisterMessage(SearchCatalogResult) + + +DESCRIPTOR._options = None +_SEARCHCATALOGRESULT.fields_by_name["integrated_system"]._options = None +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/search_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/search_pb2_grpc.py new file mode 100644 index 00000000..07cb78fe --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/search_pb2_grpc.py @@ -0,0 +1,2 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc diff --git a/google/cloud/datacatalog_v1/proto/table_spec_pb2.py b/google/cloud/datacatalog_v1/proto/table_spec_pb2.py new file mode 100644 index 00000000..4f2e89c0 --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/table_spec_pb2.py @@ -0,0 +1,427 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/table_spec.proto + +from google.protobuf.internal import enum_type_wrapper +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/table_spec.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b'\n2google/cloud/datacatalog_v1/proto/table_spec.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto"\xe8\x01\n\x11\x42igQueryTableSpec\x12L\n\x11table_source_type\x18\x01 \x01(\x0e\x32,.google.cloud.datacatalog.v1.TableSourceTypeB\x03\xe0\x41\x03\x12:\n\tview_spec\x18\x02 \x01(\x0b\x32%.google.cloud.datacatalog.v1.ViewSpecH\x00\x12<\n\ntable_spec\x18\x03 \x01(\x0b\x32&.google.cloud.datacatalog.v1.TableSpecH\x00\x42\x0b\n\ttype_spec"#\n\x08ViewSpec\x12\x17\n\nview_query\x18\x01 \x01(\tB\x03\xe0\x41\x03"L\n\tTableSpec\x12?\n\rgrouped_entry\x18\x01 \x01(\tB(\xe0\x41\x03\xfa\x41"\n datacatalog.googleapis.com/Entry"\x89\x01\n\x17\x42igQueryDateShardedSpec\x12\x39\n\x07\x64\x61taset\x18\x01 \x01(\tB(\xe0\x41\x03\xfa\x41"\n datacatalog.googleapis.com/Entry\x12\x19\n\x0ctable_prefix\x18\x02 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0bshard_count\x18\x03 \x01(\x03\x42\x03\xe0\x41\x03*[\n\x0fTableSourceType\x12!\n\x1dTABLE_SOURCE_TYPE_UNSPECIFIED\x10\x00\x12\x11\n\rBIGQUERY_VIEW\x10\x02\x12\x12\n\x0e\x42IGQUERY_TABLE\x10\x05\x42\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3', + dependencies=[ + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, + ], +) + +_TABLESOURCETYPE = _descriptor.EnumDescriptor( + name="TableSourceType", + full_name="google.cloud.datacatalog.v1.TableSourceType", + filename=None, + file=DESCRIPTOR, + values=[ + _descriptor.EnumValueDescriptor( + name="TABLE_SOURCE_TYPE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + ), + _descriptor.EnumValueDescriptor( + name="BIGQUERY_VIEW", index=1, number=2, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="BIGQUERY_TABLE", index=2, number=5, serialized_options=None, type=None + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=633, + serialized_end=724, +) +_sym_db.RegisterEnumDescriptor(_TABLESOURCETYPE) + +TableSourceType = enum_type_wrapper.EnumTypeWrapper(_TABLESOURCETYPE) +TABLE_SOURCE_TYPE_UNSPECIFIED = 0 +BIGQUERY_VIEW = 2 +BIGQUERY_TABLE = 5 + + +_BIGQUERYTABLESPEC = _descriptor.Descriptor( + name="BigQueryTableSpec", + full_name="google.cloud.datacatalog.v1.BigQueryTableSpec", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="table_source_type", + full_name="google.cloud.datacatalog.v1.BigQueryTableSpec.table_source_type", + index=0, + number=1, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="view_spec", + full_name="google.cloud.datacatalog.v1.BigQueryTableSpec.view_spec", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="table_spec", + full_name="google.cloud.datacatalog.v1.BigQueryTableSpec.table_spec", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="type_spec", + full_name="google.cloud.datacatalog.v1.BigQueryTableSpec.type_spec", + index=0, + containing_type=None, + fields=[], + ) + ], + serialized_start=144, + serialized_end=376, +) + + +_VIEWSPEC = _descriptor.Descriptor( + name="ViewSpec", + full_name="google.cloud.datacatalog.v1.ViewSpec", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="view_query", + full_name="google.cloud.datacatalog.v1.ViewSpec.view_query", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=378, + serialized_end=413, +) + + +_TABLESPEC = _descriptor.Descriptor( + name="TableSpec", + full_name="google.cloud.datacatalog.v1.TableSpec", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="grouped_entry", + full_name="google.cloud.datacatalog.v1.TableSpec.grouped_entry", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b'\340A\003\372A"\n datacatalog.googleapis.com/Entry', + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=415, + serialized_end=491, +) + + +_BIGQUERYDATESHARDEDSPEC = _descriptor.Descriptor( + name="BigQueryDateShardedSpec", + full_name="google.cloud.datacatalog.v1.BigQueryDateShardedSpec", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="dataset", + full_name="google.cloud.datacatalog.v1.BigQueryDateShardedSpec.dataset", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b'\340A\003\372A"\n datacatalog.googleapis.com/Entry', + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="table_prefix", + full_name="google.cloud.datacatalog.v1.BigQueryDateShardedSpec.table_prefix", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="shard_count", + full_name="google.cloud.datacatalog.v1.BigQueryDateShardedSpec.shard_count", + index=2, + number=3, + type=3, + cpp_type=2, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=494, + serialized_end=631, +) + +_BIGQUERYTABLESPEC.fields_by_name["table_source_type"].enum_type = _TABLESOURCETYPE +_BIGQUERYTABLESPEC.fields_by_name["view_spec"].message_type = _VIEWSPEC +_BIGQUERYTABLESPEC.fields_by_name["table_spec"].message_type = _TABLESPEC +_BIGQUERYTABLESPEC.oneofs_by_name["type_spec"].fields.append( + _BIGQUERYTABLESPEC.fields_by_name["view_spec"] +) +_BIGQUERYTABLESPEC.fields_by_name[ + "view_spec" +].containing_oneof = _BIGQUERYTABLESPEC.oneofs_by_name["type_spec"] +_BIGQUERYTABLESPEC.oneofs_by_name["type_spec"].fields.append( + _BIGQUERYTABLESPEC.fields_by_name["table_spec"] +) +_BIGQUERYTABLESPEC.fields_by_name[ + "table_spec" +].containing_oneof = _BIGQUERYTABLESPEC.oneofs_by_name["type_spec"] +DESCRIPTOR.message_types_by_name["BigQueryTableSpec"] = _BIGQUERYTABLESPEC +DESCRIPTOR.message_types_by_name["ViewSpec"] = _VIEWSPEC +DESCRIPTOR.message_types_by_name["TableSpec"] = _TABLESPEC +DESCRIPTOR.message_types_by_name["BigQueryDateShardedSpec"] = _BIGQUERYDATESHARDEDSPEC +DESCRIPTOR.enum_types_by_name["TableSourceType"] = _TABLESOURCETYPE +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + +BigQueryTableSpec = _reflection.GeneratedProtocolMessageType( + "BigQueryTableSpec", + (_message.Message,), + { + "DESCRIPTOR": _BIGQUERYTABLESPEC, + "__module__": "google.cloud.datacatalog_v1.proto.table_spec_pb2", + "__doc__": """Describes a BigQuery table. + + + Attributes: + table_source_type: + Output only. The table source type. + type_spec: + Output only. + view_spec: + Table view specification. This field should only be populated + if ``table_source_type`` is ``BIGQUERY_VIEW``. + table_spec: + Spec of a BigQuery table. This field should only be populated + if ``table_source_type`` is ``BIGQUERY_TABLE``. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.BigQueryTableSpec) + }, +) +_sym_db.RegisterMessage(BigQueryTableSpec) + +ViewSpec = _reflection.GeneratedProtocolMessageType( + "ViewSpec", + (_message.Message,), + { + "DESCRIPTOR": _VIEWSPEC, + "__module__": "google.cloud.datacatalog_v1.proto.table_spec_pb2", + "__doc__": """Table view specification. + + + Attributes: + view_query: + Output only. The query that defines the table view. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.ViewSpec) + }, +) +_sym_db.RegisterMessage(ViewSpec) + +TableSpec = _reflection.GeneratedProtocolMessageType( + "TableSpec", + (_message.Message,), + { + "DESCRIPTOR": _TABLESPEC, + "__module__": "google.cloud.datacatalog_v1.proto.table_spec_pb2", + "__doc__": """Normal BigQuery table spec. + + + Attributes: + grouped_entry: + Output only. If the table is a dated shard, i.e., with name + pattern ``[prefix]YYYYMMDD``, ``grouped_entry`` is the Data + Catalog resource name of the date sharded grouped entry, for + example, ``projects/{project_id}/locations/{location}/entrygro + ups/{entry_group_id}/entries/{entry_id}``. Otherwise, + ``grouped_entry`` is empty. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.TableSpec) + }, +) +_sym_db.RegisterMessage(TableSpec) + +BigQueryDateShardedSpec = _reflection.GeneratedProtocolMessageType( + "BigQueryDateShardedSpec", + (_message.Message,), + { + "DESCRIPTOR": _BIGQUERYDATESHARDEDSPEC, + "__module__": "google.cloud.datacatalog_v1.proto.table_spec_pb2", + "__doc__": """Spec for a group of BigQuery tables with name pattern + ``[prefix]YYYYMMDD``. Context: + https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding + + + Attributes: + dataset: + Output only. The Data Catalog resource name of the dataset + entry the current table belongs to, for example, ``projects/{p + roject_id}/locations/{location}/entrygroups/{entry_group_id}/e + ntries/{entry_id}``. + table_prefix: + Output only. The table name prefix of the shards. The name of + any given shard is ``[table_prefix]YYYYMMDD``, for example, + for shard ``MyTable20180101``, the ``table_prefix`` is + ``MyTable``. + shard_count: + Output only. Total number of shards. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.BigQueryDateShardedSpec) + }, +) +_sym_db.RegisterMessage(BigQueryDateShardedSpec) + + +DESCRIPTOR._options = None +_BIGQUERYTABLESPEC.fields_by_name["table_source_type"]._options = None +_VIEWSPEC.fields_by_name["view_query"]._options = None +_TABLESPEC.fields_by_name["grouped_entry"]._options = None +_BIGQUERYDATESHARDEDSPEC.fields_by_name["dataset"]._options = None +_BIGQUERYDATESHARDEDSPEC.fields_by_name["table_prefix"]._options = None +_BIGQUERYDATESHARDEDSPEC.fields_by_name["shard_count"]._options = None +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/table_spec_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/table_spec_pb2_grpc.py new file mode 100644 index 00000000..07cb78fe --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/table_spec_pb2_grpc.py @@ -0,0 +1,2 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc diff --git a/google/cloud/datacatalog_v1/proto/tags_pb2.py b/google/cloud/datacatalog_v1/proto/tags_pb2.py new file mode 100644 index 00000000..14436cd4 --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/tags_pb2.py @@ -0,0 +1,1157 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/tags.proto + +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 +from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/tags.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b'\n,google/cloud/datacatalog_v1/proto/tags.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x86\x03\n\x03Tag\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x15\n\x08template\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12"\n\x15template_display_name\x18\x05 \x01(\tB\x03\xe0\x41\x03\x12\x10\n\x06\x63olumn\x18\x04 \x01(\tH\x00\x12\x41\n\x06\x66ields\x18\x03 \x03(\x0b\x32,.google.cloud.datacatalog.v1.Tag.FieldsEntryB\x03\xe0\x41\x02\x1aT\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x34\n\x05value\x18\x02 \x01(\x0b\x32%.google.cloud.datacatalog.v1.TagField:\x02\x38\x01:\x81\x01\xea\x41~\n\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\\projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}B\x07\n\x05scope"\xa8\x02\n\x08TagField\x12\x19\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x16\n\x0c\x64ouble_value\x18\x02 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x03 \x01(\tH\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\x0ftimestamp_value\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x45\n\nenum_value\x18\x06 \x01(\x0b\x32/.google.cloud.datacatalog.v1.TagField.EnumValueH\x00\x12\x12\n\x05order\x18\x07 \x01(\x05\x42\x03\xe0\x41\x03\x1a!\n\tEnumValue\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x06\n\x04kind"\xcc\x02\n\x0bTagTemplate\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12I\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x34.google.cloud.datacatalog.v1.TagTemplate.FieldsEntryB\x03\xe0\x41\x02\x1a\\\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12<\n\x05value\x18\x02 \x01(\x0b\x32-.google.cloud.datacatalog.v1.TagTemplateField:\x02\x38\x01:p\xea\x41m\n&datacatalog.googleapis.com/TagTemplate\x12\x43projects/{project}/locations/{location}/tagTemplates/{tag_template}"\xa2\x02\n\x10TagTemplateField\x12\x11\n\x04name\x18\x06 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x39\n\x04type\x18\x02 \x01(\x0b\x32&.google.cloud.datacatalog.v1.FieldTypeB\x03\xe0\x41\x02\x12\x13\n\x0bis_required\x18\x03 \x01(\x08\x12\r\n\x05order\x18\x05 \x01(\x05:\x85\x01\xea\x41\x81\x01\n+datacatalog.googleapis.com/TagTemplateField\x12Rprojects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}"\x98\x03\n\tFieldType\x12N\n\x0eprimitive_type\x18\x01 \x01(\x0e\x32\x34.google.cloud.datacatalog.v1.FieldType.PrimitiveTypeH\x00\x12\x44\n\tenum_type\x18\x02 \x01(\x0b\x32/.google.cloud.datacatalog.v1.FieldType.EnumTypeH\x00\x1a\x85\x01\n\x08\x45numType\x12Q\n\x0e\x61llowed_values\x18\x01 \x03(\x0b\x32\x39.google.cloud.datacatalog.v1.FieldType.EnumType.EnumValue\x1a&\n\tEnumValue\x12\x19\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x03\xe0\x41\x02"`\n\rPrimitiveType\x12\x1e\n\x1aPRIMITIVE_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06\x44OUBLE\x10\x01\x12\n\n\x06STRING\x10\x02\x12\x08\n\x04\x42OOL\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x42\x0b\n\ttype_declB\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3', + dependencies=[ + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, + google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, + ], +) + + +_FIELDTYPE_PRIMITIVETYPE = _descriptor.EnumDescriptor( + name="PrimitiveType", + full_name="google.cloud.datacatalog.v1.FieldType.PrimitiveType", + filename=None, + file=DESCRIPTOR, + values=[ + _descriptor.EnumValueDescriptor( + name="PRIMITIVE_TYPE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + ), + _descriptor.EnumValueDescriptor( + name="DOUBLE", index=1, number=1, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="STRING", index=2, number=2, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="BOOL", index=3, number=3, serialized_options=None, type=None + ), + _descriptor.EnumValueDescriptor( + name="TIMESTAMP", index=4, number=4, serialized_options=None, type=None + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=1790, + serialized_end=1886, +) +_sym_db.RegisterEnumDescriptor(_FIELDTYPE_PRIMITIVETYPE) + + +_TAG_FIELDSENTRY = _descriptor.Descriptor( + name="FieldsEntry", + full_name="google.cloud.datacatalog.v1.Tag.FieldsEntry", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="key", + full_name="google.cloud.datacatalog.v1.Tag.FieldsEntry.key", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="value", + full_name="google.cloud.datacatalog.v1.Tag.FieldsEntry.value", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=b"8\001", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=336, + serialized_end=420, +) + +_TAG = _descriptor.Descriptor( + name="Tag", + full_name="google.cloud.datacatalog.v1.Tag", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.Tag.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="template", + full_name="google.cloud.datacatalog.v1.Tag.template", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="template_display_name", + full_name="google.cloud.datacatalog.v1.Tag.template_display_name", + index=2, + number=5, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="column", + full_name="google.cloud.datacatalog.v1.Tag.column", + index=3, + number=4, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="fields", + full_name="google.cloud.datacatalog.v1.Tag.fields", + index=4, + number=3, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[_TAG_FIELDSENTRY], + enum_types=[], + serialized_options=b"\352A~\n\036datacatalog.googleapis.com/Tag\022\\projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="scope", + full_name="google.cloud.datacatalog.v1.Tag.scope", + index=0, + containing_type=None, + fields=[], + ) + ], + serialized_start=171, + serialized_end=561, +) + + +_TAGFIELD_ENUMVALUE = _descriptor.Descriptor( + name="EnumValue", + full_name="google.cloud.datacatalog.v1.TagField.EnumValue", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.cloud.datacatalog.v1.TagField.EnumValue.display_name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=819, + serialized_end=852, +) + +_TAGFIELD = _descriptor.Descriptor( + name="TagField", + full_name="google.cloud.datacatalog.v1.TagField", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.cloud.datacatalog.v1.TagField.display_name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="double_value", + full_name="google.cloud.datacatalog.v1.TagField.double_value", + index=1, + number=2, + type=1, + cpp_type=5, + label=1, + has_default_value=False, + default_value=float(0), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="string_value", + full_name="google.cloud.datacatalog.v1.TagField.string_value", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="bool_value", + full_name="google.cloud.datacatalog.v1.TagField.bool_value", + index=3, + number=4, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="timestamp_value", + full_name="google.cloud.datacatalog.v1.TagField.timestamp_value", + index=4, + number=5, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="enum_value", + full_name="google.cloud.datacatalog.v1.TagField.enum_value", + index=5, + number=6, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="order", + full_name="google.cloud.datacatalog.v1.TagField.order", + index=6, + number=7, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[_TAGFIELD_ENUMVALUE], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="kind", + full_name="google.cloud.datacatalog.v1.TagField.kind", + index=0, + containing_type=None, + fields=[], + ) + ], + serialized_start=564, + serialized_end=860, +) + + +_TAGTEMPLATE_FIELDSENTRY = _descriptor.Descriptor( + name="FieldsEntry", + full_name="google.cloud.datacatalog.v1.TagTemplate.FieldsEntry", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="key", + full_name="google.cloud.datacatalog.v1.TagTemplate.FieldsEntry.key", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="value", + full_name="google.cloud.datacatalog.v1.TagTemplate.FieldsEntry.value", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=b"8\001", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=989, + serialized_end=1081, +) + +_TAGTEMPLATE = _descriptor.Descriptor( + name="TagTemplate", + full_name="google.cloud.datacatalog.v1.TagTemplate", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.TagTemplate.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.cloud.datacatalog.v1.TagTemplate.display_name", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="fields", + full_name="google.cloud.datacatalog.v1.TagTemplate.fields", + index=2, + number=3, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[_TAGTEMPLATE_FIELDSENTRY], + enum_types=[], + serialized_options=b"\352Am\n&datacatalog.googleapis.com/TagTemplate\022Cprojects/{project}/locations/{location}/tagTemplates/{tag_template}", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=863, + serialized_end=1195, +) + + +_TAGTEMPLATEFIELD = _descriptor.Descriptor( + name="TagTemplateField", + full_name="google.cloud.datacatalog.v1.TagTemplateField", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.cloud.datacatalog.v1.TagTemplateField.name", + index=0, + number=6, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.cloud.datacatalog.v1.TagTemplateField.display_name", + index=1, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="type", + full_name="google.cloud.datacatalog.v1.TagTemplateField.type", + index=2, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="is_required", + full_name="google.cloud.datacatalog.v1.TagTemplateField.is_required", + index=3, + number=3, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="order", + full_name="google.cloud.datacatalog.v1.TagTemplateField.order", + index=4, + number=5, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=b"\352A\201\001\n+datacatalog.googleapis.com/TagTemplateField\022Rprojects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1198, + serialized_end=1488, +) + + +_FIELDTYPE_ENUMTYPE_ENUMVALUE = _descriptor.Descriptor( + name="EnumValue", + full_name="google.cloud.datacatalog.v1.FieldType.EnumType.EnumValue", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.cloud.datacatalog.v1.FieldType.EnumType.EnumValue.display_name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1750, + serialized_end=1788, +) + +_FIELDTYPE_ENUMTYPE = _descriptor.Descriptor( + name="EnumType", + full_name="google.cloud.datacatalog.v1.FieldType.EnumType", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="allowed_values", + full_name="google.cloud.datacatalog.v1.FieldType.EnumType.allowed_values", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ) + ], + extensions=[], + nested_types=[_FIELDTYPE_ENUMTYPE_ENUMVALUE], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1655, + serialized_end=1788, +) + +_FIELDTYPE = _descriptor.Descriptor( + name="FieldType", + full_name="google.cloud.datacatalog.v1.FieldType", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="primitive_type", + full_name="google.cloud.datacatalog.v1.FieldType.primitive_type", + index=0, + number=1, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="enum_type", + full_name="google.cloud.datacatalog.v1.FieldType.enum_type", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[_FIELDTYPE_ENUMTYPE], + enum_types=[_FIELDTYPE_PRIMITIVETYPE], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="type_decl", + full_name="google.cloud.datacatalog.v1.FieldType.type_decl", + index=0, + containing_type=None, + fields=[], + ) + ], + serialized_start=1491, + serialized_end=1899, +) + +_TAG_FIELDSENTRY.fields_by_name["value"].message_type = _TAGFIELD +_TAG_FIELDSENTRY.containing_type = _TAG +_TAG.fields_by_name["fields"].message_type = _TAG_FIELDSENTRY +_TAG.oneofs_by_name["scope"].fields.append(_TAG.fields_by_name["column"]) +_TAG.fields_by_name["column"].containing_oneof = _TAG.oneofs_by_name["scope"] +_TAGFIELD_ENUMVALUE.containing_type = _TAGFIELD +_TAGFIELD.fields_by_name[ + "timestamp_value" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_TAGFIELD.fields_by_name["enum_value"].message_type = _TAGFIELD_ENUMVALUE +_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["double_value"]) +_TAGFIELD.fields_by_name["double_value"].containing_oneof = _TAGFIELD.oneofs_by_name[ + "kind" +] +_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["string_value"]) +_TAGFIELD.fields_by_name["string_value"].containing_oneof = _TAGFIELD.oneofs_by_name[ + "kind" +] +_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["bool_value"]) +_TAGFIELD.fields_by_name["bool_value"].containing_oneof = _TAGFIELD.oneofs_by_name[ + "kind" +] +_TAGFIELD.oneofs_by_name["kind"].fields.append( + _TAGFIELD.fields_by_name["timestamp_value"] +) +_TAGFIELD.fields_by_name["timestamp_value"].containing_oneof = _TAGFIELD.oneofs_by_name[ + "kind" +] +_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["enum_value"]) +_TAGFIELD.fields_by_name["enum_value"].containing_oneof = _TAGFIELD.oneofs_by_name[ + "kind" +] +_TAGTEMPLATE_FIELDSENTRY.fields_by_name["value"].message_type = _TAGTEMPLATEFIELD +_TAGTEMPLATE_FIELDSENTRY.containing_type = _TAGTEMPLATE +_TAGTEMPLATE.fields_by_name["fields"].message_type = _TAGTEMPLATE_FIELDSENTRY +_TAGTEMPLATEFIELD.fields_by_name["type"].message_type = _FIELDTYPE +_FIELDTYPE_ENUMTYPE_ENUMVALUE.containing_type = _FIELDTYPE_ENUMTYPE +_FIELDTYPE_ENUMTYPE.fields_by_name[ + "allowed_values" +].message_type = _FIELDTYPE_ENUMTYPE_ENUMVALUE +_FIELDTYPE_ENUMTYPE.containing_type = _FIELDTYPE +_FIELDTYPE.fields_by_name["primitive_type"].enum_type = _FIELDTYPE_PRIMITIVETYPE +_FIELDTYPE.fields_by_name["enum_type"].message_type = _FIELDTYPE_ENUMTYPE +_FIELDTYPE_PRIMITIVETYPE.containing_type = _FIELDTYPE +_FIELDTYPE.oneofs_by_name["type_decl"].fields.append( + _FIELDTYPE.fields_by_name["primitive_type"] +) +_FIELDTYPE.fields_by_name[ + "primitive_type" +].containing_oneof = _FIELDTYPE.oneofs_by_name["type_decl"] +_FIELDTYPE.oneofs_by_name["type_decl"].fields.append( + _FIELDTYPE.fields_by_name["enum_type"] +) +_FIELDTYPE.fields_by_name["enum_type"].containing_oneof = _FIELDTYPE.oneofs_by_name[ + "type_decl" +] +DESCRIPTOR.message_types_by_name["Tag"] = _TAG +DESCRIPTOR.message_types_by_name["TagField"] = _TAGFIELD +DESCRIPTOR.message_types_by_name["TagTemplate"] = _TAGTEMPLATE +DESCRIPTOR.message_types_by_name["TagTemplateField"] = _TAGTEMPLATEFIELD +DESCRIPTOR.message_types_by_name["FieldType"] = _FIELDTYPE +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + +Tag = _reflection.GeneratedProtocolMessageType( + "Tag", + (_message.Message,), + { + "FieldsEntry": _reflection.GeneratedProtocolMessageType( + "FieldsEntry", + (_message.Message,), + { + "DESCRIPTOR": _TAG_FIELDSENTRY, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2" + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.Tag.FieldsEntry) + }, + ), + "DESCRIPTOR": _TAG, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """Tags are used to attach custom metadata to Data Catalog + resources. Tags conform to the specifications within their tag template. + + See `Data Catalog IAM `__ for + information on the permissions needed to create or view tags. + + + Attributes: + name: + The resource name of the tag in URL format. Example: - proje + cts/{project_id}/locations/{location}/entrygroups/{entry_group + _id}/entries/{entry_id}/tags/{tag_id} where ``tag_id`` is a + system-generated identifier. Note that this Tag may not + actually be stored in the location in this name. + template: + Required. The resource name of the tag template that this tag + uses. Example: - projects/{project_id}/locations/{location}/ + tagTemplates/{tag_template_id} This field cannot be modified + after creation. + template_display_name: + Output only. The display name of the tag template. + scope: + The scope within the parent resource that this tag is attached + to. If not provided, the tag is attached to the parent + resource itself. Deleting the scope from the parent resource + will delete all tags attached to that scope. These fields + cannot be updated after creation. + column: + Resources like Entry can have schemas associated with them. + This scope allows users to attach tags to an individual column + based on that schema. For attaching a tag to a nested column, + use ``.`` to separate the column names. Example: - + ``outer_column.inner_column`` + fields: + Required. This maps the ID of a tag field to the value of and + additional information about that field. Valid field IDs are + defined by the tag’s template. A tag must have at least 1 + field and at most 500 fields. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.Tag) + }, +) +_sym_db.RegisterMessage(Tag) +_sym_db.RegisterMessage(Tag.FieldsEntry) + +TagField = _reflection.GeneratedProtocolMessageType( + "TagField", + (_message.Message,), + { + "EnumValue": _reflection.GeneratedProtocolMessageType( + "EnumValue", + (_message.Message,), + { + "DESCRIPTOR": _TAGFIELD_ENUMVALUE, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """Holds an enum value. + + + Attributes: + display_name: + The display name of the enum value. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.TagField.EnumValue) + }, + ), + "DESCRIPTOR": _TAGFIELD, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """Contains the value and supporting information for a field + within a [Tag][google.cloud.datacatalog.v1.Tag]. + + + Attributes: + display_name: + Output only. The display name of this field. + kind: + Required. The value of this field. + double_value: + Holds the value for a tag field with double type. + string_value: + Holds the value for a tag field with string type. + bool_value: + Holds the value for a tag field with boolean type. + timestamp_value: + Holds the value for a tag field with timestamp type. + enum_value: + Holds the value for a tag field with enum type. This value + must be one of the allowed values in the definition of this + enum. + order: + Output only. The order of this field with respect to other + fields in this tag. It can be set in + [Tag][google.cloud.datacatalog.v1.TagTemplateField.order]. For + example, a higher value can indicate a more important field. + The value can be negative. Multiple fields can have the same + order, and field orders within a tag do not have to be + sequential. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.TagField) + }, +) +_sym_db.RegisterMessage(TagField) +_sym_db.RegisterMessage(TagField.EnumValue) + +TagTemplate = _reflection.GeneratedProtocolMessageType( + "TagTemplate", + (_message.Message,), + { + "FieldsEntry": _reflection.GeneratedProtocolMessageType( + "FieldsEntry", + (_message.Message,), + { + "DESCRIPTOR": _TAGTEMPLATE_FIELDSENTRY, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2" + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.TagTemplate.FieldsEntry) + }, + ), + "DESCRIPTOR": _TAGTEMPLATE, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """A tag template defines a tag, which can have one or more + typed fields. The template is used to create and attach the tag to GCP + resources. `Tag template + roles `__ provide + permissions to create, edit, and use the template. See, for example, the + `TagTemplate User `__ role, + which includes permission to use the tag template to tag resources. + + + Attributes: + name: + The resource name of the tag template in URL format. Example: + - projects/{project_id}/locations/{location}/tagTemplates/{ta + g_template_id} Note that this TagTemplate and its child + resources may not actually be stored in the location in this + name. + display_name: + The display name for this template. Defaults to an empty + string. + fields: + Required. Map of tag template field IDs to the settings for + the field. This map is an exhaustive list of the allowed + fields. This map must contain at least one field and at most + 500 fields. The keys to this map are tag template field IDs. + Field IDs can contain letters (both uppercase and lowercase), + numbers (0-9) and underscores (_). Field IDs must be at least + 1 character long and at most 64 characters long. Field IDs + must start with a letter or underscore. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.TagTemplate) + }, +) +_sym_db.RegisterMessage(TagTemplate) +_sym_db.RegisterMessage(TagTemplate.FieldsEntry) + +TagTemplateField = _reflection.GeneratedProtocolMessageType( + "TagTemplateField", + (_message.Message,), + { + "DESCRIPTOR": _TAGTEMPLATEFIELD, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """The template for an individual field within a tag + template. + + + Attributes: + name: + Output only. The resource name of the tag template field in + URL format. Example: - projects/{project_id}/locations/{loca + tion}/tagTemplates/{tag_template}/fields/{field} Note that + this TagTemplateField may not actually be stored in the + location in this name. + display_name: + The display name for this field. Defaults to an empty string. + type: + Required. The type of value this tag field can contain. + is_required: + Whether this is a required field. Defaults to false. + order: + The order of this field with respect to other fields in this + tag template. For example, a higher value can indicate a more + important field. The value can be negative. Multiple fields + can have the same order, and field orders within a tag do not + have to be sequential. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.TagTemplateField) + }, +) +_sym_db.RegisterMessage(TagTemplateField) + +FieldType = _reflection.GeneratedProtocolMessageType( + "FieldType", + (_message.Message,), + { + "EnumType": _reflection.GeneratedProtocolMessageType( + "EnumType", + (_message.Message,), + { + "EnumValue": _reflection.GeneratedProtocolMessageType( + "EnumValue", + (_message.Message,), + { + "DESCRIPTOR": _FIELDTYPE_ENUMTYPE_ENUMVALUE, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """ + Attributes: + display_name: + Required. The display name of the enum value. Must not be an + empty string. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.FieldType.EnumType.EnumValue) + }, + ), + "DESCRIPTOR": _FIELDTYPE_ENUMTYPE, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """ + Attributes: + allowed_values: + Required on create; optional on update. The set of allowed + values for this enum. This set must not be empty, the display + names of the values in this set must not be empty and the + display names of the values must be case-insensitively unique + within this set. Currently, enum values can only be added to + the list of allowed values. Deletion and renaming of enum + values are not supported. Can have up to 500 allowed values. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.FieldType.EnumType) + }, + ), + "DESCRIPTOR": _FIELDTYPE, + "__module__": "google.cloud.datacatalog_v1.proto.tags_pb2", + "__doc__": """ + Attributes: + type_decl: + Required. + primitive_type: + Represents primitive types - string, bool etc. + enum_type: + Represents an enum type. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.FieldType) + }, +) +_sym_db.RegisterMessage(FieldType) +_sym_db.RegisterMessage(FieldType.EnumType) +_sym_db.RegisterMessage(FieldType.EnumType.EnumValue) + + +DESCRIPTOR._options = None +_TAG_FIELDSENTRY._options = None +_TAG.fields_by_name["template"]._options = None +_TAG.fields_by_name["template_display_name"]._options = None +_TAG.fields_by_name["fields"]._options = None +_TAG._options = None +_TAGFIELD.fields_by_name["display_name"]._options = None +_TAGFIELD.fields_by_name["order"]._options = None +_TAGTEMPLATE_FIELDSENTRY._options = None +_TAGTEMPLATE.fields_by_name["fields"]._options = None +_TAGTEMPLATE._options = None +_TAGTEMPLATEFIELD.fields_by_name["name"]._options = None +_TAGTEMPLATEFIELD.fields_by_name["type"]._options = None +_TAGTEMPLATEFIELD._options = None +_FIELDTYPE_ENUMTYPE_ENUMVALUE.fields_by_name["display_name"]._options = None +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/tags_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/tags_pb2_grpc.py new file mode 100644 index 00000000..07cb78fe --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/tags_pb2_grpc.py @@ -0,0 +1,2 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc diff --git a/google/cloud/datacatalog_v1/proto/timestamps_pb2.py b/google/cloud/datacatalog_v1/proto/timestamps_pb2.py new file mode 100644 index 00000000..c808405f --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/timestamps_pb2.py @@ -0,0 +1,145 @@ +# -*- coding: utf-8 -*- +# Generated by the protocol buffer compiler. DO NOT EDIT! +# source: google/cloud/datacatalog_v1/proto/timestamps.proto + +from google.protobuf import descriptor as _descriptor +from google.protobuf import message as _message +from google.protobuf import reflection as _reflection +from google.protobuf import symbol_database as _symbol_database + +# @@protoc_insertion_point(imports) + +_sym_db = _symbol_database.Default() + + +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 +from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 + + +DESCRIPTOR = _descriptor.FileDescriptor( + name="google/cloud/datacatalog_v1/proto/timestamps.proto", + package="google.cloud.datacatalog.v1", + syntax="proto3", + serialized_options=b"\n\037com.google.cloud.datacatalog.v1P\001ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\370\001\001\252\002\033Google.Cloud.DataCatalog.V1\312\002\033Google\\Cloud\\DataCatalog\\V1\352\002\036Google::Cloud::DataCatalog::V1", + serialized_pb=b'\n2google/cloud/datacatalog_v1/proto/timestamps.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xaa\x01\n\x10SystemTimestamps\x12/\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x42\xcb\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZFgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3', + dependencies=[ + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, + ], +) + + +_SYSTEMTIMESTAMPS = _descriptor.Descriptor( + name="SystemTimestamps", + full_name="google.cloud.datacatalog.v1.SystemTimestamps", + filename=None, + file=DESCRIPTOR, + containing_type=None, + fields=[ + _descriptor.FieldDescriptor( + name="create_time", + full_name="google.cloud.datacatalog.v1.SystemTimestamps.create_time", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="update_time", + full_name="google.cloud.datacatalog.v1.SystemTimestamps.update_time", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + ), + _descriptor.FieldDescriptor( + name="expire_time", + full_name="google.cloud.datacatalog.v1.SystemTimestamps.expire_time", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=150, + serialized_end=320, +) + +_SYSTEMTIMESTAMPS.fields_by_name[ + "create_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_SYSTEMTIMESTAMPS.fields_by_name[ + "update_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_SYSTEMTIMESTAMPS.fields_by_name[ + "expire_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +DESCRIPTOR.message_types_by_name["SystemTimestamps"] = _SYSTEMTIMESTAMPS +_sym_db.RegisterFileDescriptor(DESCRIPTOR) + +SystemTimestamps = _reflection.GeneratedProtocolMessageType( + "SystemTimestamps", + (_message.Message,), + { + "DESCRIPTOR": _SYSTEMTIMESTAMPS, + "__module__": "google.cloud.datacatalog_v1.proto.timestamps_pb2", + "__doc__": """Timestamps about this resource according to a particular system. + + + Attributes: + create_time: + The creation time of the resource within the given system. + update_time: + The last-modified time of the resource within the given + system. + expire_time: + Output only. The expiration time of the resource within the + given system. Currently only apllicable to BigQuery resources. + """, + # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.SystemTimestamps) + }, +) +_sym_db.RegisterMessage(SystemTimestamps) + + +DESCRIPTOR._options = None +_SYSTEMTIMESTAMPS.fields_by_name["expire_time"]._options = None +# @@protoc_insertion_point(module_scope) diff --git a/google/cloud/datacatalog_v1/proto/timestamps_pb2_grpc.py b/google/cloud/datacatalog_v1/proto/timestamps_pb2_grpc.py new file mode 100644 index 00000000..07cb78fe --- /dev/null +++ b/google/cloud/datacatalog_v1/proto/timestamps_pb2_grpc.py @@ -0,0 +1,2 @@ +# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +import grpc diff --git a/google/cloud/datacatalog_v1/types.py b/google/cloud/datacatalog_v1/types.py new file mode 100644 index 00000000..6bff6007 --- /dev/null +++ b/google/cloud/datacatalog_v1/types.py @@ -0,0 +1,72 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + + +from __future__ import absolute_import +import sys + +from google.api_core.protobuf_helpers import get_messages + +from google.cloud.datacatalog_v1.proto import datacatalog_pb2 +from google.cloud.datacatalog_v1.proto import gcs_fileset_spec_pb2 +from google.cloud.datacatalog_v1.proto import schema_pb2 +from google.cloud.datacatalog_v1.proto import search_pb2 +from google.cloud.datacatalog_v1.proto import table_spec_pb2 +from google.cloud.datacatalog_v1.proto import tags_pb2 +from google.cloud.datacatalog_v1.proto import timestamps_pb2 +from google.iam.v1 import iam_policy_pb2 +from google.iam.v1 import options_pb2 +from google.iam.v1 import policy_pb2 +from google.protobuf import empty_pb2 +from google.protobuf import field_mask_pb2 +from google.protobuf import timestamp_pb2 +from google.type import expr_pb2 + + +_shared_modules = [ + iam_policy_pb2, + options_pb2, + policy_pb2, + empty_pb2, + field_mask_pb2, + timestamp_pb2, + expr_pb2, +] + +_local_modules = [ + datacatalog_pb2, + gcs_fileset_spec_pb2, + schema_pb2, + search_pb2, + table_spec_pb2, + tags_pb2, + timestamps_pb2, +] + +names = [] + +for module in _shared_modules: # pragma: NO COVER + for name, message in get_messages(module).items(): + setattr(sys.modules[__name__], name, message) + names.append(name) +for module in _local_modules: + for name, message in get_messages(module).items(): + message.__module__ = "google.cloud.datacatalog_v1.types" + setattr(sys.modules[__name__], name, message) + names.append(name) + + +__all__ = tuple(sorted(names)) diff --git a/google/cloud/datacatalog_v1beta1/__init__.py b/google/cloud/datacatalog_v1beta1/__init__.py index fe3a5068..cf1b86f9 100644 --- a/google/cloud/datacatalog_v1beta1/__init__.py +++ b/google/cloud/datacatalog_v1beta1/__init__.py @@ -1,6 +1,6 @@ # -*- coding: utf-8 -*- # -# Copyright 2019 Google LLC +# Copyright 2020 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. @@ -14,7 +14,10 @@ # See the License for the specific language governing permissions and # limitations under the License. + from __future__ import absolute_import +import sys +import warnings from google.cloud.datacatalog_v1beta1 import types from google.cloud.datacatalog_v1beta1.gapic import data_catalog_client @@ -25,6 +28,15 @@ ) +if sys.version_info[:2] == (2, 7): + message = ( + "A future version of this library will drop support for Python 2.7." + "More details about Python 2 support for Google Cloud Client Libraries" + "can be found at https://cloud.google.com/python/docs/python2-sunset/" + ) + warnings.warn(message, DeprecationWarning) + + class DataCatalogClient(data_catalog_client.DataCatalogClient): __doc__ = data_catalog_client.DataCatalogClient.__doc__ enums = enums diff --git a/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py b/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py index 34fd3632..635d29af 100644 --- a/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py +++ b/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py @@ -276,7 +276,7 @@ def search_catalog( match a query. This is a custom method - (https://cloud.google.com/apis/design/custom\_methods) and does not + (https://cloud.google.com/apis/design/custom_methods) and does not return the complete resource, only the resource identifier and high level fields. Clients can subsequentally call ``Get`` methods. @@ -337,8 +337,8 @@ def search_catalog( resource, this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page. - order_by (str): Specifies the ordering of results, currently supported case-sensitive - choices are: + order_by (str): Specifies the ordering of results, currently supported + case-sensitive choices are: - ``relevance``, only supports descending - ``last_modified_timestamp [asc|desc]``, defaults to descending if not @@ -443,7 +443,7 @@ def create_entry_group( Args: parent (str): Required. The name of the project this entry group is in. Example: - - projects/{project\_id}/locations/{location} + - projects/{project_id}/locations/{location} Note that this EntryGroup and its child resources may not actually be stored in the location in this name. @@ -588,8 +588,8 @@ def delete_entry_group( metadata=None, ): """ - Deletes an EntryGroup. Only entry groups that do not contain entries can - be deleted. Users should enable the Data Catalog API in the project + Deletes an EntryGroup. Only entry groups that do not contain entries + can be deleted. Users should enable the Data Catalog API in the project identified by the ``name`` parameter (see [Data Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) for more information). @@ -662,8 +662,8 @@ def create_entry( metadata=None, ): """ - Creates an entry. Only entries of 'FILESET' type or user-specified type - can be created. + Creates an entry. Only entries of 'FILESET' type or user-specified + type can be created. Users should enable the Data Catalog API in the project identified by the ``parent`` parameter (see [Data Catalog Resource Project] @@ -689,7 +689,7 @@ def create_entry( Args: parent (str): Required. The name of the entry group this entry is in. Example: - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} Note that this Entry and its child resources may not actually be stored in the location in this name. @@ -757,8 +757,8 @@ def update_entry( metadata=None, ): """ - Updates an existing entry. Users should enable the Data Catalog API in - the project identified by the ``entry.name`` parameter (see [Data + Updates an existing entry. Users should enable the Data Catalog API + in the project identified by the ``entry.name`` parameter (see [Data Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) for more information). @@ -777,8 +777,8 @@ def update_entry( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Entry` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to update on the entry. If absent or empty, all modifiable - fields are updated. + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to update on the entry. If absent or empty, all + modifiable fields are updated. The following fields are modifiable: @@ -799,10 +799,10 @@ def update_entry( - ``schema`` - ``display_name`` - ``description`` - - user\_specified\_type - - user\_specified\_system - - linked\_resource - - source\_system\_timestamps + - user_specified_type + - user_specified_system + - linked_resource + - source_system_timestamps If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -864,11 +864,11 @@ def delete_entry( metadata=None, ): """ - Deletes an existing entry. Only entries created through ``CreateEntry`` - method can be deleted. Users should enable the Data Catalog API in the - project identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Deletes an existing entry. Only entries created through + ``CreateEntry`` method can be deleted. Users should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Example: >>> from google.cloud import datacatalog_v1beta1 @@ -882,7 +882,7 @@ def delete_entry( Args: name (str): Required. The name of the entry. Example: - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -950,7 +950,7 @@ def get_entry( Args: name (str): Required. The name of the entry. Example: - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1022,7 +1022,7 @@ def lookup_entry( Args: linked_resource (str): The full name of the Google Cloud Platform resource the Data Catalog entry represents. See: - https://cloud.google.com/apis/design/resource\_names#full\_resource\_name. + https://cloud.google.com/apis/design/resource_names#full_resource_name. Full names are case-sensitive. Examples: @@ -1034,7 +1034,7 @@ def lookup_entry( Examples: - ``cloud_pubsub.project_id.topic_id`` - - ``pubsub.project_id.`topic.id.with.dots``` + - :literal:`pubsub.project_id.`topic.id.with.dots\`` - ``bigquery.table.project_id.dataset_id.table_id`` - ``bigquery.dataset.project_id.dataset_id`` - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` @@ -1106,10 +1106,10 @@ def list_entry_groups( >>> response = client.list_entry_groups(parent) Args: - parent (str): Required. The name of the location that contains the entry groups, which - can be provided in URL format. Example: + parent (str): Required. The name of the location that contains the entry groups, + which can be provided in URL format. Example: - - projects/{project\_id}/locations/{location} + - projects/{project_id}/locations/{location} page_size (int): Optional. The maximum number of items to return. Default is 10. Max limit is 1000. Throws an invalid argument for ``page_size > 1000``. page_token (str): Optional. Token that specifies which page is requested. If empty, the first @@ -1187,16 +1187,16 @@ def list_entries( >>> response = client.list_entries(parent) Args: - parent (str): Required. The name of the entry group that contains the entries, which - can be provided in URL format. Example: + parent (str): Required. The name of the entry group that contains the entries, + which can be provided in URL format. Example: - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id} - page_size (int): The maximum number of items to return. Default is 10. Max limit is 1000. - Throws an invalid argument for ``page_size > 1000``. + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + page_size (int): The maximum number of items to return. Default is 10. Max limit is + 1000. Throws an invalid argument for ``page_size > 1000``. page_token (str): Token that specifies which page is requested. If empty, the first page is returned. - read_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to return for each Entry. If not set or empty, all fields are - returned. For example, setting read\_mask to contain only one path + read_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to return for each Entry. If not set or empty, all fields + are returned. For example, setting read_mask to contain only one path "name" will cause ListEntries to return a list of Entries with only "name" field. @@ -1264,10 +1264,10 @@ def update_entry_group( metadata=None, ): """ - Updates an EntryGroup. The user should enable the Data Catalog API in - the project identified by the ``entry_group.name`` parameter (see [Data - Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) - for more information). + Updates an EntryGroup. The user should enable the Data Catalog API + in the project identified by the ``entry_group.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1349,8 +1349,8 @@ def create_tag_template( metadata=None, ): """ - Creates a tag template. The user should enable the Data Catalog API in - the project identified by the ``parent`` parameter (see `Data Catalog + Creates a tag template. The user should enable the Data Catalog API + in the project identified by the ``parent`` parameter (see `Data Catalog Resource Project `__ for more information). @@ -1377,7 +1377,7 @@ def create_tag_template( Example: - - projects/{project\_id}/locations/us-central1 + - projects/{project_id}/locations/us-central1 tag_template_id (str): Required. The id of the tag template to create. tag_template (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplate]): Required. The tag template to create. @@ -1455,7 +1455,7 @@ def get_tag_template( Args: name (str): Required. The name of the tag template. Example: - - projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id} + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1513,13 +1513,13 @@ def update_tag_template( metadata=None, ): """ - Updates a tag template. This method cannot be used to update the fields - of a template. The tag template fields are represented as separate - resources and should be updated using their own create/update/delete - methods. Users should enable the Data Catalog API in the project - identified by the ``tag_template.name`` parameter (see [Data Catalog - Resource Project] (/data-catalog/docs/concepts/resource-project) for - more information). + Updates a tag template. This method cannot be used to update the + fields of a template. The tag template fields are represented as + separate resources and should be updated using their own + create/update/delete methods. Users should enable the Data Catalog API + in the project identified by the ``tag_template.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1625,7 +1625,7 @@ def delete_tag_template( Args: name (str): Required. The name of the tag template to delete. Example: - - projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id} + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} force (bool): Required. Currently, this field must always be set to ``true``. This confirms the deletion of any possible tags using this template. ``force = false`` will be supported in the future. @@ -1712,10 +1712,10 @@ def create_tag_template_field( Example: - - projects/{project\_id}/locations/us-central1/tagTemplates/{tag\_template\_id} + - projects/{project_id}/locations/us-central1/tagTemplates/{tag_template_id} tag_template_field_id (str): Required. The ID of the tag template field to create. Field ids can contain letters (both uppercase and lowercase), numbers (0-9), - underscores (\_) and dashes (-). Field IDs must be at least 1 character + underscores (_) and dashes (-). Field IDs must be at least 1 character long and at most 128 characters long. Field IDs must also be unique within their template. tag_template_field (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplateField]): Required. The tag template field to create. @@ -1784,9 +1784,9 @@ def update_tag_template_field( metadata=None, ): """ - Updates a field in a tag template. This method cannot be used to update - the field type. Users should enable the Data Catalog API in the project - identified by the ``name`` parameter (see [Data Catalog Resource + Updates a field in a tag template. This method cannot be used to + update the field type. Users should enable the Data Catalog API in the + project identified by the ``name`` parameter (see [Data Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) for more information). @@ -1805,7 +1805,7 @@ def update_tag_template_field( Args: name (str): Required. The name of the tag template field. Example: - - projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}/fields/{tag\_template\_field\_id} + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} tag_template_field (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplateField]): Required. The template to update. If a dict is provided, it must be of the same form as the protobuf @@ -1907,7 +1907,7 @@ def rename_tag_template_field( Args: name (str): Required. The name of the tag template. Example: - - projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}/fields/{tag\_template\_field\_id} + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} new_tag_template_field_id (str): Required. The new ID of this tag template field. For example, ``my_new_field``. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -1989,7 +1989,7 @@ def delete_tag_template_field( Args: name (str): Required. The name of the tag template field to delete. Example: - - projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}/fields/{tag\_template\_field\_id} + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} force (bool): Required. Currently, this field must always be set to ``true``. This confirms the deletion of this field from any tags using this field. ``force = false`` will be supported in the future. @@ -2067,10 +2067,10 @@ def create_tag( >>> response = client.create_tag(parent, tag) Args: - parent (str): Required. The name of the resource to attach this tag to. Tags can be - attached to Entries. Example: + parent (str): Required. The name of the resource to attach this tag to. Tags can + be attached to Entries. Example: - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} Note that this Tag and its child resources may not actually be stored in the location in this name. @@ -2228,7 +2228,7 @@ def delete_tag( Args: name (str): Required. The name of the tag to delete. Example: - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id}/tags/{tag\_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -2307,13 +2307,13 @@ def list_tags( ... pass Args: - parent (str): Required. The name of the Data Catalog resource to list the tags of. The - resource could be an ``Entry`` or an ``EntryGroup``. + parent (str): Required. The name of the Data Catalog resource to list the tags of. + The resource could be an ``Entry`` or an ``EntryGroup``. Examples: - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id} - - projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -2486,9 +2486,9 @@ def get_iam_policy( metadata=None, ): """ - Gets the access control policy for a resource. A ``NOT_FOUND`` error is - returned if the resource does not exist. An empty policy is returned if - the resource exists but does not have a policy set on it. + Gets the access control policy for a resource. A ``NOT_FOUND`` error + is returned if the resource does not exist. An empty policy is returned + if the resource exists but does not have a policy set on it. Supported resources are: @@ -2582,8 +2582,8 @@ def test_iam_permissions( metadata=None, ): """ - Returns the caller's permissions on a resource. If the resource does not - exist, an empty set of permissions is returned (We don't return a + Returns the caller's permissions on a resource. If the resource does + not exist, an empty set of permissions is returned (We don't return a ``NOT_FOUND`` error). Supported resources are: @@ -2612,8 +2612,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with - wildcards (such as '*' or 'storage.*') are not allowed. For more + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more information see `IAM Overview `__. retry (Optional[google.api_core.retry.Retry]): A retry object used diff --git a/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py b/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py index 619fdbac..15ef993d 100644 --- a/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py +++ b/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py @@ -355,8 +355,8 @@ def update_taxonomy( >>> response = client.update_taxonomy() Args: - taxonomy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Taxonomy]): The taxonomy to update. Only description, display\_name, and activated - policy types can be updated. + taxonomy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Taxonomy]): The taxonomy to update. Only description, display_name, and + activated policy types can be updated. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Taxonomy` @@ -441,7 +441,7 @@ def list_taxonomies( parent (str): Required. Resource name of the project to list the taxonomies of. page_size (int): The maximum number of items to return. Must be a value between 1 and 1000. If not set, defaults to 50. - page_token (str): The next\_page\_token value returned from a previous list request, if + page_token (str): The next_page_token value returned from a previous list request, if any. If not set, defaults to an empty string. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -718,15 +718,15 @@ def update_policy_tag( >>> response = client.update_policy_tag() Args: - policy_tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.PolicyTag]): The policy tag to update. Only the description, display\_name, and - parent\_policy\_tag fields can be updated. + policy_tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.PolicyTag]): The policy tag to update. Only the description, display_name, and + parent_policy_tag fields can be updated. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.PolicyTag` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The update mask applies to the resource. Only display\_name, description - and parent\_policy\_tag can be updated and thus can be listed in the - mask. If update\_mask is not provided, all allowed fields (i.e. - display\_name, description and parent) will be updated. For more + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The update mask applies to the resource. Only display_name, + description and parent_policy_tag can be updated and thus can be listed + in the mask. If update_mask is not provided, all allowed fields (i.e. + display_name, description and parent) will be updated. For more information including the ``FieldMask`` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If not set, defaults to all of the fields that are allowed to update. @@ -806,7 +806,7 @@ def list_policy_tags( parent (str): Required. Resource name of the taxonomy to list the policy tags of. page_size (int): The maximum number of items to return. Must be a value between 1 and 1000. If not set, defaults to 50. - page_token (str): The next\_page\_token value returned from a previous List request, if + page_token (str): The next_page_token value returned from a previous List request, if any. If not set, defaults to an empty string. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -1099,8 +1099,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with - wildcards (such as '*' or 'storage.*') are not allowed. For more + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more information see `IAM Overview `__. retry (Optional[google.api_core.retry.Retry]): A retry object used diff --git a/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py b/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py index 12e06c6d..5823352e 100644 --- a/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py +++ b/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py @@ -115,7 +115,7 @@ def search_catalog(self): match a query. This is a custom method - (https://cloud.google.com/apis/design/custom\_methods) and does not + (https://cloud.google.com/apis/design/custom_methods) and does not return the complete resource, only the resource identifier and high level fields. Clients can subsequentally call ``Get`` methods. @@ -182,8 +182,8 @@ def get_entry_group(self): def delete_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry_group`. - Deletes an EntryGroup. Only entry groups that do not contain entries can - be deleted. Users should enable the Data Catalog API in the project + Deletes an EntryGroup. Only entry groups that do not contain entries + can be deleted. Users should enable the Data Catalog API in the project identified by the ``name`` parameter (see [Data Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) for more information). @@ -199,8 +199,8 @@ def delete_entry_group(self): def create_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_entry`. - Creates an entry. Only entries of 'FILESET' type or user-specified type - can be created. + Creates an entry. Only entries of 'FILESET' type or user-specified + type can be created. Users should enable the Data Catalog API in the project identified by the ``parent`` parameter (see [Data Catalog Resource Project] @@ -219,8 +219,8 @@ def create_entry(self): def update_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_entry`. - Updates an existing entry. Users should enable the Data Catalog API in - the project identified by the ``entry.name`` parameter (see [Data + Updates an existing entry. Users should enable the Data Catalog API + in the project identified by the ``entry.name`` parameter (see [Data Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) for more information). @@ -235,11 +235,11 @@ def update_entry(self): def delete_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry`. - Deletes an existing entry. Only entries created through ``CreateEntry`` - method can be deleted. Users should enable the Data Catalog API in the - project identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Deletes an existing entry. Only entries created through + ``CreateEntry`` method can be deleted. Users should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Returns: Callable: A callable which accepts the appropriate @@ -306,10 +306,10 @@ def list_entries(self): def update_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_entry_group`. - Updates an EntryGroup. The user should enable the Data Catalog API in - the project identified by the ``entry_group.name`` parameter (see [Data - Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) - for more information). + Updates an EntryGroup. The user should enable the Data Catalog API + in the project identified by the ``entry_group.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Returns: Callable: A callable which accepts the appropriate @@ -322,8 +322,8 @@ def update_entry_group(self): def create_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template`. - Creates a tag template. The user should enable the Data Catalog API in - the project identified by the ``parent`` parameter (see `Data Catalog + Creates a tag template. The user should enable the Data Catalog API + in the project identified by the ``parent`` parameter (see `Data Catalog Resource Project `__ for more information). @@ -352,13 +352,13 @@ def get_tag_template(self): def update_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template`. - Updates a tag template. This method cannot be used to update the fields - of a template. The tag template fields are represented as separate - resources and should be updated using their own create/update/delete - methods. Users should enable the Data Catalog API in the project - identified by the ``tag_template.name`` parameter (see [Data Catalog - Resource Project] (/data-catalog/docs/concepts/resource-project) for - more information). + Updates a tag template. This method cannot be used to update the + fields of a template. The tag template fields are represented as + separate resources and should be updated using their own + create/update/delete methods. Users should enable the Data Catalog API + in the project identified by the ``tag_template.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Returns: Callable: A callable which accepts the appropriate @@ -404,9 +404,9 @@ def create_tag_template_field(self): def update_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template_field`. - Updates a field in a tag template. This method cannot be used to update - the field type. Users should enable the Data Catalog API in the project - identified by the ``name`` parameter (see [Data Catalog Resource + Updates a field in a tag template. This method cannot be used to + update the field type. Users should enable the Data Catalog API in the + project identified by the ``name`` parameter (see [Data Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) for more information). @@ -539,9 +539,9 @@ def set_iam_policy(self): def get_iam_policy(self): """Return the gRPC stub for :meth:`DataCatalogClient.get_iam_policy`. - Gets the access control policy for a resource. A ``NOT_FOUND`` error is - returned if the resource does not exist. An empty policy is returned if - the resource exists but does not have a policy set on it. + Gets the access control policy for a resource. A ``NOT_FOUND`` error + is returned if the resource does not exist. An empty policy is returned + if the resource exists but does not have a policy set on it. Supported resources are: @@ -570,8 +570,8 @@ def get_iam_policy(self): def test_iam_permissions(self): """Return the gRPC stub for :meth:`DataCatalogClient.test_iam_permissions`. - Returns the caller's permissions on a resource. If the resource does not - exist, an empty set of permissions is returned (We don't return a + Returns the caller's permissions on a resource. If the resource does + not exist, an empty set of permissions is returned (We don't return a ``NOT_FOUND`` error). Supported resources are: diff --git a/google/cloud/datacatalog_v1beta1/proto/common_pb2.py b/google/cloud/datacatalog_v1beta1/proto/common_pb2.py index 75fdac7d..7c003c5b 100644 --- a/google/cloud/datacatalog_v1beta1/proto/common_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/common_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/common.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -20,12 +17,8 @@ name="google/cloud/datacatalog_v1beta1/proto/common.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - "\n3google/cloud/datacatalog_v1beta1/proto/common.proto\x12 google.cloud.datacatalog.v1beta1*U\n\x10IntegratedSystem\x12!\n\x1dINTEGRATED_SYSTEM_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x42IGQUERY\x10\x01\x12\x10\n\x0c\x43LOUD_PUBSUB\x10\x02\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3" - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b"\n3google/cloud/datacatalog_v1beta1/proto/common.proto\x12 google.cloud.datacatalog.v1beta1*U\n\x10IntegratedSystem\x12!\n\x1dINTEGRATED_SYSTEM_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x42IGQUERY\x10\x01\x12\x10\n\x0c\x43LOUD_PUBSUB\x10\x02\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3", ) _INTEGRATEDSYSTEM = _descriptor.EnumDescriptor( diff --git a/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py b/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py index 754e8fc7..4785e799 100644 --- a/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/datacatalog.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -51,12 +48,8 @@ name="google/cloud/datacatalog_v1beta1/proto/datacatalog.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n8google/cloud/datacatalog_v1beta1/proto/datacatalog.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/common.proto\x1a=google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/schema.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/search.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/table_spec.proto\x1a\x31google/cloud/datacatalog_v1beta1/proto/tags.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/timestamps.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x9e\x02\n\x14SearchCatalogRequest\x12P\n\x05scope\x18\x06 \x01(\x0b\x32<.google.cloud.datacatalog.v1beta1.SearchCatalogRequest.ScopeB\x03\xe0\x41\x02\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x10\n\x08order_by\x18\x05 \x01(\t\x1a\x62\n\x05Scope\x12\x17\n\x0finclude_org_ids\x18\x02 \x03(\t\x12\x1b\n\x13include_project_ids\x18\x03 \x03(\t\x12#\n\x1binclude_gcp_public_datasets\x18\x07 \x01(\x08"x\n\x15SearchCatalogResponse\x12\x46\n\x07results\x18\x01 \x03(\x0b\x32\x35.google.cloud.datacatalog.v1beta1.SearchCatalogResult\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"\xb8\x01\n\x17\x43reateEntryGroupRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\x12%datacatalog.googleapis.com/EntryGroup\x12\x1b\n\x0e\x65ntry_group_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\x41\n\x0b\x65ntry_group\x18\x02 \x01(\x0b\x32,.google.cloud.datacatalog.v1beta1.EntryGroup"\x92\x01\n\x17UpdateEntryGroupRequest\x12\x46\n\x0b\x65ntry_group\x18\x01 \x01(\x0b\x32,.google.cloud.datacatalog.v1beta1.EntryGroupB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x82\x01\n\x14GetEntryGroupRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12-\n\tread_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"j\n\x17\x44\x65leteEntryGroupRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x01"\x88\x01\n\x16ListEntryGroupsRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01"v\n\x17ListEntryGroupsResponse\x12\x42\n\x0c\x65ntry_groups\x18\x01 \x03(\x0b\x32,.google.cloud.datacatalog.v1beta1.EntryGroup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa7\x01\n\x12\x43reateEntryRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x15\n\x08\x65ntry_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12;\n\x05\x65ntry\x18\x02 \x01(\x0b\x32\'.google.cloud.datacatalog.v1beta1.EntryB\x03\xe0\x41\x02"\x82\x01\n\x12UpdateEntryRequest\x12;\n\x05\x65ntry\x18\x01 \x01(\x0b\x32\'.google.cloud.datacatalog.v1beta1.EntryB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"L\n\x12\x44\x65leteEntryRequest\x12\x36\n\x04name\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41"\n datacatalog.googleapis.com/Entry"I\n\x0fGetEntryRequest\x12\x36\n\x04name\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41"\n datacatalog.googleapis.com/Entry"V\n\x12LookupEntryRequest\x12\x19\n\x0flinked_resource\x18\x01 \x01(\tH\x00\x12\x16\n\x0csql_resource\x18\x03 \x01(\tH\x00\x42\r\n\x0btarget_name"\x8f\x07\n\x05\x45ntry\x12\x38\n\x04name\x18\x01 \x01(\tB*\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x17\n\x0flinked_resource\x18\t \x01(\t\x12;\n\x04type\x18\x02 \x01(\x0e\x32+.google.cloud.datacatalog.v1beta1.EntryTypeH\x00\x12\x1d\n\x13user_specified_type\x18\x10 \x01(\tH\x00\x12T\n\x11integrated_system\x18\x11 \x01(\x0e\x32\x32.google.cloud.datacatalog.v1beta1.IntegratedSystemB\x03\xe0\x41\x03H\x01\x12\x1f\n\x15user_specified_system\x18\x12 \x01(\tH\x01\x12L\n\x10gcs_fileset_spec\x18\x06 \x01(\x0b\x32\x30.google.cloud.datacatalog.v1beta1.GcsFilesetSpecH\x02\x12R\n\x13\x62igquery_table_spec\x18\x0c \x01(\x0b\x32\x33.google.cloud.datacatalog.v1beta1.BigQueryTableSpecH\x02\x12_\n\x1a\x62igquery_date_sharded_spec\x18\x0f \x01(\x0b\x32\x39.google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpecH\x02\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x38\n\x06schema\x18\x05 \x01(\x0b\x32(.google.cloud.datacatalog.v1beta1.Schema\x12Y\n\x18source_system_timestamps\x18\x07 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.SystemTimestampsB\x03\xe0\x41\x03:x\xea\x41u\n datacatalog.googleapis.com/Entry\x12Qprojects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}B\x0c\n\nentry_typeB\x08\n\x06systemB\x0b\n\ttype_spec"\x8e\x02\n\nEntryGroup\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12X\n\x17\x64\x61ta_catalog_timestamps\x18\x04 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.SystemTimestampsB\x03\xe0\x41\x03:m\xea\x41j\n%datacatalog.googleapis.com/EntryGroup\x12\x41projects/{project}/locations/{location}/entryGroups/{entry_group}"\xc2\x01\n\x18\x43reateTagTemplateRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\x12&datacatalog.googleapis.com/TagTemplate\x12\x1c\n\x0ftag_template_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12H\n\x0ctag_template\x18\x02 \x01(\x0b\x32-.google.cloud.datacatalog.v1beta1.TagTemplateB\x03\xe0\x41\x02"U\n\x15GetTagTemplateRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate"\x95\x01\n\x18UpdateTagTemplateRequest\x12H\n\x0ctag_template\x18\x01 \x01(\x0b\x32-.google.cloud.datacatalog.v1beta1.TagTemplateB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"l\n\x18\x44\x65leteTagTemplateRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02"\x83\x01\n\x10\x43reateTagRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\x37\n\x03tag\x18\x02 \x01(\x0b\x32%.google.cloud.datacatalog.v1beta1.TagB\x03\xe0\x41\x02"|\n\x10UpdateTagRequest\x12\x37\n\x03tag\x18\x01 \x01(\x0b\x32%.google.cloud.datacatalog.v1beta1.TagB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"H\n\x10\x44\x65leteTagRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x64\x61tacatalog.googleapis.com/Tag"\xd8\x01\n\x1d\x43reateTagTemplateFieldRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate\x12"\n\x15tag_template_field_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12S\n\x12tag_template_field\x18\x03 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateFieldB\x03\xe0\x41\x02"\xed\x01\n\x1dUpdateTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12S\n\x12tag_template_field\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateFieldB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x01"\x8a\x01\n\x1dRenameTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12&\n\x19new_tag_template_field_id\x18\x02 \x01(\tB\x03\xe0\x41\x02"v\n\x1d\x44\x65leteTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02"p\n\x0fListTagsRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"`\n\x10ListTagsResponse\x12\x33\n\x04tags\x18\x01 \x03(\x0b\x32%.google.cloud.datacatalog.v1beta1.Tag\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa9\x01\n\x12ListEntriesRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12-\n\tread_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"h\n\x13ListEntriesResponse\x12\x38\n\x07\x65ntries\x18\x01 \x03(\x0b\x32\'.google.cloud.datacatalog.v1beta1.Entry\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t*[\n\tEntryType\x12\x1a\n\x16\x45NTRY_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05TABLE\x10\x02\x12\t\n\x05MODEL\x10\x05\x12\x0f\n\x0b\x44\x41TA_STREAM\x10\x03\x12\x0b\n\x07\x46ILESET\x10\x04\x32\x9f\x32\n\x0b\x44\x61taCatalog\x12\xb2\x01\n\rSearchCatalog\x12\x36.google.cloud.datacatalog.v1beta1.SearchCatalogRequest\x1a\x37.google.cloud.datacatalog.v1beta1.SearchCatalogResponse"0\x82\xd3\xe4\x93\x02\x1c"\x17/v1beta1/catalog:search:\x01*\xda\x41\x0bscope,query\x12\xea\x01\n\x10\x43reateEntryGroup\x12\x39.google.cloud.datacatalog.v1beta1.CreateEntryGroupRequest\x1a,.google.cloud.datacatalog.v1beta1.EntryGroup"m\x82\xd3\xe4\x93\x02\x43"4/v1beta1/{parent=projects/*/locations/*}/entryGroups:\x0b\x65ntry_group\xda\x41!parent,entry_group_id,entry_group\x12\xfa\x01\n\x10UpdateEntryGroup\x12\x39.google.cloud.datacatalog.v1beta1.UpdateEntryGroupRequest\x1a,.google.cloud.datacatalog.v1beta1.EntryGroup"}\x82\xd3\xe4\x93\x02O2@/v1beta1/{entry_group.name=projects/*/locations/*/entryGroups/*}:\x0b\x65ntry_group\xda\x41\x0b\x65ntry_group\xda\x41\x17\x65ntry_group,update_mask\x12\xcb\x01\n\rGetEntryGroup\x12\x36.google.cloud.datacatalog.v1beta1.GetEntryGroupRequest\x1a,.google.cloud.datacatalog.v1beta1.EntryGroup"T\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta1/{name=projects/*/locations/*/entryGroups/*}\xda\x41\x04name\xda\x41\x0ename,read_mask\x12\xaa\x01\n\x10\x44\x65leteEntryGroup\x12\x39.google.cloud.datacatalog.v1beta1.DeleteEntryGroupRequest\x1a\x16.google.protobuf.Empty"C\x82\xd3\xe4\x93\x02\x36*4/v1beta1/{name=projects/*/locations/*/entryGroups/*}\xda\x41\x04name\x12\xcd\x01\n\x0fListEntryGroups\x12\x38.google.cloud.datacatalog.v1beta1.ListEntryGroupsRequest\x1a\x39.google.cloud.datacatalog.v1beta1.ListEntryGroupsResponse"E\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta1/{parent=projects/*/locations/*}/entryGroups\xda\x41\x06parent\x12\xd3\x01\n\x0b\x43reateEntry\x12\x34.google.cloud.datacatalog.v1beta1.CreateEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"e\x82\xd3\xe4\x93\x02G">/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries:\x05\x65ntry\xda\x41\x15parent,entry_id,entry\x12\xdd\x01\n\x0bUpdateEntry\x12\x34.google.cloud.datacatalog.v1beta1.UpdateEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"o\x82\xd3\xe4\x93\x02M2D/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\x05\x65ntry\xda\x41\x05\x65ntry\xda\x41\x11\x65ntry,update_mask\x12\xaa\x01\n\x0b\x44\x65leteEntry\x12\x34.google.cloud.datacatalog.v1beta1.DeleteEntryRequest\x1a\x16.google.protobuf.Empty"M\x82\xd3\xe4\x93\x02@*>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\xda\x41\x04name\x12\xb5\x01\n\x08GetEntry\x12\x31.google.cloud.datacatalog.v1beta1.GetEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"M\x82\xd3\xe4\x93\x02@\x12>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\xda\x41\x04name\x12\x8d\x01\n\x0bLookupEntry\x12\x34.google.cloud.datacatalog.v1beta1.LookupEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"\x1f\x82\xd3\xe4\x93\x02\x19\x12\x17/v1beta1/entries:lookup\x12\xcb\x01\n\x0bListEntries\x12\x34.google.cloud.datacatalog.v1beta1.ListEntriesRequest\x1a\x35.google.cloud.datacatalog.v1beta1.ListEntriesResponse"O\x82\xd3\xe4\x93\x02@\x12>/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries\xda\x41\x06parent\x12\xf1\x01\n\x11\x43reateTagTemplate\x12:.google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"q\x82\xd3\xe4\x93\x02\x45"5/v1beta1/{parent=projects/*/locations/*}/tagTemplates:\x0ctag_template\xda\x41#parent,tag_template_id,tag_template\x12\xbe\x01\n\x0eGetTagTemplate\x12\x37.google.cloud.datacatalog.v1beta1.GetTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"D\x82\xd3\xe4\x93\x02\x37\x12\x35/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\xda\x41\x04name\x12\x83\x02\n\x11UpdateTagTemplate\x12:.google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"\x82\x01\x82\xd3\xe4\x93\x02R2B/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\x0ctag_template\xda\x41\x0ctag_template\xda\x41\x18tag_template,update_mask\x12\xb3\x01\n\x11\x44\x65leteTagTemplate\x12:.google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest\x1a\x16.google.protobuf.Empty"J\x82\xd3\xe4\x93\x02\x37*5/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\xda\x41\nname,force\x12\x9c\x02\n\x16\x43reateTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"\x8c\x01\x82\xd3\xe4\x93\x02T">/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\x12tag_template_field\xda\x41/parent,tag_template_field_id,tag_template_field\x12\xaa\x02\n\x16UpdateTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"\x9a\x01\x82\xd3\xe4\x93\x02T2>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\x12tag_template_field\xda\x41\x17name,tag_template_field\xda\x41#name,tag_template_field,update_mask\x12\x80\x02\n\x16RenameTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"q\x82\xd3\xe4\x93\x02J"E/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\x01*\xda\x41\x1ename,new_tag_template_field_id\x12\xc6\x01\n\x16\x44\x65leteTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest\x1a\x16.google.protobuf.Empty"S\x82\xd3\xe4\x93\x02@*>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}\xda\x41\nname,force\x12\x8d\x02\n\tCreateTag\x12\x32.google.cloud.datacatalog.v1beta1.CreateTagRequest\x1a%.google.cloud.datacatalog.v1beta1.Tag"\xa4\x01\x82\xd3\xe4\x93\x02\x90\x01"E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\x03tagZB";/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags:\x03tag\xda\x41\nparent,tag\x12\xa0\x02\n\tUpdateTag\x12\x32.google.cloud.datacatalog.v1beta1.UpdateTagRequest\x1a%.google.cloud.datacatalog.v1beta1.Tag"\xb7\x01\x82\xd3\xe4\x93\x02\x98\x01\x32I/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\x03tagZF2?/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}:\x03tag\xda\x41\x03tag\xda\x41\x0ftag,update_mask\x12\xee\x01\n\tDeleteTag\x12\x32.google.cloud.datacatalog.v1beta1.DeleteTagRequest\x1a\x16.google.protobuf.Empty"\x94\x01\x82\xd3\xe4\x93\x02\x86\x01*E/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}Z=*;/v1beta1/{name=projects/*/locations/*/entryGroups/*/tags/*}\xda\x41\x04name\x12\x8a\x02\n\x08ListTags\x12\x31.google.cloud.datacatalog.v1beta1.ListTagsRequest\x1a\x32.google.cloud.datacatalog.v1beta1.ListTagsResponse"\x96\x01\x82\xd3\xe4\x93\x02\x86\x01\x12\x45/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tagsZ=\x12;/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags\xda\x41\x06parent\x12\xea\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9e\x01\x82\xd3\xe4\x93\x02\x97\x01"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\x01*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy:\x01*\x12\xc0\x02\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\xf4\x01\x82\xd3\xe4\x93\x02\xed\x01"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\x01*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy:\x01*ZT"O/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy:\x01*\x12\xf2\x02\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"\x86\x02\x82\xd3\xe4\x93\x02\xff\x01"L/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\x01*ZP"K/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions:\x01*ZZ"U/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions:\x01*\x1aN\xca\x41\x1a\x64\x61tacatalog.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBx\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b'\n8google/cloud/datacatalog_v1beta1/proto/datacatalog.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/common.proto\x1a=google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/schema.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/search.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/table_spec.proto\x1a\x31google/cloud/datacatalog_v1beta1/proto/tags.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/timestamps.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x9e\x02\n\x14SearchCatalogRequest\x12P\n\x05scope\x18\x06 \x01(\x0b\x32<.google.cloud.datacatalog.v1beta1.SearchCatalogRequest.ScopeB\x03\xe0\x41\x02\x12\x12\n\x05query\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12\x10\n\x08order_by\x18\x05 \x01(\t\x1a\x62\n\x05Scope\x12\x17\n\x0finclude_org_ids\x18\x02 \x03(\t\x12\x1b\n\x13include_project_ids\x18\x03 \x03(\t\x12#\n\x1binclude_gcp_public_datasets\x18\x07 \x01(\x08"x\n\x15SearchCatalogResponse\x12\x46\n\x07results\x18\x01 \x03(\x0b\x32\x35.google.cloud.datacatalog.v1beta1.SearchCatalogResult\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"\xb8\x01\n\x17\x43reateEntryGroupRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\x12%datacatalog.googleapis.com/EntryGroup\x12\x1b\n\x0e\x65ntry_group_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\x41\n\x0b\x65ntry_group\x18\x02 \x01(\x0b\x32,.google.cloud.datacatalog.v1beta1.EntryGroup"\x92\x01\n\x17UpdateEntryGroupRequest\x12\x46\n\x0b\x65ntry_group\x18\x01 \x01(\x0b\x32,.google.cloud.datacatalog.v1beta1.EntryGroupB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x82\x01\n\x14GetEntryGroupRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12-\n\tread_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"j\n\x17\x44\x65leteEntryGroupRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x01"\x88\x01\n\x16ListEntryGroupsRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x16\n\tpage_size\x18\x02 \x01(\x05\x42\x03\xe0\x41\x01\x12\x17\n\npage_token\x18\x03 \x01(\tB\x03\xe0\x41\x01"v\n\x17ListEntryGroupsResponse\x12\x42\n\x0c\x65ntry_groups\x18\x01 \x03(\x0b\x32,.google.cloud.datacatalog.v1beta1.EntryGroup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa7\x01\n\x12\x43reateEntryRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x15\n\x08\x65ntry_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12;\n\x05\x65ntry\x18\x02 \x01(\x0b\x32\'.google.cloud.datacatalog.v1beta1.EntryB\x03\xe0\x41\x02"\x82\x01\n\x12UpdateEntryRequest\x12;\n\x05\x65ntry\x18\x01 \x01(\x0b\x32\'.google.cloud.datacatalog.v1beta1.EntryB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"L\n\x12\x44\x65leteEntryRequest\x12\x36\n\x04name\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41"\n datacatalog.googleapis.com/Entry"I\n\x0fGetEntryRequest\x12\x36\n\x04name\x18\x01 \x01(\tB(\xe0\x41\x02\xfa\x41"\n datacatalog.googleapis.com/Entry"V\n\x12LookupEntryRequest\x12\x19\n\x0flinked_resource\x18\x01 \x01(\tH\x00\x12\x16\n\x0csql_resource\x18\x03 \x01(\tH\x00\x42\r\n\x0btarget_name"\x8f\x07\n\x05\x45ntry\x12\x38\n\x04name\x18\x01 \x01(\tB*\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x17\n\x0flinked_resource\x18\t \x01(\t\x12;\n\x04type\x18\x02 \x01(\x0e\x32+.google.cloud.datacatalog.v1beta1.EntryTypeH\x00\x12\x1d\n\x13user_specified_type\x18\x10 \x01(\tH\x00\x12T\n\x11integrated_system\x18\x11 \x01(\x0e\x32\x32.google.cloud.datacatalog.v1beta1.IntegratedSystemB\x03\xe0\x41\x03H\x01\x12\x1f\n\x15user_specified_system\x18\x12 \x01(\tH\x01\x12L\n\x10gcs_fileset_spec\x18\x06 \x01(\x0b\x32\x30.google.cloud.datacatalog.v1beta1.GcsFilesetSpecH\x02\x12R\n\x13\x62igquery_table_spec\x18\x0c \x01(\x0b\x32\x33.google.cloud.datacatalog.v1beta1.BigQueryTableSpecH\x02\x12_\n\x1a\x62igquery_date_sharded_spec\x18\x0f \x01(\x0b\x32\x39.google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpecH\x02\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x38\n\x06schema\x18\x05 \x01(\x0b\x32(.google.cloud.datacatalog.v1beta1.Schema\x12Y\n\x18source_system_timestamps\x18\x07 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.SystemTimestampsB\x03\xe0\x41\x03:x\xea\x41u\n datacatalog.googleapis.com/Entry\x12Qprojects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}B\x0c\n\nentry_typeB\x08\n\x06systemB\x0b\n\ttype_spec"\x8e\x02\n\nEntryGroup\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12X\n\x17\x64\x61ta_catalog_timestamps\x18\x04 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.SystemTimestampsB\x03\xe0\x41\x03:m\xea\x41j\n%datacatalog.googleapis.com/EntryGroup\x12\x41projects/{project}/locations/{location}/entryGroups/{entry_group}"\xc2\x01\n\x18\x43reateTagTemplateRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\x12&datacatalog.googleapis.com/TagTemplate\x12\x1c\n\x0ftag_template_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12H\n\x0ctag_template\x18\x02 \x01(\x0b\x32-.google.cloud.datacatalog.v1beta1.TagTemplateB\x03\xe0\x41\x02"U\n\x15GetTagTemplateRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate"\x95\x01\n\x18UpdateTagTemplateRequest\x12H\n\x0ctag_template\x18\x01 \x01(\x0b\x32-.google.cloud.datacatalog.v1beta1.TagTemplateB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"l\n\x18\x44\x65leteTagTemplateRequest\x12<\n\x04name\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02"\x83\x01\n\x10\x43reateTagRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\x37\n\x03tag\x18\x02 \x01(\x0b\x32%.google.cloud.datacatalog.v1beta1.TagB\x03\xe0\x41\x02"|\n\x10UpdateTagRequest\x12\x37\n\x03tag\x18\x01 \x01(\x0b\x32%.google.cloud.datacatalog.v1beta1.TagB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"H\n\x10\x44\x65leteTagRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x64\x61tacatalog.googleapis.com/Tag"\xd8\x01\n\x1d\x43reateTagTemplateFieldRequest\x12>\n\x06parent\x18\x01 \x01(\tB.\xe0\x41\x02\xfa\x41(\n&datacatalog.googleapis.com/TagTemplate\x12"\n\x15tag_template_field_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12S\n\x12tag_template_field\x18\x03 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateFieldB\x03\xe0\x41\x02"\xed\x01\n\x1dUpdateTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12S\n\x12tag_template_field\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateFieldB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x01"\x8a\x01\n\x1dRenameTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12&\n\x19new_tag_template_field_id\x18\x02 \x01(\tB\x03\xe0\x41\x02"v\n\x1d\x44\x65leteTagTemplateFieldRequest\x12\x41\n\x04name\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+datacatalog.googleapis.com/TagTemplateField\x12\x12\n\x05\x66orce\x18\x02 \x01(\x08\x42\x03\xe0\x41\x02"p\n\x0fListTagsRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"`\n\x10ListTagsResponse\x12\x33\n\x04tags\x18\x01 \x03(\x0b\x32%.google.cloud.datacatalog.v1beta1.Tag\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa9\x01\n\x12ListEntriesRequest\x12=\n\x06parent\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%datacatalog.googleapis.com/EntryGroup\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12-\n\tread_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"h\n\x13ListEntriesResponse\x12\x38\n\x07\x65ntries\x18\x01 \x03(\x0b\x32\'.google.cloud.datacatalog.v1beta1.Entry\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t*[\n\tEntryType\x12\x1a\n\x16\x45NTRY_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05TABLE\x10\x02\x12\t\n\x05MODEL\x10\x05\x12\x0f\n\x0b\x44\x41TA_STREAM\x10\x03\x12\x0b\n\x07\x46ILESET\x10\x04\x32\x9f\x32\n\x0b\x44\x61taCatalog\x12\xb2\x01\n\rSearchCatalog\x12\x36.google.cloud.datacatalog.v1beta1.SearchCatalogRequest\x1a\x37.google.cloud.datacatalog.v1beta1.SearchCatalogResponse"0\x82\xd3\xe4\x93\x02\x1c"\x17/v1beta1/catalog:search:\x01*\xda\x41\x0bscope,query\x12\xea\x01\n\x10\x43reateEntryGroup\x12\x39.google.cloud.datacatalog.v1beta1.CreateEntryGroupRequest\x1a,.google.cloud.datacatalog.v1beta1.EntryGroup"m\x82\xd3\xe4\x93\x02\x43"4/v1beta1/{parent=projects/*/locations/*}/entryGroups:\x0b\x65ntry_group\xda\x41!parent,entry_group_id,entry_group\x12\xfa\x01\n\x10UpdateEntryGroup\x12\x39.google.cloud.datacatalog.v1beta1.UpdateEntryGroupRequest\x1a,.google.cloud.datacatalog.v1beta1.EntryGroup"}\x82\xd3\xe4\x93\x02O2@/v1beta1/{entry_group.name=projects/*/locations/*/entryGroups/*}:\x0b\x65ntry_group\xda\x41\x0b\x65ntry_group\xda\x41\x17\x65ntry_group,update_mask\x12\xcb\x01\n\rGetEntryGroup\x12\x36.google.cloud.datacatalog.v1beta1.GetEntryGroupRequest\x1a,.google.cloud.datacatalog.v1beta1.EntryGroup"T\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta1/{name=projects/*/locations/*/entryGroups/*}\xda\x41\x04name\xda\x41\x0ename,read_mask\x12\xaa\x01\n\x10\x44\x65leteEntryGroup\x12\x39.google.cloud.datacatalog.v1beta1.DeleteEntryGroupRequest\x1a\x16.google.protobuf.Empty"C\x82\xd3\xe4\x93\x02\x36*4/v1beta1/{name=projects/*/locations/*/entryGroups/*}\xda\x41\x04name\x12\xcd\x01\n\x0fListEntryGroups\x12\x38.google.cloud.datacatalog.v1beta1.ListEntryGroupsRequest\x1a\x39.google.cloud.datacatalog.v1beta1.ListEntryGroupsResponse"E\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta1/{parent=projects/*/locations/*}/entryGroups\xda\x41\x06parent\x12\xd3\x01\n\x0b\x43reateEntry\x12\x34.google.cloud.datacatalog.v1beta1.CreateEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"e\x82\xd3\xe4\x93\x02G">/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries:\x05\x65ntry\xda\x41\x15parent,entry_id,entry\x12\xdd\x01\n\x0bUpdateEntry\x12\x34.google.cloud.datacatalog.v1beta1.UpdateEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"o\x82\xd3\xe4\x93\x02M2D/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\x05\x65ntry\xda\x41\x05\x65ntry\xda\x41\x11\x65ntry,update_mask\x12\xaa\x01\n\x0b\x44\x65leteEntry\x12\x34.google.cloud.datacatalog.v1beta1.DeleteEntryRequest\x1a\x16.google.protobuf.Empty"M\x82\xd3\xe4\x93\x02@*>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\xda\x41\x04name\x12\xb5\x01\n\x08GetEntry\x12\x31.google.cloud.datacatalog.v1beta1.GetEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"M\x82\xd3\xe4\x93\x02@\x12>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\xda\x41\x04name\x12\x8d\x01\n\x0bLookupEntry\x12\x34.google.cloud.datacatalog.v1beta1.LookupEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"\x1f\x82\xd3\xe4\x93\x02\x19\x12\x17/v1beta1/entries:lookup\x12\xcb\x01\n\x0bListEntries\x12\x34.google.cloud.datacatalog.v1beta1.ListEntriesRequest\x1a\x35.google.cloud.datacatalog.v1beta1.ListEntriesResponse"O\x82\xd3\xe4\x93\x02@\x12>/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries\xda\x41\x06parent\x12\xf1\x01\n\x11\x43reateTagTemplate\x12:.google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"q\x82\xd3\xe4\x93\x02\x45"5/v1beta1/{parent=projects/*/locations/*}/tagTemplates:\x0ctag_template\xda\x41#parent,tag_template_id,tag_template\x12\xbe\x01\n\x0eGetTagTemplate\x12\x37.google.cloud.datacatalog.v1beta1.GetTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"D\x82\xd3\xe4\x93\x02\x37\x12\x35/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\xda\x41\x04name\x12\x83\x02\n\x11UpdateTagTemplate\x12:.google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"\x82\x01\x82\xd3\xe4\x93\x02R2B/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\x0ctag_template\xda\x41\x0ctag_template\xda\x41\x18tag_template,update_mask\x12\xb3\x01\n\x11\x44\x65leteTagTemplate\x12:.google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest\x1a\x16.google.protobuf.Empty"J\x82\xd3\xe4\x93\x02\x37*5/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\xda\x41\nname,force\x12\x9c\x02\n\x16\x43reateTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"\x8c\x01\x82\xd3\xe4\x93\x02T">/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\x12tag_template_field\xda\x41/parent,tag_template_field_id,tag_template_field\x12\xaa\x02\n\x16UpdateTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"\x9a\x01\x82\xd3\xe4\x93\x02T2>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\x12tag_template_field\xda\x41\x17name,tag_template_field\xda\x41#name,tag_template_field,update_mask\x12\x80\x02\n\x16RenameTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"q\x82\xd3\xe4\x93\x02J"E/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\x01*\xda\x41\x1ename,new_tag_template_field_id\x12\xc6\x01\n\x16\x44\x65leteTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest\x1a\x16.google.protobuf.Empty"S\x82\xd3\xe4\x93\x02@*>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}\xda\x41\nname,force\x12\x8d\x02\n\tCreateTag\x12\x32.google.cloud.datacatalog.v1beta1.CreateTagRequest\x1a%.google.cloud.datacatalog.v1beta1.Tag"\xa4\x01\x82\xd3\xe4\x93\x02\x90\x01"E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\x03tagZB";/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags:\x03tag\xda\x41\nparent,tag\x12\xa0\x02\n\tUpdateTag\x12\x32.google.cloud.datacatalog.v1beta1.UpdateTagRequest\x1a%.google.cloud.datacatalog.v1beta1.Tag"\xb7\x01\x82\xd3\xe4\x93\x02\x98\x01\x32I/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\x03tagZF2?/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}:\x03tag\xda\x41\x03tag\xda\x41\x0ftag,update_mask\x12\xee\x01\n\tDeleteTag\x12\x32.google.cloud.datacatalog.v1beta1.DeleteTagRequest\x1a\x16.google.protobuf.Empty"\x94\x01\x82\xd3\xe4\x93\x02\x86\x01*E/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}Z=*;/v1beta1/{name=projects/*/locations/*/entryGroups/*/tags/*}\xda\x41\x04name\x12\x8a\x02\n\x08ListTags\x12\x31.google.cloud.datacatalog.v1beta1.ListTagsRequest\x1a\x32.google.cloud.datacatalog.v1beta1.ListTagsResponse"\x96\x01\x82\xd3\xe4\x93\x02\x86\x01\x12\x45/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tagsZ=\x12;/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags\xda\x41\x06parent\x12\xea\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9e\x01\x82\xd3\xe4\x93\x02\x97\x01"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\x01*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy:\x01*\x12\xc0\x02\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\xf4\x01\x82\xd3\xe4\x93\x02\xed\x01"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\x01*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy:\x01*ZT"O/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy:\x01*\x12\xf2\x02\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"\x86\x02\x82\xd3\xe4\x93\x02\xff\x01"L/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\x01*ZP"K/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions:\x01*ZZ"U/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions:\x01*\x1aN\xca\x41\x1a\x64\x61tacatalog.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBx\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_client__pb2.DESCRIPTOR, @@ -213,7 +206,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -225,13 +218,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -261,13 +254,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -279,7 +272,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -336,7 +329,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -375,15 +368,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A'\022%datacatalog.googleapis.com/EntryGroup" - ), + serialized_options=b"\340A\002\372A'\022%datacatalog.googleapis.com/EntryGroup", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -395,13 +386,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -458,7 +449,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -509,15 +500,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup" - ), + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -568,15 +557,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup" - ), + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -594,7 +581,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), ], @@ -627,15 +614,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup" - ), + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -653,7 +638,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -665,13 +650,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), ], @@ -722,7 +707,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -761,15 +746,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup" - ), + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -781,13 +764,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -805,7 +788,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -844,7 +827,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -895,13 +878,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b('\340A\002\372A"\n datacatalog.googleapis.com/Entry'), + serialized_options=b'\340A\002\372A"\n datacatalog.googleapis.com/Entry', file=DESCRIPTOR, ) ], @@ -934,13 +917,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b('\340A\002\372A"\n datacatalog.googleapis.com/Entry'), + serialized_options=b'\340A\002\372A"\n datacatalog.googleapis.com/Entry', file=DESCRIPTOR, ) ], @@ -973,7 +956,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -991,7 +974,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1038,13 +1021,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\372A'\n%datacatalog.googleapis.com/EntryGroup"), + serialized_options=b"\372A'\n%datacatalog.googleapis.com/EntryGroup", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1056,7 +1039,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1092,7 +1075,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1116,7 +1099,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1128,7 +1111,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1200,7 +1183,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1218,7 +1201,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1260,16 +1243,14 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=_b( - "\352Au\n datacatalog.googleapis.com/Entry\022Qprojects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}" - ), + serialized_options=b"\352Au\n datacatalog.googleapis.com/Entry\022Qprojects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -1317,7 +1298,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1335,7 +1316,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1353,7 +1334,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -1377,16 +1358,14 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=_b( - "\352Aj\n%datacatalog.googleapis.com/EntryGroup\022Aprojects/{project}/locations/{location}/entryGroups/{entry_group}" - ), + serialized_options=b"\352Aj\n%datacatalog.googleapis.com/EntryGroup\022Aprojects/{project}/locations/{location}/entryGroups/{entry_group}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -1412,15 +1391,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A(\022&datacatalog.googleapis.com/TagTemplate" - ), + serialized_options=b"\340A\002\372A(\022&datacatalog.googleapis.com/TagTemplate", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1432,13 +1409,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1456,7 +1433,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -1489,15 +1466,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate" - ), + serialized_options=b"\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate", file=DESCRIPTOR, ) ], @@ -1536,7 +1511,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1587,15 +1562,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate" - ), + serialized_options=b"\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1613,7 +1586,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -1646,15 +1619,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036datacatalog.googleapis.com/Tag" - ), + serialized_options=b"\340A\002\372A \n\036datacatalog.googleapis.com/Tag", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1672,7 +1643,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -1711,7 +1682,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1762,15 +1733,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036datacatalog.googleapis.com/Tag" - ), + serialized_options=b"\340A\002\372A \022\036datacatalog.googleapis.com/Tag", file=DESCRIPTOR, ) ], @@ -1803,15 +1772,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate" - ), + serialized_options=b"\340A\002\372A(\n&datacatalog.googleapis.com/TagTemplate", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1823,13 +1790,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1847,7 +1814,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -1880,15 +1847,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField" - ), + serialized_options=b"\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1906,7 +1871,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1924,7 +1889,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), ], @@ -1957,15 +1922,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField" - ), + serialized_options=b"\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -1977,13 +1940,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -2016,15 +1979,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField" - ), + serialized_options=b"\340A\002\372A-\n+datacatalog.googleapis.com/TagTemplateField", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -2042,7 +2003,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -2075,15 +2036,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036datacatalog.googleapis.com/Tag" - ), + serialized_options=b"\340A\002\372A \022\036datacatalog.googleapis.com/Tag", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -2113,7 +2072,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -2170,7 +2129,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -2209,15 +2168,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup" - ), + serialized_options=b"\340A\002\372A'\n%datacatalog.googleapis.com/EntryGroup", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -2247,7 +2204,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -2322,7 +2279,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -2537,20 +2494,20 @@ SearchCatalogRequest = _reflection.GeneratedProtocolMessageType( "SearchCatalogRequest", (_message.Message,), - dict( - Scope=_reflection.GeneratedProtocolMessageType( + { + "Scope": _reflection.GeneratedProtocolMessageType( "Scope", (_message.Message,), - dict( - DESCRIPTOR=_SEARCHCATALOGREQUEST_SCOPE, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__=""" + { + "DESCRIPTOR": _SEARCHCATALOGREQUEST_SCOPE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """ Attributes: include_org_ids: Data Catalog tries to automatically choose the right corpus of data to search through. You can ensure an organization is included by adding it to ``include_org_ids``. You can ensure a - project's org is included with ``include_project_ids``. You + project’s org is included with ``include_project_ids``. You must specify at least one organization using ``include_org_ids`` or ``include_project_ids`` in all search requests. List of organization IDs to search within. To find @@ -2568,11 +2525,11 @@ default, GCP public datasets are excluded. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogRequest.Scope) - ), + }, ), - DESCRIPTOR=_SEARCHCATALOGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + "DESCRIPTOR": _SEARCHCATALOGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog]. @@ -2581,7 +2538,7 @@ Required. The scope of this search request. query: Required. The query string in search query syntax. The query - must be non-empty. Query strings can be simple as "x" or more + must be non-empty. Query strings can be simple as “x” or more qualified as: - name:x - column:x - description:y Note: Query tokens need to have a minimum of 3 characters for substring matching to work correctly. See `Data Catalog Search @@ -2589,16 +2546,16 @@ more information. page_size: Number of results in the search page. If <=0 then defaults to - 10. Max limit for page\_size is 1000. Throws an invalid - argument for page\_size > 1000. + 10. Max limit for page_size is 1000. Throws an invalid + argument for page_size > 1000. page_token: Optional. Pagination token returned in an earlier [SearchCatal - ogResponse.next\_page\_token][google.cloud.datacatalog.v1beta1 - .SearchCatalogResponse.next\_page\_token], which indicates - that this is a continuation of a prior [SearchCatalogRequest][ - google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog] - call, and that the system should return the next page of data. - If empty, the first page is returned. + ogResponse.next_page_token][google.cloud.datacatalog.v1beta1.S + earchCatalogResponse.next_page_token], which indicates that + this is a continuation of a prior [SearchCatalogRequest][googl + e.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog] call, + and that the system should return the next page of data. If + empty, the first page is returned. order_by: Specifies the ordering of results, currently supported case- sensitive choices are: - ``relevance``, only supports @@ -2607,7 +2564,7 @@ to ``relevance`` descending. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogRequest) - ), + }, ) _sym_db.RegisterMessage(SearchCatalogRequest) _sym_db.RegisterMessage(SearchCatalogRequest.Scope) @@ -2615,10 +2572,10 @@ SearchCatalogResponse = _reflection.GeneratedProtocolMessageType( "SearchCatalogResponse", (_message.Message,), - dict( - DESCRIPTOR=_SEARCHCATALOGRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _SEARCHCATALOGRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Response message for [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog]. @@ -2630,24 +2587,24 @@ results. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogResponse) - ), + }, ) _sym_db.RegisterMessage(SearchCatalogResponse) CreateEntryGroupRequest = _reflection.GeneratedProtocolMessageType( "CreateEntryGroupRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEENTRYGROUPREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATEENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [CreateEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.CreateEntryGroup]. Attributes: parent: Required. The name of the project this entry group is in. - Example: - projects/{project\_id}/locations/{location} Note + Example: - projects/{project_id}/locations/{location} Note that this EntryGroup and its child resources may not actually be stored in the location in this name. entry_group_id: @@ -2659,39 +2616,39 @@ The entry group to create. Defaults to an empty entry group. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateEntryGroupRequest) - ), + }, ) _sym_db.RegisterMessage(CreateEntryGroupRequest) UpdateEntryGroupRequest = _reflection.GeneratedProtocolMessageType( "UpdateEntryGroupRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEENTRYGROUPREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATEENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [UpdateEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntryGroup]. Attributes: entry_group: - Required. The updated entry group. "name" field must be set. + Required. The updated entry group. “name” field must be set. update_mask: The fields to update on the entry group. If absent or empty, all modifiable fields are updated. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateEntryGroupRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateEntryGroupRequest) GetEntryGroupRequest = _reflection.GeneratedProtocolMessageType( "GetEntryGroupRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETENTRYGROUPREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [GetEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.GetEntryGroup]. @@ -2705,17 +2662,17 @@ returned. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GetEntryGroupRequest) - ), + }, ) _sym_db.RegisterMessage(GetEntryGroupRequest) DeleteEntryGroupRequest = _reflection.GeneratedProtocolMessageType( "DeleteEntryGroupRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEENTRYGROUPREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETEENTRYGROUPREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [DeleteEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteEntryGroup]. @@ -2728,17 +2685,17 @@ Optional. If true, deletes all entries in the entry group. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteEntryGroupRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteEntryGroupRequest) ListEntryGroupsRequest = _reflection.GeneratedProtocolMessageType( "ListEntryGroupsRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTENTRYGROUPSREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTENTRYGROUPSREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [ListEntryGroups][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntryGroups]. @@ -2746,7 +2703,7 @@ parent: Required. The name of the location that contains the entry groups, which can be provided in URL format. Example: - - projects/{project\_id}/locations/{location} + projects/{project_id}/locations/{location} page_size: Optional. The maximum number of items to return. Default is 10. Max limit is 1000. Throws an invalid argument for @@ -2756,17 +2713,17 @@ empty, the first page is returned. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListEntryGroupsRequest) - ), + }, ) _sym_db.RegisterMessage(ListEntryGroupsRequest) ListEntryGroupsResponse = _reflection.GeneratedProtocolMessageType( "ListEntryGroupsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTENTRYGROUPSRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTENTRYGROUPSRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Response message for [ListEntryGroups][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntryGroups]. @@ -2778,25 +2735,25 @@ if no items remain in results. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListEntryGroupsResponse) - ), + }, ) _sym_db.RegisterMessage(ListEntryGroupsResponse) CreateEntryRequest = _reflection.GeneratedProtocolMessageType( "CreateEntryRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEENTRYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATEENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [CreateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.CreateEntry]. Attributes: parent: Required. The name of the entry group this entry is in. - Example: - projects/{project\_id}/locations/{location}/entry - Groups/{entry\_group\_id} Note that this Entry and its child + Example: - projects/{project_id}/locations/{location}/entryG + roups/{entry_group_id} Note that this Entry and its child resources may not actually be stored in the location in this name. entry_id: @@ -2805,23 +2762,23 @@ Required. The entry to create. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateEntryRequest) - ), + }, ) _sym_db.RegisterMessage(CreateEntryRequest) UpdateEntryRequest = _reflection.GeneratedProtocolMessageType( "UpdateEntryRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEENTRYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATEENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [UpdateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntry]. Attributes: entry: - Required. The updated entry. The "name" field must be set. + Required. The updated entry. The “name” field must be set. update_mask: The fields to update on the entry. If absent or empty, all modifiable fields are updated. The following fields are @@ -2830,64 +2787,64 @@ \* ``display_name`` \* ``description`` \* ``gcs_fileset_spec`` \* ``gcs_fileset_spec.file_patterns`` \* For entries with ``user_specified_type`` \* ``schema`` \* ``display_name`` \* - ``description`` \* user\_specified\_type \* - user\_specified\_system \* linked\_resource \* - source\_system\_timestamps + ``description`` \* user_specified_type \* + user_specified_system \* linked_resource \* + source_system_timestamps """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateEntryRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateEntryRequest) DeleteEntryRequest = _reflection.GeneratedProtocolMessageType( "DeleteEntryRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEENTRYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETEENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [DeleteEntry][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteEntry]. Attributes: name: Required. The name of the entry. Example: - projects/{projec - t\_id}/locations/{location}/entryGroups/{entry\_group\_id}/ent - ries/{entry\_id} + t_id}/locations/{location}/entryGroups/{entry_group_id}/entrie + s/{entry_id} """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteEntryRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteEntryRequest) GetEntryRequest = _reflection.GeneratedProtocolMessageType( "GetEntryRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETENTRYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [GetEntry][google.cloud.datacatalog.v1beta1.DataCatalog.GetEntry]. Attributes: name: Required. The name of the entry. Example: - projects/{projec - t\_id}/locations/{location}/entryGroups/{entry\_group\_id}/ent - ries/{entry\_id} + t_id}/locations/{location}/entryGroups/{entry_group_id}/entrie + s/{entry_id} """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GetEntryRequest) - ), + }, ) _sym_db.RegisterMessage(GetEntryRequest) LookupEntryRequest = _reflection.GeneratedProtocolMessageType( "LookupEntryRequest", (_message.Message,), - dict( - DESCRIPTOR=_LOOKUPENTRYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LOOKUPENTRYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [LookupEntry][google.cloud.datacatalog.v1beta1.DataCatalog.LookupEntry]. @@ -2898,14 +2855,14 @@ linked_resource: The full name of the Google Cloud Platform resource the Data Catalog entry represents. See: https://cloud.google.com/apis/d - esign/resource\_names#full\_resource\_name. Full names are - case-sensitive. Examples: - //bigquery.googleapis.com/proje - cts/projectId/datasets/datasetId/tables/tableId - + esign/resource_names#full_resource_name. Full names are case- + sensitive. Examples: - //bigquery.googleapis.com/projects/p + rojectId/datasets/datasetId/tables/tableId - //pubsub.googleapis.com/projects/projectId/topics/topicId sql_resource: The SQL name of the entry. SQL names are case-sensitive. Examples: - ``cloud_pubsub.project_id.topic_id`` - - ``pubsub.project_id.`topic.id.with.dots``` - + :literal:`pubsub.project_id.`topic.id.with.dots\`` - ``bigquery.table.project_id.dataset_id.table_id`` - ``bigquery.dataset.project_id.dataset_id`` - ``datacatalog.en try.project_id.location_id.entry_group_id.entry_id`` @@ -2915,17 +2872,17 @@ sql/lexical. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.LookupEntryRequest) - ), + }, ) _sym_db.RegisterMessage(LookupEntryRequest) Entry = _reflection.GeneratedProtocolMessageType( "Entry", (_message.Message,), - dict( - DESCRIPTOR=_ENTRY, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Entry Metadata. A Data Catalog Entry resource represents + { + "DESCRIPTOR": _ENTRY, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Entry Metadata. A Data Catalog Entry resource represents another resource in Google Cloud Platform (such as a BigQuery dataset or a Cloud Pub/Sub topic), or outside of Google Cloud Platform. Clients can use the ``linked_resource`` field in the Entry resource to refer to the @@ -2939,8 +2896,8 @@ Attributes: name: The Data Catalog resource name of the entry in URL format. - Example: - projects/{project\_id}/locations/{location}/entry - Groups/{entry\_group\_id}/entries/{entry\_id} Note that this + Example: - projects/{project_id}/locations/{location}/entryG + roups/{entry_group_id}/entries/{entry_id} Note that this Entry and its child resources may not actually be stored in the location in this name. linked_resource: @@ -2951,7 +2908,7 @@ ``linked_resource`` for a table resource from BigQuery is: - //bigquery.googleapis.com/projects/projectId/datasets/datasetI d/tables/tableId Output only when Entry is of type in the - EntryType enum. For entries with user\_specified\_type, this + EntryType enum. For entries with user_specified_type, this field is optional and defaults to an empty string. entry_type: Required. Entry type. @@ -2963,7 +2920,7 @@ listed in ``EntryType`` enum above. When creating an entry, users should check the enum values first, if nothing matches the entry to be created, then provide a custom value, for - example "my\_special\_type". ``user_specified_type`` strings + example “my_special_type”. ``user_specified_type`` strings must begin with a letter or underscore and can only contain letters, numbers, and underscores; are case insensitive; must be at least 1 character and at most 64 characters long. @@ -2973,11 +2930,11 @@ system: The source system of the entry. integrated_system: - Output only. This field indicates the entry's source system + Output only. This field indicates the entry’s source system that Data Catalog integrates with, such as BigQuery or Cloud Pub/Sub. user_specified_system: - This field indicates the entry's source system that Data + This field indicates the entry’s source system that Data Catalog does not integrate with. ``user_specified_system`` strings must begin with a letter or underscore and can only contain letters, numbers, and underscores; are case @@ -2995,11 +2952,11 @@ Specification for a group of BigQuery tables with name pattern ``[prefix]YYYYMMDD``. Context: https://cloud.google.com/bigquery/docs/partitioned- - tables#partitioning\_versus\_sharding. + tables#partitioning_versus_sharding. display_name: Display information such as title and description. A short - name to identify the entry, for example, "Analytics Data - Jan - 2011". Default value is an empty string. + name to identify the entry, for example, “Analytics Data - Jan + 2011”. Default value is an empty string. description: Entry description, which can consist of several sentences or paragraphs that describe entry contents. Default value is an @@ -3011,21 +2968,21 @@ Output only. Timestamps about the underlying resource, not about this Data Catalog entry. Output only when Entry is of type in the EntryType enum. For entries with - user\_specified\_type, this field is optional and defaults to - an empty timestamp. + user_specified_type, this field is optional and defaults to an + empty timestamp. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Entry) - ), + }, ) _sym_db.RegisterMessage(Entry) EntryGroup = _reflection.GeneratedProtocolMessageType( "EntryGroup", (_message.Message,), - dict( - DESCRIPTOR=_ENTRYGROUP, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""EntryGroup Metadata. An EntryGroup resource represents a + { + "DESCRIPTOR": _ENTRYGROUP, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """EntryGroup Metadata. An EntryGroup resource represents a logical grouping of zero or more Data Catalog [Entry][google.cloud.datacatalog.v1beta1.Entry] resources. @@ -3033,13 +2990,13 @@ Attributes: name: The resource name of the entry group in URL format. Example: - - projects/{project\_id}/locations/{location}/entryGroups/{en - try\_group\_id} Note that this EntryGroup and its child + - projects/{project_id}/locations/{location}/entryGroups/{ent + ry_group_id} Note that this EntryGroup and its child resources may not actually be stored in the location in this name. display_name: A short name to identify the entry group, for example, - "analytics data - jan 2011". Default value is an empty string. + “analytics data - jan 2011”. Default value is an empty string. description: Entry group description, which can consist of several sentences or paragraphs that describe entry group contents. @@ -3049,17 +3006,17 @@ is empty timestamps. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.EntryGroup) - ), + }, ) _sym_db.RegisterMessage(EntryGroup) CreateTagTemplateRequest = _reflection.GeneratedProtocolMessageType( "CreateTagTemplateRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATETAGTEMPLATEREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATETAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [CreateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplate]. @@ -3068,51 +3025,51 @@ Required. The name of the project and the template location `region `__. NOTE: Currently, only the ``us-central1 region`` is supported. - Example: - projects/{project\_id}/locations/us-central1 + Example: - projects/{project_id}/locations/us-central1 tag_template_id: Required. The id of the tag template to create. tag_template: Required. The tag template to create. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest) - ), + }, ) _sym_db.RegisterMessage(CreateTagTemplateRequest) GetTagTemplateRequest = _reflection.GeneratedProtocolMessageType( "GetTagTemplateRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETTAGTEMPLATEREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETTAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [GetTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.GetTagTemplate]. Attributes: name: Required. The name of the tag template. Example: - projects/ - {project\_id}/locations/{location}/tagTemplates/{tag\_template - \_id} + {project_id}/locations/{location}/tagTemplates/{tag_template_i + d} """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GetTagTemplateRequest) - ), + }, ) _sym_db.RegisterMessage(GetTagTemplateRequest) UpdateTagTemplateRequest = _reflection.GeneratedProtocolMessageType( "UpdateTagTemplateRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATETAGTEMPLATEREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATETAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [UpdateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplate]. Attributes: tag_template: - Required. The template to update. The "name" field must be + Required. The template to update. The “name” field must be set. update_mask: The field mask specifies the parts of the template to @@ -3120,25 +3077,25 @@ empty, all of the allowed fields above will be updated. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateTagTemplateRequest) DeleteTagTemplateRequest = _reflection.GeneratedProtocolMessageType( "DeleteTagTemplateRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETETAGTEMPLATEREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETETAGTEMPLATEREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [DeleteTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplate]. Attributes: name: Required. The name of the tag template to delete. Example: - - projects/{project\_id}/locations/{location}/tagTemplates/{tag\ - _template\_id} + projects/{project_id}/locations/{location}/tagTemplates/{tag_t + emplate_id} force: Required. Currently, this field must always be set to ``true``. This confirms the deletion of any possible tags @@ -3146,86 +3103,86 @@ the future. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteTagTemplateRequest) CreateTagRequest = _reflection.GeneratedProtocolMessageType( "CreateTagRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATETAGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATETAGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [CreateTag][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTag]. Attributes: parent: Required. The name of the resource to attach this tag to. Tags - can be attached to Entries. Example: - projects/{project\_id - }/locations/{location}/entryGroups/{entry\_group\_id}/entries/ - {entry\_id} Note that this Tag and its child resources may - not actually be stored in the location in this name. + can be attached to Entries. Example: - projects/{project_id} + /locations/{location}/entryGroups/{entry_group_id}/entries/{en + try_id} Note that this Tag and its child resources may not + actually be stored in the location in this name. tag: Required. The tag to create. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateTagRequest) - ), + }, ) _sym_db.RegisterMessage(CreateTagRequest) UpdateTagRequest = _reflection.GeneratedProtocolMessageType( "UpdateTagRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATETAGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATETAGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [UpdateTag][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTag]. Attributes: tag: - Required. The updated tag. The "name" field must be set. + Required. The updated tag. The “name” field must be set. update_mask: The fields to update on the Tag. If absent or empty, all modifiable fields are updated. Currently the only modifiable field is the field ``fields``. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateTagRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateTagRequest) DeleteTagRequest = _reflection.GeneratedProtocolMessageType( "DeleteTagRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETETAGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETETAGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [DeleteTag][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTag]. Attributes: name: Required. The name of the tag to delete. Example: - projects - /{project\_id}/locations/{location}/entryGroups/{entry\_group\ - _id}/entries/{entry\_id}/tags/{tag\_id} + /{project_id}/locations/{location}/entryGroups/{entry_group_id + }/entries/{entry_id}/tags/{tag_id} """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteTagRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteTagRequest) CreateTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( "CreateTagTemplateFieldRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATETAGTEMPLATEFIELDREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [CreateTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplateField]. @@ -3234,37 +3191,37 @@ Required. The name of the project and the template location `region `__. NOTE: Currently, only the ``us-central1 region`` is supported. - Example: - projects/{project\_id}/locations/us- - central1/tagTemplates/{tag\_template\_id} + Example: - projects/{project_id}/locations/us- + central1/tagTemplates/{tag_template_id} tag_template_field_id: Required. The ID of the tag template field to create. Field ids can contain letters (both uppercase and lowercase), - numbers (0-9), underscores (\_) and dashes (-). Field IDs must + numbers (0-9), underscores (_) and dashes (-). Field IDs must be at least 1 character long and at most 128 characters long. Field IDs must also be unique within their template. tag_template_field: Required. The tag template field to create. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest) - ), + }, ) _sym_db.RegisterMessage(CreateTagTemplateFieldRequest) UpdateTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( "UpdateTagTemplateFieldRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATETAGTEMPLATEFIELDREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [UpdateTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplateField]. Attributes: name: Required. The name of the tag template field. Example: - pro - jects/{project\_id}/locations/{location}/tagTemplates/{tag\_te - mplate\_id}/fields/{tag\_template\_field\_id} + jects/{project_id}/locations/{location}/tagTemplates/{tag_temp + late_id}/fields/{tag_template_field_id} tag_template_field: Required. The template to update. update_mask: @@ -3279,49 +3236,49 @@ is NOT allowed. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateTagTemplateFieldRequest) RenameTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( "RenameTagTemplateFieldRequest", (_message.Message,), - dict( - DESCRIPTOR=_RENAMETAGTEMPLATEFIELDREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _RENAMETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [RenameTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.RenameTagTemplateField]. Attributes: name: Required. The name of the tag template. Example: - projects/ - {project\_id}/locations/{location}/tagTemplates/{tag\_template - \_id}/fields/{tag\_template\_field\_id} + {project_id}/locations/{location}/tagTemplates/{tag_template_i + d}/fields/{tag_template_field_id} new_tag_template_field_id: Required. The new ID of this tag template field. For example, ``my_new_field``. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest) - ), + }, ) _sym_db.RegisterMessage(RenameTagTemplateFieldRequest) DeleteTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType( "DeleteTagTemplateFieldRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETETAGTEMPLATEFIELDREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETETAGTEMPLATEFIELDREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [DeleteTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplateField]. Attributes: name: Required. The name of the tag template field to delete. - Example: - projects/{project\_id}/locations/{location}/tagTe - mplates/{tag\_template\_id}/fields/{tag\_template\_field\_id} + Example: - projects/{project_id}/locations/{location}/tagTem + plates/{tag_template_id}/fields/{tag_template_field_id} force: Required. Currently, this field must always be set to ``true``. This confirms the deletion of this field from any @@ -3329,17 +3286,17 @@ the future. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteTagTemplateFieldRequest) ListTagsRequest = _reflection.GeneratedProtocolMessageType( "ListTagsRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTTAGSREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTTAGSREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [ListTags][google.cloud.datacatalog.v1beta1.DataCatalog.ListTags]. @@ -3349,9 +3306,9 @@ tags of. The resource could be an [Entry][google.cloud.datacatalog.v1beta1.Entry] or an [EntryGroup][google.cloud.datacatalog.v1beta1.EntryGroup]. - Examples: - projects/{project\_id}/locations/{location}/entr - yGroups/{entry\_group\_id} - projects/{project\_id}/locations - /{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id} + Examples: - projects/{project_id}/locations/{location}/entry + Groups/{entry_group_id} - projects/{project_id}/locations/{lo + cation}/entryGroups/{entry_group_id}/entries/{entry_id} page_size: The maximum number of tags to return. Default is 10. Max limit is 1000. @@ -3360,17 +3317,17 @@ first page is returned. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListTagsRequest) - ), + }, ) _sym_db.RegisterMessage(ListTagsRequest) ListTagsResponse = _reflection.GeneratedProtocolMessageType( "ListTagsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTTAGSRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTTAGSRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Response message for [ListTags][google.cloud.datacatalog.v1beta1.DataCatalog.ListTags]. @@ -3382,17 +3339,17 @@ if no items remain in results. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListTagsResponse) - ), + }, ) _sym_db.RegisterMessage(ListTagsResponse) ListEntriesRequest = _reflection.GeneratedProtocolMessageType( "ListEntriesRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTENTRIESREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTENTRIESREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Request message for [ListEntries][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntries]. @@ -3400,8 +3357,8 @@ parent: Required. The name of the entry group that contains the entries, which can be provided in URL format. Example: - pro - jects/{project\_id}/locations/{location}/entryGroups/{entry\_g - roup\_id} + jects/{project_id}/locations/{location}/entryGroups/{entry_gro + up_id} page_size: The maximum number of items to return. Default is 10. Max limit is 1000. Throws an invalid argument for ``page_size > @@ -3411,22 +3368,22 @@ first page is returned. read_mask: The fields to return for each Entry. If not set or empty, all - fields are returned. For example, setting read\_mask to - contain only one path "name" will cause ListEntries to return - a list of Entries with only "name" field. + fields are returned. For example, setting read_mask to contain + only one path “name” will cause ListEntries to return a list + of Entries with only “name” field. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListEntriesRequest) - ), + }, ) _sym_db.RegisterMessage(ListEntriesRequest) ListEntriesResponse = _reflection.GeneratedProtocolMessageType( "ListEntriesResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTENTRIESRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTENTRIESRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2", + "__doc__": """Response message for [ListEntries][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntries]. @@ -3438,7 +3395,7 @@ if no items remain in results. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListEntriesResponse) - ), + }, ) _sym_db.RegisterMessage(ListEntriesResponse) @@ -3499,9 +3456,7 @@ full_name="google.cloud.datacatalog.v1beta1.DataCatalog", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" - ), + serialized_options=b"\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform", serialized_start=5881, serialized_end=12312, methods=[ @@ -3512,9 +3467,7 @@ containing_service=None, input_type=_SEARCHCATALOGREQUEST, output_type=_SEARCHCATALOGRESPONSE, - serialized_options=_b( - '\202\323\344\223\002\034"\027/v1beta1/catalog:search:\001*\332A\013scope,query' - ), + serialized_options=b'\202\323\344\223\002\034"\027/v1beta1/catalog:search:\001*\332A\013scope,query', ), _descriptor.MethodDescriptor( name="CreateEntryGroup", @@ -3523,9 +3476,7 @@ containing_service=None, input_type=_CREATEENTRYGROUPREQUEST, output_type=_ENTRYGROUP, - serialized_options=_b( - '\202\323\344\223\002C"4/v1beta1/{parent=projects/*/locations/*}/entryGroups:\013entry_group\332A!parent,entry_group_id,entry_group' - ), + serialized_options=b'\202\323\344\223\002C"4/v1beta1/{parent=projects/*/locations/*}/entryGroups:\013entry_group\332A!parent,entry_group_id,entry_group', ), _descriptor.MethodDescriptor( name="UpdateEntryGroup", @@ -3534,9 +3485,7 @@ containing_service=None, input_type=_UPDATEENTRYGROUPREQUEST, output_type=_ENTRYGROUP, - serialized_options=_b( - "\202\323\344\223\002O2@/v1beta1/{entry_group.name=projects/*/locations/*/entryGroups/*}:\013entry_group\332A\013entry_group\332A\027entry_group,update_mask" - ), + serialized_options=b"\202\323\344\223\002O2@/v1beta1/{entry_group.name=projects/*/locations/*/entryGroups/*}:\013entry_group\332A\013entry_group\332A\027entry_group,update_mask", ), _descriptor.MethodDescriptor( name="GetEntryGroup", @@ -3545,9 +3494,7 @@ containing_service=None, input_type=_GETENTRYGROUPREQUEST, output_type=_ENTRYGROUP, - serialized_options=_b( - "\202\323\344\223\0026\0224/v1beta1/{name=projects/*/locations/*/entryGroups/*}\332A\004name\332A\016name,read_mask" - ), + serialized_options=b"\202\323\344\223\0026\0224/v1beta1/{name=projects/*/locations/*/entryGroups/*}\332A\004name\332A\016name,read_mask", ), _descriptor.MethodDescriptor( name="DeleteEntryGroup", @@ -3556,9 +3503,7 @@ containing_service=None, input_type=_DELETEENTRYGROUPREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0026*4/v1beta1/{name=projects/*/locations/*/entryGroups/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0026*4/v1beta1/{name=projects/*/locations/*/entryGroups/*}\332A\004name", ), _descriptor.MethodDescriptor( name="ListEntryGroups", @@ -3567,9 +3512,7 @@ containing_service=None, input_type=_LISTENTRYGROUPSREQUEST, output_type=_LISTENTRYGROUPSRESPONSE, - serialized_options=_b( - "\202\323\344\223\0026\0224/v1beta1/{parent=projects/*/locations/*}/entryGroups\332A\006parent" - ), + serialized_options=b"\202\323\344\223\0026\0224/v1beta1/{parent=projects/*/locations/*}/entryGroups\332A\006parent", ), _descriptor.MethodDescriptor( name="CreateEntry", @@ -3578,9 +3521,7 @@ containing_service=None, input_type=_CREATEENTRYREQUEST, output_type=_ENTRY, - serialized_options=_b( - '\202\323\344\223\002G">/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries:\005entry\332A\025parent,entry_id,entry' - ), + serialized_options=b'\202\323\344\223\002G">/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries:\005entry\332A\025parent,entry_id,entry', ), _descriptor.MethodDescriptor( name="UpdateEntry", @@ -3589,9 +3530,7 @@ containing_service=None, input_type=_UPDATEENTRYREQUEST, output_type=_ENTRY, - serialized_options=_b( - "\202\323\344\223\002M2D/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\005entry\332A\005entry\332A\021entry,update_mask" - ), + serialized_options=b"\202\323\344\223\002M2D/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\005entry\332A\005entry\332A\021entry,update_mask", ), _descriptor.MethodDescriptor( name="DeleteEntry", @@ -3600,9 +3539,7 @@ containing_service=None, input_type=_DELETEENTRYREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\002@*>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002@*>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\332A\004name", ), _descriptor.MethodDescriptor( name="GetEntry", @@ -3611,9 +3548,7 @@ containing_service=None, input_type=_GETENTRYREQUEST, output_type=_ENTRY, - serialized_options=_b( - "\202\323\344\223\002@\022>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002@\022>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\332A\004name", ), _descriptor.MethodDescriptor( name="LookupEntry", @@ -3622,9 +3557,7 @@ containing_service=None, input_type=_LOOKUPENTRYREQUEST, output_type=_ENTRY, - serialized_options=_b( - "\202\323\344\223\002\031\022\027/v1beta1/entries:lookup" - ), + serialized_options=b"\202\323\344\223\002\031\022\027/v1beta1/entries:lookup", ), _descriptor.MethodDescriptor( name="ListEntries", @@ -3633,9 +3566,7 @@ containing_service=None, input_type=_LISTENTRIESREQUEST, output_type=_LISTENTRIESRESPONSE, - serialized_options=_b( - "\202\323\344\223\002@\022>/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries\332A\006parent" - ), + serialized_options=b"\202\323\344\223\002@\022>/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries\332A\006parent", ), _descriptor.MethodDescriptor( name="CreateTagTemplate", @@ -3644,9 +3575,7 @@ containing_service=None, input_type=_CREATETAGTEMPLATEREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE, - serialized_options=_b( - '\202\323\344\223\002E"5/v1beta1/{parent=projects/*/locations/*}/tagTemplates:\014tag_template\332A#parent,tag_template_id,tag_template' - ), + serialized_options=b'\202\323\344\223\002E"5/v1beta1/{parent=projects/*/locations/*}/tagTemplates:\014tag_template\332A#parent,tag_template_id,tag_template', ), _descriptor.MethodDescriptor( name="GetTagTemplate", @@ -3655,9 +3584,7 @@ containing_service=None, input_type=_GETTAGTEMPLATEREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE, - serialized_options=_b( - "\202\323\344\223\0027\0225/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0027\0225/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\332A\004name", ), _descriptor.MethodDescriptor( name="UpdateTagTemplate", @@ -3666,9 +3593,7 @@ containing_service=None, input_type=_UPDATETAGTEMPLATEREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE, - serialized_options=_b( - "\202\323\344\223\002R2B/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\014tag_template\332A\014tag_template\332A\030tag_template,update_mask" - ), + serialized_options=b"\202\323\344\223\002R2B/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\014tag_template\332A\014tag_template\332A\030tag_template,update_mask", ), _descriptor.MethodDescriptor( name="DeleteTagTemplate", @@ -3677,9 +3602,7 @@ containing_service=None, input_type=_DELETETAGTEMPLATEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0027*5/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\332A\nname,force" - ), + serialized_options=b"\202\323\344\223\0027*5/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\332A\nname,force", ), _descriptor.MethodDescriptor( name="CreateTagTemplateField", @@ -3688,9 +3611,7 @@ containing_service=None, input_type=_CREATETAGTEMPLATEFIELDREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD, - serialized_options=_b( - '\202\323\344\223\002T">/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\022tag_template_field\332A/parent,tag_template_field_id,tag_template_field' - ), + serialized_options=b'\202\323\344\223\002T">/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\022tag_template_field\332A/parent,tag_template_field_id,tag_template_field', ), _descriptor.MethodDescriptor( name="UpdateTagTemplateField", @@ -3699,9 +3620,7 @@ containing_service=None, input_type=_UPDATETAGTEMPLATEFIELDREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD, - serialized_options=_b( - "\202\323\344\223\002T2>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\022tag_template_field\332A\027name,tag_template_field\332A#name,tag_template_field,update_mask" - ), + serialized_options=b"\202\323\344\223\002T2>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\022tag_template_field\332A\027name,tag_template_field\332A#name,tag_template_field,update_mask", ), _descriptor.MethodDescriptor( name="RenameTagTemplateField", @@ -3710,9 +3629,7 @@ containing_service=None, input_type=_RENAMETAGTEMPLATEFIELDREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD, - serialized_options=_b( - '\202\323\344\223\002J"E/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\001*\332A\036name,new_tag_template_field_id' - ), + serialized_options=b'\202\323\344\223\002J"E/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\001*\332A\036name,new_tag_template_field_id', ), _descriptor.MethodDescriptor( name="DeleteTagTemplateField", @@ -3721,9 +3638,7 @@ containing_service=None, input_type=_DELETETAGTEMPLATEFIELDREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\002@*>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}\332A\nname,force" - ), + serialized_options=b"\202\323\344\223\002@*>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}\332A\nname,force", ), _descriptor.MethodDescriptor( name="CreateTag", @@ -3732,9 +3647,7 @@ containing_service=None, input_type=_CREATETAGREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAG, - serialized_options=_b( - '\202\323\344\223\002\220\001"E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\003tagZB";/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags:\003tag\332A\nparent,tag' - ), + serialized_options=b'\202\323\344\223\002\220\001"E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\003tagZB";/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags:\003tag\332A\nparent,tag', ), _descriptor.MethodDescriptor( name="UpdateTag", @@ -3743,9 +3656,7 @@ containing_service=None, input_type=_UPDATETAGREQUEST, output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAG, - serialized_options=_b( - "\202\323\344\223\002\230\0012I/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\003tagZF2?/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}:\003tag\332A\003tag\332A\017tag,update_mask" - ), + serialized_options=b"\202\323\344\223\002\230\0012I/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\003tagZF2?/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}:\003tag\332A\003tag\332A\017tag,update_mask", ), _descriptor.MethodDescriptor( name="DeleteTag", @@ -3754,9 +3665,7 @@ containing_service=None, input_type=_DELETETAGREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\002\206\001*E/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}Z=*;/v1beta1/{name=projects/*/locations/*/entryGroups/*/tags/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002\206\001*E/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}Z=*;/v1beta1/{name=projects/*/locations/*/entryGroups/*/tags/*}\332A\004name", ), _descriptor.MethodDescriptor( name="ListTags", @@ -3765,9 +3674,7 @@ containing_service=None, input_type=_LISTTAGSREQUEST, output_type=_LISTTAGSRESPONSE, - serialized_options=_b( - "\202\323\344\223\002\206\001\022E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tagsZ=\022;/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags\332A\006parent" - ), + serialized_options=b"\202\323\344\223\002\206\001\022E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tagsZ=\022;/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags\332A\006parent", ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -3776,9 +3683,7 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002\227\001"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\001*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy:\001*' - ), + serialized_options=b'\202\323\344\223\002\227\001"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\001*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy:\001*', ), _descriptor.MethodDescriptor( name="GetIamPolicy", @@ -3787,9 +3692,7 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002\355\001"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\001*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy:\001*ZT"O/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy:\001*' - ), + serialized_options=b'\202\323\344\223\002\355\001"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\001*ZJ"E/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy:\001*ZT"O/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy:\001*', ), _descriptor.MethodDescriptor( name="TestIamPermissions", @@ -3798,9 +3701,7 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, - serialized_options=_b( - '\202\323\344\223\002\377\001"L/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\001*ZP"K/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions:\001*ZZ"U/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions:\001*' - ), + serialized_options=b'\202\323\344\223\002\377\001"L/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\001*ZP"K/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions:\001*ZZ"U/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions:\001*', ), ], ) diff --git a/google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec_pb2.py b/google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec_pb2.py index ba119bc0..3ef851c5 100644 --- a/google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -25,12 +22,8 @@ name="google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n=google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/timestamps.proto"\x7f\n\x0eGcsFilesetSpec\x12\x1a\n\rfile_patterns\x18\x01 \x03(\tB\x03\xe0\x41\x02\x12Q\n\x15sample_gcs_file_specs\x18\x02 \x03(\x0b\x32-.google.cloud.datacatalog.v1beta1.GcsFileSpecB\x03\xe0\x41\x03"\x8f\x01\n\x0bGcsFileSpec\x12\x16\n\tfile_path\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12O\n\x0egcs_timestamps\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.SystemTimestampsB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x04 \x01(\x03\x42\x03\xe0\x41\x03\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b'\n=google/cloud/datacatalog_v1beta1/proto/gcs_fileset_spec.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/timestamps.proto"\x7f\n\x0eGcsFilesetSpec\x12\x1a\n\rfile_patterns\x18\x01 \x03(\tB\x03\xe0\x41\x02\x12Q\n\x15sample_gcs_file_specs\x18\x02 \x03(\x0b\x32-.google.cloud.datacatalog.v1beta1.GcsFileSpecB\x03\xe0\x41\x03"\x8f\x01\n\x0bGcsFileSpec\x12\x16\n\tfile_path\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12O\n\x0egcs_timestamps\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.SystemTimestampsB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x04 \x01(\x03\x42\x03\xe0\x41\x03\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_timestamps__pb2.DESCRIPTOR, @@ -60,7 +53,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -78,7 +71,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], @@ -111,13 +104,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -135,7 +128,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -153,7 +146,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], @@ -182,10 +175,10 @@ GcsFilesetSpec = _reflection.GeneratedProtocolMessageType( "GcsFilesetSpec", (_message.Message,), - dict( - DESCRIPTOR=_GCSFILESETSPEC, - __module__="google.cloud.datacatalog_v1beta1.proto.gcs_fileset_spec_pb2", - __doc__="""Describes a Cloud Storage fileset entry. + { + "DESCRIPTOR": _GCSFILESETSPEC, + "__module__": "google.cloud.datacatalog_v1beta1.proto.gcs_fileset_spec_pb2", + "__doc__": """Describes a Cloud Storage fileset entry. Attributes: @@ -194,7 +187,7 @@ Storage. See `Cloud Storage documentation `__ for more information. Note that bucket wildcards are currently not - supported. Examples of valid file\_patterns: - + supported. Examples of valid file_patterns: - ``gs://bucket_name/dir/*``: matches all files within ``bucket_name/dir`` directory. - ``gs://bucket_name/dir/**``: matches all files in ``bucket_name/dir`` spanning all @@ -205,7 +198,7 @@ ``gs://bucket_name/[aeiou].txt``: matches files that contain a single vowel character followed by ``.txt`` in ``bucket_name`` - ``gs://bucket_name/[a-m].txt``: matches - files that contain ``a``, ``b``, ... or ``m`` followed by + files that contain ``a``, ``b``, … or ``m`` followed by ``.txt`` in ``bucket_name`` - ``gs://bucket_name/a/*/b``: matches all files in ``bucket_name`` that match ``a/*/b`` pattern, such as ``a/c/b``, ``a/d/b`` - @@ -218,17 +211,17 @@ files contained in this fileset are represented here. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GcsFilesetSpec) - ), + }, ) _sym_db.RegisterMessage(GcsFilesetSpec) GcsFileSpec = _reflection.GeneratedProtocolMessageType( "GcsFileSpec", (_message.Message,), - dict( - DESCRIPTOR=_GCSFILESPEC, - __module__="google.cloud.datacatalog_v1beta1.proto.gcs_fileset_spec_pb2", - __doc__="""Specifications of a single file in Cloud Storage. + { + "DESCRIPTOR": _GCSFILESPEC, + "__module__": "google.cloud.datacatalog_v1beta1.proto.gcs_fileset_spec_pb2", + "__doc__": """Specifications of a single file in Cloud Storage. Attributes: @@ -241,7 +234,7 @@ Output only. The size of the file, in bytes. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GcsFileSpec) - ), + }, ) _sym_db.RegisterMessage(GcsFileSpec) diff --git a/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py b/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py index ef97ea55..3a994f1e 100644 --- a/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/policytagmanager.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -32,12 +29,8 @@ name="google/cloud/datacatalog_v1beta1/proto/policytagmanager.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1B\025PolicyTagManagerProtoP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n=google/cloud/datacatalog_v1beta1/proto/policytagmanager.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/timestamps.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\xe3\x02\n\x08Taxonomy\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x19\n\x0c\x64isplay_name\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x18\n\x0b\x64\x65scription\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12Z\n\x16\x61\x63tivated_policy_types\x18\x06 \x03(\x0e\x32\x35.google.cloud.datacatalog.v1beta1.Taxonomy.PolicyTypeB\x03\xe0\x41\x01"J\n\nPolicyType\x12\x1b\n\x17POLICY_TYPE_UNSPECIFIED\x10\x00\x12\x1f\n\x1b\x46INE_GRAINED_ACCESS_CONTROL\x10\x01:g\xea\x41\x64\n#datacatalog.googleapis.com/Taxonomy\x12=projects/{project}/locations/{location}/taxonomies/{taxonomy}"\x8c\x02\n\tPolicyTag\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x19\n\x0c\x64isplay_name\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x19\n\x11parent_policy_tag\x18\x04 \x01(\t\x12\x1e\n\x11\x63hild_policy_tags\x18\x05 \x03(\tB\x03\xe0\x41\x03:\x80\x01\xea\x41}\n$datacatalog.googleapis.com/PolicyTag\x12Uprojects/{project}/locations/{location}/taxonomies/{taxonomy}/policyTags/{policy_tag}"\x92\x01\n\x15\x43reateTaxonomyRequest\x12;\n\x06parent\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\x12#datacatalog.googleapis.com/Taxonomy\x12<\n\x08taxonomy\x18\x02 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.Taxonomy"R\n\x15\x44\x65leteTaxonomyRequest\x12\x39\n\x04name\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\n#datacatalog.googleapis.com/Taxonomy"\x86\x01\n\x15UpdateTaxonomyRequest\x12<\n\x08taxonomy\x18\x01 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.Taxonomy\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"{\n\x15ListTaxonomiesRequest\x12;\n\x06parent\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\x12#datacatalog.googleapis.com/Taxonomy\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"q\n\x16ListTaxonomiesResponse\x12>\n\ntaxonomies\x18\x01 \x03(\x0b\x32*.google.cloud.datacatalog.v1beta1.Taxonomy\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"O\n\x12GetTaxonomyRequest\x12\x39\n\x04name\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\n#datacatalog.googleapis.com/Taxonomy"\x97\x01\n\x16\x43reatePolicyTagRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$datacatalog.googleapis.com/PolicyTag\x12?\n\npolicy_tag\x18\x02 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.PolicyTag"T\n\x16\x44\x65letePolicyTagRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$datacatalog.googleapis.com/PolicyTag"\x8a\x01\n\x16UpdatePolicyTagRequest\x12?\n\npolicy_tag\x18\x01 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.PolicyTag\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"|\n\x15ListPolicyTagsRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$datacatalog.googleapis.com/PolicyTag\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"s\n\x16ListPolicyTagsResponse\x12@\n\x0bpolicy_tags\x18\x01 \x03(\x0b\x32+.google.cloud.datacatalog.v1beta1.PolicyTag\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"Q\n\x13GetPolicyTagRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$datacatalog.googleapis.com/PolicyTag2\xe5\x16\n\x10PolicyTagManager\x12\xce\x01\n\x0e\x43reateTaxonomy\x12\x37.google.cloud.datacatalog.v1beta1.CreateTaxonomyRequest\x1a*.google.cloud.datacatalog.v1beta1.Taxonomy"W\x82\xd3\xe4\x93\x02?"3/v1beta1/{parent=projects/*/locations/*}/taxonomies:\x08taxonomy\xda\x41\x0fparent,taxonomy\x12\xa5\x01\n\x0e\x44\x65leteTaxonomy\x12\x37.google.cloud.datacatalog.v1beta1.DeleteTaxonomyRequest\x1a\x16.google.protobuf.Empty"B\x82\xd3\xe4\x93\x02\x35*3/v1beta1/{name=projects/*/locations/*/taxonomies/*}\xda\x41\x04name\x12\xd0\x01\n\x0eUpdateTaxonomy\x12\x37.google.cloud.datacatalog.v1beta1.UpdateTaxonomyRequest\x1a*.google.cloud.datacatalog.v1beta1.Taxonomy"Y\x82\xd3\xe4\x93\x02H2\n\ntaxonomies\x18\x01 \x03(\x0b\x32*.google.cloud.datacatalog.v1beta1.Taxonomy\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"O\n\x12GetTaxonomyRequest\x12\x39\n\x04name\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\n#datacatalog.googleapis.com/Taxonomy"\x97\x01\n\x16\x43reatePolicyTagRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$datacatalog.googleapis.com/PolicyTag\x12?\n\npolicy_tag\x18\x02 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.PolicyTag"T\n\x16\x44\x65letePolicyTagRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$datacatalog.googleapis.com/PolicyTag"\x8a\x01\n\x16UpdatePolicyTagRequest\x12?\n\npolicy_tag\x18\x01 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.PolicyTag\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"|\n\x15ListPolicyTagsRequest\x12<\n\x06parent\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\x12$datacatalog.googleapis.com/PolicyTag\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"s\n\x16ListPolicyTagsResponse\x12@\n\x0bpolicy_tags\x18\x01 \x03(\x0b\x32+.google.cloud.datacatalog.v1beta1.PolicyTag\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"Q\n\x13GetPolicyTagRequest\x12:\n\x04name\x18\x01 \x01(\tB,\xe0\x41\x02\xfa\x41&\n$datacatalog.googleapis.com/PolicyTag2\xe5\x16\n\x10PolicyTagManager\x12\xce\x01\n\x0e\x43reateTaxonomy\x12\x37.google.cloud.datacatalog.v1beta1.CreateTaxonomyRequest\x1a*.google.cloud.datacatalog.v1beta1.Taxonomy"W\x82\xd3\xe4\x93\x02?"3/v1beta1/{parent=projects/*/locations/*}/taxonomies:\x08taxonomy\xda\x41\x0fparent,taxonomy\x12\xa5\x01\n\x0e\x44\x65leteTaxonomy\x12\x37.google.cloud.datacatalog.v1beta1.DeleteTaxonomyRequest\x1a\x16.google.protobuf.Empty"B\x82\xd3\xe4\x93\x02\x35*3/v1beta1/{name=projects/*/locations/*/taxonomies/*}\xda\x41\x04name\x12\xd0\x01\n\x0eUpdateTaxonomy\x12\x37.google.cloud.datacatalog.v1beta1.UpdateTaxonomyRequest\x1a*.google.cloud.datacatalog.v1beta1.Taxonomy"Y\x82\xd3\xe4\x93\x02H2 (LatLong, City, ZipCode). PolicyTag - "Geolocation" contains three child policy tags: "LatLong", "City", and - "ZipCode". + “Geolocation” contains three child policy tags: “LatLong”, “City”, and + “ZipCode”. Attributes: name: Output only. Resource name of this policy tag, whose format - is: "projects/{project\_number}/locations/{location\_id}/taxon - omies/{taxonomy\_id}/policyTags/{id}". + is: “projects/{project_number}/locations/{location_id}/taxonom + ies/{taxonomy_id}/policyTags/{id}”. display_name: Required. User defined name of this policy tag. It must: be unique within the parent taxonomy; contain only unicode @@ -1050,28 +1023,28 @@ set, defaults to an empty description. If not set, defaults to an empty description. parent_policy_tag: - Resource name of this policy tag's parent policy tag (e.g. for - the "LatLong" policy tag in the example above, this field - contains the resource name of the "Geolocation" policy tag). + Resource name of this policy tag’s parent policy tag (e.g. for + the “LatLong” policy tag in the example above, this field + contains the resource name of the “Geolocation” policy tag). If empty, it means this policy tag is a top level policy tag - (e.g. this field is empty for the "Geolocation" policy tag in + (e.g. this field is empty for the “Geolocation” policy tag in the example above). If not set, defaults to an empty string. child_policy_tags: Output only. Resource names of child policy tags of this policy tag. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.PolicyTag) - ), + }, ) _sym_db.RegisterMessage(PolicyTag) CreateTaxonomyRequest = _reflection.GeneratedProtocolMessageType( "CreateTaxonomyRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATETAXONOMYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATETAXONOMYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [CreateTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.CreateTaxonomy]. @@ -1083,17 +1056,17 @@ The taxonomy to be created. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateTaxonomyRequest) - ), + }, ) _sym_db.RegisterMessage(CreateTaxonomyRequest) DeleteTaxonomyRequest = _reflection.GeneratedProtocolMessageType( "DeleteTaxonomyRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETETAXONOMYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETETAXONOMYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [DeleteTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.DeleteTaxonomy]. @@ -1103,23 +1076,23 @@ policy tags in this taxonomy will also be deleted. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteTaxonomyRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteTaxonomyRequest) UpdateTaxonomyRequest = _reflection.GeneratedProtocolMessageType( "UpdateTaxonomyRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATETAXONOMYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATETAXONOMYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [UpdateTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.UpdateTaxonomy]. Attributes: taxonomy: - The taxonomy to update. Only description, display\_name, and + The taxonomy to update. Only description, display_name, and activated policy types can be updated. update_mask: The update mask applies to the resource. For the ``FieldMask`` @@ -1128,17 +1101,17 @@ defaults to all of the fields that are allowed to update. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateTaxonomyRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateTaxonomyRequest) ListTaxonomiesRequest = _reflection.GeneratedProtocolMessageType( "ListTaxonomiesRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTTAXONOMIESREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTTAXONOMIESREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [ListTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListTaxonomies]. @@ -1150,21 +1123,21 @@ The maximum number of items to return. Must be a value between 1 and 1000. If not set, defaults to 50. page_token: - The next\_page\_token value returned from a previous list + The next_page_token value returned from a previous list request, if any. If not set, defaults to an empty string. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListTaxonomiesRequest) - ), + }, ) _sym_db.RegisterMessage(ListTaxonomiesRequest) ListTaxonomiesResponse = _reflection.GeneratedProtocolMessageType( "ListTaxonomiesResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTTAXONOMIESRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTTAXONOMIESRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Response message for [ListTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListTaxonomies]. @@ -1176,17 +1149,17 @@ there are no more results in the list. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListTaxonomiesResponse) - ), + }, ) _sym_db.RegisterMessage(ListTaxonomiesResponse) GetTaxonomyRequest = _reflection.GeneratedProtocolMessageType( "GetTaxonomyRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETTAXONOMYREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETTAXONOMYREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [GetTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.GetTaxonomy]. @@ -1195,17 +1168,17 @@ Required. Resource name of the requested taxonomy. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GetTaxonomyRequest) - ), + }, ) _sym_db.RegisterMessage(GetTaxonomyRequest) CreatePolicyTagRequest = _reflection.GeneratedProtocolMessageType( "CreatePolicyTagRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEPOLICYTAGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATEPOLICYTAGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [CreatePolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.CreatePolicyTag]. @@ -1217,17 +1190,17 @@ The policy tag to be created. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreatePolicyTagRequest) - ), + }, ) _sym_db.RegisterMessage(CreatePolicyTagRequest) DeletePolicyTagRequest = _reflection.GeneratedProtocolMessageType( "DeletePolicyTagRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEPOLICYTAGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETEPOLICYTAGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [DeletePolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.DeletePolicyTag]. @@ -1237,47 +1210,47 @@ of its descendant policy tags will also be deleted. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeletePolicyTagRequest) - ), + }, ) _sym_db.RegisterMessage(DeletePolicyTagRequest) UpdatePolicyTagRequest = _reflection.GeneratedProtocolMessageType( "UpdatePolicyTagRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEPOLICYTAGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATEPOLICYTAGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [UpdatePolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.UpdatePolicyTag]. Attributes: policy_tag: - The policy tag to update. Only the description, display\_name, - and parent\_policy\_tag fields can be updated. + The policy tag to update. Only the description, display_name, + and parent_policy_tag fields can be updated. update_mask: - The update mask applies to the resource. Only display\_name, - description and parent\_policy\_tag can be updated and thus - can be listed in the mask. If update\_mask is not provided, - all allowed fields (i.e. display\_name, description and - parent) will be updated. For more information including the + The update mask applies to the resource. Only display_name, + description and parent_policy_tag can be updated and thus can + be listed in the mask. If update_mask is not provided, all + allowed fields (i.e. display_name, description and parent) + will be updated. For more information including the ``FieldMask`` definition, see https://developers.google.com/protocol- buffers/docs/reference/google.protobuf#fieldmask If not set, defaults to all of the fields that are allowed to update. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdatePolicyTagRequest) - ), + }, ) _sym_db.RegisterMessage(UpdatePolicyTagRequest) ListPolicyTagsRequest = _reflection.GeneratedProtocolMessageType( "ListPolicyTagsRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTPOLICYTAGSREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTPOLICYTAGSREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [ListPolicyTags][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListPolicyTags]. @@ -1289,21 +1262,21 @@ The maximum number of items to return. Must be a value between 1 and 1000. If not set, defaults to 50. page_token: - The next\_page\_token value returned from a previous List + The next_page_token value returned from a previous List request, if any. If not set, defaults to an empty string. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListPolicyTagsRequest) - ), + }, ) _sym_db.RegisterMessage(ListPolicyTagsRequest) ListPolicyTagsResponse = _reflection.GeneratedProtocolMessageType( "ListPolicyTagsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTPOLICYTAGSRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTPOLICYTAGSRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Response message for [ListPolicyTags][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListPolicyTags]. @@ -1315,17 +1288,17 @@ there are no more results in the list. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListPolicyTagsResponse) - ), + }, ) _sym_db.RegisterMessage(ListPolicyTagsResponse) GetPolicyTagRequest = _reflection.GeneratedProtocolMessageType( "GetPolicyTagRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETPOLICYTAGREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETPOLICYTAGREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanager_pb2", + "__doc__": """Request message for [GetPolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.GetPolicyTag]. @@ -1334,7 +1307,7 @@ Required. Resource name of the requested policy tag. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GetPolicyTagRequest) - ), + }, ) _sym_db.RegisterMessage(GetPolicyTagRequest) @@ -1363,9 +1336,7 @@ full_name="google.cloud.datacatalog.v1beta1.PolicyTagManager", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" - ), + serialized_options=b"\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform", serialized_start=2422, serialized_end=5339, methods=[ @@ -1376,9 +1347,7 @@ containing_service=None, input_type=_CREATETAXONOMYREQUEST, output_type=_TAXONOMY, - serialized_options=_b( - '\202\323\344\223\002?"3/v1beta1/{parent=projects/*/locations/*}/taxonomies:\010taxonomy\332A\017parent,taxonomy' - ), + serialized_options=b'\202\323\344\223\002?"3/v1beta1/{parent=projects/*/locations/*}/taxonomies:\010taxonomy\332A\017parent,taxonomy', ), _descriptor.MethodDescriptor( name="DeleteTaxonomy", @@ -1387,9 +1356,7 @@ containing_service=None, input_type=_DELETETAXONOMYREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0025*3/v1beta1/{name=projects/*/locations/*/taxonomies/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0025*3/v1beta1/{name=projects/*/locations/*/taxonomies/*}\332A\004name", ), _descriptor.MethodDescriptor( name="UpdateTaxonomy", @@ -1398,9 +1365,7 @@ containing_service=None, input_type=_UPDATETAXONOMYREQUEST, output_type=_TAXONOMY, - serialized_options=_b( - "\202\323\344\223\002H2\n\ntaxonomies\x18\x01 \x03(\x0b\x32*.google.cloud.datacatalog.v1beta1.Taxonomy"\xc7\x01\n\x17\x45xportTaxonomiesRequest\x12;\n\x06parent\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\x12#datacatalog.googleapis.com/Taxonomy\x12?\n\ntaxonomies\x18\x02 \x03(\tB+\xe0\x41\x02\xfa\x41%\n#datacatalog.googleapis.com/Taxonomy\x12\x1f\n\x15serialized_taxonomies\x18\x03 \x01(\x08H\x00\x42\r\n\x0b\x64\x65stination"d\n\x18\x45xportTaxonomiesResponse\x12H\n\ntaxonomies\x18\x01 \x03(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.SerializedTaxonomy2\x92\x04\n\x1dPolicyTagManagerSerialization\x12\xd0\x01\n\x10ImportTaxonomies\x12\x39.google.cloud.datacatalog.v1beta1.ImportTaxonomiesRequest\x1a:.google.cloud.datacatalog.v1beta1.ImportTaxonomiesResponse"E\x82\xd3\xe4\x93\x02?":/v1beta1/{parent=projects/*/locations/*}/taxonomies:import:\x01*\x12\xcd\x01\n\x10\x45xportTaxonomies\x12\x39.google.cloud.datacatalog.v1beta1.ExportTaxonomiesRequest\x1a:.google.cloud.datacatalog.v1beta1.ExportTaxonomiesResponse"B\x82\xd3\xe4\x93\x02<\x12:/v1beta1/{parent=projects/*/locations/*}/taxonomies:export\x1aN\xca\x41\x1a\x64\x61tacatalog.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x9c\x01\n$com.google.cloud.datacatalog.v1beta1B"PolicyTagManagerSerializationProtoP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b'\n$com.google.cloud.datacatalog.v1beta1B"PolicyTagManagerSerializationProtoP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001', + serialized_pb=b'\nJgoogle/cloud/datacatalog_v1beta1/proto/policytagmanagerserialization.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a=google/cloud/datacatalog_v1beta1/proto/policytagmanager.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x17google/api/client.proto"\x90\x01\n\x12SerializedTaxonomy\x12\x19\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12J\n\x0bpolicy_tags\x18\x03 \x03(\x0b\x32\x35.google.cloud.datacatalog.v1beta1.SerializedPolicyTag"\x97\x01\n\x13SerializedPolicyTag\x12\x19\n\x0c\x64isplay_name\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12P\n\x11\x63hild_policy_tags\x18\x04 \x03(\x0b\x32\x35.google.cloud.datacatalog.v1beta1.SerializedPolicyTag"\xa9\x01\n\x17ImportTaxonomiesRequest\x12;\n\x06parent\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\x12#datacatalog.googleapis.com/Taxonomy\x12G\n\rinline_source\x18\x02 \x01(\x0b\x32..google.cloud.datacatalog.v1beta1.InlineSourceH\x00\x42\x08\n\x06source"]\n\x0cInlineSource\x12M\n\ntaxonomies\x18\x01 \x03(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.SerializedTaxonomyB\x03\xe0\x41\x02"Z\n\x18ImportTaxonomiesResponse\x12>\n\ntaxonomies\x18\x01 \x03(\x0b\x32*.google.cloud.datacatalog.v1beta1.Taxonomy"\xc7\x01\n\x17\x45xportTaxonomiesRequest\x12;\n\x06parent\x18\x01 \x01(\tB+\xe0\x41\x02\xfa\x41%\x12#datacatalog.googleapis.com/Taxonomy\x12?\n\ntaxonomies\x18\x02 \x03(\tB+\xe0\x41\x02\xfa\x41%\n#datacatalog.googleapis.com/Taxonomy\x12\x1f\n\x15serialized_taxonomies\x18\x03 \x01(\x08H\x00\x42\r\n\x0b\x64\x65stination"d\n\x18\x45xportTaxonomiesResponse\x12H\n\ntaxonomies\x18\x01 \x03(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.SerializedTaxonomy2\x92\x04\n\x1dPolicyTagManagerSerialization\x12\xd0\x01\n\x10ImportTaxonomies\x12\x39.google.cloud.datacatalog.v1beta1.ImportTaxonomiesRequest\x1a:.google.cloud.datacatalog.v1beta1.ImportTaxonomiesResponse"E\x82\xd3\xe4\x93\x02?":/v1beta1/{parent=projects/*/locations/*}/taxonomies:import:\x01*\x12\xcd\x01\n\x10\x45xportTaxonomies\x12\x39.google.cloud.datacatalog.v1beta1.ExportTaxonomiesRequest\x1a:.google.cloud.datacatalog.v1beta1.ExportTaxonomiesResponse"B\x82\xd3\xe4\x93\x02<\x12:/v1beta1/{parent=projects/*/locations/*}/taxonomies:export\x1aN\xca\x41\x1a\x64\x61tacatalog.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x9c\x01\n$com.google.cloud.datacatalog.v1beta1B"PolicyTagManagerSerializationProtoP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, @@ -62,13 +55,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -80,7 +73,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -137,13 +130,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -155,7 +148,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -212,15 +205,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A%\022#datacatalog.googleapis.com/Taxonomy" - ), + serialized_options=b"\340A\002\372A%\022#datacatalog.googleapis.com/Taxonomy", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -285,7 +276,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ) ], @@ -357,15 +348,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A%\022#datacatalog.googleapis.com/Taxonomy" - ), + serialized_options=b"\340A\002\372A%\022#datacatalog.googleapis.com/Taxonomy", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -383,9 +372,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A%\n#datacatalog.googleapis.com/Taxonomy" - ), + serialized_options=b"\340A\002\372A%\n#datacatalog.googleapis.com/Taxonomy", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -504,10 +491,10 @@ SerializedTaxonomy = _reflection.GeneratedProtocolMessageType( "SerializedTaxonomy", (_message.Message,), - dict( - DESCRIPTOR=_SERIALIZEDTAXONOMY, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", - __doc__="""Message capturing a taxonomy and its policy tag hierarchy + { + "DESCRIPTOR": _SERIALIZEDTAXONOMY, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", + "__doc__": """Message capturing a taxonomy and its policy tag hierarchy as a nested proto. Used for taxonomy import/export and mutation. @@ -523,17 +510,17 @@ Top level policy tags associated with the taxonomy if any. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SerializedTaxonomy) - ), + }, ) _sym_db.RegisterMessage(SerializedTaxonomy) SerializedPolicyTag = _reflection.GeneratedProtocolMessageType( "SerializedPolicyTag", (_message.Message,), - dict( - DESCRIPTOR=_SERIALIZEDPOLICYTAG, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", - __doc__="""Message representing one policy tag when exported as a + { + "DESCRIPTOR": _SERIALIZEDPOLICYTAG, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", + "__doc__": """Message representing one policy tag when exported as a nested proto. @@ -549,17 +536,17 @@ Children of the policy tag if any. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SerializedPolicyTag) - ), + }, ) _sym_db.RegisterMessage(SerializedPolicyTag) ImportTaxonomiesRequest = _reflection.GeneratedProtocolMessageType( "ImportTaxonomiesRequest", (_message.Message,), - dict( - DESCRIPTOR=_IMPORTTAXONOMIESREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _IMPORTTAXONOMIESREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", + "__doc__": """Request message for [ImportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ImportTaxonomies]. @@ -574,17 +561,17 @@ Inline source used for taxonomies import """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ImportTaxonomiesRequest) - ), + }, ) _sym_db.RegisterMessage(ImportTaxonomiesRequest) InlineSource = _reflection.GeneratedProtocolMessageType( "InlineSource", (_message.Message,), - dict( - DESCRIPTOR=_INLINESOURCE, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", - __doc__="""Inline source used for taxonomies import. + { + "DESCRIPTOR": _INLINESOURCE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", + "__doc__": """Inline source used for taxonomies import. Attributes: @@ -592,17 +579,17 @@ Required. Taxonomies to be imported. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.InlineSource) - ), + }, ) _sym_db.RegisterMessage(InlineSource) ImportTaxonomiesResponse = _reflection.GeneratedProtocolMessageType( "ImportTaxonomiesResponse", (_message.Message,), - dict( - DESCRIPTOR=_IMPORTTAXONOMIESRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _IMPORTTAXONOMIESRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", + "__doc__": """Response message for [ImportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ImportTaxonomies]. @@ -611,17 +598,17 @@ Taxonomies that were imported. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ImportTaxonomiesResponse) - ), + }, ) _sym_db.RegisterMessage(ImportTaxonomiesResponse) ExportTaxonomiesRequest = _reflection.GeneratedProtocolMessageType( "ExportTaxonomiesRequest", (_message.Message,), - dict( - DESCRIPTOR=_EXPORTTAXONOMIESREQUEST, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _EXPORTTAXONOMIESREQUEST, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", + "__doc__": """Request message for [ExportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ExportTaxonomies]. @@ -637,17 +624,17 @@ Export taxonomies as serialized taxonomies. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ExportTaxonomiesRequest) - ), + }, ) _sym_db.RegisterMessage(ExportTaxonomiesRequest) ExportTaxonomiesResponse = _reflection.GeneratedProtocolMessageType( "ExportTaxonomiesResponse", (_message.Message,), - dict( - DESCRIPTOR=_EXPORTTAXONOMIESRESPONSE, - __module__="google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _EXPORTTAXONOMIESRESPONSE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.policytagmanagerserialization_pb2", + "__doc__": """Response message for [ExportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ExportTaxonomies]. @@ -656,7 +643,7 @@ List of taxonomies and policy tags in a tree structure. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ExportTaxonomiesResponse) - ), + }, ) _sym_db.RegisterMessage(ExportTaxonomiesResponse) @@ -674,9 +661,7 @@ full_name="google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" - ), + serialized_options=b"\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform", serialized_start=1283, serialized_end=1813, methods=[ @@ -687,9 +672,7 @@ containing_service=None, input_type=_IMPORTTAXONOMIESREQUEST, output_type=_IMPORTTAXONOMIESRESPONSE, - serialized_options=_b( - '\202\323\344\223\002?":/v1beta1/{parent=projects/*/locations/*}/taxonomies:import:\001*' - ), + serialized_options=b'\202\323\344\223\002?":/v1beta1/{parent=projects/*/locations/*}/taxonomies:import:\001*', ), _descriptor.MethodDescriptor( name="ExportTaxonomies", @@ -698,9 +681,7 @@ containing_service=None, input_type=_EXPORTTAXONOMIESREQUEST, output_type=_EXPORTTAXONOMIESRESPONSE, - serialized_options=_b( - "\202\323\344\223\002<\022:/v1beta1/{parent=projects/*/locations/*}/taxonomies:export" - ), + serialized_options=b"\202\323\344\223\002<\022:/v1beta1/{parent=projects/*/locations/*}/taxonomies:export", ), ], ) diff --git a/google/cloud/datacatalog_v1beta1/proto/schema_pb2.py b/google/cloud/datacatalog_v1beta1/proto/schema_pb2.py index 1c679bf0..61121e28 100644 --- a/google/cloud/datacatalog_v1beta1/proto/schema_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/schema_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/schema.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -22,12 +19,8 @@ name="google/cloud/datacatalog_v1beta1/proto/schema.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n3google/cloud/datacatalog_v1beta1/proto/schema.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto"N\n\x06Schema\x12\x44\n\x07\x63olumns\x18\x02 \x03(\x0b\x32..google.cloud.datacatalog.v1beta1.ColumnSchemaB\x03\xe0\x41\x02"\xac\x01\n\x0c\x43olumnSchema\x12\x13\n\x06\x63olumn\x18\x06 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\x04type\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x18\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x11\n\x04mode\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12G\n\nsubcolumns\x18\x07 \x03(\x0b\x32..google.cloud.datacatalog.v1beta1.ColumnSchemaB\x03\xe0\x41\x01\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b'\n3google/cloud/datacatalog_v1beta1/proto/schema.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto"N\n\x06Schema\x12\x44\n\x07\x63olumns\x18\x02 \x03(\x0b\x32..google.cloud.datacatalog.v1beta1.ColumnSchemaB\x03\xe0\x41\x02"\xac\x01\n\x0c\x43olumnSchema\x12\x13\n\x06\x63olumn\x18\x06 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\x04type\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x18\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x03\xe0\x41\x01\x12\x11\n\x04mode\x18\x03 \x01(\tB\x03\xe0\x41\x01\x12G\n\nsubcolumns\x18\x07 \x03(\x0b\x32..google.cloud.datacatalog.v1beta1.ColumnSchemaB\x03\xe0\x41\x01\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[google_dot_api_dot_field__behavior__pb2.DESCRIPTOR], ) @@ -54,7 +47,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ) ], @@ -87,13 +80,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -105,13 +98,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -123,13 +116,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -141,13 +134,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -165,7 +158,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\001"), + serialized_options=b"\340A\001", file=DESCRIPTOR, ), ], @@ -190,10 +183,10 @@ Schema = _reflection.GeneratedProtocolMessageType( "Schema", (_message.Message,), - dict( - DESCRIPTOR=_SCHEMA, - __module__="google.cloud.datacatalog_v1beta1.proto.schema_pb2", - __doc__="""Represents a schema (e.g. BigQuery, GoogleSQL, Avro + { + "DESCRIPTOR": _SCHEMA, + "__module__": "google.cloud.datacatalog_v1beta1.proto.schema_pb2", + "__doc__": """Represents a schema (e.g. BigQuery, GoogleSQL, Avro schema). @@ -203,17 +196,17 @@ sub-columns can be specified. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Schema) - ), + }, ) _sym_db.RegisterMessage(Schema) ColumnSchema = _reflection.GeneratedProtocolMessageType( "ColumnSchema", (_message.Message,), - dict( - DESCRIPTOR=_COLUMNSCHEMA, - __module__="google.cloud.datacatalog_v1beta1.proto.schema_pb2", - __doc__="""Representation of a column within a schema. Columns could + { + "DESCRIPTOR": _COLUMNSCHEMA, + "__module__": "google.cloud.datacatalog_v1beta1.proto.schema_pb2", + "__doc__": """Representation of a column within a schema. Columns could be nested inside other columns. @@ -226,7 +219,7 @@ Optional. Description of the column. Default value is an empty string. mode: - Optional. A column's mode indicates whether the values in this + Optional. A column’s mode indicates whether the values in this column are required, nullable, etc. Only ``NULLABLE``, ``REQUIRED`` and ``REPEATED`` are supported. Default mode is ``NULLABLE``. @@ -235,7 +228,7 @@ more sub-columns. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ColumnSchema) - ), + }, ) _sym_db.RegisterMessage(ColumnSchema) diff --git a/google/cloud/datacatalog_v1beta1/proto/search_pb2.py b/google/cloud/datacatalog_v1beta1/proto/search_pb2.py index f5cde2e1..84dddbde 100644 --- a/google/cloud/datacatalog_v1beta1/proto/search_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/search_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/search.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -27,12 +24,8 @@ name="google/cloud/datacatalog_v1beta1/proto/search.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n3google/cloud/datacatalog_v1beta1/proto/search.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xbd\x01\n\x13SearchCatalogResult\x12N\n\x12search_result_type\x18\x01 \x01(\x0e\x32\x32.google.cloud.datacatalog.v1beta1.SearchResultType\x12\x1d\n\x15search_result_subtype\x18\x02 \x01(\t\x12\x1e\n\x16relative_resource_name\x18\x03 \x01(\t\x12\x17\n\x0flinked_resource\x18\x04 \x01(\t*d\n\x10SearchResultType\x12"\n\x1eSEARCH_RESULT_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x45NTRY\x10\x01\x12\x10\n\x0cTAG_TEMPLATE\x10\x02\x12\x0f\n\x0b\x45NTRY_GROUP\x10\x03\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b'\n3google/cloud/datacatalog_v1beta1/proto/search.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xbd\x01\n\x13SearchCatalogResult\x12N\n\x12search_result_type\x18\x01 \x01(\x0e\x32\x32.google.cloud.datacatalog.v1beta1.SearchResultType\x12\x1d\n\x15search_result_subtype\x18\x02 \x01(\t\x12\x1e\n\x16relative_resource_name\x18\x03 \x01(\t\x12\x17\n\x0flinked_resource\x18\x04 \x01(\t*d\n\x10SearchResultType\x12"\n\x1eSEARCH_RESULT_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x45NTRY\x10\x01\x12\x10\n\x0cTAG_TEMPLATE\x10\x02\x12\x0f\n\x0b\x45NTRY_GROUP\x10\x03\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR, @@ -111,7 +104,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -129,7 +122,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -147,7 +140,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -177,10 +170,10 @@ SearchCatalogResult = _reflection.GeneratedProtocolMessageType( "SearchCatalogResult", (_message.Message,), - dict( - DESCRIPTOR=_SEARCHCATALOGRESULT, - __module__="google.cloud.datacatalog_v1beta1.proto.search_pb2", - __doc__="""A result that appears in the response of a search request. + { + "DESCRIPTOR": _SEARCHCATALOGRESULT, + "__module__": "google.cloud.datacatalog_v1beta1.proto.search_pb2", + "__doc__": """A result that appears in the response of a search request. Each result captures details of one entry that matches the search. @@ -190,8 +183,8 @@ which Get method to call to fetch the full resource. search_result_subtype: Sub-type of the search result. This is a dot-delimited - description of the resource's full type, and is the same as - the value callers would provide in the "type" search facet. + description of the resource’s full type, and is the same as + the value callers would provide in the “type” search facet. Examples: ``entry.table``, ``entry.dataStream``, ``tagTemplate``. relative_resource_name: @@ -201,12 +194,12 @@ ``projects/{project_id}/tagTemplates/{tag_template_id}`` linked_resource: The full name of the cloud resource the entry belongs to. See: - https://cloud.google.com/apis/design/resource\_names#full\_res - ource\_name. Example: - ``//bigquery.googleapis.com/projects - /projectId/datasets/datasetId/tables/tableId`` + https://cloud.google.com/apis/design/resource_names#full_resou + rce_name. Example: - ``//bigquery.googleapis.com/projects/pr + ojectId/datasets/datasetId/tables/tableId`` """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogResult) - ), + }, ) _sym_db.RegisterMessage(SearchCatalogResult) diff --git a/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2.py b/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2.py index 3d1467ce..eea644a3 100644 --- a/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/table_spec.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -24,12 +21,8 @@ name="google/cloud/datacatalog_v1beta1/proto/table_spec.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n7google/cloud/datacatalog_v1beta1/proto/table_spec.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto"\xf7\x01\n\x11\x42igQueryTableSpec\x12Q\n\x11table_source_type\x18\x01 \x01(\x0e\x32\x31.google.cloud.datacatalog.v1beta1.TableSourceTypeB\x03\xe0\x41\x03\x12?\n\tview_spec\x18\x02 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.ViewSpecH\x00\x12\x41\n\ntable_spec\x18\x03 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.TableSpecH\x00\x42\x0b\n\ttype_spec"#\n\x08ViewSpec\x12\x17\n\nview_query\x18\x01 \x01(\tB\x03\xe0\x41\x03"L\n\tTableSpec\x12?\n\rgrouped_entry\x18\x01 \x01(\tB(\xe0\x41\x03\xfa\x41"\n datacatalog.googleapis.com/Entry"\x89\x01\n\x17\x42igQueryDateShardedSpec\x12\x39\n\x07\x64\x61taset\x18\x01 \x01(\tB(\xe0\x41\x03\xfa\x41"\n datacatalog.googleapis.com/Entry\x12\x19\n\x0ctable_prefix\x18\x02 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0bshard_count\x18\x03 \x01(\x03\x42\x03\xe0\x41\x03*[\n\x0fTableSourceType\x12!\n\x1dTABLE_SOURCE_TYPE_UNSPECIFIED\x10\x00\x12\x11\n\rBIGQUERY_VIEW\x10\x02\x12\x12\n\x0e\x42IGQUERY_TABLE\x10\x05\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b'\n7google/cloud/datacatalog_v1beta1/proto/table_spec.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto"\xf7\x01\n\x11\x42igQueryTableSpec\x12Q\n\x11table_source_type\x18\x01 \x01(\x0e\x32\x31.google.cloud.datacatalog.v1beta1.TableSourceTypeB\x03\xe0\x41\x03\x12?\n\tview_spec\x18\x02 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.ViewSpecH\x00\x12\x41\n\ntable_spec\x18\x03 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.TableSpecH\x00\x42\x0b\n\ttype_spec"#\n\x08ViewSpec\x12\x17\n\nview_query\x18\x01 \x01(\tB\x03\xe0\x41\x03"L\n\tTableSpec\x12?\n\rgrouped_entry\x18\x01 \x01(\tB(\xe0\x41\x03\xfa\x41"\n datacatalog.googleapis.com/Entry"\x89\x01\n\x17\x42igQueryDateShardedSpec\x12\x39\n\x07\x64\x61taset\x18\x01 \x01(\tB(\xe0\x41\x03\xfa\x41"\n datacatalog.googleapis.com/Entry\x12\x19\n\x0ctable_prefix\x18\x02 \x01(\tB\x03\xe0\x41\x03\x12\x18\n\x0bshard_count\x18\x03 \x01(\x03\x42\x03\xe0\x41\x03*[\n\x0fTableSourceType\x12!\n\x1dTABLE_SOURCE_TYPE_UNSPECIFIED\x10\x00\x12\x11\n\rBIGQUERY_VIEW\x10\x02\x12\x12\n\x0e\x42IGQUERY_TABLE\x10\x05\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, @@ -91,7 +84,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -168,13 +161,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ) ], @@ -207,13 +200,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b('\340A\003\372A"\n datacatalog.googleapis.com/Entry'), + serialized_options=b'\340A\003\372A"\n datacatalog.googleapis.com/Entry', file=DESCRIPTOR, ) ], @@ -246,13 +239,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b('\340A\003\372A"\n datacatalog.googleapis.com/Entry'), + serialized_options=b'\340A\003\372A"\n datacatalog.googleapis.com/Entry', file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -264,13 +257,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -288,7 +281,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], @@ -329,10 +322,10 @@ BigQueryTableSpec = _reflection.GeneratedProtocolMessageType( "BigQueryTableSpec", (_message.Message,), - dict( - DESCRIPTOR=_BIGQUERYTABLESPEC, - __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", - __doc__="""Describes a BigQuery table. + { + "DESCRIPTOR": _BIGQUERYTABLESPEC, + "__module__": "google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", + "__doc__": """Describes a BigQuery table. Attributes: @@ -348,17 +341,17 @@ if ``table_source_type`` is ``BIGQUERY_TABLE``. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.BigQueryTableSpec) - ), + }, ) _sym_db.RegisterMessage(BigQueryTableSpec) ViewSpec = _reflection.GeneratedProtocolMessageType( "ViewSpec", (_message.Message,), - dict( - DESCRIPTOR=_VIEWSPEC, - __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", - __doc__="""Table view specification. + { + "DESCRIPTOR": _VIEWSPEC, + "__module__": "google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", + "__doc__": """Table view specification. Attributes: @@ -366,17 +359,17 @@ Output only. The query that defines the table view. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ViewSpec) - ), + }, ) _sym_db.RegisterMessage(ViewSpec) TableSpec = _reflection.GeneratedProtocolMessageType( "TableSpec", (_message.Message,), - dict( - DESCRIPTOR=_TABLESPEC, - __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", - __doc__="""Normal BigQuery table spec. + { + "DESCRIPTOR": _TABLESPEC, + "__module__": "google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", + "__doc__": """Normal BigQuery table spec. Attributes: @@ -389,19 +382,19 @@ ``grouped_entry`` is empty. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TableSpec) - ), + }, ) _sym_db.RegisterMessage(TableSpec) BigQueryDateShardedSpec = _reflection.GeneratedProtocolMessageType( "BigQueryDateShardedSpec", (_message.Message,), - dict( - DESCRIPTOR=_BIGQUERYDATESHARDEDSPEC, - __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", - __doc__="""Spec for a group of BigQuery tables with name pattern + { + "DESCRIPTOR": _BIGQUERYDATESHARDEDSPEC, + "__module__": "google.cloud.datacatalog_v1beta1.proto.table_spec_pb2", + "__doc__": """Spec for a group of BigQuery tables with name pattern ``[prefix]YYYYMMDD``. Context: - https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning\_versus\_sharding + https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding Attributes: @@ -419,7 +412,7 @@ Output only. Total number of shards. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpec) - ), + }, ) _sym_db.RegisterMessage(BigQueryDateShardedSpec) diff --git a/google/cloud/datacatalog_v1beta1/proto/tags_pb2.py b/google/cloud/datacatalog_v1beta1/proto/tags_pb2.py index 4bb2509a..f9d484e6 100644 --- a/google/cloud/datacatalog_v1beta1/proto/tags_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/tags_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/tags.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -24,12 +21,8 @@ name="google/cloud/datacatalog_v1beta1/proto/tags.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n1google/cloud/datacatalog_v1beta1/proto/tags.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x90\x03\n\x03Tag\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x15\n\x08template\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12"\n\x15template_display_name\x18\x05 \x01(\tB\x03\xe0\x41\x03\x12\x10\n\x06\x63olumn\x18\x04 \x01(\tH\x00\x12\x46\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x31.google.cloud.datacatalog.v1beta1.Tag.FieldsEntryB\x03\xe0\x41\x02\x1aY\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x39\n\x05value\x18\x02 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.TagField:\x02\x38\x01:\x81\x01\xea\x41~\n\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\\projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}B\x07\n\x05scope"\x99\x02\n\x08TagField\x12\x19\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x16\n\x0c\x64ouble_value\x18\x02 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x03 \x01(\tH\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\x0ftimestamp_value\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12J\n\nenum_value\x18\x06 \x01(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.TagField.EnumValueH\x00\x1a!\n\tEnumValue\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x06\n\x04kind"\xd6\x02\n\x0bTagTemplate\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12N\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x39.google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntryB\x03\xe0\x41\x02\x1a\x61\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x41\n\x05value\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateField:\x02\x38\x01:p\xea\x41m\n&datacatalog.googleapis.com/TagTemplate\x12\x43projects/{project}/locations/{location}/tagTemplates/{tag_template}"\x98\x02\n\x10TagTemplateField\x12\x11\n\x04name\x18\x06 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12>\n\x04type\x18\x02 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.FieldTypeB\x03\xe0\x41\x02\x12\x13\n\x0bis_required\x18\x03 \x01(\x08:\x85\x01\xea\x41\x81\x01\n+datacatalog.googleapis.com/TagTemplateField\x12Rprojects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}"\xa7\x03\n\tFieldType\x12S\n\x0eprimitive_type\x18\x01 \x01(\x0e\x32\x39.google.cloud.datacatalog.v1beta1.FieldType.PrimitiveTypeH\x00\x12I\n\tenum_type\x18\x02 \x01(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.FieldType.EnumTypeH\x00\x1a\x8a\x01\n\x08\x45numType\x12V\n\x0e\x61llowed_values\x18\x01 \x03(\x0b\x32>.google.cloud.datacatalog.v1beta1.FieldType.EnumType.EnumValue\x1a&\n\tEnumValue\x12\x19\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x03\xe0\x41\x02"`\n\rPrimitiveType\x12\x1e\n\x1aPRIMITIVE_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06\x44OUBLE\x10\x01\x12\n\n\x06STRING\x10\x02\x12\x08\n\x04\x42OOL\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x42\x0b\n\ttype_declBx\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b'\n1google/cloud/datacatalog_v1beta1/proto/tags.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x90\x03\n\x03Tag\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x15\n\x08template\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12"\n\x15template_display_name\x18\x05 \x01(\tB\x03\xe0\x41\x03\x12\x10\n\x06\x63olumn\x18\x04 \x01(\tH\x00\x12\x46\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x31.google.cloud.datacatalog.v1beta1.Tag.FieldsEntryB\x03\xe0\x41\x02\x1aY\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x39\n\x05value\x18\x02 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.TagField:\x02\x38\x01:\x81\x01\xea\x41~\n\x1e\x64\x61tacatalog.googleapis.com/Tag\x12\\projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}B\x07\n\x05scope"\x99\x02\n\x08TagField\x12\x19\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12\x16\n\x0c\x64ouble_value\x18\x02 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x03 \x01(\tH\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\x0ftimestamp_value\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12J\n\nenum_value\x18\x06 \x01(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.TagField.EnumValueH\x00\x1a!\n\tEnumValue\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x06\n\x04kind"\xd6\x02\n\x0bTagTemplate\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12N\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x39.google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntryB\x03\xe0\x41\x02\x1a\x61\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x41\n\x05value\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateField:\x02\x38\x01:p\xea\x41m\n&datacatalog.googleapis.com/TagTemplate\x12\x43projects/{project}/locations/{location}/tagTemplates/{tag_template}"\x98\x02\n\x10TagTemplateField\x12\x11\n\x04name\x18\x06 \x01(\tB\x03\xe0\x41\x03\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12>\n\x04type\x18\x02 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.FieldTypeB\x03\xe0\x41\x02\x12\x13\n\x0bis_required\x18\x03 \x01(\x08:\x85\x01\xea\x41\x81\x01\n+datacatalog.googleapis.com/TagTemplateField\x12Rprojects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}"\xa7\x03\n\tFieldType\x12S\n\x0eprimitive_type\x18\x01 \x01(\x0e\x32\x39.google.cloud.datacatalog.v1beta1.FieldType.PrimitiveTypeH\x00\x12I\n\tenum_type\x18\x02 \x01(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.FieldType.EnumTypeH\x00\x1a\x8a\x01\n\x08\x45numType\x12V\n\x0e\x61llowed_values\x18\x01 \x03(\x0b\x32>.google.cloud.datacatalog.v1beta1.FieldType.EnumType.EnumValue\x1a&\n\tEnumValue\x12\x19\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x03\xe0\x41\x02"`\n\rPrimitiveType\x12\x1e\n\x1aPRIMITIVE_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06\x44OUBLE\x10\x01\x12\n\n\x06STRING\x10\x02\x12\x08\n\x04\x42OOL\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x42\x0b\n\ttype_declBx\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, @@ -88,7 +81,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -119,7 +112,7 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -144,7 +137,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -162,13 +155,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -180,13 +173,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -198,7 +191,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -222,16 +215,14 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], extensions=[], nested_types=[_TAG_FIELDSENTRY], enum_types=[], - serialized_options=_b( - "\352A~\n\036datacatalog.googleapis.com/Tag\022\\projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}" - ), + serialized_options=b"\352A~\n\036datacatalog.googleapis.com/Tag\022\\projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -265,7 +256,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -303,13 +294,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -339,7 +330,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -440,7 +431,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -471,7 +462,7 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -496,7 +487,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -514,7 +505,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -538,16 +529,14 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], extensions=[], nested_types=[_TAGTEMPLATE_FIELDSENTRY], enum_types=[], - serialized_options=_b( - "\352Am\n&datacatalog.googleapis.com/TagTemplate\022Cprojects/{project}/locations/{location}/tagTemplates/{tag_template}" - ), + serialized_options=b"\352Am\n&datacatalog.googleapis.com/TagTemplate\022Cprojects/{project}/locations/{location}/tagTemplates/{tag_template}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -573,13 +562,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -591,7 +580,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -615,7 +604,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -640,9 +629,7 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=_b( - "\352A\201\001\n+datacatalog.googleapis.com/TagTemplateField\022Rprojects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}" - ), + serialized_options=b"\352A\201\001\n+datacatalog.googleapis.com/TagTemplateField\022Rprojects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -668,13 +655,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ) ], @@ -858,19 +845,19 @@ Tag = _reflection.GeneratedProtocolMessageType( "Tag", (_message.Message,), - dict( - FieldsEntry=_reflection.GeneratedProtocolMessageType( + { + "FieldsEntry": _reflection.GeneratedProtocolMessageType( "FieldsEntry", (_message.Message,), - dict( - DESCRIPTOR=_TAG_FIELDSENTRY, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2" + { + "DESCRIPTOR": _TAG_FIELDSENTRY, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2" # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Tag.FieldsEntry) - ), + }, ), - DESCRIPTOR=_TAG, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__="""Tags are used to attach custom metadata to Data Catalog + "DESCRIPTOR": _TAG, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """Tags are used to attach custom metadata to Data Catalog resources. Tags conform to the specifications within their tag template. See `Data Catalog IAM `__ for @@ -880,15 +867,15 @@ Attributes: name: The resource name of the tag in URL format. Example: - proje - cts/{project\_id}/locations/{location}/entrygroups/{entry\_gro - up\_id}/entries/{entry\_id}/tags/{tag\_id} where ``tag_id`` - is a system-generated identifier. Note that this Tag may not + cts/{project_id}/locations/{location}/entrygroups/{entry_group + _id}/entries/{entry_id}/tags/{tag_id} where ``tag_id`` is a + system-generated identifier. Note that this Tag may not actually be stored in the location in this name. template: Required. The resource name of the tag template that this tag - uses. Example: - projects/{project\_id}/locations/{location} - /tagTemplates/{tag\_template\_id} This field cannot be - modified after creation. + uses. Example: - projects/{project_id}/locations/{location}/ + tagTemplates/{tag_template_id} This field cannot be modified + after creation. template_display_name: Output only. The display name of the tag template. scope: @@ -906,11 +893,11 @@ fields: Required. This maps the ID of a tag field to the value of and additional information about that field. Valid field IDs are - defined by the tag's template. A tag must have at least 1 + defined by the tag’s template. A tag must have at least 1 field and at most 500 fields. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Tag) - ), + }, ) _sym_db.RegisterMessage(Tag) _sym_db.RegisterMessage(Tag.FieldsEntry) @@ -918,14 +905,14 @@ TagField = _reflection.GeneratedProtocolMessageType( "TagField", (_message.Message,), - dict( - EnumValue=_reflection.GeneratedProtocolMessageType( + { + "EnumValue": _reflection.GeneratedProtocolMessageType( "EnumValue", (_message.Message,), - dict( - DESCRIPTOR=_TAGFIELD_ENUMVALUE, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__="""Holds an enum value. + { + "DESCRIPTOR": _TAGFIELD_ENUMVALUE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """Holds an enum value. Attributes: @@ -933,11 +920,11 @@ The display name of the enum value. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagField.EnumValue) - ), + }, ), - DESCRIPTOR=_TAGFIELD, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__="""Contains the value and supporting information for a field + "DESCRIPTOR": _TAGFIELD, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """Contains the value and supporting information for a field within a [Tag][google.cloud.datacatalog.v1beta1.Tag]. @@ -960,7 +947,7 @@ enum. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagField) - ), + }, ) _sym_db.RegisterMessage(TagField) _sym_db.RegisterMessage(TagField.EnumValue) @@ -968,19 +955,19 @@ TagTemplate = _reflection.GeneratedProtocolMessageType( "TagTemplate", (_message.Message,), - dict( - FieldsEntry=_reflection.GeneratedProtocolMessageType( + { + "FieldsEntry": _reflection.GeneratedProtocolMessageType( "FieldsEntry", (_message.Message,), - dict( - DESCRIPTOR=_TAGTEMPLATE_FIELDSENTRY, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2" + { + "DESCRIPTOR": _TAGTEMPLATE_FIELDSENTRY, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2" # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntry) - ), + }, ), - DESCRIPTOR=_TAGTEMPLATE, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__="""A tag template defines a tag, which can have one or more + "DESCRIPTOR": _TAGTEMPLATE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """A tag template defines a tag, which can have one or more typed fields. The template is used to create and attach the tag to GCP resources. `Tag template roles `__ provide @@ -992,8 +979,8 @@ Attributes: name: The resource name of the tag template in URL format. Example: - - projects/{project\_id}/locations/{location}/tagTemplates/{t - ag\_template\_id} Note that this TagTemplate and its child + - projects/{project_id}/locations/{location}/tagTemplates/{ta + g_template_id} Note that this TagTemplate and its child resources may not actually be stored in the location in this name. display_name: @@ -1005,12 +992,12 @@ fields. This map must contain at least one field and at most 500 fields. The keys to this map are tag template field IDs. Field IDs can contain letters (both uppercase and lowercase), - numbers (0-9) and underscores (\_). Field IDs must be at least + numbers (0-9) and underscores (_). Field IDs must be at least 1 character long and at most 64 characters long. Field IDs must start with a letter or underscore. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagTemplate) - ), + }, ) _sym_db.RegisterMessage(TagTemplate) _sym_db.RegisterMessage(TagTemplate.FieldsEntry) @@ -1018,18 +1005,18 @@ TagTemplateField = _reflection.GeneratedProtocolMessageType( "TagTemplateField", (_message.Message,), - dict( - DESCRIPTOR=_TAGTEMPLATEFIELD, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__="""The template for an individual field within a tag + { + "DESCRIPTOR": _TAGTEMPLATEFIELD, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """The template for an individual field within a tag template. Attributes: name: Output only. The resource name of the tag template field in - URL format. Example: - projects/{project\_id}/locations/{loc - ation}/tagTemplates/{tag\_template}/fields/{field} Note that + URL format. Example: - projects/{project_id}/locations/{loca + tion}/tagTemplates/{tag_template}/fields/{field} Note that this TagTemplateField may not actually be stored in the location in this name. display_name: @@ -1040,36 +1027,36 @@ Whether this is a required field. Defaults to false. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagTemplateField) - ), + }, ) _sym_db.RegisterMessage(TagTemplateField) FieldType = _reflection.GeneratedProtocolMessageType( "FieldType", (_message.Message,), - dict( - EnumType=_reflection.GeneratedProtocolMessageType( + { + "EnumType": _reflection.GeneratedProtocolMessageType( "EnumType", (_message.Message,), - dict( - EnumValue=_reflection.GeneratedProtocolMessageType( + { + "EnumValue": _reflection.GeneratedProtocolMessageType( "EnumValue", (_message.Message,), - dict( - DESCRIPTOR=_FIELDTYPE_ENUMTYPE_ENUMVALUE, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__=""" + { + "DESCRIPTOR": _FIELDTYPE_ENUMTYPE_ENUMVALUE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """ Attributes: display_name: Required. The display name of the enum value. Must not be an empty string. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.FieldType.EnumType.EnumValue) - ), + }, ), - DESCRIPTOR=_FIELDTYPE_ENUMTYPE, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__=""" + "DESCRIPTOR": _FIELDTYPE_ENUMTYPE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """ Attributes: allowed_values: Required on create; optional on update. The set of allowed @@ -1081,11 +1068,11 @@ values are not supported. Can have up to 500 allowed values. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.FieldType.EnumType) - ), + }, ), - DESCRIPTOR=_FIELDTYPE, - __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2", - __doc__=""" + "DESCRIPTOR": _FIELDTYPE, + "__module__": "google.cloud.datacatalog_v1beta1.proto.tags_pb2", + "__doc__": """ Attributes: type_decl: Required. @@ -1095,7 +1082,7 @@ Represents an enum type. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.FieldType) - ), + }, ) _sym_db.RegisterMessage(FieldType) _sym_db.RegisterMessage(FieldType.EnumType) diff --git a/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py b/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py index 873b2035..9957a0ff 100644 --- a/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/datacatalog_v1beta1/proto/timestamps.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -23,12 +20,8 @@ name="google/cloud/datacatalog_v1beta1/proto/timestamps.proto", package="google.cloud.datacatalog.v1beta1", syntax="proto3", - serialized_options=_b( - "\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001" - ), - serialized_pb=_b( - '\n7google/cloud/datacatalog_v1beta1/proto/timestamps.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xaa\x01\n\x10SystemTimestamps\x12/\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3' - ), + serialized_options=b"\n$com.google.cloud.datacatalog.v1beta1P\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001", + serialized_pb=b'\n7google/cloud/datacatalog_v1beta1/proto/timestamps.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xaa\x01\n\x10SystemTimestamps\x12/\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x42x\n$com.google.cloud.datacatalog.v1beta1P\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, @@ -94,7 +87,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], @@ -125,11 +118,10 @@ SystemTimestamps = _reflection.GeneratedProtocolMessageType( "SystemTimestamps", (_message.Message,), - dict( - DESCRIPTOR=_SYSTEMTIMESTAMPS, - __module__="google.cloud.datacatalog_v1beta1.proto.timestamps_pb2", - __doc__="""Timestamps about this resource according to a particular - system. + { + "DESCRIPTOR": _SYSTEMTIMESTAMPS, + "__module__": "google.cloud.datacatalog_v1beta1.proto.timestamps_pb2", + "__doc__": """Timestamps about this resource according to a particular system. Attributes: @@ -143,7 +135,7 @@ given system. Currently only apllicable to BigQuery resources. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SystemTimestamps) - ), + }, ) _sym_db.RegisterMessage(SystemTimestamps) diff --git a/synth.metadata b/synth.metadata index 1acc7732..5e89896a 100644 --- a/synth.metadata +++ b/synth.metadata @@ -1,20 +1,19 @@ { - "updateTime": "2020-02-25T13:14:24.965186Z", + "updateTime": "2020-03-27T17:42:23.096126Z", "sources": [ { - "generator": { - "name": "artman", - "version": "0.45.1", - "dockerImage": "googleapis/artman@sha256:36956ca6a4dc70a59de5d5d0fd35061b050bb56884516f0898f46d8220f25738" + "git": { + "name": ".", + "remote": "git@github.com:googleapis/python-datacatalog", + "sha": "9323589a08498263831913cdf4b8dfac0689f476" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "0b1876b35e98f560f9c9ca9797955f020238a092", - "internalRef": "296986742", - "log": "0b1876b35e98f560f9c9ca9797955f020238a092\nUse an older version of protoc-docs-plugin that is compatible with the specified gapic-generator and protobuf versions.\n\nprotoc-docs-plugin >=0.4.0 (see commit https://github.com/googleapis/protoc-docs-plugin/commit/979f03ede6678c487337f3d7e88bae58df5207af) is incompatible with protobuf 3.9.1.\n\nPiperOrigin-RevId: 296986742\n\n1e47e676cddbbd8d93f19ba0665af15b5532417e\nFix: Restore a method signature for UpdateCluster\n\nPiperOrigin-RevId: 296901854\n\n" + "sha": "48a166ce9f6e2a88b10947341b37336fe9dd3478", + "internalRef": "303302813" } }, { @@ -26,14 +25,22 @@ } ], "destinations": [ + { + "client": { + "source": "googleapis", + "apiName": "datacatalog", + "apiVersion": "v1", + "language": "python", + "generator": "bazel" + } + }, { "client": { "source": "googleapis", "apiName": "datacatalog", "apiVersion": "v1beta1", "language": "python", - "generator": "gapic", - "config": "google/cloud/datacatalog/v1beta1/artman_datacatalog_v1beta1.yaml" + "generator": "bazel" } } ] diff --git a/synth.py b/synth.py index 21c504f0..2949d4e9 100644 --- a/synth.py +++ b/synth.py @@ -17,40 +17,37 @@ import synthtool as s from synthtool import gcp -gapic = gcp.GAPICGenerator() +gapic = gcp.GAPICBazel() common = gcp.CommonTemplates() -version = 'v1beta1' + # ---------------------------------------------------------------------------- # Generate datacatalog GAPIC layer # ---------------------------------------------------------------------------- -library = gapic.py_library( - 'datacatalog', - version, - config_path='/google/cloud/datacatalog/v1beta1/artman_datacatalog_v1beta1.yaml', - artman_output_name='datacatalog-v1beta1', - include_protos=True, - generator_args=["--dev_samples"], -) - -s.move( - library, - excludes=[ - 'docs/conf.py', - 'docs/index.rst', - 'google/cloud/datacatalog_v1beta1/__init__.py', - 'README.rst', - 'nox*.py', - 'setup.py', - 'setup.cfg', - ], -) +versions = ['v1', 'v1beta1'] +for version in versions: + library = gapic.py_library( + 'datacatalog', + version, + ) + + s.move( + library, + excludes=[ + 'docs/conf.py', + 'docs/index.rst', + 'README.rst', + 'nox*.py', + 'setup.py', + 'setup.cfg', + ], + ) # Fix docstring issue for classes with no summary line s.replace( "google/cloud/**/proto/*_pb2.py", - '''__doc__ = """Attributes:''', - '''__doc__ = """ + ''''__doc__': """Attributes:''', + '''"__doc__": """ Attributes:''', ) diff --git a/tests/unit/gapic/v1/test_data_catalog_client_v1.py b/tests/unit/gapic/v1/test_data_catalog_client_v1.py new file mode 100644 index 00000000..6d36cdcd --- /dev/null +++ b/tests/unit/gapic/v1/test_data_catalog_client_v1.py @@ -0,0 +1,1268 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + +"""Unit tests.""" + +import mock +import pytest + +from google.cloud import datacatalog_v1 +from google.cloud.datacatalog_v1.proto import datacatalog_pb2 +from google.cloud.datacatalog_v1.proto import search_pb2 +from google.cloud.datacatalog_v1.proto import tags_pb2 +from google.iam.v1 import iam_policy_pb2 +from google.iam.v1 import policy_pb2 +from google.protobuf import empty_pb2 + + +class MultiCallableStub(object): + """Stub for the grpc.UnaryUnaryMultiCallable interface.""" + + def __init__(self, method, channel_stub): + self.method = method + self.channel_stub = channel_stub + + def __call__(self, request, timeout=None, metadata=None, credentials=None): + self.channel_stub.requests.append((self.method, request)) + + response = None + if self.channel_stub.responses: + response = self.channel_stub.responses.pop() + + if isinstance(response, Exception): + raise response + + if response: + return response + + +class ChannelStub(object): + """Stub for the grpc.Channel interface.""" + + def __init__(self, responses=[]): + self.responses = responses + self.requests = [] + + def unary_unary(self, method, request_serializer=None, response_deserializer=None): + return MultiCallableStub(method, self) + + +class CustomException(Exception): + pass + + +class TestDataCatalogClient(object): + def test_search_catalog(self): + # Setup Expected Response + next_page_token = "" + results_element = {} + results = [results_element] + expected_response = {"next_page_token": next_page_token, "results": results} + expected_response = datacatalog_pb2.SearchCatalogResponse(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + scope = {} + query = "query107944136" + + paged_list_response = client.search_catalog(scope, query) + resources = list(paged_list_response) + assert len(resources) == 1 + + assert expected_response.results[0] == resources[0] + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.SearchCatalogRequest( + scope=scope, query=query + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_search_catalog_exception(self): + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + scope = {} + query = "query107944136" + + paged_list_response = client.search_catalog(scope, query) + with pytest.raises(CustomException): + list(paged_list_response) + + def test_create_entry_group(self): + # Setup Expected Response + name = "name3373707" + display_name = "displayName1615086568" + description = "description-1724546052" + expected_response = { + "name": name, + "display_name": display_name, + "description": description, + } + expected_response = datacatalog_pb2.EntryGroup(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.location_path("[PROJECT]", "[LOCATION]") + entry_group_id = "entryGroupId-43122680" + + response = client.create_entry_group(parent, entry_group_id) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.CreateEntryGroupRequest( + parent=parent, entry_group_id=entry_group_id + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_create_entry_group_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.location_path("[PROJECT]", "[LOCATION]") + entry_group_id = "entryGroupId-43122680" + + with pytest.raises(CustomException): + client.create_entry_group(parent, entry_group_id) + + def test_get_entry_group(self): + # Setup Expected Response + name_2 = "name2-1052831874" + display_name = "displayName1615086568" + description = "description-1724546052" + expected_response = { + "name": name_2, + "display_name": display_name, + "description": description, + } + expected_response = datacatalog_pb2.EntryGroup(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + response = client.get_entry_group(name) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.GetEntryGroupRequest(name=name) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_get_entry_group_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + with pytest.raises(CustomException): + client.get_entry_group(name) + + def test_update_entry_group(self): + # Setup Expected Response + name = "name3373707" + display_name = "displayName1615086568" + description = "description-1724546052" + expected_response = { + "name": name, + "display_name": display_name, + "description": description, + } + expected_response = datacatalog_pb2.EntryGroup(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + entry_group = {} + + response = client.update_entry_group(entry_group) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.UpdateEntryGroupRequest( + entry_group=entry_group + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_update_entry_group_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + entry_group = {} + + with pytest.raises(CustomException): + client.update_entry_group(entry_group) + + def test_delete_entry_group(self): + channel = ChannelStub() + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + client.delete_entry_group(name) + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.DeleteEntryGroupRequest(name=name) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_delete_entry_group_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + with pytest.raises(CustomException): + client.delete_entry_group(name) + + def test_list_entry_groups(self): + # Setup Expected Response + next_page_token = "" + entry_groups_element = {} + entry_groups = [entry_groups_element] + expected_response = { + "next_page_token": next_page_token, + "entry_groups": entry_groups, + } + expected_response = datacatalog_pb2.ListEntryGroupsResponse(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + paged_list_response = client.list_entry_groups(parent) + resources = list(paged_list_response) + assert len(resources) == 1 + + assert expected_response.entry_groups[0] == resources[0] + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.ListEntryGroupsRequest(parent=parent) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_list_entry_groups_exception(self): + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + paged_list_response = client.list_entry_groups(parent) + with pytest.raises(CustomException): + list(paged_list_response) + + def test_create_entry(self): + # Setup Expected Response + name = "name3373707" + linked_resource = "linkedResource1544625012" + user_specified_type = "userSpecifiedType-940364963" + user_specified_system = "userSpecifiedSystem-1776119406" + display_name = "displayName1615086568" + description = "description-1724546052" + expected_response = { + "name": name, + "linked_resource": linked_resource, + "user_specified_type": user_specified_type, + "user_specified_system": user_specified_system, + "display_name": display_name, + "description": description, + } + expected_response = datacatalog_pb2.Entry(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + entry_id = "entryId-2093663224" + entry = {} + + response = client.create_entry(parent, entry_id, entry) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.CreateEntryRequest( + parent=parent, entry_id=entry_id, entry=entry + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_create_entry_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + entry_id = "entryId-2093663224" + entry = {} + + with pytest.raises(CustomException): + client.create_entry(parent, entry_id, entry) + + def test_update_entry(self): + # Setup Expected Response + name = "name3373707" + linked_resource = "linkedResource1544625012" + user_specified_type = "userSpecifiedType-940364963" + user_specified_system = "userSpecifiedSystem-1776119406" + display_name = "displayName1615086568" + description = "description-1724546052" + expected_response = { + "name": name, + "linked_resource": linked_resource, + "user_specified_type": user_specified_type, + "user_specified_system": user_specified_system, + "display_name": display_name, + "description": description, + } + expected_response = datacatalog_pb2.Entry(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + entry = {} + + response = client.update_entry(entry) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.UpdateEntryRequest(entry=entry) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_update_entry_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + entry = {} + + with pytest.raises(CustomException): + client.update_entry(entry) + + def test_delete_entry(self): + channel = ChannelStub() + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]") + + client.delete_entry(name) + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.DeleteEntryRequest(name=name) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_delete_entry_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]") + + with pytest.raises(CustomException): + client.delete_entry(name) + + def test_get_entry(self): + # Setup Expected Response + name_2 = "name2-1052831874" + linked_resource = "linkedResource1544625012" + user_specified_type = "userSpecifiedType-940364963" + user_specified_system = "userSpecifiedSystem-1776119406" + display_name = "displayName1615086568" + description = "description-1724546052" + expected_response = { + "name": name_2, + "linked_resource": linked_resource, + "user_specified_type": user_specified_type, + "user_specified_system": user_specified_system, + "display_name": display_name, + "description": description, + } + expected_response = datacatalog_pb2.Entry(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]") + + response = client.get_entry(name) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.GetEntryRequest(name=name) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_get_entry_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]") + + with pytest.raises(CustomException): + client.get_entry(name) + + def test_lookup_entry(self): + # Setup Expected Response + name = "name3373707" + linked_resource = "linkedResource1544625012" + user_specified_type = "userSpecifiedType-940364963" + user_specified_system = "userSpecifiedSystem-1776119406" + display_name = "displayName1615086568" + description = "description-1724546052" + expected_response = { + "name": name, + "linked_resource": linked_resource, + "user_specified_type": user_specified_type, + "user_specified_system": user_specified_system, + "display_name": display_name, + "description": description, + } + expected_response = datacatalog_pb2.Entry(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + response = client.lookup_entry() + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.LookupEntryRequest() + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_lookup_entry_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + with pytest.raises(CustomException): + client.lookup_entry() + + def test_list_entries(self): + # Setup Expected Response + next_page_token = "" + entries_element = {} + entries = [entries_element] + expected_response = {"next_page_token": next_page_token, "entries": entries} + expected_response = datacatalog_pb2.ListEntriesResponse(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + paged_list_response = client.list_entries(parent) + resources = list(paged_list_response) + assert len(resources) == 1 + + assert expected_response.entries[0] == resources[0] + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.ListEntriesRequest(parent=parent) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_list_entries_exception(self): + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.entry_group_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]") + + paged_list_response = client.list_entries(parent) + with pytest.raises(CustomException): + list(paged_list_response) + + def test_create_tag_template(self): + # Setup Expected Response + name = "name3373707" + display_name = "displayName1615086568" + expected_response = {"name": name, "display_name": display_name} + expected_response = tags_pb2.TagTemplate(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.location_path("[PROJECT]", "[LOCATION]") + tag_template_id = "tagTemplateId-2020335141" + tag_template = {} + + response = client.create_tag_template(parent, tag_template_id, tag_template) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.CreateTagTemplateRequest( + parent=parent, tag_template_id=tag_template_id, tag_template=tag_template + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_create_tag_template_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.location_path("[PROJECT]", "[LOCATION]") + tag_template_id = "tagTemplateId-2020335141" + tag_template = {} + + with pytest.raises(CustomException): + client.create_tag_template(parent, tag_template_id, tag_template) + + def test_get_tag_template(self): + # Setup Expected Response + name_2 = "name2-1052831874" + display_name = "displayName1615086568" + expected_response = {"name": name_2, "display_name": display_name} + expected_response = tags_pb2.TagTemplate(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]") + + response = client.get_tag_template(name) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.GetTagTemplateRequest(name=name) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_get_tag_template_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]") + + with pytest.raises(CustomException): + client.get_tag_template(name) + + def test_update_tag_template(self): + # Setup Expected Response + name = "name3373707" + display_name = "displayName1615086568" + expected_response = {"name": name, "display_name": display_name} + expected_response = tags_pb2.TagTemplate(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + tag_template = {} + + response = client.update_tag_template(tag_template) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.UpdateTagTemplateRequest( + tag_template=tag_template + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_update_tag_template_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + tag_template = {} + + with pytest.raises(CustomException): + client.update_tag_template(tag_template) + + def test_delete_tag_template(self): + channel = ChannelStub() + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]") + force = False + + client.delete_tag_template(name, force) + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.DeleteTagTemplateRequest( + name=name, force=force + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_delete_tag_template_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]") + force = False + + with pytest.raises(CustomException): + client.delete_tag_template(name, force) + + def test_create_tag_template_field(self): + # Setup Expected Response + name = "name3373707" + display_name = "displayName1615086568" + is_required = True + order = 106006350 + expected_response = { + "name": name, + "display_name": display_name, + "is_required": is_required, + "order": order, + } + expected_response = tags_pb2.TagTemplateField(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]") + tag_template_field_id = "tagTemplateFieldId-92144832" + tag_template_field = {} + + response = client.create_tag_template_field( + parent, tag_template_field_id, tag_template_field + ) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.CreateTagTemplateFieldRequest( + parent=parent, + tag_template_field_id=tag_template_field_id, + tag_template_field=tag_template_field, + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_create_tag_template_field_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]") + tag_template_field_id = "tagTemplateFieldId-92144832" + tag_template_field = {} + + with pytest.raises(CustomException): + client.create_tag_template_field( + parent, tag_template_field_id, tag_template_field + ) + + def test_update_tag_template_field(self): + # Setup Expected Response + name_2 = "name2-1052831874" + display_name = "displayName1615086568" + is_required = True + order = 106006350 + expected_response = { + "name": name_2, + "display_name": display_name, + "is_required": is_required, + "order": order, + } + expected_response = tags_pb2.TagTemplateField(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.tag_template_field_path( + "[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]" + ) + tag_template_field = {} + + response = client.update_tag_template_field(name, tag_template_field) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.UpdateTagTemplateFieldRequest( + name=name, tag_template_field=tag_template_field + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_update_tag_template_field_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.tag_template_field_path( + "[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]" + ) + tag_template_field = {} + + with pytest.raises(CustomException): + client.update_tag_template_field(name, tag_template_field) + + def test_rename_tag_template_field(self): + # Setup Expected Response + name_2 = "name2-1052831874" + display_name = "displayName1615086568" + is_required = True + order = 106006350 + expected_response = { + "name": name_2, + "display_name": display_name, + "is_required": is_required, + "order": order, + } + expected_response = tags_pb2.TagTemplateField(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.tag_template_field_path( + "[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]" + ) + new_tag_template_field_id = "newTagTemplateFieldId-1668354591" + + response = client.rename_tag_template_field(name, new_tag_template_field_id) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.RenameTagTemplateFieldRequest( + name=name, new_tag_template_field_id=new_tag_template_field_id + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_rename_tag_template_field_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.tag_template_field_path( + "[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]" + ) + new_tag_template_field_id = "newTagTemplateFieldId-1668354591" + + with pytest.raises(CustomException): + client.rename_tag_template_field(name, new_tag_template_field_id) + + def test_delete_tag_template_field(self): + channel = ChannelStub() + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.tag_template_field_path( + "[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]" + ) + force = False + + client.delete_tag_template_field(name, force) + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.DeleteTagTemplateFieldRequest( + name=name, force=force + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_delete_tag_template_field_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.tag_template_field_path( + "[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]" + ) + force = False + + with pytest.raises(CustomException): + client.delete_tag_template_field(name, force) + + def test_create_tag(self): + # Setup Expected Response + name = "name3373707" + template = "template-1321546630" + template_display_name = "templateDisplayName-532252787" + column = "column-1354837162" + expected_response = { + "name": name, + "template": template, + "template_display_name": template_display_name, + "column": column, + } + expected_response = tags_pb2.Tag(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.tag_path( + "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]", "[TAG]" + ) + tag = {} + + response = client.create_tag(parent, tag) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.CreateTagRequest(parent=parent, tag=tag) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_create_tag_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.tag_path( + "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]", "[TAG]" + ) + tag = {} + + with pytest.raises(CustomException): + client.create_tag(parent, tag) + + def test_update_tag(self): + # Setup Expected Response + name = "name3373707" + template = "template-1321546630" + template_display_name = "templateDisplayName-532252787" + column = "column-1354837162" + expected_response = { + "name": name, + "template": template, + "template_display_name": template_display_name, + "column": column, + } + expected_response = tags_pb2.Tag(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + tag = {} + + response = client.update_tag(tag) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.UpdateTagRequest(tag=tag) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_update_tag_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + tag = {} + + with pytest.raises(CustomException): + client.update_tag(tag) + + def test_delete_tag(self): + channel = ChannelStub() + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]") + + client.delete_tag(name) + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.DeleteTagRequest(name=name) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_delete_tag_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]") + + with pytest.raises(CustomException): + client.delete_tag(name) + + def test_list_tags(self): + # Setup Expected Response + next_page_token = "" + tags_element = {} + tags = [tags_element] + expected_response = {"next_page_token": next_page_token, "tags": tags} + expected_response = datacatalog_pb2.ListTagsResponse(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + parent = client.entry_path( + "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]" + ) + + paged_list_response = client.list_tags(parent) + resources = list(paged_list_response) + assert len(resources) == 1 + + assert expected_response.tags[0] == resources[0] + + assert len(channel.requests) == 1 + expected_request = datacatalog_pb2.ListTagsRequest(parent=parent) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_list_tags_exception(self): + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + parent = client.entry_path( + "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]" + ) + + paged_list_response = client.list_tags(parent) + with pytest.raises(CustomException): + list(paged_list_response) + + def test_set_iam_policy(self): + # Setup Expected Response + version = 351608024 + etag = b"21" + expected_response = {"version": version, "etag": etag} + expected_response = policy_pb2.Policy(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + resource = "resource-341064690" + policy = {} + + response = client.set_iam_policy(resource, policy) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = iam_policy_pb2.SetIamPolicyRequest( + resource=resource, policy=policy + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_set_iam_policy_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + resource = "resource-341064690" + policy = {} + + with pytest.raises(CustomException): + client.set_iam_policy(resource, policy) + + def test_get_iam_policy(self): + # Setup Expected Response + version = 351608024 + etag = b"21" + expected_response = {"version": version, "etag": etag} + expected_response = policy_pb2.Policy(**expected_response) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + resource = "resource-341064690" + + response = client.get_iam_policy(resource) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_get_iam_policy_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + resource = "resource-341064690" + + with pytest.raises(CustomException): + client.get_iam_policy(resource) + + def test_test_iam_permissions(self): + # Setup Expected Response + expected_response = {} + expected_response = iam_policy_pb2.TestIamPermissionsResponse( + **expected_response + ) + + # Mock the API response + channel = ChannelStub(responses=[expected_response]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup Request + resource = "resource-341064690" + permissions = [] + + response = client.test_iam_permissions(resource, permissions) + assert expected_response == response + + assert len(channel.requests) == 1 + expected_request = iam_policy_pb2.TestIamPermissionsRequest( + resource=resource, permissions=permissions + ) + actual_request = channel.requests[0][1] + assert expected_request == actual_request + + def test_test_iam_permissions_exception(self): + # Mock the API response + channel = ChannelStub(responses=[CustomException()]) + patch = mock.patch("google.api_core.grpc_helpers.create_channel") + with patch as create_channel: + create_channel.return_value = channel + client = datacatalog_v1.DataCatalogClient() + + # Setup request + resource = "resource-341064690" + permissions = [] + + with pytest.raises(CustomException): + client.test_iam_permissions(resource, permissions) From 96f9693f074621708c611878e0325c1104982a13 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Thu, 9 Apr 2020 09:40:59 -0700 Subject: [PATCH 3/4] docs: update docstrings (via synth) (#16) --- .coveragerc | 16 + .flake8 | 16 + .github/ISSUE_TEMPLATE/bug_report.md | 3 +- CONTRIBUTING.rst | 15 +- MANIFEST.in | 16 + .../gapic/data_catalog_client.py | 883 +++++++++++------- google/cloud/datacatalog_v1/gapic/enums.py | 17 +- .../transports/data_catalog_grpc_transport.py | 247 ++--- .../datacatalog_v1/proto/datacatalog_pb2.py | 5 +- .../datacatalog_v1/proto/timestamps_pb2.py | 3 +- .../gapic/data_catalog_client.py | 808 +++++++++------- .../cloud/datacatalog_v1beta1/gapic/enums.py | 51 +- .../gapic/policy_tag_manager_client.py | 72 +- .../transports/data_catalog_grpc_transport.py | 329 ++++--- .../proto/datacatalog_pb2.py | 5 +- .../proto/policytagmanager_pb2.py | 8 +- .../proto/timestamps_pb2.py | 3 +- noxfile.py | 3 +- setup.cfg | 16 + synth.metadata | 19 +- 20 files changed, 1493 insertions(+), 1042 deletions(-) diff --git a/.coveragerc b/.coveragerc index b178b094..dd39c854 100644 --- a/.coveragerc +++ b/.coveragerc @@ -1,3 +1,19 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + # Generated by synthtool. DO NOT EDIT! [run] branch = True diff --git a/.flake8 b/.flake8 index 0268ecc9..20fe9bda 100644 --- a/.flake8 +++ b/.flake8 @@ -1,3 +1,19 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + # Generated by synthtool. DO NOT EDIT! [flake8] ignore = E203, E266, E501, W503 diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index f1a886c2..48add3cb 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -11,8 +11,7 @@ Thanks for stopping by to let us know something could be better! Please run down the following list and make sure you've tried the usual "quick fixes": - Search the issues already opened: https://github.com/googleapis/python-datacatalog/issues - - Search the issues on our "catch-all" repository: https://github.com/googleapis/google-cloud-python - - Search StackOverflow: http://stackoverflow.com/questions/tagged/google-cloud-platform+python + - Search StackOverflow: https://stackoverflow.com/questions/tagged/google-cloud-platform+python If you are still having issues, please be sure to include as much information as possible: diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index abb152bc..1800a1f1 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -22,7 +22,7 @@ In order to add a feature: documentation. - The feature must work fully on the following CPython versions: 2.7, - 3.5, 3.6, and 3.7 on both UNIX and Windows. + 3.5, 3.6, 3.7 and 3.8 on both UNIX and Windows. - The feature must not add unnecessary dependencies (where "unnecessary" is of course subjective, but new dependencies should @@ -214,26 +214,18 @@ We support: - `Python 3.5`_ - `Python 3.6`_ - `Python 3.7`_ +- `Python 3.8`_ .. _Python 3.5: https://docs.python.org/3.5/ .. _Python 3.6: https://docs.python.org/3.6/ .. _Python 3.7: https://docs.python.org/3.7/ +.. _Python 3.8: https://docs.python.org/3.8/ Supported versions can be found in our ``noxfile.py`` `config`_. .. _config: https://github.com/googleapis/python-datacatalog/blob/master/noxfile.py -We explicitly decided not to support `Python 2.5`_ due to `decreased usage`_ -and lack of continuous integration `support`_. - -.. _Python 2.5: https://docs.python.org/2.5/ -.. _decreased usage: https://caremad.io/2013/10/a-look-at-pypi-downloads/ -.. _support: https://blog.travis-ci.com/2013-11-18-upcoming-build-environment-updates/ - -We have `dropped 2.6`_ as a supported version as well since Python 2.6 is no -longer supported by the core development team. - Python 2.7 support is deprecated. All code changes should maintain Python 2.7 compatibility until January 1, 2020. We also explicitly decided to support Python 3 beginning with version @@ -247,7 +239,6 @@ We also explicitly decided to support Python 3 beginning with version .. _prominent: https://docs.djangoproject.com/en/1.9/faq/install/#what-python-version-can-i-use-with-django .. _projects: http://flask.pocoo.org/docs/0.10/python3/ .. _Unicode literal support: https://www.python.org/dev/peps/pep-0414/ -.. _dropped 2.6: https://github.com/googleapis/google-cloud-python/issues/995 ********** Versioning diff --git a/MANIFEST.in b/MANIFEST.in index cd011be2..68855abc 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,3 +1,19 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + # Generated by synthtool. DO NOT EDIT! include README.rst LICENSE recursive-include google *.json *.proto diff --git a/google/cloud/datacatalog_v1/gapic/data_catalog_client.py b/google/cloud/datacatalog_v1/gapic/data_catalog_client.py index dbecb79a..c1cbe39b 100644 --- a/google/cloud/datacatalog_v1/gapic/data_catalog_client.py +++ b/google/cloud/datacatalog_v1/gapic/data_catalog_client.py @@ -270,22 +270,7 @@ def search_catalog( metadata=None, ): """ - Searches Data Catalog for multiple resources like entries, tags that - match a query. - - This is a custom method - (https://cloud.google.com/apis/design/custom_methods) and does not - return the complete resource, only the resource identifier and high - level fields. Clients can subsequentally call ``Get`` methods. - - Note that Data Catalog search queries do not guarantee full recall. - Query results that match your query may not be returned, even in - subsequent result pages. Also note that results returned (and not - returned) can vary across repeated search queries. - - See `Data Catalog Search - Syntax `__ - for more information. + Request message for ``CreateEntry``. Example: >>> from google.cloud import datacatalog_v1 @@ -313,39 +298,35 @@ def search_catalog( ... pass Args: - scope (Union[dict, ~google.cloud.datacatalog_v1.types.Scope]): Required. The scope of this search request. A ``scope`` that has - empty ``include_org_ids``, ``include_project_ids`` AND false - ``include_gcp_public_datasets`` is considered invalid. Data Catalog will - return an error in such a case. + scope (Union[dict, ~google.cloud.datacatalog_v1.types.Scope]): Creates a field in a tag template. The user should enable the Data + Catalog API in the project identified by the ``parent`` parameter (see + `Data Catalog Resource + Project `__ + for more information). If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.Scope` - query (str): Required. The query string in search query syntax. The query must be - non-empty. - - Query strings can be simple as "x" or more qualified as: - - - name:x - - column:x - - description:y - - Note: Query tokens need to have a minimum of 3 characters for substring - matching to work correctly. See `Data Catalog Search - Syntax `__ - for more information. + query (str): A ``TagTemplate``. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page. - order_by (str): Specifies the ordering of results, currently supported - case-sensitive choices are: + order_by (str): Set true to use the old proto1 MessageSet wire format for + extensions. This is provided for backwards-compatibility with the + MessageSet wire format. You should not use this for any other reason: + It's less efficient, has fewer features, and is more complicated. + + The message must be defined exactly as follows: message Foo { option + message_set_wire_format = true; extensions 4 to max; } Note that the + message cannot have any defined fields; MessageSets only have + extensions. - - ``relevance``, only supports descending - - ``last_modified_timestamp [asc|desc]``, defaults to descending if not - specified + All extensions of your type must be singular messages; e.g. they cannot + be int32s, enums, or repeated messages. - If not specified, defaults to ``relevance`` descending. + Because this is an option, the above two restrictions are not enforced + by the protocol compiler. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -407,24 +388,12 @@ def create_entry_group( metadata=None, ): """ - Creates an EntryGroup. + Required. The name of the entry group this entry is in. Example: - An entry group contains logically related entries together with Cloud - Identity and Access Management policies that specify the users who can - create, edit, and view entries within the entry group. + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} - Data Catalog automatically creates an entry group for BigQuery entries - ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own - entry group to contain Cloud Storage fileset entries or custom type - entries, and the IAM policies associated with those entries. Entry - groups, like entries, can be searched. - - A maximum of 10,000 entry groups may be created per organization across - all locations. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Note that this Entry and its child resources may not actually be stored + in the location in this name. Example: >>> from google.cloud import datacatalog_v1 @@ -439,12 +408,7 @@ def create_entry_group( >>> response = client.create_entry_group(parent, entry_group_id) Args: - parent (str): Required. The name of the project this entry group is in. Example: - - - projects/{project_id}/locations/{location} - - Note that this EntryGroup and its child resources may not actually be - stored in the location in this name. + parent (str): Request message for ``RenameTagTemplateField``. entry_group_id (str): Required. The id of the entry group to create. The id must begin with a letter or underscore, contain only English letters, numbers and underscores, and be at most 64 characters. @@ -523,8 +487,7 @@ def get_entry_group( >>> response = client.get_entry_group(name) Args: - name (str): Required. The name of the entry group. For example, - ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. + name (str): Request message for ``DeleteEntry``. read_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to return. If not set or empty, all fields are returned. If a dict is provided, it must be of the same form as the protobuf @@ -586,10 +549,11 @@ def update_entry_group( metadata=None, ): """ - Updates an EntryGroup. The user should enable the Data Catalog API - in the project identified by the ``entry_group.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The full name of the cloud resource the entry belongs to. See: + https://cloud.google.com/apis/design/resource_names#full_resource_name. + Example: + + - ``//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId`` Example: >>> from google.cloud import datacatalog_v1 @@ -670,11 +634,10 @@ def delete_entry_group( metadata=None, ): """ - Deletes an EntryGroup. Only entry groups that do not contain entries - can be deleted. Users should enable the Data Catalog API in the project - identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + JSON name of this field. The value is set by protocol compiler. If + the user has set a "json_name" option on this field, that option's value + will be used. Otherwise, it's deduced from the field's name by + converting it to camelCase. Example: >>> from google.cloud import datacatalog_v1 @@ -686,8 +649,22 @@ def delete_entry_group( >>> client.delete_entry_group(name) Args: - name (str): Required. The name of the entry group. For example, - ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. + name (str): Identifies which part of the FileDescriptorProto was defined at this + location. + + Each element is a field number or an index. They form a path from the + root FileDescriptorProto to the place where the definition. For example, + this path: [ 4, 3, 2, 7, 1 ] refers to: file.message_type(3) // 4, 3 + .field(7) // 2, 7 .name() // 1 This is because + FileDescriptorProto.message_type has field number 4: repeated + DescriptorProto message_type = 4; and DescriptorProto.field has field + number 2: repeated FieldDescriptorProto field = 2; and + FieldDescriptorProto.name has field number 1: optional string name = 1; + + Thus, the above path gives the location of a field name. If we removed + the last element: [ 4, 3, 2, 7 ] this path refers to the whole field + declaration (from the beginning of the label to the terminating + semicolon). force (bool): Optional. If true, deletes all entries in the entry group. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -767,10 +744,17 @@ def list_entry_groups( ... pass Args: - parent (str): Required. The name of the location that contains the entry groups, - which can be provided in URL format. Example: + parent (str): The resource type that the annotated field references. + + Example: + + :: - - projects/{project_id}/locations/{location} + message Subscription { + string topic = 2 [(google.api.resource_reference) = { + type: "pubsub.googleapis.com/Topic" + }]; + } page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -850,14 +834,11 @@ def create_entry( metadata=None, ): """ - Creates an entry. Only entries of 'FILESET' type or user-specified - type can be created. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). - - A maximum of 100,000 entries may be created per entry group. + The name of the uninterpreted option. Each string represents a + segment in a dot-separated name. is_extension is true iff a segment + represents an extension (denoted with parentheses in options specs in + .proto files). E.g.,{ ["foo", false], ["bar.baz", true], ["qux", false] + } represents "foo.(bar.baz).qux". Example: >>> from google.cloud import datacatalog_v1 @@ -875,12 +856,19 @@ def create_entry( >>> response = client.create_entry(parent, entry_id, entry) Args: - parent (str): Required. The name of the entry group this entry is in. Example: + parent (str): The resource type of a child collection that the annotated field + references. This is useful for annotating the ``parent`` field that + doesn't have a fixed resource type. - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + Example: + + :: - Note that this Entry and its child resources may not actually be stored - in the location in this name. + message ListLogEntriesRequest { + string parent = 1 [(google.api.resource_reference) = { + child_type: "logging.googleapis.com/LogEntry" + }; + } entry_id (str): Required. The id of the entry to create. entry (Union[dict, ~google.cloud.datacatalog_v1.types.Entry]): Required. The entry to create. @@ -945,10 +933,13 @@ def update_entry( metadata=None, ): """ - Updates an existing entry. Users should enable the Data Catalog API - in the project identified by the ``entry.name`` parameter (see [Data - Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) - for more information). + Updates a tag template. This method cannot be used to update the + fields of a template. The tag template fields are represented as + separate resources and should be updated using their own + create/update/delete methods. Users should enable the Data Catalog API + in the project identified by the ``tag_template.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Example: >>> from google.cloud import datacatalog_v1 @@ -965,32 +956,9 @@ def update_entry( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.Entry` - update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to update on the entry. If absent or empty, all - modifiable fields are updated. - - The following fields are modifiable: - - - For entries with type ``DATA_STREAM``: - - - ``schema`` - - - For entries with type ``FILESET`` - - - ``schema`` - - ``display_name`` - - ``description`` - - ``gcs_fileset_spec`` - - ``gcs_fileset_spec.file_patterns`` - - - For entries with ``user_specified_type`` + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): Required. The name of the entry. Example: - - ``schema`` - - ``display_name`` - - ``description`` - - user_specified_type - - user_specified_system - - linked_resource - - source_system_timestamps + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.FieldMask` @@ -1052,11 +1020,8 @@ def delete_entry( metadata=None, ): """ - Deletes an existing entry. Only entries created through - ``CreateEntry`` method can be deleted. Users should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The source system of the entry. Only applicable when + ``search_result_type`` is ENTRY. Example: >>> from google.cloud import datacatalog_v1 @@ -1068,9 +1033,37 @@ def delete_entry( >>> client.delete_entry(name) Args: - name (str): Required. The name of the entry. Example: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + name (str): Protocol Buffers - Google's data interchange format Copyright 2008 + Google Inc. All rights reserved. + https://developers.google.com/protocol-buffers/ + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are + met: + + :: + + * Redistributions of source code must retain the above copyright + + notice, this list of conditions and the following disclaimer. \* + Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. \* + Neither the name of Google Inc. nor the names of its contributors may be + used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS + IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER + OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1136,9 +1129,22 @@ def get_entry( >>> response = client.get_entry(name) Args: - name (str): Required. The name of the entry. Example: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + name (str): Whether the message is an automatically generated map entry type for + the maps field. + + For maps fields: map map_field = 1; The parsed + descriptor looks like: message MapFieldEntry { option map_entry = true; + optional KeyType key = 1; optional ValueType value = 2; } repeated + MapFieldEntry map_field = 1; + + Implementations may choose not to generate the map_entry=true message, + but use a native map in the target language to hold the keys and values. + The reflection APIs in such implementations still need to work as if the + field is a repeated message field. + + NOTE: Do not set the option in .proto files. Always use the maps syntax + instead. The option should only be implicitly set by the proto compiler + parser. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1208,27 +1214,14 @@ def lookup_entry( >>> response = client.lookup_entry() Args: - linked_resource (str): The full name of the Google Cloud Platform resource the Data Catalog - entry represents. See: - https://cloud.google.com/apis/design/resource_names#full_resource_name. - Full names are case-sensitive. + linked_resource (str): Request message for ``LookupEntry``. + sql_resource (str): Output only. The resource name of the tag template field in URL + format. Example: - Examples: + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template}/fields/{field} - - //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId - - //pubsub.googleapis.com/projects/projectId/topics/topicId - sql_resource (str): The SQL name of the entry. SQL names are case-sensitive. - - Examples: - - - ``cloud_pubsub.project_id.topic_id`` - - :literal:`pubsub.project_id.`topic.id.with.dots\`` - - ``bigquery.table.project_id.dataset_id.table_id`` - - ``bigquery.dataset.project_id.dataset_id`` - - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` - - ``*_id``\ s shoud satisfy the standard SQL rules for identifiers. - https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. + Note that this TagTemplateField may not actually be stored in the + location in this name. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1306,19 +1299,13 @@ def list_entries( ... pass Args: - parent (str): Required. The name of the entry group that contains the entries, - which can be provided in URL format. Example: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + parent (str): Request message for ``SearchCatalog``. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page. - read_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to return for each Entry. If not set or empty, all fields - are returned. For example, setting read_mask to contain only one path - "name" will cause ListEntries to return a list of Entries with only - "name" field. + read_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): Request message for ``UpdateEntryGroup``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.FieldMask` @@ -1396,11 +1383,9 @@ def create_tag_template( metadata=None, ): """ - Creates a tag template. The user should enable the Data Catalog API - in the project identified by the ``parent`` parameter (see `Data Catalog - Resource - Project `__ - for more information). + The resource has one pattern, but the API owner expects to add more + later. (This is the inverse of ORIGINALLY_SINGLE_PATTERN, and prevents + that from being necessary once there are multiple patterns.) Example: >>> from google.cloud import datacatalog_v1 @@ -1418,13 +1403,7 @@ def create_tag_template( >>> response = client.create_tag_template(parent, tag_template_id, tag_template) Args: - parent (str): Required. The name of the project and the template location - `region `__. - NOTE: Currently, only the ``us-central1 region`` is supported. - - Example: - - - projects/{project_id}/locations/us-central1 + parent (str): Request message for ``GetEntry``. tag_template_id (str): Required. The id of the tag template to create. tag_template (Union[dict, ~google.cloud.datacatalog_v1.types.TagTemplate]): Required. The tag template to create. @@ -1500,9 +1479,8 @@ def get_tag_template( >>> response = client.get_tag_template(name) Args: - name (str): Required. The name of the tag template. Example: - - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + name (str): Spec of a BigQuery table. This field should only be populated if + ``table_source_type`` is ``BIGQUERY_TABLE``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1560,13 +1538,7 @@ def update_tag_template( metadata=None, ): """ - Updates a tag template. This method cannot be used to update the - fields of a template. The tag template fields are represented as - separate resources and should be updated using their own - create/update/delete methods. Users should enable the Data Catalog API - in the project identified by the ``tag_template.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Request message for ``UpdateTagTemplateField``. Example: >>> from google.cloud import datacatalog_v1 @@ -1583,13 +1555,9 @@ def update_tag_template( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.TagTemplate` - update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The field mask specifies the parts of the template to overwrite. - - Allowed fields: - - - ``display_name`` - - If absent or empty, all of the allowed fields above will be updated. + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): Number of results in the search page. If <=0 then defaults to 10. + Max limit for page_size is 1000. Throws an invalid argument for + page_size > 1000. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.FieldMask` @@ -1652,10 +1620,16 @@ def delete_tag_template( metadata=None, ): """ - Deletes a tag template and all tags using the template. Users should - enable the Data Catalog API in the project identified by the ``name`` - parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The resource type. It must be in the format of + {service_name}/{resource_type_kind}. The ``resource_type_kind`` must be + singular and must not include version numbers. + + Example: ``storage.googleapis.com/Bucket`` + + The value of the resource_type_kind must follow the regular expression + /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and + should use PascalCase (UpperCamelCase). The maximum number of characters + allowed for the ``resource_type_kind`` is 100. Example: >>> from google.cloud import datacatalog_v1 @@ -1670,12 +1644,46 @@ def delete_tag_template( >>> client.delete_tag_template(name, force) Args: - name (str): Required. The name of the tag template to delete. Example: + name (str): If this SourceCodeInfo represents a complete declaration, these are + any comments appearing before and after the declaration which appear to + be attached to the declaration. - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} - force (bool): Required. Currently, this field must always be set to ``true``. This - confirms the deletion of any possible tags using this template. - ``force = false`` will be supported in the future. + A series of line comments appearing on consecutive lines, with no other + tokens appearing on those lines, will be treated as a single comment. + + leading_detached_comments will keep paragraphs of comments that appear + before (but not connected to) the current element. Each paragraph, + separated by empty lines, will be one comment element in the repeated + field. + + Only the comment content is provided; comment markers (e.g. //) are + stripped out. For block comments, leading whitespace and an asterisk + will be stripped from the beginning of each line other than the first. + Newlines are included in the output. + + Examples: + + optional int32 foo = 1; // Comment attached to foo. // Comment attached + to bar. optional int32 bar = 2; + + optional string baz = 3; // Comment attached to baz. // Another line + attached to baz. + + // Comment attached to qux. // // Another line attached to qux. optional + double qux = 4; + + // Detached comment for corge. This is not leading or trailing comments + // to qux or corge because there are blank lines separating it from // + both. + + // Detached comment for corge paragraph 2. + + optional string corge = 5; /\* Block comment attached \* to corge. + Leading asterisks \* will be removed. */ /* Block comment attached to \* + grault. \*/ optional int32 grault = 6; + + // ignored detached comments. + force (bool): Response message for ``ListTags``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1731,11 +1739,9 @@ def create_tag_template_field( metadata=None, ): """ - Creates a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``parent`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + Required. The name of the tag template field. Example: + + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} Example: >>> from google.cloud import datacatalog_v1 @@ -1753,18 +1759,15 @@ def create_tag_template_field( >>> response = client.create_tag_template_field(parent, tag_template_field_id, tag_template_field) Args: - parent (str): Required. The name of the project and the template location - `region `__. - NOTE: Currently, only the ``us-central1 region`` is supported. - - Example: + parent (str): Required. The name of the entry group that contains the entries, + which can be provided in URL format. Example: - - projects/{project_id}/locations/us-central1/tagTemplates/{tag_template_id} - tag_template_field_id (str): Required. The ID of the tag template field to create. Field ids can - contain letters (both uppercase and lowercase), numbers (0-9), - underscores (_) and dashes (-). Field IDs must be at least 1 character - long and at most 128 characters long. Field IDs must also be unique - within their template. + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + tag_template_field_id (str): Output only. If the table is a dated shard, i.e., with name pattern + ``[prefix]YYYYMMDD``, ``grouped_entry`` is the Data Catalog resource + name of the date sharded grouped entry, for example, + ``projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}``. + Otherwise, ``grouped_entry`` is empty. tag_template_field (Union[dict, ~google.cloud.datacatalog_v1.types.TagTemplateField]): Required. The tag template field to create. If a dict is provided, it must be of the same form as the protobuf @@ -1831,11 +1834,7 @@ def update_tag_template_field( metadata=None, ): """ - Updates a field in a tag template. This method cannot be used to - update the field type. Users should enable the Data Catalog API in the - project identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Request message for ``SetIamPolicy`` method. Example: >>> from google.cloud import datacatalog_v1 @@ -1850,27 +1849,18 @@ def update_tag_template_field( >>> response = client.update_tag_template_field(name, tag_template_field) Args: - name (str): Required. The name of the tag template field. Example: - - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + name (str): This field indicates the entry's source system that Data Catalog + does not integrate with. ``user_specified_system`` strings must begin + with a letter or underscore and can only contain letters, numbers, and + underscores; are case insensitive; must be at least 1 character and at + most 64 characters long. tag_template_field (Union[dict, ~google.cloud.datacatalog_v1.types.TagTemplateField]): Required. The template to update. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.TagTemplateField` - update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): Optional. The field mask specifies the parts of the template to be - updated. Allowed fields: - - - ``display_name`` - - ``type.enum_type`` - - ``is_required`` + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): Required. The name of the tag template. Example: - If ``update_mask`` is not set or empty, all of the allowed fields above - will be updated. - - When updating an enum type, the provided values will be merged with the - existing values. Therefore, enum values can only be added, existing enum - values cannot be deleted nor renamed. Updating a template field from - optional to required is NOT allowed. + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.FieldMask` @@ -1933,11 +1923,12 @@ def rename_tag_template_field( metadata=None, ): """ - Renames a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + The resource name of the tag in URL format. Example: + + - projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + + where ``tag_id`` is a system-generated identifier. Note that this Tag + may not actually be stored in the location in this name. Example: >>> from google.cloud import datacatalog_v1 @@ -1952,11 +1943,27 @@ def rename_tag_template_field( >>> response = client.rename_tag_template_field(name, new_tag_template_field_id) Args: - name (str): Required. The name of the tag template. Example: - - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} - new_tag_template_field_id (str): Required. The new ID of this tag template field. For example, - ``my_new_field``. + name (str): The maximum number of items to return. Default is 10. Max limit is + 1000. Throws an invalid argument for ``page_size > 1000``. + new_tag_template_field_id (str): Gets the access control policy for a resource. A ``NOT_FOUND`` error + is returned if the resource does not exist. An empty policy is returned + if the resource exists but does not have a policy set on it. + + Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Pub/Sub and any external Google Cloud Platform resources + synced to Data Catalog. + + Callers must have following Google IAM permission + + - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag + templates. + - ``datacatalog.entries.getIamPolicy`` to get policies on entries. + - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry + groups. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -2016,10 +2023,30 @@ def delete_tag_template_field( metadata=None, ): """ - Deletes a field in a tag template and all uses of that field. Users - should enable the Data Catalog API in the project identified by the - ``name`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Optional. The relative resource name pattern associated with this + resource type. The DNS prefix of the full resource name shouldn't be + specified here. + + The path pattern must follow the syntax, which aligns with HTTP binding + syntax: + + :: + + Template = Segment { "/" Segment } ; + Segment = LITERAL | Variable ; + Variable = "{" LITERAL "}" ; + + Examples: + + :: + + - "projects/{project}/topics/{topic}" + - "projects/{project}/knowledgeBases/{knowledge_base}" + + The components in braces correspond to the IDs for each resource in the + hierarchy. It is expected that, if multiple patterns are provided, the + same component name (e.g. "project") refers to IDs of the same type of + resource. Example: >>> from google.cloud import datacatalog_v1 @@ -2034,12 +2061,234 @@ def delete_tag_template_field( >>> client.delete_tag_template_field(name, force) Args: - name (str): Required. The name of the tag template field to delete. Example: + name (str): ``FieldMask`` represents a set of symbolic field paths, for example: + + :: + + paths: "f.a" + paths: "f.b.d" + + Here ``f`` represents a field in some root message, ``a`` and ``b`` + fields in the message found in ``f``, and ``d`` a field found in the + message in ``f.b``. + + Field masks are used to specify a subset of fields that should be + returned by a get operation or modified by an update operation. Field + masks also have a custom JSON encoding (see below). + + # Field Masks in Projections + + When used in the context of a projection, a response message or + sub-message is filtered by the API to only contain those fields as + specified in the mask. For example, if the mask in the previous example + is applied to a response message as follows: + + :: + + f { + a : 22 + b { + d : 1 + x : 2 + } + y : 13 + } + z: 8 + + The result will not contain specific values for fields x,y and z (their + value will be set to the default, and omitted in proto text output): + + :: + + f { + a : 22 + b { + d : 1 + } + } + + A repeated field is not allowed except at the last position of a paths + string. + + If a FieldMask object is not present in a get operation, the operation + applies to all fields (as if a FieldMask of all fields had been + specified). + + Note that a field mask does not necessarily apply to the top-level + response message. In case of a REST get operation, the field mask + applies directly to the response, but in case of a REST list operation, + the mask instead applies to each individual message in the returned + resource list. In case of a REST custom method, other definitions may be + used. Where the mask applies will be clearly documented together with + its declaration in the API. In any case, the effect on the returned + resource/resources is required behavior for APIs. + + # Field Masks in Update Operations + + A field mask in update operations specifies which fields of the targeted + resource are going to be updated. The API is required to only change the + values of the fields as specified in the mask and leave the others + untouched. If a resource is passed in to describe the updated values, + the API ignores the values of all fields not covered by the mask. + + If a repeated field is specified for an update operation, new values + will be appended to the existing repeated field in the target resource. + Note that a repeated field is only allowed in the last position of a + ``paths`` string. + + If a sub-message is specified in the last position of the field mask for + an update operation, then new value will be merged into the existing + sub-message in the target resource. + + For example, given the target message: + + :: + + f { + b { + d: 1 + x: 2 + } + c: [1] + } + + And an update message: + + :: + + f { + b { + d: 10 + } + c: [2] + } + + then if the field mask is: + + paths: ["f.b", "f.c"] + + then the result will be: + + :: + + f { + b { + d: 10 + x: 2 + } + c: [1, 2] + } + + An implementation may provide options to override this default behavior + for repeated and message fields. + + In order to reset a field's value to the default, the field must be in + the mask and set to the default value in the provided resource. Hence, + in order to reset all fields of a resource, provide a default instance + of the resource and set all fields in the mask, or do not provide a mask + as described below. + + If a field mask is not present on update, the operation applies to all + fields (as if a field mask of all fields has been specified). Note that + in the presence of schema evolution, this may mean that fields the + client does not know and has therefore not filled into the request will + be reset to their default. If this is unwanted behavior, a specific + service may require a client to always specify a field mask, producing + an error if not. + + As with get operations, the location of the resource which describes the + updated values in the request message depends on the operation kind. In + any case, the effect of the field mask is required to be honored by the + API. + + ## Considerations for HTTP REST + + The HTTP kind of an update operation which uses a field mask must be set + to PATCH instead of PUT in order to satisfy HTTP semantics (PUT must + only be used for full updates). + + # JSON Encoding of Field Masks + + In JSON, a field mask is encoded as a single string where paths are + separated by a comma. Fields name in each path are converted to/from + lower-camel naming conventions. + + As an example, consider the following message declarations: + + :: + + message Profile { + User user = 1; + Photo photo = 2; + } + message User { + string display_name = 1; + string address = 2; + } + + In proto a field mask for ``Profile`` may look as such: - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} - force (bool): Required. Currently, this field must always be set to ``true``. This - confirms the deletion of this field from any tags using this field. - ``force = false`` will be supported in the future. + :: + + mask { + paths: "user.display_name" + paths: "photo" + } + + In JSON, the same mask is represented as below: + + :: + + { + mask: "user.displayName,photo" + } + + # Field Masks and Oneof Fields + + Field masks treat fields in oneofs just as regular fields. Consider the + following message: + + :: + + message SampleMessage { + oneof test_oneof { + string name = 4; + SubMessage sub_message = 9; + } + } + + The field mask can be: + + :: + + mask { + paths: "name" + } + + Or: + + :: + + mask { + paths: "sub_message" + } + + Note that oneof type names ("test_oneof" in this case) cannot be used in + paths. + + ## Field Mask Verification + + The implementation of any API method which has a FieldMask type field in + the request should verify the included field paths, and return an + ``INVALID_ARGUMENT`` error if any path is unmappable. + force (bool): Creates an entry. Only entries of 'FILESET' type or user-specified + type can be created. + + Users should enable the Data Catalog API in the project identified by + the ``parent`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + + A maximum of 100,000 entries may be created per entry group. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -2094,12 +2343,10 @@ def create_tag( metadata=None, ): """ - Creates a tag on an ``Entry``. Note: The project identified by the - ``parent`` parameter for the - `tag `__ - and the `tag - template `__ - used to create the tag must be from the same organization. + Deletes a tag template and all tags using the template. Users should + enable the Data Catalog API in the project identified by the ``name`` + parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Example: >>> from google.cloud import datacatalog_v1 @@ -2114,13 +2361,17 @@ def create_tag( >>> response = client.create_tag(parent, tag) Args: - parent (str): Required. The name of the resource to attach this tag to. Tags can - be attached to Entries. Example: + parent (str): A generic empty message that you can re-use to avoid defining + duplicated empty messages in your APIs. A typical example is to use it + as the request or the response type of an API method. For instance: - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + :: + + service Foo { + rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); + } - Note that this Tag and its child resources may not actually be stored in - the location in this name. + The JSON representation for ``Empty`` is empty JSON object ``{}``. tag (Union[dict, ~google.cloud.datacatalog_v1.types.Tag]): Required. The tag to create. If a dict is provided, it must be of the same form as the protobuf @@ -2199,9 +2450,7 @@ def update_tag( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.Tag` - update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): The fields to update on the Tag. If absent or empty, all modifiable - fields are updated. Currently the only modifiable field is the field - ``fields``. + update_mask (Union[dict, ~google.cloud.datacatalog_v1.types.FieldMask]): Lists the tags on an ``Entry``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.FieldMask` @@ -2273,9 +2522,15 @@ def delete_tag( >>> client.delete_tag(name) Args: - name (str): Required. The name of the tag to delete. Example: + name (str): The full name of the Google Cloud Platform resource the Data Catalog + entry represents. See: + https://cloud.google.com/apis/design/resource_names#full_resource_name. + Full names are case-sensitive. - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + Examples: + + - //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + - //pubsub.googleapis.com/projects/projectId/topics/topicId retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -2330,7 +2585,18 @@ def list_tags( metadata=None, ): """ - Lists the tags on an ``Entry``. + The SQL name of the entry. SQL names are case-sensitive. + + Examples: + + - ``cloud_pubsub.project_id.topic_id`` + - :literal:`pubsub.project_id.`topic.id.with.dots\`` + - ``bigquery.table.project_id.dataset_id.table_id`` + - ``bigquery.dataset.project_id.dataset_id`` + - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` + + ``*_id``\ s shoud satisfy the standard SQL rules for identifiers. + https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. Example: >>> from google.cloud import datacatalog_v1 @@ -2354,13 +2620,8 @@ def list_tags( ... pass Args: - parent (str): Required. The name of the Data Catalog resource to list the tags of. - The resource could be an ``Entry`` or an ``EntryGroup``. - - Examples: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + parent (str): Specification that applies to a BigQuery table. This is only valid + on entries of type ``TABLE``. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -2437,22 +2698,7 @@ def set_iam_policy( metadata=None, ): """ - Sets the access control policy for a resource. Replaces any existing - policy. Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Pub/Sub and any external Google Cloud Platform resources - synced to Data Catalog. - - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag - templates. - - ``datacatalog.entries.setIamPolicy`` to set policies on entries. - - ``datacatalog.entryGroups.setIamPolicy`` to set policies on entry - groups. + ``Tag`` details. Example: >>> from google.cloud import datacatalog_v1 @@ -2470,10 +2716,11 @@ def set_iam_policy( Args: resource (str): REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. - policy (Union[dict, ~google.cloud.datacatalog_v1.types.Policy]): REQUIRED: The complete policy to be applied to the ``resource``. The - size of the policy is limited to a few 10s of KB. An empty policy is a - valid policy but certain Cloud Platform services (such as Projects) - might reject them. + policy (Union[dict, ~google.cloud.datacatalog_v1.types.Policy]): Deletes an EntryGroup. Only entry groups that do not contain entries + can be deleted. Users should enable the Data Catalog API in the project + identified by the ``name`` parameter (see [Data Catalog Resource + Project] (/data-catalog/docs/concepts/resource-project) for more + information). If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.Policy` @@ -2534,25 +2781,7 @@ def get_iam_policy( metadata=None, ): """ - Gets the access control policy for a resource. A ``NOT_FOUND`` error - is returned if the resource does not exist. An empty policy is returned - if the resource exists but does not have a policy set on it. - - Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Pub/Sub and any external Google Cloud Platform resources - synced to Data Catalog. - - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag - templates. - - ``datacatalog.entries.getIamPolicy`` to get policies on entries. - - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry - groups. + Request message for ``UpdateEntry``. Example: >>> from google.cloud import datacatalog_v1 @@ -2567,8 +2796,8 @@ def get_iam_policy( Args: resource (str): REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. - options_ (Union[dict, ~google.cloud.datacatalog_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to - ``GetIamPolicy``. This field is only used by Cloud IAM. + options_ (Union[dict, ~google.cloud.datacatalog_v1.types.GetPolicyOptions]): For extensions, this is the name of the type being extended. It is + resolved in the same manner as type_name. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1.types.GetPolicyOptions` @@ -2631,20 +2860,10 @@ def test_iam_permissions( metadata=None, ): """ - Returns the caller's permissions on a resource. If the resource does - not exist, an empty set of permissions is returned (We don't return a - ``NOT_FOUND`` error). - - Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Pub/Sub and any external Google Cloud Platform resources - synced to Data Catalog. - - A caller is not required to have Google IAM permission to make this - request. + REQUIRED: The complete policy to be applied to the ``resource``. The + size of the policy is limited to a few 10s of KB. An empty policy is a + valid policy but certain Cloud Platform services (such as Projects) + might reject them. Example: >>> from google.cloud import datacatalog_v1 @@ -2662,10 +2881,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions - with wildcards (such as '*' or 'storage.*') are not allowed. For more - information see `IAM - Overview `__. + permissions (list[str]): An annotation that describes a resource definition, see + ``ResourceDescriptor``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. diff --git a/google/cloud/datacatalog_v1/gapic/enums.py b/google/cloud/datacatalog_v1/gapic/enums.py index b5c584ba..93befd3b 100644 --- a/google/cloud/datacatalog_v1/gapic/enums.py +++ b/google/cloud/datacatalog_v1/gapic/enums.py @@ -21,9 +21,7 @@ class EntryType(enum.IntEnum): """ - Entry resources in Data Catalog can be of different types e.g. a - BigQuery Table entry is of type ``TABLE``. This enum describes all the - possible types Data Catalog contains. + Request message for ``DeleteTag``. Attributes: ENTRY_TYPE_UNSPECIFIED (int): Default unknown type. @@ -66,9 +64,16 @@ class SearchResultType(enum.IntEnum): Attributes: SEARCH_RESULT_TYPE_UNSPECIFIED (int): Default unknown type. - ENTRY (int): An ``Entry``. - TAG_TEMPLATE (int): A ``TagTemplate``. - ENTRY_GROUP (int): An ``EntryGroup``. + ENTRY (int): Request message for ``GetEntryGroup``. + TAG_TEMPLATE (int): An indicator of the behavior of a given field (for example, that a + field is required in requests, or given as output but ignored as input). + This **does not** change the behavior in protocol buffers itself; it + only denotes the behavior and may affect how API tooling handles the + field. + + Note: This enum **may** receive new values in the future. + ENTRY_GROUP (int): Required. The name of the entry group. For example, + ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. """ SEARCH_RESULT_TYPE_UNSPECIFIED = 0 diff --git a/google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py b/google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py index 0f626a90..5f3dbea4 100644 --- a/google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py +++ b/google/cloud/datacatalog_v1/gapic/transports/data_catalog_grpc_transport.py @@ -111,22 +111,7 @@ def channel(self): def search_catalog(self): """Return the gRPC stub for :meth:`DataCatalogClient.search_catalog`. - Searches Data Catalog for multiple resources like entries, tags that - match a query. - - This is a custom method - (https://cloud.google.com/apis/design/custom_methods) and does not - return the complete resource, only the resource identifier and high - level fields. Clients can subsequentally call ``Get`` methods. - - Note that Data Catalog search queries do not guarantee full recall. - Query results that match your query may not be returned, even in - subsequent result pages. Also note that results returned (and not - returned) can vary across repeated search queries. - - See `Data Catalog Search - Syntax `__ - for more information. + Request message for ``CreateEntry``. Returns: Callable: A callable which accepts the appropriate @@ -139,24 +124,12 @@ def search_catalog(self): def create_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_entry_group`. - Creates an EntryGroup. - - An entry group contains logically related entries together with Cloud - Identity and Access Management policies that specify the users who can - create, edit, and view entries within the entry group. + Required. The name of the entry group this entry is in. Example: - Data Catalog automatically creates an entry group for BigQuery entries - ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own - entry group to contain Cloud Storage fileset entries or custom type - entries, and the IAM policies associated with those entries. Entry - groups, like entries, can be searched. + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} - A maximum of 10,000 entry groups may be created per organization across - all locations. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Note that this Entry and its child resources may not actually be stored + in the location in this name. Returns: Callable: A callable which accepts the appropriate @@ -182,10 +155,11 @@ def get_entry_group(self): def update_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_entry_group`. - Updates an EntryGroup. The user should enable the Data Catalog API - in the project identified by the ``entry_group.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The full name of the cloud resource the entry belongs to. See: + https://cloud.google.com/apis/design/resource_names#full_resource_name. + Example: + + - ``//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId`` Returns: Callable: A callable which accepts the appropriate @@ -198,11 +172,10 @@ def update_entry_group(self): def delete_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry_group`. - Deletes an EntryGroup. Only entry groups that do not contain entries - can be deleted. Users should enable the Data Catalog API in the project - identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + JSON name of this field. The value is set by protocol compiler. If + the user has set a "json_name" option on this field, that option's value + will be used. Otherwise, it's deduced from the field's name by + converting it to camelCase. Returns: Callable: A callable which accepts the appropriate @@ -228,14 +201,11 @@ def list_entry_groups(self): def create_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_entry`. - Creates an entry. Only entries of 'FILESET' type or user-specified - type can be created. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). - - A maximum of 100,000 entries may be created per entry group. + The name of the uninterpreted option. Each string represents a + segment in a dot-separated name. is_extension is true iff a segment + represents an extension (denoted with parentheses in options specs in + .proto files). E.g.,{ ["foo", false], ["bar.baz", true], ["qux", false] + } represents "foo.(bar.baz).qux". Returns: Callable: A callable which accepts the appropriate @@ -248,10 +218,13 @@ def create_entry(self): def update_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_entry`. - Updates an existing entry. Users should enable the Data Catalog API - in the project identified by the ``entry.name`` parameter (see [Data - Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) - for more information). + Updates a tag template. This method cannot be used to update the + fields of a template. The tag template fields are represented as + separate resources and should be updated using their own + create/update/delete methods. Users should enable the Data Catalog API + in the project identified by the ``tag_template.name`` parameter (see + [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Returns: Callable: A callable which accepts the appropriate @@ -264,11 +237,8 @@ def update_entry(self): def delete_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry`. - Deletes an existing entry. Only entries created through - ``CreateEntry`` method can be deleted. Users should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The source system of the entry. Only applicable when + ``search_result_type`` is ENTRY. Returns: Callable: A callable which accepts the appropriate @@ -322,11 +292,9 @@ def list_entries(self): def create_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template`. - Creates a tag template. The user should enable the Data Catalog API - in the project identified by the ``parent`` parameter (see `Data Catalog - Resource - Project `__ - for more information). + The resource has one pattern, but the API owner expects to add more + later. (This is the inverse of ORIGINALLY_SINGLE_PATTERN, and prevents + that from being necessary once there are multiple patterns.) Returns: Callable: A callable which accepts the appropriate @@ -352,13 +320,7 @@ def get_tag_template(self): def update_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template`. - Updates a tag template. This method cannot be used to update the - fields of a template. The tag template fields are represented as - separate resources and should be updated using their own - create/update/delete methods. Users should enable the Data Catalog API - in the project identified by the ``tag_template.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Request message for ``UpdateTagTemplateField``. Returns: Callable: A callable which accepts the appropriate @@ -371,10 +333,16 @@ def update_tag_template(self): def delete_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template`. - Deletes a tag template and all tags using the template. Users should - enable the Data Catalog API in the project identified by the ``name`` - parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The resource type. It must be in the format of + {service_name}/{resource_type_kind}. The ``resource_type_kind`` must be + singular and must not include version numbers. + + Example: ``storage.googleapis.com/Bucket`` + + The value of the resource_type_kind must follow the regular expression + /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and + should use PascalCase (UpperCamelCase). The maximum number of characters + allowed for the ``resource_type_kind`` is 100. Returns: Callable: A callable which accepts the appropriate @@ -387,11 +355,9 @@ def delete_tag_template(self): def create_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template_field`. - Creates a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``parent`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + Required. The name of the tag template field. Example: + + - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} Returns: Callable: A callable which accepts the appropriate @@ -404,11 +370,7 @@ def create_tag_template_field(self): def update_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template_field`. - Updates a field in a tag template. This method cannot be used to - update the field type. Users should enable the Data Catalog API in the - project identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Request message for ``SetIamPolicy`` method. Returns: Callable: A callable which accepts the appropriate @@ -421,11 +383,12 @@ def update_tag_template_field(self): def rename_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.rename_tag_template_field`. - Renames a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + The resource name of the tag in URL format. Example: + + - projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + + where ``tag_id`` is a system-generated identifier. Note that this Tag + may not actually be stored in the location in this name. Returns: Callable: A callable which accepts the appropriate @@ -438,10 +401,30 @@ def rename_tag_template_field(self): def delete_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template_field`. - Deletes a field in a tag template and all uses of that field. Users - should enable the Data Catalog API in the project identified by the - ``name`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Optional. The relative resource name pattern associated with this + resource type. The DNS prefix of the full resource name shouldn't be + specified here. + + The path pattern must follow the syntax, which aligns with HTTP binding + syntax: + + :: + + Template = Segment { "/" Segment } ; + Segment = LITERAL | Variable ; + Variable = "{" LITERAL "}" ; + + Examples: + + :: + + - "projects/{project}/topics/{topic}" + - "projects/{project}/knowledgeBases/{knowledge_base}" + + The components in braces correspond to the IDs for each resource in the + hierarchy. It is expected that, if multiple patterns are provided, the + same component name (e.g. "project") refers to IDs of the same type of + resource. Returns: Callable: A callable which accepts the appropriate @@ -454,12 +437,10 @@ def delete_tag_template_field(self): def create_tag(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_tag`. - Creates a tag on an ``Entry``. Note: The project identified by the - ``parent`` parameter for the - `tag `__ - and the `tag - template `__ - used to create the tag must be from the same organization. + Deletes a tag template and all tags using the template. Users should + enable the Data Catalog API in the project identified by the ``name`` + parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). Returns: Callable: A callable which accepts the appropriate @@ -498,7 +479,18 @@ def delete_tag(self): def list_tags(self): """Return the gRPC stub for :meth:`DataCatalogClient.list_tags`. - Lists the tags on an ``Entry``. + The SQL name of the entry. SQL names are case-sensitive. + + Examples: + + - ``cloud_pubsub.project_id.topic_id`` + - :literal:`pubsub.project_id.`topic.id.with.dots\`` + - ``bigquery.table.project_id.dataset_id.table_id`` + - ``bigquery.dataset.project_id.dataset_id`` + - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` + + ``*_id``\ s shoud satisfy the standard SQL rules for identifiers. + https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. Returns: Callable: A callable which accepts the appropriate @@ -511,22 +503,7 @@ def list_tags(self): def set_iam_policy(self): """Return the gRPC stub for :meth:`DataCatalogClient.set_iam_policy`. - Sets the access control policy for a resource. Replaces any existing - policy. Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Pub/Sub and any external Google Cloud Platform resources - synced to Data Catalog. - - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag - templates. - - ``datacatalog.entries.setIamPolicy`` to set policies on entries. - - ``datacatalog.entryGroups.setIamPolicy`` to set policies on entry - groups. + ``Tag`` details. Returns: Callable: A callable which accepts the appropriate @@ -539,25 +516,7 @@ def set_iam_policy(self): def get_iam_policy(self): """Return the gRPC stub for :meth:`DataCatalogClient.get_iam_policy`. - Gets the access control policy for a resource. A ``NOT_FOUND`` error - is returned if the resource does not exist. An empty policy is returned - if the resource exists but does not have a policy set on it. - - Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Pub/Sub and any external Google Cloud Platform resources - synced to Data Catalog. - - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag - templates. - - ``datacatalog.entries.getIamPolicy`` to get policies on entries. - - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry - groups. + Request message for ``UpdateEntry``. Returns: Callable: A callable which accepts the appropriate @@ -570,20 +529,10 @@ def get_iam_policy(self): def test_iam_permissions(self): """Return the gRPC stub for :meth:`DataCatalogClient.test_iam_permissions`. - Returns the caller's permissions on a resource. If the resource does - not exist, an empty set of permissions is returned (We don't return a - ``NOT_FOUND`` error). - - Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Pub/Sub and any external Google Cloud Platform resources - synced to Data Catalog. - - A caller is not required to have Google IAM permission to make this - request. + REQUIRED: The complete policy to be applied to the ``resource``. The + size of the policy is limited to a few 10s of KB. An empty policy is a + valid policy but certain Cloud Platform services (such as Projects) + might reject them. Returns: Callable: A callable which accepts the appropriate diff --git a/google/cloud/datacatalog_v1/proto/datacatalog_pb2.py b/google/cloud/datacatalog_v1/proto/datacatalog_pb2.py index 8c9990e5..bdc6bdd5 100644 --- a/google/cloud/datacatalog_v1/proto/datacatalog_pb2.py +++ b/google/cloud/datacatalog_v1/proto/datacatalog_pb2.py @@ -2865,9 +2865,8 @@ ``bigquery.dataset.project_id.dataset_id`` - ``datacatalog.en try.project_id.location_id.entry_group_id.entry_id`` ``*_id``\ s shoud satisfy the standard SQL rules for - identifiers. - https://cloud.google.com/bigquery/docs/reference/standard- - sql/lexical. + identifiers. https://cloud.google.com/bigquery/docs/reference + /standard-sql/lexical. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1.LookupEntryRequest) }, diff --git a/google/cloud/datacatalog_v1/proto/timestamps_pb2.py b/google/cloud/datacatalog_v1/proto/timestamps_pb2.py index c808405f..1104081b 100644 --- a/google/cloud/datacatalog_v1/proto/timestamps_pb2.py +++ b/google/cloud/datacatalog_v1/proto/timestamps_pb2.py @@ -121,7 +121,8 @@ { "DESCRIPTOR": _SYSTEMTIMESTAMPS, "__module__": "google.cloud.datacatalog_v1.proto.timestamps_pb2", - "__doc__": """Timestamps about this resource according to a particular system. + "__doc__": """Timestamps about this resource according to a particular + system. Attributes: diff --git a/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py b/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py index 635d29af..3b5fac26 100644 --- a/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py +++ b/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py @@ -272,22 +272,8 @@ def search_catalog( metadata=None, ): """ - Searches Data Catalog for multiple resources like entries, tags that - match a query. - - This is a custom method - (https://cloud.google.com/apis/design/custom_methods) and does not - return the complete resource, only the resource identifier and high - level fields. Clients can subsequentally call ``Get`` methods. - - Note that Data Catalog search queries do not guarantee full recall. - Query results that match your query may not be returned, even in - subsequent result pages. Also note that results returned (and not - returned) can vary across repeated search queries. - - See `Data Catalog Search - Syntax `__ - for more information. + Output only. Resource name of this policy tag, whose format is: + "projects/{project_number}/locations/{location_id}/taxonomies/{taxonomy_id}/policyTags/{id}". Example: >>> from google.cloud import datacatalog_v1beta1 @@ -319,32 +305,31 @@ def search_catalog( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Scope` - query (str): Required. The query string in search query syntax. The query must be - non-empty. - - Query strings can be simple as "x" or more qualified as: + query (str): The Data Catalog resource name of the entry in URL format. Example: - - name:x - - column:x - - description:y + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} - Note: Query tokens need to have a minimum of 3 characters for substring - matching to work correctly. See `Data Catalog Search - Syntax `__ - for more information. + Note that this Entry and its child resources may not actually be stored + in the location in this name. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page. - order_by (str): Specifies the ordering of results, currently supported - case-sensitive choices are: - - - ``relevance``, only supports descending - - ``last_modified_timestamp [asc|desc]``, defaults to descending if not - specified - - If not specified, defaults to ``relevance`` descending. + order_by (str): ``etag`` is used for optimistic concurrency control as a way to help + prevent simultaneous updates of a policy from overwriting each other. It + is strongly suggested that systems make use of the ``etag`` in the + read-modify-write cycle to perform policy updates in order to avoid race + conditions: An ``etag`` is returned in the response to ``getIamPolicy``, + and systems are expected to put that etag in the request to + ``setIamPolicy`` to ensure that their change will be applied to the same + version of the policy. + + If no ``etag`` is provided in the call to ``setIamPolicy``, then the + existing policy is overwritten. Due to blind-set semantics of an + etag-less policy, 'setIamPolicy' will not fail even if the incoming + policy version does not meet the requirements for modifying the stored + policy. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -406,24 +391,7 @@ def create_entry_group( metadata=None, ): """ - Creates an EntryGroup. - - An entry group contains logically related entries together with Cloud - Identity and Access Management policies that specify the users who can - create, edit, and view entries within the entry group. - - Data Catalog automatically creates an entry group for BigQuery entries - ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own - entry group to contain Cloud Storage fileset entries or custom type - entries, and the IAM policies associated with those entries. Entry - groups, like entries, can be searched. - - A maximum of 10,000 entry groups may be created per organization across - all locations. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Request message for ``LookupEntry``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -441,12 +409,19 @@ def create_entry_group( >>> response = client.create_entry_group(parent, entry_group_id, entry_group) Args: - parent (str): Required. The name of the project this entry group is in. Example: + parent (str): The resource this metadata entry refers to. - - projects/{project_id}/locations/{location} + For Google Cloud Platform resources, ``linked_resource`` is the `full + name of the + resource `__. + For example, the ``linked_resource`` for a table resource from BigQuery + is: - Note that this EntryGroup and its child resources may not actually be - stored in the location in this name. + - //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + + Output only when Entry is of type in the EntryType enum. For entries + with user_specified_type, this field is optional and defaults to an + empty string. entry_group_id (str): Required. The id of the entry group to create. The id must begin with a letter or underscore, contain only English letters, numbers and underscores, and be at most 64 characters. @@ -525,8 +500,30 @@ def get_entry_group( >>> response = client.get_entry_group(name) Args: - name (str): Required. The name of the entry group. For example, - ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. + name (str): Optional. The relative resource name pattern associated with this + resource type. The DNS prefix of the full resource name shouldn't be + specified here. + + The path pattern must follow the syntax, which aligns with HTTP binding + syntax: + + :: + + Template = Segment { "/" Segment } ; + Segment = LITERAL | Variable ; + Variable = "{" LITERAL "}" ; + + Examples: + + :: + + - "projects/{project}/topics/{topic}" + - "projects/{project}/knowledgeBases/{knowledge_base}" + + The components in braces correspond to the IDs for each resource in the + hierarchy. It is expected that, if multiple patterns are provided, the + same component name (e.g. "project") refers to IDs of the same type of + resource. read_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to return. If not set or empty, all fields are returned. If a dict is provided, it must be of the same form as the protobuf @@ -588,11 +585,7 @@ def delete_entry_group( metadata=None, ): """ - Deletes an EntryGroup. Only entry groups that do not contain entries - can be deleted. Users should enable the Data Catalog API in the project - identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Request message for ``GetEntry``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -604,8 +597,11 @@ def delete_entry_group( >>> client.delete_entry_group(name) Args: - name (str): Required. The name of the entry group. For example, - ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. + name (str): The full name of the cloud resource the entry belongs to. See: + https://cloud.google.com/apis/design/resource_names#full_resource_name. + Example: + + - ``//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId`` force (bool): Optional. If true, deletes all entries in the entry group. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will @@ -662,14 +658,8 @@ def create_entry( metadata=None, ): """ - Creates an entry. Only entries of 'FILESET' type or user-specified - type can be created. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). - - A maximum of 100,000 entries may be created per entry group. + For extensions, this is the name of the type being extended. It is + resolved in the same manner as type_name. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -687,12 +677,8 @@ def create_entry( >>> response = client.create_entry(parent, entry_id, entry) Args: - parent (str): Required. The name of the entry group this entry is in. Example: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} - - Note that this Entry and its child resources may not actually be stored - in the location in this name. + parent (str): Spec of a BigQuery table. This field should only be populated if + ``table_source_type`` is ``BIGQUERY_TABLE``. entry_id (str): Required. The id of the entry to create. entry (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Entry]): Required. The entry to create. @@ -757,10 +743,7 @@ def update_entry( metadata=None, ): """ - Updates an existing entry. Users should enable the Data Catalog API - in the project identified by the ``entry.name`` parameter (see [Data - Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) - for more information). + A ``TagTemplate``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -777,32 +760,10 @@ def update_entry( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Entry` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to update on the entry. If absent or empty, all - modifiable fields are updated. - - The following fields are modifiable: - - - For entries with type ``DATA_STREAM``: - - - ``schema`` - - - For entries with type ``FILESET`` - - - ``schema`` - - ``display_name`` - - ``description`` - - ``gcs_fileset_spec`` - - ``gcs_fileset_spec.file_patterns`` - - - For entries with ``user_specified_type`` - - - ``schema`` - - ``display_name`` - - ``description`` - - user_specified_type - - user_specified_system - - linked_resource - - source_system_timestamps + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The plural name used in the resource name, such as 'projects' for + the name of 'projects/{project}'. It is the same concept of the + ``plural`` field in k8s CRD spec + https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/ If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -864,11 +825,15 @@ def delete_entry( metadata=None, ): """ - Deletes an existing entry. Only entries created through - ``CreateEntry`` method can be deleted. Users should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The full name of the Google Cloud Platform resource the Data Catalog + entry represents. See: + https://cloud.google.com/apis/design/resource_names#full_resource_name. + Full names are case-sensitive. + + Examples: + + - //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + - //pubsub.googleapis.com/projects/projectId/topics/topicId Example: >>> from google.cloud import datacatalog_v1beta1 @@ -880,9 +845,21 @@ def delete_entry( >>> client.delete_entry(name) Args: - name (str): Required. The name of the entry. Example: + name (str): Set true to use the old proto1 MessageSet wire format for + extensions. This is provided for backwards-compatibility with the + MessageSet wire format. You should not use this for any other reason: + It's less efficient, has fewer features, and is more complicated. - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + The message must be defined exactly as follows: message Foo { option + message_set_wire_format = true; extensions 4 to max; } Note that the + message cannot have any defined fields; MessageSets only have + extensions. + + All extensions of your type must be singular messages; e.g. they cannot + be int32s, enums, or repeated messages. + + Because this is an option, the above two restrictions are not enforced + by the protocol compiler. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -948,9 +925,10 @@ def get_entry( >>> response = client.get_entry(name) Args: - name (str): Required. The name of the entry. Example: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + name (str): The same concept of the ``singular`` field in k8s CRD spec + https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/ + Such as "project" for the ``resourcemanager.googleapis.com/Project`` + type. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1020,27 +998,26 @@ def lookup_entry( >>> response = client.lookup_entry() Args: - linked_resource (str): The full name of the Google Cloud Platform resource the Data Catalog - entry represents. See: - https://cloud.google.com/apis/design/resource_names#full_resource_name. - Full names are case-sensitive. - - Examples: - - - //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId - - //pubsub.googleapis.com/projects/projectId/topics/topicId - sql_resource (str): The SQL name of the entry. SQL names are case-sensitive. - - Examples: - - - ``cloud_pubsub.project_id.topic_id`` - - :literal:`pubsub.project_id.`topic.id.with.dots\`` - - ``bigquery.table.project_id.dataset_id.table_id`` - - ``bigquery.dataset.project_id.dataset_id`` - - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` - - ``*_id``\ s shoud satisfy the standard SQL rules for identifiers. - https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. + linked_resource (str): Gets the access control policy for a resource. A ``NOT_FOUND`` error + is returned if the resource does not exist. An empty policy is returned + if the resource exists but does not have a policy set on it. + + Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Cloud Pub/Sub and any external Google Cloud Platform + resources synced to Cloud Data Catalog. + + Callers must have following Google IAM permission + + - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag + templates. + - ``datacatalog.entries.getIamPolicy`` to get policies on entries. + - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry + groups. + sql_resource (str): Request message for ``UpdateTaxonomy``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1106,12 +1083,18 @@ def list_entry_groups( >>> response = client.list_entry_groups(parent) Args: - parent (str): Required. The name of the location that contains the entry groups, - which can be provided in URL format. Example: - - - projects/{project_id}/locations/{location} - page_size (int): Optional. The maximum number of items to return. Default is 10. Max - limit is 1000. Throws an invalid argument for ``page_size > 1000``. + parent (str): Entry type if it does not fit any of the input-allowed values listed + in ``EntryType`` enum above. When creating an entry, users should check + the enum values first, if nothing matches the entry to be created, then + provide a custom value, for example "my_special_type". + ``user_specified_type`` strings must begin with a letter or underscore + and can only contain letters, numbers, and underscores; are case + insensitive; must be at least 1 character and at most 64 characters + long. + + Currently, only FILESET enum value is allowed. All other entries created + through Data Catalog must use ``user_specified_type``. + page_size (int): Lists the tags on an ``Entry``. page_token (str): Optional. Token that specifies which page is requested. If empty, the first page is returned. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -1187,18 +1170,39 @@ def list_entries( >>> response = client.list_entries(parent) Args: - parent (str): Required. The name of the entry group that contains the entries, - which can be provided in URL format. Example: + parent (str): Creates an EntryGroup. - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} - page_size (int): The maximum number of items to return. Default is 10. Max limit is - 1000. Throws an invalid argument for ``page_size > 1000``. + An entry group contains logically related entries together with Cloud + Identity and Access Management policies that specify the users who can + create, edit, and view entries within the entry group. + + Data Catalog automatically creates an entry group for BigQuery entries + ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own + entry group to contain Cloud Storage fileset entries or custom type + entries, and the IAM policies associated with those entries. Entry + groups, like entries, can be searched. + + A maximum of 10,000 entry groups may be created per organization across + all locations. + + Users should enable the Data Catalog API in the project identified by + the ``parent`` parameter (see [Data Catalog Resource Project] + (/data-catalog/docs/concepts/resource-project) for more information). + page_size (int): Required. The name of the project and the template location + `region `__. + NOTE: Currently, only the ``us-central1 region`` is supported. + + Example: + + - projects/{project_id}/locations/us-central1 page_token (str): Token that specifies which page is requested. If empty, the first page is returned. - read_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to return for each Entry. If not set or empty, all fields - are returned. For example, setting read_mask to contain only one path - "name" will cause ListEntries to return a list of Entries with only - "name" field. + read_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Tags are used to attach custom metadata to Data Catalog resources. + Tags conform to the specifications within their tag template. + + See `Data Catalog + IAM `__ for + information on the permissions needed to create or view tags. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -1264,10 +1268,7 @@ def update_entry_group( metadata=None, ): """ - Updates an EntryGroup. The user should enable the Data Catalog API - in the project identified by the ``entry_group.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + An ``Entry``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1349,11 +1350,10 @@ def create_tag_template( metadata=None, ): """ - Creates a tag template. The user should enable the Data Catalog API - in the project identified by the ``parent`` parameter (see `Data Catalog - Resource - Project `__ - for more information). + The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more + information see `IAM + Overview `__. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1371,13 +1371,7 @@ def create_tag_template( >>> response = client.create_tag_template(parent, tag_template_id, tag_template) Args: - parent (str): Required. The name of the project and the template location - `region `__. - NOTE: Currently, only the ``us-central1 region`` is supported. - - Example: - - - projects/{project_id}/locations/us-central1 + parent (str): Request message for ``SearchCatalog``. tag_template_id (str): Required. The id of the tag template to create. tag_template (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplate]): Required. The tag template to create. @@ -1453,9 +1447,22 @@ def get_tag_template( >>> response = client.get_tag_template(name) Args: - name (str): Required. The name of the tag template. Example: - - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + name (str): Whether the message is an automatically generated map entry type for + the maps field. + + For maps fields: map map_field = 1; The parsed + descriptor looks like: message MapFieldEntry { option map_entry = true; + optional KeyType key = 1; optional ValueType value = 2; } repeated + MapFieldEntry map_field = 1; + + Implementations may choose not to generate the map_entry=true message, + but use a native map in the target language to hold the keys and values. + The reflection APIs in such implementations still need to work as if the + field is a repeated message field. + + NOTE: Do not set the option in .proto files. Always use the maps syntax + instead. The option should only be implicitly set by the proto compiler + parser. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1513,13 +1520,8 @@ def update_tag_template( metadata=None, ): """ - Updates a tag template. This method cannot be used to update the - fields of a template. The tag template fields are represented as - separate resources and should be updated using their own - create/update/delete methods. Users should enable the Data Catalog API - in the project identified by the ``tag_template.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + An annotation that describes a resource definition, see + ``ResourceDescriptor``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1536,13 +1538,29 @@ def update_tag_template( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplate` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The field mask specifies the parts of the template to overwrite. + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Specifies the identities requesting access for a Cloud Platform + resource. ``members`` can have the following values: + + - ``allUsers``: A special identifier that represents anyone who is on + the internet; with or without a Google account. + + - ``allAuthenticatedUsers``: A special identifier that represents + anyone who is authenticated with a Google account or a service + account. - Allowed fields: + - ``user:{emailid}``: An email address that represents a specific + Google account. For example, ``alice@example.com`` . - - ``display_name`` + - ``serviceAccount:{emailid}``: An email address that represents a + service account. For example, + ``my-other-app@appspot.gserviceaccount.com``. - If absent or empty, all of the allowed fields above will be updated. + - ``group:{emailid}``: An email address that represents a Google group. + For example, ``admins@example.com``. + + - ``domain:{domain}``: The G Suite domain (primary) that represents all + the users of that domain. For example, ``google.com`` or + ``example.com``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -1605,10 +1623,10 @@ def delete_tag_template( metadata=None, ): """ - Deletes a tag template and all tags using the template. Users should - enable the Data Catalog API in the project identified by the ``name`` - parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The relative resource name of the resource in URL format. Examples: + + - ``projects/{project_id}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}`` + - ``projects/{project_id}/tagTemplates/{tag_template_id}`` Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1623,12 +1641,47 @@ def delete_tag_template( >>> client.delete_tag_template(name, force) Args: - name (str): Required. The name of the tag template to delete. Example: - - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} - force (bool): Required. Currently, this field must always be set to ``true``. This - confirms the deletion of any possible tags using this template. - ``force = false`` will be supported in the future. + name (str): A Location identifies a piece of source code in a .proto file which + corresponds to a particular definition. This information is intended to + be useful to IDEs, code indexers, documentation generators, and similar + tools. + + For example, say we have a file like: message Foo { optional string foo + = 1; } Let's look at just the field definition: optional string foo = 1; + ^ ^^ ^^ ^ ^^^ a bc de f ghi We have the following locations: span path + represents [a,i) [ 4, 0, 2, 0 ] The whole field definition. [a,b) [ 4, + 0, 2, 0, 4 ] The label (optional). [c,d) [ 4, 0, 2, 0, 5 ] The type + (string). [e,f) [ 4, 0, 2, 0, 1 ] The name (foo). [g,h) [ 4, 0, 2, 0, 3 + ] The number (1). + + Notes: + + - A location may refer to a repeated field itself (i.e. not to any + particular index within it). This is used whenever a set of elements + are logically enclosed in a single code segment. For example, an + entire extend block (possibly containing multiple extension + definitions) will have an outer location whose path refers to the + "extensions" repeated field without an index. + - Multiple locations may have the same path. This happens when a single + logical declaration is spread out across multiple places. The most + obvious example is the "extend" block again -- there may be multiple + extend blocks in the same scope, each of which will have the same + path. + - A location's span is not always a subset of its parent's span. For + example, the "extendee" of an extension declaration appears at the + beginning of the "extend" block and is shared by all extensions + within the block. + - Just because a location's span is a subset of some other location's + span does not mean that it is a descendant. For example, a "group" + defines both a type and a field in a single declaration. Thus, the + locations corresponding to the type and field and their components + will overlap. + - Code which tries to interpret locations should probably be designed + to ignore those that it doesn't understand, as more types of + locations could be recorded in the future. + force (bool): Spec for a group of BigQuery tables with name pattern + ``[prefix]YYYYMMDD``. Context: + https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1684,11 +1737,7 @@ def create_tag_template_field( metadata=None, ): """ - Creates a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``parent`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + An ``EntryGroup``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1706,18 +1755,12 @@ def create_tag_template_field( >>> response = client.create_tag_template_field(parent, tag_template_field_id, tag_template_field) Args: - parent (str): Required. The name of the project and the template location - `region `__. - NOTE: Currently, only the ``us-central1 region`` is supported. - - Example: - - - projects/{project_id}/locations/us-central1/tagTemplates/{tag_template_id} - tag_template_field_id (str): Required. The ID of the tag template field to create. Field ids can - contain letters (both uppercase and lowercase), numbers (0-9), - underscores (_) and dashes (-). Field IDs must be at least 1 character - long and at most 128 characters long. Field IDs must also be unique - within their template. + parent (str): Required. Currently, this field must always be set to ``true``. This + confirms the deletion of any possible tags using this template. + ``force = false`` will be supported in the future. + tag_template_field_id (str): Output only. The table name prefix of the shards. The name of any + given shard is ``[table_prefix]YYYYMMDD``, for example, for shard + ``MyTable20180101``, the ``table_prefix`` is ``MyTable``. tag_template_field (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplateField]): Required. The tag template field to create. If a dict is provided, it must be of the same form as the protobuf @@ -1784,11 +1827,12 @@ def update_tag_template_field( metadata=None, ): """ - Updates a field in a tag template. This method cannot be used to - update the field type. Users should enable the Data Catalog API in the - project identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Creates a tag on an ``Entry``. Note: The project identified by the + ``parent`` parameter for the + `tag `__ + and the `tag + template `__ + used to create the tag must be from the same organization. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1803,27 +1847,26 @@ def update_tag_template_field( >>> response = client.update_tag_template_field(name, tag_template_field) Args: - name (str): Required. The name of the tag template field. Example: + name (str): Required. The name of the tag template. Example: - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} tag_template_field (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplateField]): Required. The template to update. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplateField` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Optional. The field mask specifies the parts of the template to be - updated. Allowed fields: + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Required. The query string in search query syntax. The query must be + non-empty. - - ``display_name`` - - ``type.enum_type`` - - ``is_required`` + Query strings can be simple as "x" or more qualified as: - If ``update_mask`` is not set or empty, all of the allowed fields above - will be updated. + - name:x + - column:x + - description:y - When updating an enum type, the provided values will be merged with the - existing values. Therefore, enum values can only be added, existing enum - values cannot be deleted nor renamed. Updating a template field from - optional to required is NOT allowed. + Note: Query tokens need to have a minimum of 3 characters for substring + matching to work correctly. See `Data Catalog Search + Syntax `__ + for more information. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -1886,11 +1929,18 @@ def rename_tag_template_field( metadata=None, ): """ - Renames a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + The SQL name of the entry. SQL names are case-sensitive. + + Examples: + + - ``cloud_pubsub.project_id.topic_id`` + - :literal:`pubsub.project_id.`topic.id.with.dots\`` + - ``bigquery.table.project_id.dataset_id.table_id`` + - ``bigquery.dataset.project_id.dataset_id`` + - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` + + ``*_id``\ s shoud satisfy the standard SQL rules for identifiers. + https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1905,11 +1955,12 @@ def rename_tag_template_field( >>> response = client.rename_tag_template_field(name, new_tag_template_field_id) Args: - name (str): Required. The name of the tag template. Example: + name (str): Required. The name of the entry group that contains the entries, + which can be provided in URL format. Example: - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} - new_tag_template_field_id (str): Required. The new ID of this tag template field. For example, - ``my_new_field``. + - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + new_tag_template_field_id (str): Output only. Resource name of this taxonomy, whose format is: + "projects/{project_number}/locations/{location_id}/taxonomies/{id}". retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1969,10 +2020,127 @@ def delete_tag_template_field( metadata=None, ): """ - Deletes a field in a tag template and all uses of that field. Users - should enable the Data Catalog API in the project identified by the - ``name`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + A simple descriptor of a resource type. + + ResourceDescriptor annotates a resource message (either by means of a + protobuf annotation or use in the service config), and associates the + resource's schema, the resource type, and the pattern of the resource + name. + + Example: + + :: + + message Topic { + // Indicates this message defines a resource schema. + // Declares the resource type in the format of {service}/{kind}. + // For Kubernetes resources, the format is {api group}/{kind}. + option (google.api.resource) = { + type: "pubsub.googleapis.com/Topic" + name_descriptor: { + pattern: "projects/{project}/topics/{topic}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + } + }; + } + + The ResourceDescriptor Yaml config will look like: + + :: + + resources: + - type: "pubsub.googleapis.com/Topic" + name_descriptor: + - pattern: "projects/{project}/topics/{topic}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + + Sometimes, resources have multiple patterns, typically because they can + live under multiple parents. + + Example: + + :: + + message LogEntry { + option (google.api.resource) = { + type: "logging.googleapis.com/LogEntry" + name_descriptor: { + pattern: "projects/{project}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + } + name_descriptor: { + pattern: "folders/{folder}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" + parent_name_extractor: "folders/{folder}" + } + name_descriptor: { + pattern: "organizations/{organization}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Organization" + parent_name_extractor: "organizations/{organization}" + } + name_descriptor: { + pattern: "billingAccounts/{billing_account}/logs/{log}" + parent_type: "billing.googleapis.com/BillingAccount" + parent_name_extractor: "billingAccounts/{billing_account}" + } + }; + } + + The ResourceDescriptor Yaml config will look like: + + :: + + resources: + - type: 'logging.googleapis.com/LogEntry' + name_descriptor: + - pattern: "projects/{project}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + - pattern: "folders/{folder}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" + parent_name_extractor: "folders/{folder}" + - pattern: "organizations/{organization}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Organization" + parent_name_extractor: "organizations/{organization}" + - pattern: "billingAccounts/{billing_account}/logs/{log}" + parent_type: "billing.googleapis.com/BillingAccount" + parent_name_extractor: "billingAccounts/{billing_account}" + + For flexible resources, the resource name doesn't contain parent names, + but the resource itself has parents for policy evaluation. + + Example: + + :: + + message Shelf { + option (google.api.resource) = { + type: "library.googleapis.com/Shelf" + name_descriptor: { + pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + } + name_descriptor: { + pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" + } + }; + } + + The ResourceDescriptor Yaml config will look like: + + :: + + resources: + - type: 'library.googleapis.com/Shelf' + name_descriptor: + - pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + - pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" Example: >>> from google.cloud import datacatalog_v1beta1 @@ -1987,12 +2155,14 @@ def delete_tag_template_field( >>> client.delete_tag_template_field(name, force) Args: - name (str): Required. The name of the tag template field to delete. Example: - - - projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} - force (bool): Required. Currently, this field must always be set to ``true``. This - confirms the deletion of this field from any tags using this field. - ``force = false`` will be supported in the future. + name (str): A taxonomy is a collection of policy tags that classify data along a + common axis. For instance a data *sensitivity* taxonomy could contain + policy tags denoting PII such as age, zipcode, and SSN. A data *origin* + taxonomy could contain policy tags to distinguish user data, employee + data, partner data, public data. + force (bool): Number of results in the search page. If <=0 then defaults to 10. + Max limit for page_size is 1000. Throws an invalid argument for + page_size > 1000. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -2047,12 +2217,7 @@ def create_tag( metadata=None, ): """ - Creates a tag on an ``Entry``. Note: The project identified by the - ``parent`` parameter for the - `tag `__ - and the `tag - template `__ - used to create the tag must be from the same organization. + Response message for ``ListTags``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -2067,13 +2232,8 @@ def create_tag( >>> response = client.create_tag(parent, tag) Args: - parent (str): Required. The name of the resource to attach this tag to. Tags can - be attached to Entries. Example: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} - - Note that this Tag and its child resources may not actually be stored in - the location in this name. + parent (str): The next_page_token value returned from a previous list request, if + any. If not set, defaults to an empty string. tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Tag]): Required. The tag to create. If a dict is provided, it must be of the same form as the protobuf @@ -2152,9 +2312,10 @@ def update_tag( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Tag` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The fields to update on the Tag. If absent or empty, all modifiable - fields are updated. Currently the only modifiable field is the field - ``fields``. + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): If ``true``, include Google Cloud Platform (GCP) public datasets in + the search results. Info on GCP public datasets is available at + https://cloud.google.com/public-datasets/. By default, GCP public + datasets are excluded. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -2226,9 +2387,22 @@ def delete_tag( >>> client.delete_tag(name) Args: - name (str): Required. The name of the tag to delete. Example: - - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + name (str): Identifies which part of the FileDescriptorProto was defined at this + location. + + Each element is a field number or an index. They form a path from the + root FileDescriptorProto to the place where the definition. For example, + this path: [ 4, 3, 2, 7, 1 ] refers to: file.message_type(3) // 4, 3 + .field(7) // 2, 7 .name() // 1 This is because + FileDescriptorProto.message_type has field number 4: repeated + DescriptorProto message_type = 4; and DescriptorProto.field has field + number 2: repeated FieldDescriptorProto field = 2; and + FieldDescriptorProto.name has field number 1: optional string name = 1; + + Thus, the above path gives the location of a field name. If we removed + the last element: [ 4, 3, 2, 7 ] this path refers to the whole field + declaration (from the beginning of the label to the terminating + semicolon). retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -2283,7 +2457,7 @@ def list_tags( metadata=None, ): """ - Lists the tags on an ``Entry``. + Request message for ``ExportTaxonomies``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -2307,13 +2481,22 @@ def list_tags( ... pass Args: - parent (str): Required. The name of the Data Catalog resource to list the tags of. - The resource could be an ``Entry`` or an ``EntryGroup``. + parent (str): Searches Data Catalog for multiple resources like entries, tags that + match a query. - Examples: + This is a custom method + (https://cloud.google.com/apis/design/custom_methods) and does not + return the complete resource, only the resource identifier and high + level fields. Clients can subsequentally call ``Get`` methods. - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} - - projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + Note that Data Catalog search queries do not guarantee full recall. + Query results that match your query may not be returned, even in + subsequent result pages. Also note that results returned (and not + returned) can vary across repeated search queries. + + See `Data Catalog Search + Syntax `__ + for more information. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -2390,22 +2573,7 @@ def set_iam_policy( metadata=None, ): """ - Sets the access control policy for a resource. Replaces any existing - policy. Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Cloud Pub/Sub and any external Google Cloud Platform - resources synced to Cloud Data Catalog. - - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag - templates. - - ``datacatalog.entries.setIamPolicy`` to set policies on entries. - - ``datacatalog.entryGroups.setIamPolicy`` to set policies on entry - groups. + Response message for ``TestIamPermissions`` method. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -2422,10 +2590,8 @@ def set_iam_policy( Args: resource (str): REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. - policy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Policy]): REQUIRED: The complete policy to be applied to the ``resource``. The - size of the policy is limited to a few 10s of KB. An empty policy is a - valid policy but certain Cloud Platform services (such as Projects) - might reject them. + policy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Policy]): Required. The name of the entry group. For example, + ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Policy` @@ -2486,25 +2652,14 @@ def get_iam_policy( metadata=None, ): """ - Gets the access control policy for a resource. A ``NOT_FOUND`` error - is returned if the resource does not exist. An empty policy is returned - if the resource exists but does not have a policy set on it. - - Supported resources are: + Entry Metadata. A Data Catalog Entry resource represents another + resource in Google Cloud Platform (such as a BigQuery dataset or a Cloud + Pub/Sub topic), or outside of Google Cloud Platform. Clients can use the + ``linked_resource`` field in the Entry resource to refer to the original + resource ID of the source system. - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Cloud Pub/Sub and any external Google Cloud Platform - resources synced to Cloud Data Catalog. - - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag - templates. - - ``datacatalog.entries.getIamPolicy`` to get policies on entries. - - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry - groups. + An Entry resource contains resource details, such as its schema. An + Entry can also be used to attach flexible metadata, such as a ``Tag``. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -2518,8 +2673,11 @@ def get_iam_policy( Args: resource (str): REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. - options_ (Union[dict, ~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to - ``GetIamPolicy``. This field is only used by Cloud IAM. + options_ (Union[dict, ~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions]): Renames a field in a tag template. The user should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + `Data Catalog Resource + Project `__ + for more information). If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions` @@ -2582,20 +2740,8 @@ def test_iam_permissions( metadata=None, ): """ - Returns the caller's permissions on a resource. If the resource does - not exist, an empty set of permissions is returned (We don't return a - ``NOT_FOUND`` error). - - Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Cloud Pub/Sub and any external Google Cloud Platform - resources synced to Cloud Data Catalog. - - A caller is not required to have Google IAM permission to make this - request. + If set, gives the index of a oneof in the containing type's + oneof_decl list. This field is a member of that oneof. Example: >>> from google.cloud import datacatalog_v1beta1 @@ -2612,10 +2758,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions - with wildcards (such as '*' or 'storage.*') are not allowed. For more - information see `IAM - Overview `__. + permissions (list[str]): An annotation that describes a resource reference, see + ``ResourceReference``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. diff --git a/google/cloud/datacatalog_v1beta1/gapic/enums.py b/google/cloud/datacatalog_v1beta1/gapic/enums.py index 9912b11a..a5dc5516 100644 --- a/google/cloud/datacatalog_v1beta1/gapic/enums.py +++ b/google/cloud/datacatalog_v1beta1/gapic/enums.py @@ -21,9 +21,37 @@ class EntryType(enum.IntEnum): """ - Entry resources in Data Catalog can be of different types e.g. a - BigQuery Table entry is of type ``TABLE``. This enum describes all the - possible types Data Catalog contains. + Protocol Buffers - Google's data interchange format Copyright 2008 + Google Inc. All rights reserved. + https://developers.google.com/protocol-buffers/ + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are + met: + + :: + + * Redistributions of source code must retain the above copyright + + notice, this list of conditions and the following disclaimer. \* + Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. \* + Neither the name of Google Inc. nor the names of its contributors may be + used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS + IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED + TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A + PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER + OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Attributes: ENTRY_TYPE_UNSPECIFIED (int): Default unknown type @@ -65,9 +93,20 @@ class SearchResultType(enum.IntEnum): Attributes: SEARCH_RESULT_TYPE_UNSPECIFIED (int): Default unknown type. - ENTRY (int): An ``Entry``. - TAG_TEMPLATE (int): A ``TagTemplate``. - ENTRY_GROUP (int): An ``EntryGroup``. + ENTRY (int): A designation of a specific field behavior (required, output only, + etc.) in protobuf messages. + + Examples: + + string name = 1 [(google.api.field_behavior) = REQUIRED]; State state = + 1 [(google.api.field_behavior) = OUTPUT_ONLY]; google.protobuf.Duration + ttl = 1 [(google.api.field_behavior) = INPUT_ONLY]; + google.protobuf.Timestamp expire_time = 1 [(google.api.field_behavior) = + OUTPUT_ONLY, (google.api.field_behavior) = IMMUTABLE]; + TAG_TEMPLATE (int): Request message for ``CreateEntry``. + ENTRY_GROUP (int): Optional. A column's mode indicates whether the values in this + column are required, nullable, etc. Only ``NULLABLE``, ``REQUIRED`` and + ``REPEATED`` are supported. Default mode is ``NULLABLE``. """ SEARCH_RESULT_TYPE_UNSPECIFIED = 0 diff --git a/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py b/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py index 15ef993d..a40da15a 100644 --- a/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py +++ b/google/cloud/datacatalog_v1beta1/gapic/policy_tag_manager_client.py @@ -355,15 +355,16 @@ def update_taxonomy( >>> response = client.update_taxonomy() Args: - taxonomy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Taxonomy]): The taxonomy to update. Only description, display_name, and - activated policy types can be updated. + taxonomy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Taxonomy]): Request message for ``CreateEntryGroup``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Taxonomy` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The update mask applies to the resource. For the ``FieldMask`` - definition, see - https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask - If not set, defaults to all of the fields that are allowed to update. + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Required. The name of the project this entry group is in. Example: + + - projects/{project_id}/locations/{location} + + Note that this EntryGroup and its child resources may not actually be + stored in the location in this name. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -441,8 +442,8 @@ def list_taxonomies( parent (str): Required. Resource name of the project to list the taxonomies of. page_size (int): The maximum number of items to return. Must be a value between 1 and 1000. If not set, defaults to 50. - page_token (str): The next_page_token value returned from a previous list request, if - any. If not set, defaults to an empty string. + page_token (str): Input and output type names. These are resolved in the same way as + FieldDescriptorProto.type_name, but must refer to a message type. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -718,18 +719,18 @@ def update_policy_tag( >>> response = client.update_policy_tag() Args: - policy_tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.PolicyTag]): The policy tag to update. Only the description, display_name, and - parent_policy_tag fields can be updated. + policy_tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.PolicyTag]): Resources like Entry can have schemas associated with them. This + scope allows users to attach tags to an individual column based on that + schema. + + For attaching a tag to a nested column, use ``.`` to separate the column + names. Example: + + - ``outer_column.inner_column`` If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.PolicyTag` - update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): The update mask applies to the resource. Only display_name, - description and parent_policy_tag can be updated and thus can be listed - in the mask. If update_mask is not provided, all allowed fields (i.e. - display_name, description and parent) will be updated. For more - information including the ``FieldMask`` definition, see - https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask - If not set, defaults to all of the fields that are allowed to update. + update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Associates ``members`` with a ``role``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask` @@ -806,8 +807,22 @@ def list_policy_tags( parent (str): Required. Resource name of the taxonomy to list the policy tags of. page_size (int): The maximum number of items to return. Must be a value between 1 and 1000. If not set, defaults to 50. - page_token (str): The next_page_token value returned from a previous List request, if - any. If not set, defaults to an empty string. + page_token (str): Sets the access control policy for a resource. Replaces any existing + policy. Supported resources are: + + - Tag templates. + - Entries. + - Entry groups. Note, this method cannot be used to manage policies for + BigQuery, Cloud Pub/Sub and any external Google Cloud Platform + resources synced to Cloud Data Catalog. + + Callers must have following Google IAM permission + + - ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag + templates. + - ``datacatalog.entries.setIamPolicy`` to set policies on entries. + - ``datacatalog.entryGroups.setIamPolicy`` to set policies on entry + groups. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -946,8 +961,11 @@ def get_iam_policy( Args: resource (str): REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. - options_ (Union[dict, ~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to - ``GetIamPolicy``. This field is only used by Cloud IAM. + options_ (Union[dict, ~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions]): Renames a field in a tag template. The user should enable the Data + Catalog API in the project identified by the ``name`` parameter (see + `Data Catalog Resource + Project `__ + for more information). If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions` @@ -1022,10 +1040,8 @@ def set_iam_policy( Args: resource (str): REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field. - policy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Policy]): REQUIRED: The complete policy to be applied to the ``resource``. The - size of the policy is limited to a few 10s of KB. An empty policy is a - valid policy but certain Cloud Platform services (such as Projects) - might reject them. + policy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Policy]): Required. The name of the entry group. For example, + ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.datacatalog_v1beta1.types.Policy` @@ -1099,10 +1115,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions - with wildcards (such as '*' or 'storage.*') are not allowed. For more - information see `IAM - Overview `__. + permissions (list[str]): An annotation that describes a resource reference, see + ``ResourceReference``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. diff --git a/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py b/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py index 5823352e..8ac41c97 100644 --- a/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py +++ b/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py @@ -111,22 +111,8 @@ def channel(self): def search_catalog(self): """Return the gRPC stub for :meth:`DataCatalogClient.search_catalog`. - Searches Data Catalog for multiple resources like entries, tags that - match a query. - - This is a custom method - (https://cloud.google.com/apis/design/custom_methods) and does not - return the complete resource, only the resource identifier and high - level fields. Clients can subsequentally call ``Get`` methods. - - Note that Data Catalog search queries do not guarantee full recall. - Query results that match your query may not be returned, even in - subsequent result pages. Also note that results returned (and not - returned) can vary across repeated search queries. - - See `Data Catalog Search - Syntax `__ - for more information. + Output only. Resource name of this policy tag, whose format is: + "projects/{project_number}/locations/{location_id}/taxonomies/{taxonomy_id}/policyTags/{id}". Returns: Callable: A callable which accepts the appropriate @@ -139,24 +125,7 @@ def search_catalog(self): def create_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_entry_group`. - Creates an EntryGroup. - - An entry group contains logically related entries together with Cloud - Identity and Access Management policies that specify the users who can - create, edit, and view entries within the entry group. - - Data Catalog automatically creates an entry group for BigQuery entries - ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own - entry group to contain Cloud Storage fileset entries or custom type - entries, and the IAM policies associated with those entries. Entry - groups, like entries, can be searched. - - A maximum of 10,000 entry groups may be created per organization across - all locations. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + Request message for ``LookupEntry``. Returns: Callable: A callable which accepts the appropriate @@ -182,11 +151,7 @@ def get_entry_group(self): def delete_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry_group`. - Deletes an EntryGroup. Only entry groups that do not contain entries - can be deleted. Users should enable the Data Catalog API in the project - identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Request message for ``GetEntry``. Returns: Callable: A callable which accepts the appropriate @@ -199,14 +164,8 @@ def delete_entry_group(self): def create_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_entry`. - Creates an entry. Only entries of 'FILESET' type or user-specified - type can be created. - - Users should enable the Data Catalog API in the project identified by - the ``parent`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). - - A maximum of 100,000 entries may be created per entry group. + For extensions, this is the name of the type being extended. It is + resolved in the same manner as type_name. Returns: Callable: A callable which accepts the appropriate @@ -219,10 +178,7 @@ def create_entry(self): def update_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_entry`. - Updates an existing entry. Users should enable the Data Catalog API - in the project identified by the ``entry.name`` parameter (see [Data - Catalog Resource Project] (/data-catalog/docs/concepts/resource-project) - for more information). + A ``TagTemplate``. Returns: Callable: A callable which accepts the appropriate @@ -235,11 +191,15 @@ def update_entry(self): def delete_entry(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_entry`. - Deletes an existing entry. Only entries created through - ``CreateEntry`` method can be deleted. Users should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The full name of the Google Cloud Platform resource the Data Catalog + entry represents. See: + https://cloud.google.com/apis/design/resource_names#full_resource_name. + Full names are case-sensitive. + + Examples: + + - //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + - //pubsub.googleapis.com/projects/projectId/topics/topicId Returns: Callable: A callable which accepts the appropriate @@ -306,10 +266,7 @@ def list_entries(self): def update_entry_group(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_entry_group`. - Updates an EntryGroup. The user should enable the Data Catalog API - in the project identified by the ``entry_group.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + An ``Entry``. Returns: Callable: A callable which accepts the appropriate @@ -322,11 +279,10 @@ def update_entry_group(self): def create_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template`. - Creates a tag template. The user should enable the Data Catalog API - in the project identified by the ``parent`` parameter (see `Data Catalog - Resource - Project `__ - for more information). + The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more + information see `IAM + Overview `__. Returns: Callable: A callable which accepts the appropriate @@ -352,13 +308,8 @@ def get_tag_template(self): def update_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template`. - Updates a tag template. This method cannot be used to update the - fields of a template. The tag template fields are represented as - separate resources and should be updated using their own - create/update/delete methods. Users should enable the Data Catalog API - in the project identified by the ``tag_template.name`` parameter (see - [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + An annotation that describes a resource definition, see + ``ResourceDescriptor``. Returns: Callable: A callable which accepts the appropriate @@ -371,10 +322,10 @@ def update_tag_template(self): def delete_tag_template(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template`. - Deletes a tag template and all tags using the template. Users should - enable the Data Catalog API in the project identified by the ``name`` - parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + The relative resource name of the resource in URL format. Examples: + + - ``projects/{project_id}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}`` + - ``projects/{project_id}/tagTemplates/{tag_template_id}`` Returns: Callable: A callable which accepts the appropriate @@ -387,11 +338,7 @@ def delete_tag_template(self): def create_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template_field`. - Creates a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``parent`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + An ``EntryGroup``. Returns: Callable: A callable which accepts the appropriate @@ -404,11 +351,12 @@ def create_tag_template_field(self): def update_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template_field`. - Updates a field in a tag template. This method cannot be used to - update the field type. Users should enable the Data Catalog API in the - project identified by the ``name`` parameter (see [Data Catalog Resource - Project] (/data-catalog/docs/concepts/resource-project) for more - information). + Creates a tag on an ``Entry``. Note: The project identified by the + ``parent`` parameter for the + `tag `__ + and the `tag + template `__ + used to create the tag must be from the same organization. Returns: Callable: A callable which accepts the appropriate @@ -421,11 +369,18 @@ def update_tag_template_field(self): def rename_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.rename_tag_template_field`. - Renames a field in a tag template. The user should enable the Data - Catalog API in the project identified by the ``name`` parameter (see - `Data Catalog Resource - Project `__ - for more information). + The SQL name of the entry. SQL names are case-sensitive. + + Examples: + + - ``cloud_pubsub.project_id.topic_id`` + - :literal:`pubsub.project_id.`topic.id.with.dots\`` + - ``bigquery.table.project_id.dataset_id.table_id`` + - ``bigquery.dataset.project_id.dataset_id`` + - ``datacatalog.entry.project_id.location_id.entry_group_id.entry_id`` + + ``*_id``\ s shoud satisfy the standard SQL rules for identifiers. + https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. Returns: Callable: A callable which accepts the appropriate @@ -438,10 +393,127 @@ def rename_tag_template_field(self): def delete_tag_template_field(self): """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template_field`. - Deletes a field in a tag template and all uses of that field. Users - should enable the Data Catalog API in the project identified by the - ``name`` parameter (see [Data Catalog Resource Project] - (/data-catalog/docs/concepts/resource-project) for more information). + A simple descriptor of a resource type. + + ResourceDescriptor annotates a resource message (either by means of a + protobuf annotation or use in the service config), and associates the + resource's schema, the resource type, and the pattern of the resource + name. + + Example: + + :: + + message Topic { + // Indicates this message defines a resource schema. + // Declares the resource type in the format of {service}/{kind}. + // For Kubernetes resources, the format is {api group}/{kind}. + option (google.api.resource) = { + type: "pubsub.googleapis.com/Topic" + name_descriptor: { + pattern: "projects/{project}/topics/{topic}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + } + }; + } + + The ResourceDescriptor Yaml config will look like: + + :: + + resources: + - type: "pubsub.googleapis.com/Topic" + name_descriptor: + - pattern: "projects/{project}/topics/{topic}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + + Sometimes, resources have multiple patterns, typically because they can + live under multiple parents. + + Example: + + :: + + message LogEntry { + option (google.api.resource) = { + type: "logging.googleapis.com/LogEntry" + name_descriptor: { + pattern: "projects/{project}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + } + name_descriptor: { + pattern: "folders/{folder}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" + parent_name_extractor: "folders/{folder}" + } + name_descriptor: { + pattern: "organizations/{organization}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Organization" + parent_name_extractor: "organizations/{organization}" + } + name_descriptor: { + pattern: "billingAccounts/{billing_account}/logs/{log}" + parent_type: "billing.googleapis.com/BillingAccount" + parent_name_extractor: "billingAccounts/{billing_account}" + } + }; + } + + The ResourceDescriptor Yaml config will look like: + + :: + + resources: + - type: 'logging.googleapis.com/LogEntry' + name_descriptor: + - pattern: "projects/{project}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + parent_name_extractor: "projects/{project}" + - pattern: "folders/{folder}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" + parent_name_extractor: "folders/{folder}" + - pattern: "organizations/{organization}/logs/{log}" + parent_type: "cloudresourcemanager.googleapis.com/Organization" + parent_name_extractor: "organizations/{organization}" + - pattern: "billingAccounts/{billing_account}/logs/{log}" + parent_type: "billing.googleapis.com/BillingAccount" + parent_name_extractor: "billingAccounts/{billing_account}" + + For flexible resources, the resource name doesn't contain parent names, + but the resource itself has parents for policy evaluation. + + Example: + + :: + + message Shelf { + option (google.api.resource) = { + type: "library.googleapis.com/Shelf" + name_descriptor: { + pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + } + name_descriptor: { + pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" + } + }; + } + + The ResourceDescriptor Yaml config will look like: + + :: + + resources: + - type: 'library.googleapis.com/Shelf' + name_descriptor: + - pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Project" + - pattern: "shelves/{shelf}" + parent_type: "cloudresourcemanager.googleapis.com/Folder" Returns: Callable: A callable which accepts the appropriate @@ -454,12 +526,7 @@ def delete_tag_template_field(self): def create_tag(self): """Return the gRPC stub for :meth:`DataCatalogClient.create_tag`. - Creates a tag on an ``Entry``. Note: The project identified by the - ``parent`` parameter for the - `tag `__ - and the `tag - template `__ - used to create the tag must be from the same organization. + Response message for ``ListTags``. Returns: Callable: A callable which accepts the appropriate @@ -498,7 +565,7 @@ def delete_tag(self): def list_tags(self): """Return the gRPC stub for :meth:`DataCatalogClient.list_tags`. - Lists the tags on an ``Entry``. + Request message for ``ExportTaxonomies``. Returns: Callable: A callable which accepts the appropriate @@ -511,22 +578,7 @@ def list_tags(self): def set_iam_policy(self): """Return the gRPC stub for :meth:`DataCatalogClient.set_iam_policy`. - Sets the access control policy for a resource. Replaces any existing - policy. Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Cloud Pub/Sub and any external Google Cloud Platform - resources synced to Cloud Data Catalog. - - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag - templates. - - ``datacatalog.entries.setIamPolicy`` to set policies on entries. - - ``datacatalog.entryGroups.setIamPolicy`` to set policies on entry - groups. + Response message for ``TestIamPermissions`` method. Returns: Callable: A callable which accepts the appropriate @@ -539,25 +591,14 @@ def set_iam_policy(self): def get_iam_policy(self): """Return the gRPC stub for :meth:`DataCatalogClient.get_iam_policy`. - Gets the access control policy for a resource. A ``NOT_FOUND`` error - is returned if the resource does not exist. An empty policy is returned - if the resource exists but does not have a policy set on it. - - Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Cloud Pub/Sub and any external Google Cloud Platform - resources synced to Cloud Data Catalog. + Entry Metadata. A Data Catalog Entry resource represents another + resource in Google Cloud Platform (such as a BigQuery dataset or a Cloud + Pub/Sub topic), or outside of Google Cloud Platform. Clients can use the + ``linked_resource`` field in the Entry resource to refer to the original + resource ID of the source system. - Callers must have following Google IAM permission - - - ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag - templates. - - ``datacatalog.entries.getIamPolicy`` to get policies on entries. - - ``datacatalog.entryGroups.getIamPolicy`` to get policies on entry - groups. + An Entry resource contains resource details, such as its schema. An + Entry can also be used to attach flexible metadata, such as a ``Tag``. Returns: Callable: A callable which accepts the appropriate @@ -570,20 +611,8 @@ def get_iam_policy(self): def test_iam_permissions(self): """Return the gRPC stub for :meth:`DataCatalogClient.test_iam_permissions`. - Returns the caller's permissions on a resource. If the resource does - not exist, an empty set of permissions is returned (We don't return a - ``NOT_FOUND`` error). - - Supported resources are: - - - Tag templates. - - Entries. - - Entry groups. Note, this method cannot be used to manage policies for - BigQuery, Cloud Pub/Sub and any external Google Cloud Platform - resources synced to Cloud Data Catalog. - - A caller is not required to have Google IAM permission to make this - request. + If set, gives the index of a oneof in the containing type's + oneof_decl list. This field is a member of that oneof. Returns: Callable: A callable which accepts the appropriate diff --git a/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py b/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py index 4785e799..9a36fadd 100644 --- a/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py @@ -2867,9 +2867,8 @@ ``bigquery.dataset.project_id.dataset_id`` - ``datacatalog.en try.project_id.location_id.entry_group_id.entry_id`` ``*_id``\ s shoud satisfy the standard SQL rules for - identifiers. - https://cloud.google.com/bigquery/docs/reference/standard- - sql/lexical. + identifiers. https://cloud.google.com/bigquery/docs/reference + /standard-sql/lexical. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.LookupEntryRequest) }, diff --git a/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py b/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py index 3a994f1e..ce0a321f 100644 --- a/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/policytagmanager_pb2.py @@ -1234,10 +1234,10 @@ be listed in the mask. If update_mask is not provided, all allowed fields (i.e. display_name, description and parent) will be updated. For more information including the - ``FieldMask`` definition, see - https://developers.google.com/protocol- - buffers/docs/reference/google.protobuf#fieldmask If not set, - defaults to all of the fields that are allowed to update. + ``FieldMask`` definition, see https://developers.google.com + /protocol-buffers/docs/reference/google.protobuf#fieldmask If + not set, defaults to all of the fields that are allowed to + update. """, # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdatePolicyTagRequest) }, diff --git a/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py b/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py index 9957a0ff..6eedb85a 100644 --- a/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py +++ b/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py @@ -121,7 +121,8 @@ { "DESCRIPTOR": _SYSTEMTIMESTAMPS, "__module__": "google.cloud.datacatalog_v1beta1.proto.timestamps_pb2", - "__doc__": """Timestamps about this resource according to a particular system. + "__doc__": """Timestamps about this resource according to a particular + system. Attributes: diff --git a/noxfile.py b/noxfile.py index b7e0c258..5a7bc23d 100644 --- a/noxfile.py +++ b/noxfile.py @@ -111,7 +111,6 @@ def system(session): # Install all test dependencies, then install this package into the # virtualenv's dist-packages. session.install("mock", "pytest") - session.install("-e", ".") # Run py.test against the system tests. @@ -156,7 +155,7 @@ def docs(session): """Build the docs for this library.""" session.install("-e", ".") - session.install("sphinx", "alabaster", "recommonmark") + session.install("sphinx<3.0.0", "alabaster", "recommonmark") shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True) session.run( diff --git a/setup.cfg b/setup.cfg index 3bd55550..c3a2b39f 100644 --- a/setup.cfg +++ b/setup.cfg @@ -1,3 +1,19 @@ +# -*- coding: utf-8 -*- +# +# Copyright 2020 Google LLC +# +# 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 +# +# https://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. + # Generated by synthtool. DO NOT EDIT! [bdist_wheel] universal = 1 diff --git a/synth.metadata b/synth.metadata index 5e89896a..6ce3841b 100644 --- a/synth.metadata +++ b/synth.metadata @@ -1,26 +1,27 @@ { - "updateTime": "2020-03-27T17:42:23.096126Z", + "updateTime": "2020-04-09T12:17:20.178566Z", "sources": [ { "git": { "name": ".", - "remote": "git@github.com:googleapis/python-datacatalog", - "sha": "9323589a08498263831913cdf4b8dfac0689f476" + "remote": "https://github.com/googleapis/python-datacatalog.git", + "sha": "21629fed1f86bb1a2800b5213f59acc5d862e2f5" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "48a166ce9f6e2a88b10947341b37336fe9dd3478", - "internalRef": "303302813" + "sha": "ee4ea76504aa60c2bff9b7c11269c155d8c21e0d", + "internalRef": "305619145", + "log": "ee4ea76504aa60c2bff9b7c11269c155d8c21e0d\ngapic-generator:\n- feat: Support extra plugin_args for php bazel rules rules (#3165)\n- feat: support '*' in resource definition (#3163)\n- fix: add null check and better error message when referenced resource is not found (#3169)\n\nresource name plugin:\n- support * annotation in resource def (#84)\n\nPiperOrigin-RevId: 305619145\n\ne4f4b23e07315492b533746e6a9255a1e6b3e748\nosconfig v1beta: fix the incorrect pattern for GuestPolicy resource and remove the obsolete history field.\n\nPiperOrigin-RevId: 305617619\n\nd741cd976975c745d0199987aff0e908b8352992\nchore: enable gapicv2 for firestore/v1 API\n\nNote that this contains breaking Java changes:\n com.google.cloud.firestore.v1.FirestoreClient: Method 'public void deleteDocument(com.google.firestore.v1.AnyPathName)' has been removed\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305561906\n\n0d69cddaa23b556e7299f84ad55a02ec1cad55a9\nchore: enable gapicv2 for firestore/admin/v1 API\n\nCommitter: @miraleung\n\nThere are the following breaking changes due to the collection_id discrepancy between [1] and [2]\n\n1. https://github.com/googleapis/googleapis/blob/6f8350c0df231d7e742fa10dbf929f33047715c9/google/firestore/admin/v1/firestore_gapic.yaml#L24-L29\n2. https://github.com/googleapis/googleapis/blob/6f8350c0df231d7e742fa10dbf929f33047715c9/google/firestore/admin/v1/field.proto#L39\n```\ncom.google.firestore.admin.v1.FieldName: Method 'public java.lang.String getCollectionId()' has been removed\ncom.google.firestore.admin.v1.FieldName: Method 'public java.lang.String getFieldId()' has been removed\ncom.google.firestore.admin.v1.FieldName$Builder: Method 'public java.lang.String getCollectionId()' has been removed\ncom.google.firestore.admin.v1.FieldName$Builder: Method 'public java.lang.String getFieldId()' has been removed\ncom.google.firestore.admin.v1.FieldName$Builder: Method 'public com.google.firestore.admin.v1.FieldName$Builder setCollectionId(java.lang.String)' has been removed\ncom.google.firestore.admin.v1.FieldName$Builder: Method 'public com.google.firestore.admin.v1.FieldName$Builder setFieldId(java.lang.String)' has been removed\ncom.google.firestore.admin.v1.IndexName: Method 'public java.lang.String getCollectionId()' has been removed\ncom.google.firestore.admin.v1.IndexName: Method 'public java.lang.String getIndexId()' has been removed\ncom.google.firestore.admin.v1.IndexName$Builder: Method 'public java.lang.String getCollectionId()' has been removed\ncom.google.firestore.admin.v1.IndexName$Builder: Method 'public java.lang.String getIndexId()' has been removed\ncom.google.firestore.admin.v1.IndexName$Builder: Method 'public com.google.firestore.admin.v1.IndexName$Builder setCollectionId(java.lang.String)' has been removed\ncom.google.firestore.admin.v1.IndexName$Builder: Method 'public com.google.firestore.admin.v1.IndexName$Builder setIndexId(java.lang.String)' has been removed\n```\n\nPiperOrigin-RevId: 305561114\n\n6f8350c0df231d7e742fa10dbf929f33047715c9\nchore: enable gapicv2 for firestore/v1beta1 API\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305537104\n\nd398d687aad9eab4c6ceee9cd5e012fa61f7e28c\ndocs: change relative URLs to absolute URLs to fix broken links.\n\nPiperOrigin-RevId: 305496764\n\n5520cb891a72ab0b0cbe3facaca7b012785f5b49\nchore: update gapic-generator to cd3c9ee7\n\nChanges include:\n* update generated nox file\n* fix generated license text alignment\n\nPiperOrigin-RevId: 305484038\n\nb20965f260d70e57b7dcd312cd356d6a81f31f8e\nUpdating retry configuration settings.\n\nPiperOrigin-RevId: 305431885\n\n83d7f20c06182cb6ada9a3b47daf17b2fd22b020\nMigrate dialogflow from gapic v1 to gapic v2.\nIncluding breaking changes (resource pattern change) introduced in cl/304043500.\n\ncommitter: @hzyi-google\nPiperOrigin-RevId: 305358314\n\nf8a97692250a6c781d87528995a5c72d41ca7762\nchore: enable gapic v2 and proto annotation for Grafeas API.\n\ncommitter: @noahdietz\nPiperOrigin-RevId: 305354660\n\nb1a5ca68468eb1587168972c9d15928e98ba92b0\nEnable gapicv2 for v1/osconfig\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305351235\n\nc803327f9b1dd2583b070645b5b86e5e7ead3161\nEnable gapicv2 for osconfig/agentendpoint/v1beta\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305350472\n\n99dddf1de598f95a71d3536f5c170d84f0c0ef87\nchore: enable gapicv2 for build/v1 API\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305349884\n\nbf85ee3ed64951c14b19ef8577689f43ee6f0f41\nchore: enable gapicv2 for cloudbuild/v1 API\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305349873\n\nf497c7aa912df121e11772767e667fdbc10a63d9\nchore: enable gapic v2 and proto annotation for Web Security Scanner v1alpha API.\n\ncommitter: @noahdietz\nPiperOrigin-RevId: 305349342\n\n0669a37c66d76bd413343da69420bb75c49062e7\nchore: rename unused GAPIC v1 configs for IAM to legacy\n\ncommitter: @noahdietz\nPiperOrigin-RevId: 305340308\n\naf7da29c24814a1c873c22f477e9dd8dd5a17b0b\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 305330079\n\n3f767aa32b4b3313027d05b503aaba63e0c432a3\ndocs: Update an out-of-date external link.\n\nPiperOrigin-RevId: 305329485\n\n9ede34d093b9d786a974448fc7a3a17948c203e2\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 305327985\n\n27daba50281357b676e1ba882422ebeab4ce4f92\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 305327500\n\n82de0f6f04649651958b96fbc5b0b39dd4dbbd01\nFix: Add missing resource name definition (from the Compute API).\n\nPiperOrigin-RevId: 305324763\n\n744591190e828440f72745aef217f883afd1fd71\ndocs: change relative URLs to absolute URLs to fix broken links.\n\nPiperOrigin-RevId: 305323909\n\n1247c135ceaedfe04261d27a64aaecf78ffbae74\nchore: enable gapicv2 for videointelligence/v1beta2 API\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305321976\n\n633c8b13227b9e3810749964d580e5be504db488\nchore: enable gapicv2 for videointelligence/v1p1beta1 API\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305320877\n\n29aac60f121dc43382b37ff92f2dbb692d94143a\ndocs: fix broken link to policy reference documentation.\n\nPiperOrigin-RevId: 305319540\n\n54ddbbf14c489b8a2f0731aa39408c016f5a8387\nbazel: update gapic-generator-go to v0.13.0\n\nChanges include:\n* add clientHook feature\n\nPiperOrigin-RevId: 305289945\n\n823facb4ca6a4b36b817ce955a790dcb40cf808f\nchore: enable gapicv2 for videointelligence/v1p3beta1\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305155214\n\n6b9c969d42bcb0f8206675bd868ed7d1ddcdaef9\nAdd API for bigqueryreservation v1.\n\nPiperOrigin-RevId: 305151484\n\n514f7d27811832a9f58b83d6f6305d894b097cf6\nchore: enable gapicv2 for phishingprotection/v1beta1 API\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305126983\n\nff74d47d47280e6bbcbad1a7c82b1e0959c472ec\nfix: PHP-related fixes in BUILD.bazel and service.yamls\n\nThis PR also adds the rules for all 7 langauges in OsLogin and Kms BUILD.bazel files. Those build files were missing rules for 5 langagues, including PHP.\n\nThis PR is the prerequisite for migrating PHP synth.py scripts from artman to bazel.\n\nThe fixes in service.yaml fix regression made during proto annotation migration. This became visible only during PHP generation, because only PHP depends on the affected sections of the service.yaml config.\n\nPiperOrigin-RevId: 305108224\n\nfdbc7b1f63969307c71143a0c24fdfd02e739df6\nEnable gapicv2 for osconfig/agentendpoint/v1\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305086443\n\n1490d30e1ae339570dd7826ba625a603ede91a08\nEnable gapicv2 for osconfig/v1beta\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305069755\n\n7bf824e82e5c3549642b150dc4a9579602000f34\nEnable gapicv2 for iam/credentials/v1\n\nCommitter: @miraleung\nPiperOrigin-RevId: 305065283\n\n9ff6fd3b22f99167827e89aae7778408b5e82425\nUpdates Dataproc v1 API:\n- Adds Dataproc Jobs.SubmitJobAsOperation RPC\n- Adds SparkR and Presto job types to WorkflowTemplates\n- Adds new Optional Components\n- Clarifies usage of some APIs\n\nPiperOrigin-RevId: 305053617\n\ncad0f5137a70d0d14a8d9acbfcee98e4cd3e9662\nUpdates to Dataproc v1beta2 API:\n- Adds SparkR and Presto job types to WorkflowTemplates\n- Adds new Optional Components\n- Clarifies usage of some APIs\n\nPiperOrigin-RevId: 305053062\n\na005f045a301535eeb4c4b3fa7bb94eec9d22a8b\nAdd support for Cloud EKM to the Cloud KMS service and resource protos.\n\nPiperOrigin-RevId: 305026790\n\n5077b1e4674afdbbf11dac3f5f43d36285ba53ff\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 304836531\n\nd6cb4997910eda04c0c66c0f2fd043eeaa0f660d\nchore: enable gapic v2 and proto annotation for documentai API.\n\ncommitter @summer-ji-eng\n\nPiperOrigin-RevId: 304724866\n\n490bc556608bfa5b1548c9374b06152fa33d657e\nEnable gapicv2 for devtools/remoteworkers/v1test2\n\nCommitter: @miraleung\nPiperOrigin-RevId: 304718691\n\n9f78ce31a5bd7f4a63e3cf0ddf28221557adb7ed\nEnable gapicv2 for managedidentities/v1beta1\n\nCommitter: @miraleung\nPiperOrigin-RevId: 304718676\n\n6e17d259b8e320bc51aa240cefef05ec753e2b83\ndocs: treat a dummy example URL as a string literal instead of a link\n\nPiperOrigin-RevId: 304716376\n\na8d76f99d3073aaccabdcc122c798a63e812c4fe\ndocs: change relative URLs to absolute URLs to fix broken links.\n\nPiperOrigin-RevId: 304702368\n\n65c749bc6a1d240416a0e6979381b67f97aff907\ndocs: fix formatting of some regexes and string literals.\n\nPiperOrigin-RevId: 304701150\n\n9119eefcd2b5ce845a680fa4ec4093ed733498f0\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 304698702\n\n62a2a7cc33d3535638d220df238823eefcca930d\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 304696461\n\n23848c8f64a5e81a239d6133378468185f1756dc\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 304696192\n\n9514fa9e390a4c0715972c5b510cf4c10ad049a1\ndocs: change relative URLs to absolute URLs to fix broken links.\n\nPiperOrigin-RevId: 304695334\n\n0f7b1509a9a452808c3d07fe90fedfcea763d7d5\nfix: change config_schema_version to 2.0.0 for containeranalysis v1 gapic config.\n\ncommitter: @hzyi-google\nPiperOrigin-RevId: 304672648\n\n3d52f3c126fbfc31f067a7f54737b7f0dfbce163\nDialogflow weekly v2 library update:\n- Change `parent` field's resource_reference to specify child_type instead of type per client library generation requirement;\n- Change Session with its child resource pattern to support both projects/{project}/agent/sessions/{session} and projects/{project}/agent/environments/{environment}/users/{user}/sessions/{session};\n- Fix `method_signature`\n- Regular documentation update\n\nImportant updates are also posted at:\nhttps://cloud.google.com/dialogflow/docs/release-notes\n\nPiperOrigin-RevId: 304635286\n\n4a6a01ce0ead505c245d11a2ce156de34800c58f\ndocs: change a relative URL to an absolute URL to fix broken links.\n\nPiperOrigin-RevId: 304633630\n\n1b969c28a6579265e89cd35e6c2ecacc89970e2d\nchore: set Ruby namespace in proto options\n\nPiperOrigin-RevId: 304620317\n\n5378173a889f9c7d83e36e52d38a6267190de692\nAdd v1beta2 SubmitJobAsOperation RPC to Dataproc.\n\nPiperOrigin-RevId: 304594381\n\n3d5d228a58bdf875e6147b228db3159010c735ee\nEnable visibility on the GetSnapshot and GetTopicSnapshots methods\n\nPiperOrigin-RevId: 304500143\n\n1346f5c11a0376bc82c5c03259b304de52671518\nRefresh public client library for Cloud Monitoring.\nIncrease default ListTimeSeries deadline to 90s.\n\nPiperOrigin-RevId: 304467075\n\n4a6cfccb4a32cb28db7366295d90078c6af3112f\ndocs: Fix link in monitoring summary description.\n\nPiperOrigin-RevId: 304438717\n\n6e2ea9a4b63a264090f1bd4b5b25766a3f634f3a\nfix: add interface name overrides back to logging gapic config.\n\ncommitter: @hzyi-google\nPiperOrigin-RevId: 304438432\n\n01f3ccbaa66cf3ae4e3b9fd140b1ecfbe54a3ed0\nFix: Add package/namespace options for C#, Ruby and PHP in remaining protos.\n\nPiperOrigin-RevId: 304416658\n\nb89abbf12cd3c086abddcd79adb0a653349f960a\nchore(google/maps): Rename nox.py to noxfile.py\n\nupstream wip fix here: https://github.com/googleapis/gapic-generator/pull/3156\n\nPiperOrigin-RevId: 304411146\n\nbbf26d7f11fae7789b13959bf100983c496c9807\nSynchronize new proto/yaml changes.\n\nPiperOrigin-RevId: 304409906\n\n75047719f704d61f405cac6d7439637ab36c1232\nfix Dataproc: add missing `REQUIRED` annotation.\n\nPiperOrigin-RevId: 304305096\n\n7e1b880fd5d477176cf9b0bb9b137b9bea56e787\nAdd Ruby/PHP namespace options\n\nPiperOrigin-RevId: 304288402\n\naba342359b6743353195ca53f944fe71e6fb6cd4\nchore: add java assembly target for accesscontextmanager BUILD.bazel\n\nPiperOrigin-RevId: 304207684\n\ndc65f39f33cb139b3a2244199a3e722a4d94b679\nFor Secret Manager v1 and v1beta1, noted Secret ID character limitations.\n\nPiperOrigin-RevId: 304035052\n\n2ee8c4d06db823c29a127709e66c35e38b6e98ab\nchore(deps): Update gax-java dependency\nThis is to integrate java11 incompatibility fix\n\nPiperOrigin-RevId: 304032057\n\nb5c94cec71ea9b840dc0110a0275323313ecc85a\nchore: add java assembly target for orgpolicy BUILD.bazel\n\nPiperOrigin-RevId: 304021854\n\n690f4d6344197fde775230cec165a9db3b3929c7\nchore: use the latest protoc-java-resource-name-plugin in third_party/googleapis WORKSPACE.\n- trace up only one level when calculating parent types with singleton resource names\n\nPiperOrigin-RevId: 304007414\n\n87144228bd9920b824996355f27891310fad5a32\nEnable gapic v2 for DLP.\n\nCommitter: @hzyi-google\nPiperOrigin-RevId: 303999064\n\n17cfae00f2bb51cb1683f017da7e295a1b0f01a8\nAdd a new AuthorizationType for Data Source Definition.\n\nPiperOrigin-RevId: 303992863\n\n6da3d64919c006ef40cad2026f1e39084253afe2\nfix(google/maps): Change importpath to developers.google.com/maps/go.\n\nPiperOrigin-RevId: 303976942\n\n2983dccde54f0ce31793e1e628379616c468aea0\nbuild(google/maps): only modify root build.gradle with ext plugin\n\nPiperOrigin-RevId: 303975876\n\n00f0a285f2716ce57e98afe500e450b17b556ff8\nfix: Integerate gapic-generator java_gapic rules Java11 fix\n\nPiperOrigin-RevId: 303899179\n\na62857d26bd2ae15aec13a9244989e4104195b63\nfix: add proto_package to the artman config of dataproc v1beta2 to make artman smoketest pass.\n\nPiperOrigin-RevId: 303853989\n\nf260ba248df934fd4ddc22950fb529a59d79e0b5\nchore: use the latest gapic-generator in googleapis WORKSPACE.\n- PHP multi-pattern resource name support.\n- Trace up only one level when calculating parent types with singleton resource names\n\nPiperOrigin-RevId: 303836059\n\n89c7d455fffa5d8a7e73c2f4da43a74605ed72a6\nfeat: Add client library options to OsConfigService v1 patch APIs.\n\nPiperOrigin-RevId: 303831150\n\na45b0a2a8f6f497547ab531a4da978c76441d076\ndataproc: add back non-default retry parameters.\ncommitter: @hzyi-google\n\nPiperOrigin-RevId: 303830177\n\nad895ce95f1f6d2261fbbc3e8897958294e4f017\nenable gapic v2 for containeranalysis.\ncommitter: @hzyi-google\n\nPiperOrigin-RevId: 303821111\n\nbaf83e521834b67397839bcbe2d7864b49e38787\nAdding \"resource_reference\" annotations to services.\n\nPiperOrigin-RevId: 303791704\n\n7be2811ad17013a5ea24cd75dfd9e399dd6e18fe\nfix: Update gapic-generator version to pickup discogapic fixes\n\nPiperOrigin-RevId: 303545940\n\nb655808b3481a92f478ae2f828a6ce8220e40f32\ncloudasset: add org policy and access context manager protos to client libraries.\n\nPiperOrigin-RevId: 303527638\n\nd8c5da9a9471659b51d5862dd2ea7ad3c4bc49ef\nPopulate BAZEL.build files for AccessContextManager.\n\nPiperOrigin-RevId: 303526825\n\ncf9db7161cb9d4dbef06cd8bf5354ec485e51e2d\nPopulate BAZEL.build files for OrgPolicy.\n\nPiperOrigin-RevId: 303526702\n\n558b800ed594acc02555cc560fbb39c0e42bc438\nchore: turn on gapic v2 for Dataproc API.\nfix:\n- add missing method signatures\n- remove resource_reference not on a string field\n- adjust resource name pattern orders\n\nPiperOrigin-RevId: 303431167\n\n8eb444cf5ff63f68d826acbb37b2ac3da58655fb\nAdd logging protos for Recommender v1beta1.\n\nPiperOrigin-RevId: 303426030\n\n" } }, { - "template": { - "name": "python_library", - "origin": "synthtool.gcp", - "version": "2020.2.4" + "git": { + "name": "synthtool", + "remote": "https://github.com/googleapis/synthtool.git", + "sha": "7f8e62aa3edd225f76347a16f92e400661fdfb52" } } ], From bcd0a5ea8314041dab85dbaf1f4efc28d5abdde0 Mon Sep 17 00:00:00 2001 From: "release-please[bot]" <55107282+release-please[bot]@users.noreply.github.com> Date: Thu, 9 Apr 2020 16:50:04 +0000 Subject: [PATCH 4/4] chore: release 0.7.0 (#15) :robot: I have created a release \*beep\* \*boop\* --- ## [0.7.0](https://www.github.com/googleapis/python-datacatalog/compare/v0.6.0...v0.7.0) (2020-04-09) ### Features * add v1 ([#13](https://www.github.com/googleapis/python-datacatalog/issues/13)) ([21629fe](https://www.github.com/googleapis/python-datacatalog/commit/21629fed1f86bb1a2800b5213f59acc5d862e2f5)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). --- CHANGELOG.md | 7 +++++++ setup.py | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d05cf66a..2e6ad743 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,13 @@ [1]: https://pypi.org/project/google-cloud-datacatalog/#history +## [0.7.0](https://www.github.com/googleapis/python-datacatalog/compare/v0.6.0...v0.7.0) (2020-04-09) + + +### Features + +* add v1 ([#13](https://www.github.com/googleapis/python-datacatalog/issues/13)) ([21629fe](https://www.github.com/googleapis/python-datacatalog/commit/21629fed1f86bb1a2800b5213f59acc5d862e2f5)) + ## [0.6.0](https://www.github.com/googleapis/python-datacatalog/compare/v0.5.0...v0.6.0) (2020-02-24) diff --git a/setup.py b/setup.py index 3820ab18..009ab623 100644 --- a/setup.py +++ b/setup.py @@ -21,7 +21,7 @@ name = "google-cloud-datacatalog" description = "Google Cloud Data Catalog API API client library" -version = "0.6.0" +version = "0.7.0" # Should be one of: # 'Development Status :: 3 - Alpha' # 'Development Status :: 4 - Beta'