google-cloud-dataplex-v1 0.3.0 → 0.5.0

data/lib/google/cloud/dataplex/v1/dataplex_service.rb

@@ -34,9 +34,9 @@ module Google
         ##
         # Dataplex service provides data lakes as a service. The primary resources
         # offered by this service are Lakes, Zones and Assets which collectively allow
-        # a data adminstrator to organize, manage, secure and catalog data across their
-        # organization located across cloud projects in a variety of storage systems
-        # including Cloud Storage and BigQuery.
+        # a data administrator to organize, manage, secure and catalog data across
+        # their organization located across cloud projects in a variety of storage
+        # systems including Cloud Storage and BigQuery.
         #
         # To load this service and instantiate a client:
         #

data/lib/google/cloud/dataplex/v1/logs_pb.rb

@@ -3,6 +3,7 @@
 
 require 'google/protobuf'
 
+require 'google/api/resource_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
 
@@ -33,6 +34,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :partition, :string, 1
       optional :entity, :string, 2
       optional :type, :enum, 3, "google.cloud.dataplex.v1.DiscoveryEvent.EntityType"
+      repeated :sampled_data_locations, :string, 4
     end
     add_message "google.cloud.dataplex.v1.DiscoveryEvent.ActionDetails" do
       optional :type, :string, 1
@@ -84,6 +86,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :user_id, :string, 2
       optional :session_id, :string, 3
       optional :type, :enum, 4, "google.cloud.dataplex.v1.SessionEvent.EventType"
+      optional :event_succeeded, :bool, 6
+      optional :fast_startup_enabled, :bool, 7
+      optional :unassigned_duration, :message, 8, "google.protobuf.Duration"
       oneof :detail do
         optional :query, :message, 5, "google.cloud.dataplex.v1.SessionEvent.QueryDetail"
       end
@@ -106,6 +111,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :START, 1
       value :STOP, 2
       value :QUERY, 3
+      value :CREATE, 4
     end
   end
 end

data/lib/google/cloud/dataplex/v1/metadata_service/client.rb

@@ -18,6 +18,8 @@
 
 require "google/cloud/errors"
 require "google/cloud/dataplex/v1/metadata_pb"
+require "google/cloud/location"
+require "google/iam/v1"
 
 module Google
   module Cloud
@@ -164,6 +166,18 @@ module Google
               @quota_project_id = @config.quota_project
               @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
 
+              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
+              @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
+                config.credentials = credentials
+                config.quota_project = @quota_project_id
+                config.endpoint = @config.endpoint
+              end
+
               @metadata_service_stub = ::Gapic::ServiceStub.new(
                 ::Google::Cloud::Dataplex::V1::MetadataService::Stub,
                 credentials:  credentials,
@@ -173,6 +187,20 @@ module Google
               )
             end
 
+            ##
+            # Get the associated client for mix-in of the Locations.
+            #
+            # @return [Google::Cloud::Location::Locations::Client]
+            #
+            attr_reader :location_client
+
+            ##
+            # Get the associated client for mix-in of the IAMPolicy.
+            #
+            # @return [Google::Iam::V1::IAMPolicy::Client]
+            #
+            attr_reader :iam_policy_client
+
             # Service calls
 
             ##
@@ -376,7 +404,8 @@ module Google
             #     Required. The resource name of the entity:
             #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}`.
             #   @param etag [::String]
-            #     Required. The etag associated with the partition if it was previously retrieved.
+            #     Required. The etag associated with the entity, which can be retrieved with a
+            #     [GetEntity][] request.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -570,8 +599,8 @@ module Google
             #     - Entity ID: ?filter="id=entityID"
             #     - Asset ID: ?filter="asset=assetID"
             #     - Data path ?filter="data_path=gs://my-bucket"
-            #     - Is HIVE compatible: ?filter=”hive_compatible=true”
-            #     - Is BigQuery compatible: ?filter=”bigquery_compatible=true”
+            #     - Is HIVE compatible: ?filter="hive_compatible=true"
+            #     - Is BigQuery compatible: ?filter="bigquery_compatible=true"
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Dataplex::V1::Entity>]
@@ -760,7 +789,7 @@ module Google
             #     The \\{partition_value_path} segment consists of an ordered sequence of
             #     partition values separated by "/". All values must be provided.
             #   @param etag [::String]
-            #     Optional. The etag associated with the partition if it was previously retrieved.
+            #     Optional. The etag associated with the partition.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -945,14 +974,14 @@ module Google
             #     provided to `ListPartitions` must match the call that provided the
             #     page token.
             #   @param filter [::String]
-            #     Optional. Filter the partitions returned to the caller using a key vslue pair
-            #     expression. The filter expression supports:
+            #     Optional. Filter the partitions returned to the caller using a key value pair
+            #     expression. Supported operators and syntax:
             #
-            #     - logical operators: AND, OR
+            #     - logic operators: AND, OR
             #     - comparison operators: <, >, >=, <= ,=, !=
             #     - LIKE operators:
-            #         - The right hand of a LIKE operator supports “.” and
-            #           “*” for wildcard searches, for example "value1 LIKE ".*oo.*"
+            #       - The right hand of a LIKE operator supports "." and
+            #         "*" for wildcard searches, for example "value1 LIKE ".*oo.*"
             #     - parenthetical grouping: ( )
             #
             #     Sample filter expression: `?filter="key1 < value1 OR key2 > value2"

data/lib/google/cloud/dataplex/v1/service_pb.rb

@@ -206,6 +206,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :parent, :string, 1
       optional :page_size, :int32, 2
       optional :page_token, :string, 3
+      optional :filter, :string, 4
     end
     add_message "google.cloud.dataplex.v1.ListSessionsResponse" do
       repeated :sessions, :message, 1, "google.cloud.dataplex.v1.Session"

data/lib/google/cloud/dataplex/v1/service_services_pb.rb

@@ -26,9 +26,9 @@ module Google
         module DataplexService
           # Dataplex service provides data lakes as a service. The primary resources
           # offered by this service are Lakes, Zones and Assets which collectively allow
-          # a data adminstrator to organize, manage, secure and catalog data across their
-          # organization located across cloud projects in a variety of storage systems
-          # including Cloud Storage and BigQuery.
+          # a data administrator to organize, manage, secure and catalog data across
+          # their organization located across cloud projects in a variety of storage
+          # systems including Cloud Storage and BigQuery.
           class Service
 
             include ::GRPC::GenericService

data/lib/google/cloud/dataplex/v1/tasks_pb.rb

@@ -22,8 +22,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       map :labels, :string, :string, 8
       optional :trigger_spec, :message, 100, "google.cloud.dataplex.v1.Task.TriggerSpec"
       optional :execution_spec, :message, 101, "google.cloud.dataplex.v1.Task.ExecutionSpec"
+      optional :execution_status, :message, 201, "google.cloud.dataplex.v1.Task.ExecutionStatus"
       oneof :config do
         optional :spark, :message, 300, "google.cloud.dataplex.v1.Task.SparkTaskConfig"
+        optional :notebook, :message, 302, "google.cloud.dataplex.v1.Task.NotebookTaskConfig"
       end
     end
     add_message "google.cloud.dataplex.v1.Task.InfrastructureSpec" do
@@ -42,6 +44,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :max_executors_count, :int32, 2
     end
     add_message "google.cloud.dataplex.v1.Task.InfrastructureSpec.ContainerImageRuntime" do
+      optional :image, :string, 1
       repeated :java_jars, :string, 2
       repeated :python_packages, :string, 3
       map :properties, :string, :string, 4
@@ -70,7 +73,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.dataplex.v1.Task.ExecutionSpec" do
       map :args, :string, :string, 4
       optional :service_account, :string, 5
+      optional :project, :string, 7
       optional :max_job_execution_lifetime, :message, 8, "google.protobuf.Duration"
+      optional :kms_key, :string, 9
     end
     add_message "google.cloud.dataplex.v1.Task.SparkTaskConfig" do
       repeated :file_uris, :string, 3
@@ -84,6 +89,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :sql_script, :string, 105
       end
     end
+    add_message "google.cloud.dataplex.v1.Task.NotebookTaskConfig" do
+      optional :notebook, :string, 4
+      optional :infrastructure_spec, :message, 3, "google.cloud.dataplex.v1.Task.InfrastructureSpec"
+      repeated :file_uris, :string, 5
+      repeated :archive_uris, :string, 6
+    end
+    add_message "google.cloud.dataplex.v1.Task.ExecutionStatus" do
+      optional :update_time, :message, 3, "google.protobuf.Timestamp"
+      optional :latest_job, :message, 9, "google.cloud.dataplex.v1.Job"
+    end
     add_message "google.cloud.dataplex.v1.Job" do
       optional :name, :string, 1
       optional :uid, :string, 2
@@ -124,6 +139,8 @@ module Google
         Task::TriggerSpec::Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Task.TriggerSpec.Type").enummodule
         Task::ExecutionSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Task.ExecutionSpec").msgclass
         Task::SparkTaskConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Task.SparkTaskConfig").msgclass
+        Task::NotebookTaskConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Task.NotebookTaskConfig").msgclass
+        Task::ExecutionStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Task.ExecutionStatus").msgclass
         Job = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Job").msgclass
         Job::Service = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Job.Service").enummodule
         Job::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataplex.v1.Job.State").enummodule

data/lib/google/cloud/dataplex/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Dataplex
       module V1
-        VERSION = "0.3.0"
+        VERSION = "0.5.0"
       end
     end
   end

data/proto_docs/google/cloud/dataplex/v1/logs.rb

@@ -102,6 +102,10 @@ module Google
           # @!attribute [rw] type
           #   @return [::Google::Cloud::Dataplex::V1::DiscoveryEvent::EntityType]
           #     The type of the containing entity resource.
+          # @!attribute [rw] sampled_data_locations
+          #   @return [::Array<::String>]
+          #     The locations of the data items (e.g., a Cloud Storage objects) sampled
+          #     for metadata inference.
           class PartitionDetails
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -237,7 +241,8 @@ module Google
         #     The log message.
         # @!attribute [rw] user_id
         #   @return [::String]
-        #     The information about the user that created the session.
+        #     The information about the user that created the session. It will be the
+        #     email address of the user.
         # @!attribute [rw] session_id
         #   @return [::String]
         #     Unique identifier for the session.
@@ -247,6 +252,16 @@ module Google
         # @!attribute [rw] query
         #   @return [::Google::Cloud::Dataplex::V1::SessionEvent::QueryDetail]
         #     The execution details of the query.
+        # @!attribute [rw] event_succeeded
+        #   @return [::Boolean]
+        #     The status of the event.
+        # @!attribute [rw] fast_startup_enabled
+        #   @return [::Boolean]
+        #     If the session is associated with an Environment with fast startup enabled,
+        #     and was pre-created before being assigned to a user.
+        # @!attribute [rw] unassigned_duration
+        #   @return [::Google::Protobuf::Duration]
+        #     The idle duration of a warm pooled session before it is assigned to user.
         class SessionEvent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -292,7 +307,7 @@ module Google
             # An unspecified event type.
             EVENT_TYPE_UNSPECIFIED = 0
 
-            # Event for start of a session.
+            # Event when the session is assigned to a user.
             START = 1
 
             # Event for stop of a session.
@@ -300,6 +315,10 @@ module Google
 
             # Query events in the session.
             QUERY = 3
+
+            # Event for creation of a cluster. It is not yet assigned to a user.
+            # This comes before START in the sequence
+            CREATE = 4
           end
         end
       end

data/proto_docs/google/cloud/dataplex/v1/metadata.rb

@@ -61,7 +61,8 @@ module Google
         #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}`.
         # @!attribute [rw] etag
         #   @return [::String]
-        #     Required. The etag associated with the partition if it was previously retrieved.
+        #     Required. The etag associated with the entity, which can be retrieved with a
+        #     [GetEntity][] request.
         class DeleteEntityRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -94,15 +95,16 @@ module Google
         #     - Entity ID: ?filter="id=entityID"
         #     - Asset ID: ?filter="asset=assetID"
         #     - Data path ?filter="data_path=gs://my-bucket"
-        #     - Is HIVE compatible: ?filter=”hive_compatible=true”
-        #     - Is BigQuery compatible: ?filter=”bigquery_compatible=true”
+        #     - Is HIVE compatible: ?filter="hive_compatible=true"
+        #     - Is BigQuery compatible: ?filter="bigquery_compatible=true"
         class ListEntitiesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Entity views.
           module EntityView
-            # The default unset value. The API will default to the FULL view.
+            # The default unset value. Return both table and fileset entities
+            # if unspecified.
             ENTITY_VIEW_UNSPECIFIED = 0
 
             # Only list table entities.
@@ -173,14 +175,14 @@ module Google
         #     page token.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. Filter the partitions returned to the caller using a key vslue pair
-        #     expression. The filter expression supports:
+        #     Optional. Filter the partitions returned to the caller using a key value pair
+        #     expression. Supported operators and syntax:
         #
-        #     - logical operators: AND, OR
+        #     - logic operators: AND, OR
         #     - comparison operators: <, >, >=, <= ,=, !=
         #     - LIKE operators:
-        #         - The right hand of a LIKE operator supports “.” and
-        #           “*” for wildcard searches, for example "value1 LIKE ".*oo.*"
+        #       - The right hand of a LIKE operator supports "." and
+        #         "*" for wildcard searches, for example "value1 LIKE ".*oo.*"
         #     - parenthetical grouping: ( )
         #
         #     Sample filter expression: `?filter="key1 < value1 OR key2 > value2"
@@ -224,7 +226,7 @@ module Google
         #     partition values separated by "/". All values must be provided.
         # @!attribute [rw] etag
         #   @return [::String]
-        #     Optional. The etag associated with the partition if it was previously retrieved.
+        #     Optional. The etag associated with the partition.
         class DeletePartitionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -262,7 +264,7 @@ module Google
         #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{id}`.
         # @!attribute [rw] display_name
         #   @return [::String]
-        #     Optional. Display name must be shorter than or equal to 63 characters.
+        #     Optional. Display name must be shorter than or equal to 256 characters.
         # @!attribute [rw] description
         #   @return [::String]
         #     Optional. User friendly longer description text. Must be shorter than or equal to
@@ -279,11 +281,12 @@ module Google
         #     published table name. Specifying a new ID in an update entity
         #     request will override the existing value.
         #     The ID must contain only letters (a-z, A-Z), numbers (0-9), and
-        #     underscores. Must begin with a letter.
+        #     underscores. Must begin with a letter and consist of 256 or fewer
+        #     characters.
         # @!attribute [rw] etag
         #   @return [::String]
-        #     Optional. The etag for this entity. Required for update and delete requests. Must
-        #     match the server's etag.
+        #     Optional. The etag associated with the entity, which can be retrieved with a
+        #     [GetEntity][] request. Required for update and delete requests.
         # @!attribute [rw] type
         #   @return [::Google::Cloud::Dataplex::V1::Entity::Type]
         #     Required. Immutable. The type of entity.
@@ -367,13 +370,11 @@ module Google
         # Represents partition metadata contained within entity instances.
         # @!attribute [r] name
         #   @return [::String]
-        #     Output only. The values must be HTML URL encoded two times before constructing the path.
-        #     For example, if you have a value of "US:CA", encoded it two times and you
-        #     get "US%253ACA". Then if you have the 2nd value is "CA#Sunnyvale", encoded
-        #     two times and you get "CA%2523Sunnyvale". The partition values path is
-        #     "US%253ACA/CA%2523Sunnyvale". The final URL will be
-        #     "https://.../partitions/US%253ACA/CA%2523Sunnyvale". The name field in the
-        #     responses will always have the encoded format.
+        #     Output only. Partition values used in the HTTP URL must be
+        #     double encoded. For example, `url_encode(url_encode(value))` can be used
+        #     to encode "US:CA/CA#Sunnyvale so that the request URL ends
+        #     with "/partitions/US%253ACA/CA%2523Sunnyvale".
+        #     The name field in the response retains the encoded format.
         # @!attribute [rw] values
         #   @return [::Array<::String>]
         #     Required. Immutable. The set of values representing the partition, which correspond to the
@@ -394,26 +395,23 @@ module Google
         # Schema information describing the structure and layout of the data.
         # @!attribute [rw] user_managed
         #   @return [::Boolean]
-        #     Required. Whether the schema is user-managed or managed by the service.
-        #     - Set user_manage to false if you would like Dataplex to help you manage
-        #     the schema. You will get the full service provided by Dataplex discovery,
-        #     including new data discovery, schema inference and schema evolution. You
-        #     can still provide input the schema of the entities, for example renaming a
-        #     schema field, changing CSV or Json options if you think the discovered
-        #     values are not as accurate. Dataplex will consider your input as the
-        #     initial schema (as if they were produced by the previous discovery run),
-        #     and will evolve schema or flag actions based on that.
-        #     - Set user_manage to true if you would like to fully manage the entity
-        #     schema by yourself. This is useful when you would like to manually specify
-        #     the schema for a table. In this case, the schema defined by the user is
-        #     guaranteed to be kept unchanged and would not be overwritten. But this also
-        #     means Dataplex will not provide schema evolution management for you.
-        #     Dataplex will still be able to manage partition registration (i.e., keeping
-        #     the list of partitions up to date) when Dataplex discovery is turned on and
-        #     user_managed is set to true.
+        #     Required. Set to `true` if user-managed or `false` if managed by Dataplex. The
+        #     default is `false` (managed by Dataplex).
+        #
+        #     - Set to `false`to enable Dataplex discovery to update the schema.
+        #       including new data discovery, schema inference, and schema evolution.
+        #       Users retain the ability to input and edit the schema. Dataplex
+        #       treats schema input by the user as though produced
+        #       by a previous Dataplex discovery operation, and it will
+        #       evolve the schema and take action based on that treatment.
+        #
+        #     - Set to `true` to fully manage the entity
+        #       schema. This setting guarantees that Dataplex will not
+        #       change schema fields.
         # @!attribute [rw] fields
         #   @return [::Array<::Google::Cloud::Dataplex::V1::Schema::SchemaField>]
         #     Optional. The sequence of fields describing data in table entities.
+        #     **Note:** BigQuery SchemaFields are immutable.
         # @!attribute [rw] partition_fields
         #   @return [::Array<::Google::Cloud::Dataplex::V1::Schema::PartitionField>]
         #     Optional. The sequence of fields describing the partition structure in entities.
@@ -428,8 +426,9 @@ module Google
           # Represents a column field within a table schema.
           # @!attribute [rw] name
           #   @return [::String]
-          #     Required. The name of the field. The maximum length is 767 characters. The name
-          #     must begins with a letter and not contains `:` and `.`.
+          #     Required. The name of the field. Must contain only letters, numbers and
+          #     underscores, with a maximum length of 767 characters,
+          #     and must begin with a letter or underscore.
           # @!attribute [rw] description
           #   @return [::String]
           #     Optional. User friendly field description. Must be less than or equal to 1024
@@ -450,11 +449,13 @@ module Google
 
           # Represents a key field within the entity's partition structure. You could
           # have up to 20 partition fields, but only the first 10 partitions have the
-          # filtering ability due to performance consideration.
+          # filtering ability due to performance consideration. **Note:**
+          # Partition fields are immutable.
           # @!attribute [rw] name
           #   @return [::String]
-          #     Required. Partition name is editable if only the partition style is not HIVE
-          #     compatible. The maximum length allowed is 767 characters.
+          #     Required. Partition field name must consist of letters, numbers, and underscores
+          #     only, with a maximum of length of 256 characters,
+          #     and must begin with a letter or underscore..
           # @!attribute [rw] type
           #   @return [::Google::Cloud::Dataplex::V1::Schema::Type]
           #     Required. Immutable. The type of field.
@@ -555,6 +556,7 @@ module Google
         #   @return [::String]
         #     Required. The mime type descriptor for the data. Must match the pattern
         #     \\{type}/\\{subtype}. Supported values:
+        #
         #     - application/x-parquet
         #     - application/x-avro
         #     - application/x-orc
@@ -590,8 +592,9 @@ module Google
           #     Optional. The delimiter used to separate values. Defaults to ','.
           # @!attribute [rw] quote
           #   @return [::String]
-          #     Optional. The character used to quote column values. Accepts '"' and '''.
-          #     Defaults to '"' if unspecified.
+          #     Optional. The character used to quote column values. Accepts '"'
+          #     (double quotation mark) or ''' (single quotation mark). Defaults to
+          #     '"' (double quotation mark) if unspecified.
           class CsvOptions
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/dataplex/v1/resources.rb

@@ -154,7 +154,7 @@ module Google
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The relative resource name of the zone, of the form:
-        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}`
+        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}`.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     Optional. User friendly display name.

data/proto_docs/google/cloud/dataplex/v1/service.rb

@@ -70,7 +70,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the lake:
-        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}`
+        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}`.
         class DeleteLakeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -123,7 +123,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the parent lake:
-        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}`
+        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of actions to return. The service may return fewer than this
@@ -292,7 +292,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the parent zone:
-        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}`
+        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}`.
         # @!attribute [rw] asset_id
         #   @return [::String]
         #     Required. Asset identifier.
@@ -536,7 +536,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the task:
-        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{tasks_id}`
+        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/tasks/{tasks_id}`.
         class GetTaskRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -600,7 +600,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the parent lake:
-        #     projects/\\{project_id}/locations/\\{location_id}/lakes/\\{lake_id}
+        #     `projects/{project_id}/locations/{location_id}/lakes/{lake_id}`.
         # @!attribute [rw] environment_id
         #   @return [::String]
         #     Required. Environment identifier.
@@ -642,7 +642,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the environment:
-        #     projects/\\{project_id}/locations/\\{location_id}/lakes/\\{lake_id}/environments/\\{environment_id}`
+        #     `projects/{project_id}/locations/{location_id}/lakes/{lake_id}/environments/{environment_id}`.
         class DeleteEnvironmentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -652,7 +652,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the parent lake:
-        #     projects/\\{project_id}/locations/\\{location_id}/lakes/\\{lake_id}
+        #     `projects/{project_id}/locations/{location_id}/lakes/{lake_id}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of environments to return. The service may return fewer than
@@ -692,7 +692,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the environment:
-        #     projects/\\{project_id}/locations/\\{location_id}/lakes/\\{lake_id}/environments/\\{environment_id}
+        #     `projects/{project_id}/locations/{location_id}/lakes/{lake_id}/environments/{environment_id}`.
         class GetEnvironmentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -702,7 +702,7 @@ module Google
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the parent environment:
-        #     projects/\\{project_number}/locations/\\{location_id}/lakes/\\{lake_id}/environment/\\{environment_id}
+        #     `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/environment/{environment_id}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of sessions to return. The service may return fewer than
@@ -714,6 +714,17 @@ module Google
         #     retrieve the subsequent page. When paginating, all other parameters
         #     provided to `ListSessions` must match the call that provided the page
         #     token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filter request. The following `mode` filter is supported to return only the
+        #     sessions belonging to the requester when the mode is USER and return
+        #     sessions of all the users when the mode is ADMIN. When no filter is sent
+        #     default to USER mode.
+        #     NOTE: When the mode is ADMIN, the requester should have
+        #     `dataplex.environments.listAllSessions` permission to list all sessions,
+        #     in absence of the permission, the request fails.
+        #
+        #     mode = ADMIN | USER
         class ListSessionsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods