google-cloud-data_catalog-v1 0.4.5 → 0.7.1

data/lib/google/cloud/datacatalog/v1/policytagmanager_services_pb.rb

@@ -0,0 +1,86 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/datacatalog/v1/policytagmanager.proto for package 'Google.Cloud.DataCatalog.V1'
+# Original file comments:
+# Copyright 2021 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
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'grpc'
+require 'google/cloud/datacatalog/v1/policytagmanager_pb'
+
+module Google
+  module Cloud
+    module DataCatalog
+      module V1
+        module PolicyTagManager
+          # Policy Tag Manager API service allows clients to manage their policy tags and
+          # taxonomies.
+          #
+          # Policy tags are used to tag BigQuery columns and apply additional access
+          # control policies. A taxonomy is a hierarchical grouping of policy tags that
+          # classify data along a common axis.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.datacatalog.v1.PolicyTagManager'
+
+            # Creates a taxonomy in a specified project. The taxonomy is initially empty,
+            # i.e., does not contain policy tags.
+            rpc :CreateTaxonomy, ::Google::Cloud::DataCatalog::V1::CreateTaxonomyRequest, ::Google::Cloud::DataCatalog::V1::Taxonomy
+            # Deletes a taxonomy. This method will also delete all policy tags in this
+            # taxonomy, their associated policies, and the policy tags references from
+            # BigQuery columns.
+            rpc :DeleteTaxonomy, ::Google::Cloud::DataCatalog::V1::DeleteTaxonomyRequest, ::Google::Protobuf::Empty
+            # Updates a taxonomy. This method can update the taxonomy's display name,
+            # description, and activated policy types.
+            rpc :UpdateTaxonomy, ::Google::Cloud::DataCatalog::V1::UpdateTaxonomyRequest, ::Google::Cloud::DataCatalog::V1::Taxonomy
+            # Lists all taxonomies in a project in a particular location that the caller
+            # has permission to view.
+            rpc :ListTaxonomies, ::Google::Cloud::DataCatalog::V1::ListTaxonomiesRequest, ::Google::Cloud::DataCatalog::V1::ListTaxonomiesResponse
+            # Gets a taxonomy.
+            rpc :GetTaxonomy, ::Google::Cloud::DataCatalog::V1::GetTaxonomyRequest, ::Google::Cloud::DataCatalog::V1::Taxonomy
+            # Creates a policy tag in a taxonomy.
+            rpc :CreatePolicyTag, ::Google::Cloud::DataCatalog::V1::CreatePolicyTagRequest, ::Google::Cloud::DataCatalog::V1::PolicyTag
+            # Deletes a policy tag. This method also deletes:
+            #
+            # * all of its descendant policy tags, if any
+            # * the policies associated with the policy tag and its descendants
+            # * references from BigQuery table schema of the policy tag and its
+            #   descendants.
+            rpc :DeletePolicyTag, ::Google::Cloud::DataCatalog::V1::DeletePolicyTagRequest, ::Google::Protobuf::Empty
+            # Updates a policy tag. This method can update the policy tag's display
+            # name, description, and parent policy tag.
+            rpc :UpdatePolicyTag, ::Google::Cloud::DataCatalog::V1::UpdatePolicyTagRequest, ::Google::Cloud::DataCatalog::V1::PolicyTag
+            # Lists all policy tags in a taxonomy.
+            rpc :ListPolicyTags, ::Google::Cloud::DataCatalog::V1::ListPolicyTagsRequest, ::Google::Cloud::DataCatalog::V1::ListPolicyTagsResponse
+            # Gets a policy tag.
+            rpc :GetPolicyTag, ::Google::Cloud::DataCatalog::V1::GetPolicyTagRequest, ::Google::Cloud::DataCatalog::V1::PolicyTag
+            # Gets the IAM policy for a policy tag or a taxonomy.
+            rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy
+            # Sets the IAM policy for a policy tag or a taxonomy.
+            rpc :SetIamPolicy, ::Google::Iam::V1::SetIamPolicyRequest, ::Google::Iam::V1::Policy
+            # Returns the permissions that a caller has on a specified policy tag or
+            # taxonomy.
+            rpc :TestIamPermissions, ::Google::Iam::V1::TestIamPermissionsRequest, ::Google::Iam::V1::TestIamPermissionsResponse
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb

@@ -0,0 +1,70 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog/v1/policytagmanagerserialization.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
+require 'google/cloud/datacatalog/v1/policytagmanager_pb'
+require 'google/iam/v1/policy_pb'
+require 'google/api/client_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/datacatalog/v1/policytagmanagerserialization.proto", :syntax => :proto3) do
+    add_message "google.cloud.datacatalog.v1.SerializedTaxonomy" do
+      optional :display_name, :string, 1
+      optional :description, :string, 2
+      repeated :policy_tags, :message, 3, "google.cloud.datacatalog.v1.SerializedPolicyTag"
+      repeated :activated_policy_types, :enum, 4, "google.cloud.datacatalog.v1.Taxonomy.PolicyType"
+    end
+    add_message "google.cloud.datacatalog.v1.SerializedPolicyTag" do
+      optional :policy_tag, :string, 1
+      optional :display_name, :string, 2
+      optional :description, :string, 3
+      repeated :child_policy_tags, :message, 4, "google.cloud.datacatalog.v1.SerializedPolicyTag"
+    end
+    add_message "google.cloud.datacatalog.v1.ImportTaxonomiesRequest" do
+      optional :parent, :string, 1
+      oneof :source do
+        optional :inline_source, :message, 2, "google.cloud.datacatalog.v1.InlineSource"
+        optional :cross_regional_source, :message, 3, "google.cloud.datacatalog.v1.CrossRegionalSource"
+      end
+    end
+    add_message "google.cloud.datacatalog.v1.InlineSource" do
+      repeated :taxonomies, :message, 1, "google.cloud.datacatalog.v1.SerializedTaxonomy"
+    end
+    add_message "google.cloud.datacatalog.v1.CrossRegionalSource" do
+      optional :taxonomy, :string, 1
+    end
+    add_message "google.cloud.datacatalog.v1.ImportTaxonomiesResponse" do
+      repeated :taxonomies, :message, 1, "google.cloud.datacatalog.v1.Taxonomy"
+    end
+    add_message "google.cloud.datacatalog.v1.ExportTaxonomiesRequest" do
+      optional :parent, :string, 1
+      repeated :taxonomies, :string, 2
+      oneof :destination do
+        optional :serialized_taxonomies, :bool, 3
+      end
+    end
+    add_message "google.cloud.datacatalog.v1.ExportTaxonomiesResponse" do
+      repeated :taxonomies, :message, 1, "google.cloud.datacatalog.v1.SerializedTaxonomy"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module DataCatalog
+      module V1
+        SerializedTaxonomy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.SerializedTaxonomy").msgclass
+        SerializedPolicyTag = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.SerializedPolicyTag").msgclass
+        ImportTaxonomiesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ImportTaxonomiesRequest").msgclass
+        InlineSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.InlineSource").msgclass
+        CrossRegionalSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.CrossRegionalSource").msgclass
+        ImportTaxonomiesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ImportTaxonomiesResponse").msgclass
+        ExportTaxonomiesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ExportTaxonomiesRequest").msgclass
+        ExportTaxonomiesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ExportTaxonomiesResponse").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_services_pb.rb

@@ -0,0 +1,62 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/datacatalog/v1/policytagmanagerserialization.proto for package 'Google.Cloud.DataCatalog.V1'
+# Original file comments:
+# Copyright 2021 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
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'grpc'
+require 'google/cloud/datacatalog/v1/policytagmanagerserialization_pb'
+
+module Google
+  module Cloud
+    module DataCatalog
+      module V1
+        module PolicyTagManagerSerialization
+          # Policy Tag Manager serialization API service allows clients to manipulate
+          # their policy tags and taxonomies in serialized format, where taxonomy is a
+          # hierarchical group of policy tags.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.datacatalog.v1.PolicyTagManagerSerialization'
+
+            # Creates new taxonomies (including their policy tags) by importing from
+            # inlined source or cross-regional source. New taxonomies will be created in
+            # a given parent project.
+            #
+            # If using the cross-regional source, a new taxonomy is created by copying
+            # from a source in another region.
+            #
+            # If using the inlined source, this method provides a way to bulk create
+            # taxonomies and policy tags using nested proto structure.
+            rpc :ImportTaxonomies, ::Google::Cloud::DataCatalog::V1::ImportTaxonomiesRequest, ::Google::Cloud::DataCatalog::V1::ImportTaxonomiesResponse
+            # Exports taxonomies as the requested type and returns the taxonomies
+            # including their policy tags. The requested taxonomies must belong to one
+            # project.
+            #
+            # SerializedTaxonomy protos with nested policy tags that are generated by
+            # this method can be used as input for future ImportTaxonomies calls.
+            rpc :ExportTaxonomies, ::Google::Cloud::DataCatalog::V1::ExportTaxonomiesRequest, ::Google::Cloud::DataCatalog::V1::ExportTaxonomiesResponse
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/datacatalog/v1/search_pb.rb

@@ -13,6 +13,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :search_result_subtype, :string, 2
       optional :relative_resource_name, :string, 3
       optional :linked_resource, :string, 4
+      optional :modify_time, :message, 7, "google.protobuf.Timestamp"
+      optional :fully_qualified_name, :string, 10
       oneof :system do
         optional :integrated_system, :enum, 8, "google.cloud.datacatalog.v1.IntegratedSystem"
         optional :user_specified_system, :string, 9

data/lib/google/cloud/datacatalog/v1/table_spec_pb.rb

@@ -29,6 +29,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :TABLE_SOURCE_TYPE_UNSPECIFIED, 0
       value :BIGQUERY_VIEW, 2
       value :BIGQUERY_TABLE, 5
+      value :BIGQUERY_MATERIALIZED_VIEW, 7
     end
   end
 end

data/lib/google/cloud/datacatalog/v1/tags_pb.rb

@@ -41,6 +41,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :display_name, :string, 1
       optional :type, :message, 2, "google.cloud.datacatalog.v1.FieldType"
       optional :is_required, :bool, 3
+      optional :description, :string, 4
       optional :order, :int32, 5
     end
     add_message "google.cloud.datacatalog.v1.FieldType" do

data/proto_docs/google/api/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # This indicates that the field may be set once in a request to create a
       # resource, but may not be changed thereafter.
       IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
     end
   end
 end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # 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}"
+    #     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.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     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
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. 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/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     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.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/datacatalog/v1/common.rb

@@ -32,6 +32,9 @@ module Google
 
           # Cloud Pub/Sub.
           CLOUD_PUBSUB = 2
+
+          # Dataproc Metastore.
+          DATAPROC_METASTORE = 3
         end
       end
     end

data/proto_docs/google/cloud/datacatalog/v1/data_source.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module DataCatalog
+      module V1
+        # Describes the physical location of an entry.
+        # @!attribute [rw] service
+        #   @return [::Google::Cloud::DataCatalog::V1::DataSource::Service]
+        #     Service in which the data is physically stored.
+        # @!attribute [rw] resource
+        #   @return [::String]
+        #     Full name of the resource as defined by the service, e.g.
+        #     //bigquery.googleapis.com/projects/\\{project_id}/locations/\\{location}/datasets/\\{dataset_id}/tables/\\{table_id}
+        class DataSource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Service name where the data is stored.
+          module Service
+            # Default unknown service.
+            SERVICE_UNSPECIFIED = 0
+
+            # Google Cloud Storage service.
+            CLOUD_STORAGE = 1
+
+            # BigQuery service.
+            BIGQUERY = 2
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb

@@ -31,8 +31,8 @@ module Google
         #     return an error in such a case.
         # @!attribute [rw] query
         #   @return [::String]
-        #     Required. The query string in search query syntax. The query must be
-        #     non-empty.
+        #     Optional. The query string in search query syntax. An empty query string will result
+        #     in all data assets (in the specified scope) that the user has access to.
         #
         #     Query strings can be simple as "x" or more qualified as:
         #
@@ -51,8 +51,8 @@ module Google
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. Pagination token returned in an earlier
-        #     {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token},
-        #     which indicates that this is a continuation of a prior
+        #     {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}, which
+        #     indicates that this is a continuation of a prior
         #     {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#search_catalog SearchCatalogRequest}
         #     call, and that the system should return the next page of data. If empty,
         #     the first page is returned.
@@ -91,39 +91,14 @@ module Google
           #   @return [::Array<::String>]
           #     Optional. The list of locations to search within.
           #     1. If empty, search will be performed in all locations;
-          #     2. If any of the locations are NOT in the valid locations list, error
-          #     will be returned;
+          #     2. If any of the locations are NOT [supported
+          #     regions](https://cloud.google.com/data-catalog/docs/concepts/regions#supported_regions),
+          #     error will be returned;
           #     3. Otherwise, search only the given locations for matching results.
           #     Typical usage is to leave this field empty. When a location is
           #     unreachable as returned in the `SearchCatalogResponse.unreachable` field,
           #     users can repeat the search request with this parameter set to get
           #     additional information on the error.
-          #
-          #     Valid locations:
-          #      * asia-east1
-          #      * asia-east2
-          #      * asia-northeast1
-          #      * asia-northeast2
-          #      * asia-northeast3
-          #      * asia-south1
-          #      * asia-southeast1
-          #      * australia-southeast1
-          #      * eu
-          #      * europe-north1
-          #      * europe-west1
-          #      * europe-west2
-          #      * europe-west3
-          #      * europe-west4
-          #      * europe-west6
-          #      * global
-          #      * northamerica-northeast1
-          #      * southamerica-east1
-          #      * us
-          #      * us-central1
-          #      * us-east1
-          #      * us-east4
-          #      * us-west1
-          #      * us-west2
           class Scope
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -143,7 +118,7 @@ module Google
         #     Unreachable locations. Search result does not include data from those
         #     locations. Users can get additional information on the error by repeating
         #     the search request with a more restrictive parameter -- setting the value
-        #     for `SearchDataCatalogRequest.scope.include_locations`.
+        #     for `SearchDataCatalogRequest.scope.restricted_locations`.
         class SearchCatalogResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -153,17 +128,19 @@ module Google
         # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#create_entry_group CreateEntryGroup}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the project this entry group is in. Example:
+        #     Required. The name of the project this entry group belongs to. 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.
+        #     Note: The entry group itself and its child resources might not be
+        #     stored in the location specified in its name.
         # @!attribute [rw] entry_group_id
         #   @return [::String]
-        #     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.
+        #     Required. The ID of the entry group to create.
+        #
+        #     The ID must contain only letters (a-z, A-Z), numbers (0-9),
+        #     underscores (_), and must start with a letter or underscore.
+        #     The maximum size is 64 bytes when encoded in UTF-8.
         # @!attribute [rw] entry_group
         #   @return [::Google::Cloud::DataCatalog::V1::EntryGroup]
         #     The entry group to create. Defaults to an empty entry group.
@@ -179,8 +156,11 @@ module Google
         #     Required. The updated entry group. "name" field must be set.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     The fields to update on the entry group. If absent or empty, all modifiable
-        #     fields are updated.
+        #     Names of fields whose values to overwrite on an entry group.
+        #
+        #     If this parameter is absent or empty, all modifiable fields
+        #     are overwritten. If such fields are non-required and omitted in the
+        #     request body, their values are emptied.
         class UpdateEntryGroupRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -218,18 +198,18 @@ module Google
         # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#list_entry_groups ListEntryGroups}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the location that contains the entry groups, which
-        #     can be provided in URL format. Example:
+        #     Required. The name of the location that contains the entry groups, which can be
+        #     provided in URL format. Example:
         #
         #     * projects/\\{project_id}/locations/\\{location}
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. The maximum number of items to return. Default is 10. Max limit
-        #     is 1000. Throws an invalid argument for `page_size > 1000`.
+        #     Optional. The maximum number of items to return. Default is 10. Max limit is 1000.
+        #     Throws an invalid argument for `page_size > 1000`.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. Token that specifies which page is requested. If empty, the first
-        #     page is returned.
+        #     Optional. Token that specifies which page is requested. If empty, the first page is
+        #     returned.
         class ListEntryGroupsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -253,15 +233,19 @@ module Google
         # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#create_entry CreateEntry}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the entry group this entry is in. Example:
+        #     Required. The name of the entry group this entry belongs to. 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.
+        #     Note: The entry itself and its child resources might not be stored in
+        #     the location specified in its name.
         # @!attribute [rw] entry_id
         #   @return [::String]
-        #     Required. The id of the entry to create.
+        #     Required. The ID of the entry to create.
+        #
+        #     The ID must contain only letters (a-z, A-Z), numbers (0-9),
+        #     and underscores (_).
+        #     The maximum size is 64 bytes when encoded in UTF-8.
         # @!attribute [rw] entry
         #   @return [::Google::Cloud::DataCatalog::V1::Entry]
         #     Required. The entry to create.
@@ -277,26 +261,30 @@ module Google
         #     Required. The updated entry. The "name" field must be set.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     The fields to update on the entry. If absent or empty, all modifiable
-        #     fields are updated.
+        #     Names of fields whose values to overwrite on an entry.
+        #
+        #     If this parameter is absent or empty, all modifiable fields
+        #     are overwritten. If such fields are non-required and omitted in the
+        #     request body, their values are emptied.
         #
         #     The following fields are modifiable:
+        #
         #     * For entries with type `DATA_STREAM`:
         #        * `schema`
-        #     * For entries with type `FILESET`
+        #     * For entries with type `FILESET`:
         #        * `schema`
         #        * `display_name`
         #        * `description`
         #        * `gcs_fileset_spec`
         #        * `gcs_fileset_spec.file_patterns`
-        #     * For entries with `user_specified_type`
+        #     * For entries with `user_specified_type`:
         #        * `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`
         class UpdateEntryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -351,8 +339,25 @@ module Google
         #       * `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.
+        #     `*_id`s should satisfy the standard SQL rules for identifiers.
         #     https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical.
+        # @!attribute [rw] fully_qualified_name
+        #   @return [::String]
+        #     Fully qualified name (FQN) of the resource.
+        #
+        #     FQNs take two forms:
+        #
+        #     * For non-regionalized resources:
+        #
+        #       `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
+        #
+        #     * For regionalized resources:
+        #
+        #       `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
+        #
+        #     Example for a DPMS table:
+        #
+        #     `dataproc_metastore:project_id.location_id.instance_id.database_id.table_id`
         class LookupEntryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -368,14 +373,15 @@ module Google
         # An Entry resource contains resource details, such as its schema. An Entry can
         # also be used to attach flexible metadata, such as a
         # {::Google::Cloud::DataCatalog::V1::Tag Tag}.
-        # @!attribute [rw] name
+        # @!attribute [r] name
         #   @return [::String]
-        #     The Data Catalog resource name of the entry in URL format. Example:
+        #     Output only. The resource name of an entry in URL format.
+        #     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 Entry and its child resources may not actually be stored in
-        #     the location in this name.
+        #     Note: The entry itself and its child resources might not be
+        #     stored in the location specified in its name.
         # @!attribute [rw] linked_resource
         #   @return [::String]
         #     The resource this metadata entry refers to.
@@ -385,11 +391,37 @@ module Google
         #     resource](https://cloud.google.com/apis/design/resource_names#full_resource_name).
         #     For example, the `linked_resource` for a table resource from BigQuery is:
         #
-        #     * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId
+        #     `//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.
+        #     Output only when entry is one of the types in the `EntryType` enum.
+        #
+        #     For entries with a `user_specified_type`, this field is optional and
+        #     defaults to an empty string.
+        #
+        #     The resource string must contain only letters (a-z, A-Z), numbers (0-9),
+        #     underscores (_), periods (.), colons (:), slashes (/), dashes (-),
+        #     and hashes (#).
+        #     The maximum size is 200 bytes when encoded in UTF-8.
+        # @!attribute [rw] fully_qualified_name
+        #   @return [::String]
+        #     Fully qualified name (FQN) of the resource. Set automatically for entries
+        #     representing resources from synced systems. Settable only during creation
+        #     and read-only afterwards. Can be used for search and lookup of the entries.
+        #
+        #
+        #     FQNs take two forms:
+        #
+        #     * For non-regionalized resources:
+        #
+        #       `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
+        #
+        #     * For regionalized resources:
+        #
+        #       `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
+        #
+        #     Example for a DPMS table:
+        #
+        #     `dataproc_metastore:project_id.location_id.instance_id.database_id.table_id`
         # @!attribute [rw] type
         #   @return [::Google::Cloud::DataCatalog::V1::EntryType]
         #     The type of the entry.
@@ -408,8 +440,8 @@ module Google
         #     through Data Catalog must use `user_specified_type`.
         # @!attribute [r] integrated_system
         #   @return [::Google::Cloud::DataCatalog::V1::IntegratedSystem]
-        #     Output only. This field indicates the entry's source system that Data
-        #     Catalog integrates with, such as BigQuery or Pub/Sub.
+        #     Output only. This field indicates the entry's source system that Data Catalog
+        #     integrates with, such as BigQuery or Pub/Sub.
         # @!attribute [rw] user_specified_system
         #   @return [::String]
         #     This field indicates the entry's source system that Data Catalog does not
@@ -430,15 +462,28 @@ module Google
         #     Specification for a group of BigQuery tables with name pattern
         #     `[prefix]YYYYMMDD`. Context:
         #     https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding.
+        # @!attribute [rw] database_table_spec
+        #   @return [::Google::Cloud::DataCatalog::V1::DatabaseTableSpec]
+        #     Specification that applies to a table resource. Only valid
+        #     for entries of `TABLE` type.
         # @!attribute [rw] display_name
         #   @return [::String]
-        #     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.
+        #     Display name of an entry.
+        #
+        #     The name must contain only Unicode letters, numbers (0-9), underscores (_),
+        #     dashes (-), spaces ( ), and can't start or end with spaces.
+        #     The maximum size is 200 bytes when encoded in UTF-8.
+        #     Default value is an empty string.
         # @!attribute [rw] description
         #   @return [::String]
-        #     Entry description, which can consist of several sentences or paragraphs
-        #     that describe entry contents. Default value is an empty string.
+        #     Entry description that can consist of several sentences or paragraphs
+        #     that describe entry contents.
+        #
+        #     The description must not contain Unicode non-characters as well as C0
+        #     and C1 control codes except tabs (HT), new lines (LF), carriage returns
+        #     (CR), and page breaks (FF).
+        #     The maximum size is 2000 bytes when encoded in UTF-8.
+        #     Default value is an empty string.
         # @!attribute [rw] schema
         #   @return [::Google::Cloud::DataCatalog::V1::Schema]
         #     Schema of the entry. An entry might not have any schema attached to it.
@@ -448,11 +493,36 @@ module Google
         #     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.
+        # @!attribute [r] data_source
+        #   @return [::Google::Cloud::DataCatalog::V1::DataSource]
+        #     Output only. Physical location of the entry.
         class Entry
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Specification that applies to a table resource. Only valid
+        # for entries of `TABLE` type.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::DataCatalog::V1::DatabaseTableSpec::TableType]
+        #     Type of this table.
+        class DatabaseTableSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Type of the table.
+          module TableType
+            # Default unknown table type.
+            TABLE_TYPE_UNSPECIFIED = 0
+
+            # Native table.
+            NATIVE = 1
+
+            # External table.
+            EXTERNAL = 2
+          end
+        end
+
         # EntryGroup Metadata.
         # An EntryGroup resource represents a logical grouping of zero or more
         # Data Catalog {::Google::Cloud::DataCatalog::V1::Entry Entry} resources.
@@ -460,10 +530,10 @@ module Google
         #   @return [::String]
         #     The resource name of the entry group in URL format. Example:
         #
-        #     * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}
+        #     `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`
         #
-        #     Note that this EntryGroup and its child resources may not actually be
-        #     stored in the location in this name.
+        #     Note: The entry group itself and its child resources might not be
+        #     stored in the location specified in its name.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     A short name to identify the entry group, for example,
@@ -475,8 +545,7 @@ module Google
         #     string.
         # @!attribute [r] data_catalog_timestamps
         #   @return [::Google::Cloud::DataCatalog::V1::SystemTimestamps]
-        #     Output only. Timestamps about this EntryGroup. Default value is empty
-        #     timestamps.
+        #     Output only. Timestamps about this EntryGroup. Default value is empty timestamps.
         class EntryGroup
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -494,7 +563,11 @@ module Google
         #     * projects/\\{project_id}/locations/us-central1
         # @!attribute [rw] tag_template_id
         #   @return [::String]
-        #     Required. The id of the tag template to create.
+        #     Required. The ID of the tag template to create.
+        #
+        #     The ID must contain only lowercase letters (a-z), numbers (0-9),
+        #     or underscores (_), and must start with a letter or underscore.
+        #     The maximum size is 64 bytes when encoded in UTF-8.
         # @!attribute [rw] tag_template
         #   @return [::Google::Cloud::DataCatalog::V1::TagTemplate]
         #     Required. The tag template to create.
@@ -522,13 +595,12 @@ module Google
         #     Required. The template to update. The "name" field must be set.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     The field mask specifies the parts of the template to overwrite.
-        #
-        #     Allowed fields:
-        #
-        #       * `display_name`
+        #     Names of fields whose values to overwrite on a tag template. Currently,
+        #     only `display_name` can be overwritten.
         #
-        #     If absent or empty, all of the allowed fields above will be updated.
+        #     In general, if this parameter is absent or empty, all modifiable fields
+        #     are overwritten. If such fields are non-required and omitted in the
+        #     request body, their values are emptied.
         class UpdateTagTemplateRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -555,13 +627,13 @@ module Google
         # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#create_tag CreateTag}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the resource to attach this tag to. Tags can be
-        #     attached to Entries. Example:
+        #     Required. The name of the resource to attach this tag to. Tags can be attached to
+        #     entries. An entry can have up to 1000 attached tags. 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.
+        #     Note: The tag and its child resources might not be stored in
+        #     the location specified in its name.
         # @!attribute [rw] tag
         #   @return [::Google::Cloud::DataCatalog::V1::Tag]
         #     Required. The tag to create.
@@ -577,8 +649,12 @@ module Google
         #     Required. The updated tag. The "name" field must be set.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::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`.
+        #     Names of fields whose values to overwrite on a tag. Currently, a tag has
+        #     the only modifiable field with the name `fields`.
+        #
+        #     In general, if this parameter is absent or empty, all modifiable fields
+        #     are overwritten. If such fields are non-required and omitted in the
+        #     request body, their values are emptied.
         class UpdateTagRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -609,7 +685,10 @@ module Google
         # @!attribute [rw] tag_template_field_id
         #   @return [::String]
         #     Required. The ID of the tag template field to create.
-        #     Field ids can contain letters (both uppercase and lowercase), numbers
+        #
+        #     Note: Adding a required field to an existing template is *not* allowed.
+        #
+        #     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.
@@ -633,20 +712,22 @@ module Google
         #     Required. The template to update.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     Optional. The field mask specifies the parts of the template to be updated.
-        #     Allowed fields:
+        #     Optional. Names of fields whose values to overwrite on an individual field of a tag
+        #     template. The following fields are modifiable:
         #
         #       * `display_name`
         #       * `type.enum_type`
         #       * `is_required`
         #
-        #     If `update_mask` is not set or empty, all of the allowed fields above will
-        #     be updated.
+        #     If this parameter is absent or empty, all modifiable fields
+        #     are overwritten. If such fields are non-required and omitted in the request
+        #     body, their values are emptied with one exception: when updating an enum
+        #     type, the provided values are merged with the existing values. Therefore,
+        #     enum values can only be added, existing enum values cannot be deleted or
+        #     renamed.
         #
-        #     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.
+        #     Additionally, updating a template field from optional to required is
+        #     *not* allowed.
         class UpdateTagTemplateFieldRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -661,13 +742,27 @@ module Google
         #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}
         # @!attribute [rw] new_tag_template_field_id
         #   @return [::String]
-        #     Required. The new ID of this tag template field. For example,
-        #     `my_new_field`.
+        #     Required. The new ID of this tag template field. For example, `my_new_field`.
         class RenameTagTemplateFieldRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for
+        # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#rename_tag_template_field_enum_value RenameTagTemplateFieldEnumValue}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the enum field value. Example:
+        #
+        #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}/enumValues/\\{enum_value_display_name}
+        # @!attribute [rw] new_enum_value_display_name
+        #   @return [::String]
+        #     Required. The new display name of the enum value. For example, `my_new_enum_value`.
+        class RenameTagTemplateFieldEnumValueRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for
         # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#delete_tag_template_field DeleteTagTemplateField}.
         # @!attribute [rw] name
@@ -689,8 +784,8 @@ module Google
         # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#list_tags ListTags}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The name of the Data Catalog resource to list the tags of. The
-        #     resource could be an {::Google::Cloud::DataCatalog::V1::Entry Entry} or an
+        #     Required. The name of the Data Catalog resource to list the tags of. The resource
+        #     could be an {::Google::Cloud::DataCatalog::V1::Entry Entry} or an
         #     {::Google::Cloud::DataCatalog::V1::EntryGroup EntryGroup}.
         #
         #     Examples:
@@ -779,13 +874,19 @@ module Google
           # https://cloud.google.com/bigquery-ml/docs/bigqueryml-intro
           MODEL = 5
 
-          # Output only. An entry type which is used for streaming entries. Example:
+          # An entry type which is used for streaming entries. Example:
           # Pub/Sub topic.
           DATA_STREAM = 3
 
           # An entry type which is a set of files or objects. Example:
           # Cloud Storage fileset.
           FILESET = 4
+
+          # A database.
+          DATABASE = 7
+
+          # A service, for example, a Dataproc Metastore service.
+          SERVICE = 14
         end
       end
     end