google-cloud-service_directory-v1beta1 0.6.0 → 0.7.2

data/lib/google/cloud/service_directory/v1beta1/registration_service/paths.rb

@@ -83,6 +83,23 @@ module Google
               "projects/#{project}/locations/#{location}/namespaces/#{namespace}"
             end
 
+            ##
+            # Create a fully-qualified Network resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/global/networks/{network}`
+            #
+            # @param project [String]
+            # @param network [String]
+            #
+            # @return [::String]
+            def network_path project:, network:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/locations/global/networks/#{network}"
+            end
+
             ##
             # Create a fully-qualified Service resource string.
             #

data/lib/google/cloud/service_directory/v1beta1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ServiceDirectory
       module V1beta1
-        VERSION = "0.6.0"
+        VERSION = "0.7.2"
       end
     end
   end

data/lib/google/cloud/servicedirectory/v1beta1/endpoint_pb.rb

@@ -5,6 +5,7 @@ require 'google/protobuf'
 
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/protobuf/timestamp_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/servicedirectory/v1beta1/endpoint.proto", :syntax => :proto3) do
@@ -13,6 +14,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :address, :string, 2
       optional :port, :int32, 3
       map :metadata, :string, :string, 4
+      optional :network, :string, 5
+      optional :create_time, :message, 6, "google.protobuf.Timestamp"
+      optional :update_time, :message, 7, "google.protobuf.Timestamp"
     end
   end
 end

data/lib/google/cloud/servicedirectory/v1beta1/namespace_pb.rb

@@ -5,12 +5,15 @@ require 'google/protobuf'
 
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/protobuf/timestamp_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/servicedirectory/v1beta1/namespace.proto", :syntax => :proto3) do
     add_message "google.cloud.servicedirectory.v1beta1.Namespace" do
       optional :name, :string, 1
       map :labels, :string, :string, 2
+      optional :create_time, :message, 4, "google.protobuf.Timestamp"
+      optional :update_time, :message, 5, "google.protobuf.Timestamp"
     end
   end
 end

data/lib/google/cloud/servicedirectory/v1beta1/registration_service_services_pb.rb

@@ -47,7 +47,7 @@ module Google
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.servicedirectory.v1beta1.RegistrationService'
 
-            # Creates a namespace, and returns the new Namespace.
+            # Creates a namespace, and returns the new namespace.
             rpc :CreateNamespace, ::Google::Cloud::ServiceDirectory::V1beta1::CreateNamespaceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Namespace
             # Lists all namespaces.
             rpc :ListNamespaces, ::Google::Cloud::ServiceDirectory::V1beta1::ListNamespacesRequest, ::Google::Cloud::ServiceDirectory::V1beta1::ListNamespacesResponse
@@ -58,7 +58,7 @@ module Google
             # Deletes a namespace. This also deletes all services and endpoints in
             # the namespace.
             rpc :DeleteNamespace, ::Google::Cloud::ServiceDirectory::V1beta1::DeleteNamespaceRequest, ::Google::Protobuf::Empty
-            # Creates a service, and returns the new Service.
+            # Creates a service, and returns the new service.
             rpc :CreateService, ::Google::Cloud::ServiceDirectory::V1beta1::CreateServiceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Service
             # Lists all services belonging to a namespace.
             rpc :ListServices, ::Google::Cloud::ServiceDirectory::V1beta1::ListServicesRequest, ::Google::Cloud::ServiceDirectory::V1beta1::ListServicesResponse
@@ -69,15 +69,15 @@ module Google
             # Deletes a service. This also deletes all endpoints associated with
             # the service.
             rpc :DeleteService, ::Google::Cloud::ServiceDirectory::V1beta1::DeleteServiceRequest, ::Google::Protobuf::Empty
-            # Creates a endpoint, and returns the new Endpoint.
+            # Creates an endpoint, and returns the new endpoint.
             rpc :CreateEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::CreateEndpointRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Endpoint
             # Lists all endpoints.
             rpc :ListEndpoints, ::Google::Cloud::ServiceDirectory::V1beta1::ListEndpointsRequest, ::Google::Cloud::ServiceDirectory::V1beta1::ListEndpointsResponse
-            # Gets a endpoint.
+            # Gets an endpoint.
             rpc :GetEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::GetEndpointRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Endpoint
-            # Updates a endpoint.
+            # Updates an endpoint.
             rpc :UpdateEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::UpdateEndpointRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Endpoint
-            # Deletes a endpoint.
+            # Deletes an endpoint.
             rpc :DeleteEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::DeleteEndpointRequest, ::Google::Protobuf::Empty
             # Gets the IAM Policy for a resource (namespace or service only).
             rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy

data/lib/google/cloud/servicedirectory/v1beta1/service_pb.rb

@@ -6,6 +6,7 @@ require 'google/protobuf'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/servicedirectory/v1beta1/endpoint_pb'
+require 'google/protobuf/timestamp_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/servicedirectory/v1beta1/service.proto", :syntax => :proto3) do
@@ -13,6 +14,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       map :metadata, :string, :string, 2
       repeated :endpoints, :message, 3, "google.cloud.servicedirectory.v1beta1.Endpoint"
+      optional :create_time, :message, 6, "google.protobuf.Timestamp"
+      optional :update_time, :message, 7, "google.protobuf.Timestamp"
     end
   end
 end

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # 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
+      # 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
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

data/proto_docs/google/cloud/servicedirectory/v1beta1/endpoint.rb

@@ -27,26 +27,62 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Immutable. The resource name for the endpoint in the format
-        #     'projects/*/locations/*/namespaces/*/services/*/endpoints/*'.
+        #     `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
         # @!attribute [rw] address
         #   @return [::String]
-        #     Optional. An IPv4 or IPv6 address. Service Directory will reject bad
-        #     addresses like:
-        #       "8.8.8"
-        #       "8.8.8.8:53"
-        #       "test:bad:address"
-        #       "[::1]"
-        #       "[::1]:8080"
+        #     Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like:
+        #
+        #     *   `8.8.8`
+        #     *   `8.8.8.8:53`
+        #     *   `test:bad:address`
+        #     *   `[::1]`
+        #     *   `[::1]:8080`
+        #
         #     Limited to 45 characters.
         # @!attribute [rw] port
         #   @return [::Integer]
-        #     Optional. Service Directory will reject values outside of [0, 65535].
+        #     Optional. Service Directory rejects values outside of `[0, 65535]`.
         # @!attribute [rw] metadata
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. Metadata for the endpoint. This data can be consumed by service
-        #     clients.  The entire metadata dictionary may contain up to 512 characters,
-        #     spread accoss all key-value pairs. Metadata that goes beyond any these
-        #     limits will be rejected.
+        #     clients.
+        #
+        #     Restrictions:
+        #
+        #     *   The entire metadata dictionary may contain up to 512 characters,
+        #         spread accoss all key-value pairs. Metadata that goes beyond this
+        #         limit are rejected
+        #     *   Valid metadata keys have two segments: an optional prefix and name,
+        #         separated by a slash (/). The name segment is required and must be 63
+        #         characters or less, beginning and ending with an alphanumeric character
+        #         ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and
+        #         alphanumerics between. The prefix is optional. If specified, the prefix
+        #         must be a DNS subdomain: a series of DNS labels separated by dots (.),
+        #         not longer than 253 characters in total, followed by a slash (/).
+        #         Metadata that fails to meet these requirements are rejected
+        #     *   The `(*.)google.com/` and `(*.)googleapis.com/` prefixes are reserved
+        #         for system metadata managed by Service Directory. If the user tries
+        #         to write to these keyspaces, those entries are silently ignored by
+        #         the system
+        #
+        #     Note: This field is equivalent to the `annotations` field in the v1 API.
+        #     They have the same syntax and read/write to the same location in Service
+        #     Directory.
+        # @!attribute [rw] network
+        #   @return [::String]
+        #     Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
+        #     `projects/<project number>/locations/global/networks/*`.
+        #
+        #     The project must be specified by project number (project id is rejected).
+        #     Incorrectly formatted networks are rejected, but no other validation
+        #     is performed on this field (ex. network or project existence, reachability,
+        #     or permissions).
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the endpoint was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the endpoint was last updated.
         class Endpoint
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/servicedirectory/v1beta1/lookup_service.rb

@@ -35,22 +35,37 @@ module Google
         #   @return [::String]
         #     Optional. The filter applied to the endpoints of the resolved service.
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name" or "metadata.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS and is
-        #     roughly the same as "=".
-        #     <value> must be the same data type as the field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
+        #
+        #     *   `<field>` can be `name`, `address`, `port`, or `metadata.<key>` for
+        #         map field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "metadata.owner" returns Endpoints that have a label with the
-        #       key "owner", this is the same as "metadata:owner"
-        #     * "metadata.protocol=gRPC" returns Endpoints that have key/value
-        #       "protocol=gRPC"
-        #     * "metadata.owner!=sd AND metadata.foo=bar" returns
-        #       Endpoints that have "owner" field in metadata with a value that is not
-        #       "sd" AND have the key/value foo=bar.
+        #
+        #     *   `metadata.owner` returns endpoints that have a annotation with the key
+        #         `owner`, this is the same as `metadata:owner`
+        #     *   `metadata.protocol=gRPC` returns endpoints that have key/value
+        #         `protocol=gRPC`
+        #     *   `address=192.108.1.105` returns endpoints that have this address
+        #     *   `port>8080` returns endpoints that have port number larger than 8080
+        #     *
+        #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
+        #         returns endpoints that have name that is alphabetically later than the
+        #         string, so "endpoint-e" is returned but "endpoint-a" is not
+        #     *   `metadata.owner!=sd AND metadata.foo=bar` returns endpoints that have
+        #         `owner` in annotation key but value is not `sd` AND have key/value
+        #          `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that endpoint
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any endpoint, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         class ResolveServiceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/servicedirectory/v1beta1/namespace.rb

@@ -27,12 +27,18 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Immutable. The resource name for the namespace in the format
-        #     'projects/*/locations/*/namespaces/*'.
+        #     `projects/*/locations/*/namespaces/*`.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Optional. Resource labels associated with this Namespace.
-        #     No more than 64 user labels can be associated with a given resource.  Label
+        #     Optional. Resource labels associated with this namespace.
+        #     No more than 64 user labels can be associated with a given resource. Label
         #     keys and values can be no longer than 63 characters.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the namespace was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the namespace was last updated.
         class Namespace
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/servicedirectory/v1beta1/registration_service.rb

@@ -46,8 +46,8 @@ module Google
         # The request message for {::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#list_namespaces RegistrationService.ListNamespaces}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the project and location whose namespaces we'd like to
-        #     list.
+        #     Required. The resource name of the project and location whose namespaces you'd like
+        #     to list.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. The maximum number of items to return.
@@ -56,40 +56,45 @@ module Google
         #     Optional. The next_page_token value returned from a previous List request, if any.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. The filter to list result by.
+        #     Optional. The filter to list results by.
+        #
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name", or "labels.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
-        #     is roughly the same as "=".
-        #     <value> must be the same data type as field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     *   `<field>` can be `name` or `labels.<key>` for map field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "labels.owner" returns Namespaces that have a label with the key "owner"
-        #       this is the same as "labels:owner".
-        #     * "labels.protocol=gRPC" returns Namespaces that have key/value
-        #       "protocol=gRPC".
-        #     * "name>projects/my-project/locations/us-east/namespaces/namespace-c"
-        #       returns Namespaces that have name that is alphabetically later than the
-        #       string, so "namespace-e" will be returned but "namespace-a" will not be.
-        #     * "labels.owner!=sd AND labels.foo=bar" returns Namespaces that have
-        #       "owner" in label key but value is not "sd" AND have key/value foo=bar.
-        #     * "doesnotexist.foo=bar" returns an empty list. Note that Namespace doesn't
-        #       have a field called "doesnotexist". Since the filter does not match any
-        #       Namespaces, it returns no results.
+        #
+        #     *   `labels.owner` returns namespaces that have a label with the key
+        #         `owner`, this is the same as `labels:owner`
+        #     *   `labels.owner=sd` returns namespaces that have key/value `owner=sd`
+        #     *   `name>projects/my-project/locations/us-east1/namespaces/namespace-c`
+        #         returns namespaces that have name that is alphabetically later than the
+        #         string, so "namespace-e" is returned but "namespace-a" is not
+        #     *   `labels.owner!=sd AND labels.foo=bar` returns namespaces that have
+        #         `owner` in label key but value is not `sd` AND have key/value `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that namespace
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any namespaces, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. The order to list result by.
+        #     Optional. The order to list results by.
+        #
+        #     General `order_by` string syntax: `<field> (<asc|desc>) (,)`
         #
-        #     General order by string syntax:
-        #     <field> (<asc|desc>) (,)
-        #     <field> allows values \\{"name"}
-        #     <asc/desc> ascending or descending order by <field>. If this is left
-        #     blank, "asc" is used.
-        #     Note that an empty order_by string result in default order, which is order
-        #     by name in ascending order.
+        #     *   `<field>` allows value: `name`
+        #     *   `<asc|desc>` ascending or descending order by `<field>`. If this is
+        #         left blank, `asc` is used
+        #
+        #     Note that an empty `order_by` string results in default order, which is
+        #     order by `name` in ascending order.
         class ListNamespacesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -162,7 +167,7 @@ module Google
         # The request message for {::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#list_services RegistrationService.ListServices}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the namespace whose services we'd
+        #     Required. The resource name of the namespace whose services you'd
         #     like to list.
         # @!attribute [rw] page_size
         #   @return [::Integer]
@@ -173,32 +178,48 @@ module Google
         #     if any.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. The filter to list result by.
+        #     Optional. The filter to list results by.
+        #
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name", or "metadata.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
-        #     is roughly the same as "=".
-        #     <value> must be the same data type as field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     *   `<field>` can be `name` or `metadata.<key>` for map field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "metadata.owner" returns Services that have a label with the key "owner"
-        #       this is the same as "metadata:owner".
-        #     * "metadata.protocol=gRPC" returns Services that have key/value
-        #       "protocol=gRPC".
-        #     * "name>projects/my-project/locations/us-east/namespaces/my-namespace/services/service-c"
-        #       returns Services that have name that is alphabetically later than the
-        #       string, so "service-e" will be returned but "service-a" will not be.
-        #     * "metadata.owner!=sd AND metadata.foo=bar" returns Services that have
-        #       "owner" in label key but value is not "sd" AND have key/value foo=bar.
-        #     * "doesnotexist.foo=bar" returns an empty list. Note that Service doesn't
-        #       have a field called "doesnotexist". Since the filter does not match any
-        #       Services, it returns no results.
+        #
+        #     *   `metadata.owner` returns services that have a metadata with the key
+        #         `owner`, this is the same as `metadata:owner`
+        #     *   `metadata.protocol=gRPC` returns services that have key/value
+        #         `protocol=gRPC`
+        #     *
+        #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/service-c`
+        #         returns services that have name that is alphabetically later than the
+        #         string, so "service-e" is returned but "service-a" is not
+        #     *   `metadata.owner!=sd AND metadata.foo=bar` returns services that have
+        #         `owner` in metadata key but value is not `sd` AND have key/value
+        #         `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that service
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any services, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. The order to list result by.
+        #     Optional. The order to list results by.
+        #
+        #     General `order_by` string syntax: `<field> (<asc|desc>) (,)`
+        #
+        #     *   `<field>` allows value: `name`
+        #     *   `<asc|desc>` ascending or descending order by `<field>`. If this is
+        #         left blank, `asc` is used
+        #
+        #     Note that an empty `order_by` string results in default order, which is
+        #     order by `name` in ascending order.
         class ListServicesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -219,7 +240,7 @@ module Google
 
         # The request message for {::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#get_service RegistrationService.GetService}.
         # This should not be used for looking up a service. Insead, use the `resolve`
-        # method as it will contain all endpoints and associated metadata.
+        # method as it contains all endpoints and associated metadata.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The name of the service to get.
@@ -273,7 +294,7 @@ module Google
         # The request message for {::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#list_endpoints RegistrationService.ListEndpoints}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. The resource name of the service whose endpoints we'd like to
+        #     Required. The resource name of the service whose endpoints you'd like to
         #     list.
         # @!attribute [rw] page_size
         #   @return [::Integer]
@@ -284,34 +305,51 @@ module Google
         #     if any.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. The filter to list result by.
+        #     Optional. The filter to list results by.
         #
-        #     General filter string syntax:
-        #     <field> <operator> <value> (<logical connector>)
-        #     <field> can be "name", "address", "port" or "metadata.<key>" for map field.
-        #     <operator> can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
-        #     is roughly the same as "=".
-        #     <value> must be the same data type as field.
-        #     <logical connector> can be "AND, OR, NOT".
+        #     General `filter` string syntax:
+        #     `<field> <operator> <value> (<logical connector>)`
+        #
+        #     *   `<field>` can be `name`, `address`, `port`, or `metadata.<key>` for map
+        #         field
+        #     *   `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
+        #         means `HAS`, and is roughly the same as `=`
+        #     *   `<value>` must be the same data type as field
+        #     *   `<logical connector>` can be `AND`, `OR`, `NOT`
         #
         #     Examples of valid filters:
-        #     * "metadata.owner" returns Endpoints that have a label with the key "owner"
-        #       this is the same as "metadata:owner".
-        #     * "metadata.protocol=gRPC" returns Endpoints that have key/value
-        #       "protocol=gRPC".
-        #     * "address=192.108.1.105" returns Endpoints that have this address.
-        #     * "port>8080" returns Endpoints that have port number larger than 8080.
-        #     * "name>projects/my-project/locations/us-east/namespaces/my-namespace/services/my-service/endpoints/endpoint-c"
-        #       returns Endpoints that have name that is alphabetically later than the
-        #       string, so "endpoint-e" will be returned but "endpoint-a" will not be.
-        #     * "metadata.owner!=sd AND metadata.foo=bar" returns Endpoints that have
-        #       "owner" in label key but value is not "sd" AND have key/value foo=bar.
-        #     * "doesnotexist.foo=bar" returns an empty list. Note that Endpoint doesn't
-        #       have a field called "doesnotexist". Since the filter does not match any
-        #       Endpoints, it returns no results.
+        #
+        #     *   `metadata.owner` returns endpoints that have a metadata with the key
+        #         `owner`, this is the same as `metadata:owner`
+        #     *   `metadata.protocol=gRPC` returns endpoints that have key/value
+        #         `protocol=gRPC`
+        #     *   `address=192.108.1.105` returns endpoints that have this address
+        #     *   `port>8080` returns endpoints that have port number larger than 8080
+        #     *
+        #     `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
+        #         returns endpoints that have name that is alphabetically later than the
+        #         string, so "endpoint-e" is returned but "endpoint-a" is not
+        #     *   `metadata.owner!=sd AND metadata.foo=bar` returns endpoints that have
+        #         `owner` in metadata key but value is not `sd` AND have key/value
+        #          `foo=bar`
+        #     *   `doesnotexist.foo=bar` returns an empty list. Note that endpoint
+        #         doesn't have a field called "doesnotexist". Since the filter does not
+        #         match any endpoints, it returns no results
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. The order to list result by.
+        #     Optional. The order to list results by.
+        #
+        #     General `order_by` string syntax: `<field> (<asc|desc>) (,)`
+        #
+        #     *   `<field>` allows values: `name`, `address`, `port`
+        #     *   `<asc|desc>` ascending or descending order by `<field>`. If this is
+        #         left blank, `asc` is used
+        #
+        #     Note that an empty `order_by` string results in default order, which is
+        #     order by `name` in ascending order.
         class ListEndpointsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods