google-cloud-service_directory-v1beta1 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 289a35f625ed3a5939f0351d28cd1e64fe90018261e8cd7a1bb7f12a6fd6934e
-  data.tar.gz: bd2b1d891bac45ee8c379bd951d0e88bebc1164c844456097891aeeb1c7b3b00
+  metadata.gz: 9dbd5753cd1f9cdaa0ef5ea57d5c720ebc2731900c3224c9a4296bfb50a942b0
+  data.tar.gz: 42125fbf91f807801f8171b3424538221d4a713b5233ac8c75e49e946506d2ae
 SHA512:
-  metadata.gz: b102661112782775c3078e48dc4a2ea34e91886107afb9e2d02d94a7415cf31ec6e64d09f472e539b176522cf3341faffb932dc827c7092a0c705eb0dad9312e
-  data.tar.gz: d58904adaaa3fe5f8cdc658e20f2ff56914169fe565802d14e6f4bf90df9ea7b987ccbe483d96d4f986944a4cb59e83deade76b5465934821698e341873b07dc
+  metadata.gz: 878b03786e5fb06d9dd4a1e829759a5f24496f80c1a76cc020ef42455f6b7286a5258c200682b1d6aa4f1a760affeff10527322b169d0e56ef4f89a50f60887c
+  data.tar.gz: '03561611104928b7ff027601d15b442359344c18ed55985d4e8de01dbf974a4403a4fddbc8778334d982a127a0ba16a258421a6cb55520c5ae9bb3eaf182cacb'

data/lib/google/cloud/service_directory/v1beta1/lookup_service/client.rb

@@ -187,22 +187,37 @@ module Google
             #   @param endpoint_filter [::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).
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::ServiceDirectory::V1beta1::ResolveServiceResponse]

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

@@ -173,7 +173,7 @@ module Google
             # Service calls
 
             ##
-            # Creates a namespace, and returns the new Namespace.
+            # Creates a namespace, and returns the new namespace.
             #
             # @overload create_namespace(request, options = nil)
             #   Pass arguments to `create_namespace` via a request object, either of type
@@ -268,46 +268,51 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::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.
             #   @param page_size [::Integer]
             #     Optional. The maximum number of items to return.
             #   @param page_token [::String]
             #     Optional. The next_page_token value returned from a previous List request, if any.
             #   @param filter [::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).
             #   @param order_by [::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.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ServiceDirectory::V1beta1::Namespace>]
@@ -557,7 +562,7 @@ module Google
             end
 
             ##
-            # Creates a service, and returns the new Service.
+            # Creates a service, and returns the new service.
             #
             # @overload create_service(request, options = nil)
             #   Pass arguments to `create_service` via a request object, either of type
@@ -651,7 +656,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::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.
             #   @param page_size [::Integer]
             #     Optional. The maximum number of items to return.
@@ -659,31 +664,47 @@ module Google
             #     Optional. The next_page_token value returned from a previous List request,
             #     if any.
             #   @param filter [::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).
             #   @param order_by [::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.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ServiceDirectory::V1beta1::Service>]
@@ -933,7 +954,7 @@ module Google
             end
 
             ##
-            # Creates a endpoint, and returns the new Endpoint.
+            # Creates an endpoint, and returns the new endpoint.
             #
             # @overload create_endpoint(request, options = nil)
             #   Pass arguments to `create_endpoint` via a request object, either of type
@@ -1027,7 +1048,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::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.
             #   @param page_size [::Integer]
             #     Optional. The maximum number of items to return.
@@ -1035,33 +1056,50 @@ module Google
             #     Optional. The next_page_token value returned from a previous List request,
             #     if any.
             #   @param filter [::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).
             #   @param order_by [::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.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ServiceDirectory::V1beta1::Endpoint>]
@@ -1110,7 +1148,7 @@ module Google
             end
 
             ##
-            # Gets a endpoint.
+            # Gets an endpoint.
             #
             # @overload get_endpoint(request, options = nil)
             #   Pass arguments to `get_endpoint` via a request object, either of type
@@ -1176,7 +1214,7 @@ module Google
             end
 
             ##
-            # Updates a endpoint.
+            # Updates an endpoint.
             #
             # @overload update_endpoint(request, options = nil)
             #   Pass arguments to `update_endpoint` via a request object, either of type
@@ -1244,7 +1282,7 @@ module Google
             end
 
             ##
-            # Deletes a endpoint.
+            # Deletes an endpoint.
             #
             # @overload delete_endpoint(request, options = nil)
             #   Pass arguments to `delete_endpoint` via a request object, either of type

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.1"
+        VERSION = "0.7.0"
       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/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

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

@@ -28,17 +28,46 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Immutable. The resource name for the service in the format
-        #     'projects/*/locations/*/namespaces/*/services/*'.
+        #     `projects/*/locations/*/namespaces/*/services/*`.
         # @!attribute [rw] metadata
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. Metadata for the service. This data can be consumed by service
-        #     clients.  The entire metadata dictionary may contain up to 2000 characters,
-        #     spread across all key-value pairs. Metadata that goes beyond any these
-        #     limits will be rejected.
+        #     clients.
+        #
+        #     Restrictions:
+        #
+        #     *   The entire metadata dictionary may contain up to 2000 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 [r] endpoints
         #   @return [::Array<::Google::Cloud::ServiceDirectory::V1beta1::Endpoint>]
-        #     Output only. Endpoints associated with this service. Returned on LookupService.Resolve.
-        #     Control plane clients should use RegistrationService.ListEndpoints.
+        #     Output only. Endpoints associated with this service. Returned on
+        #     {::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client#resolve_service LookupService.ResolveService}. Control plane clients should use
+        #     {::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#list_endpoints RegistrationService.ListEndpoints}.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the service was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the service was last updated. Note: endpoints being
+        #     created/deleted/updated within the service are not considered service
+        #     updates for the purpose of this timestamp.
         class Service
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/timestamp.rb

@@ -0,0 +1,129 @@
+# 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 Protobuf
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
+    #
+    # # Examples
+    #
+    # Example 1: Compute Timestamp from POSIX `time()`.
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(time(NULL));
+    #     timestamp.set_nanos(0);
+    #
+    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
+    #
+    #     struct timeval tv;
+    #     gettimeofday(&tv, NULL);
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(tv.tv_sec);
+    #     timestamp.set_nanos(tv.tv_usec * 1000);
+    #
+    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
+    #
+    #     FILETIME ft;
+    #     GetSystemTimeAsFileTime(&ft);
+    #     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
+    #
+    #     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
+    #     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
+    #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
+    #
+    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
+    #
+    #     long millis = System.currentTimeMillis();
+    #
+    #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
+    #         .setNanos((int) ((millis % 1000) * 1000000)).build();
+    #
+    #
+    # Example 5: Compute Timestamp from Java `Instant.now()`.
+    #
+    #     Instant now = Instant.now();
+    #
+    #     Timestamp timestamp =
+    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+    #             .setNanos(now.getNano()).build();
+    #
+    #
+    # Example 6: Compute Timestamp from current time in Python.
+    #
+    #     timestamp = Timestamp()
+    #     timestamp.GetCurrentTime()
+    #
+    # # JSON Mapping
+    #
+    # In JSON format, the Timestamp type is encoded as a string in the
+    # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
+    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
+    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
+    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
+    # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
+    # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
+    #
+    # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
+    # 01:30 UTC on January 15, 2017.
+    #
+    # In JavaScript, one can convert a Date object to this format using the
+    # standard
+    # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
+    # method. In Python, a standard `datetime.datetime` object can be converted
+    # to this format using
+    # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
+    # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+    # the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # ) to obtain a formatter capable of generating timestamps in this format.
+    # @!attribute [rw] seconds
+    #   @return [::Integer]
+    #     Represents seconds of UTC time since Unix epoch
+    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+    #     9999-12-31T23:59:59Z inclusive.
+    # @!attribute [rw] nanos
+    #   @return [::Integer]
+    #     Non-negative fractions of a second at nanosecond resolution. Negative
+    #     second values with fractions must still have non-negative nanos values
+    #     that count forward in time. Must be from 0 to 999,999,999
+    #     inclusive.
+    class Timestamp
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-service_directory-v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-17 00:00:00.000000000 Z
+date: 2021-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -220,6 +220,7 @@ files:
 - proto_docs/google/iam/v1/policy.rb
 - proto_docs/google/protobuf/empty.rb
 - proto_docs/google/protobuf/field_mask.rb
+- proto_docs/google/protobuf/timestamp.rb
 - proto_docs/google/type/expr.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses: