google-cloud-service_directory-v1beta1 0.1.0

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

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module ServiceDirectory
+      module V1beta1
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client#resolve_service LookupService.ResolveService}.
+        # Looks up a service by its name, returns the service and its endpoints.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the service to resolve.
+        # @!attribute [rw] max_endpoints
+        #   @return [Integer]
+        #     Optional. The maximum number of endpoints to return. Defaults to 25. Maximum is 100.
+        #     If a value less than one is specified, the Default is used.
+        #     If a value greater than the Maximum is specified, the Maximum is used.
+        # @!attribute [rw] endpoint_filter
+        #   @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".
+        #
+        #     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.
+        class ResolveServiceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for {Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client#resolve_service LookupService.ResolveService}.
+        # @!attribute [rw] service
+        #   @return [Google::Cloud::ServiceDirectory::V1beta1::Service]
+        class ResolveServiceResponse
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module ServiceDirectory
+      module V1beta1
+        # A container for {Google::Cloud::ServiceDirectory::V1beta1::Service services}.
+        # Namespaces allow administrators to group services together and define
+        # permissions for a collection of services.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Immutable. The resource name for the namespace in the format
+        #     '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
+        #     keys and values can be no longer than 63 characters.
+        class Namespace
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [String]
+          # @!attribute [rw] value
+          #   @return [String]
+          class LabelsEntry
+            include Google::Protobuf::MessageExts
+            extend Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,367 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module ServiceDirectory
+      module V1beta1
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#create_namespace RegistrationService.CreateNamespace}.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Required. The resource name of the project and location the namespace
+        #     will be created in.
+        # @!attribute [rw] namespace_id
+        #   @return [String]
+        #     Required. The Resource ID must be 1-63 characters long, and comply with
+        #     <a href="https://www.ietf.org/rfc/rfc1035.txt" target="_blank">RFC1035</a>.
+        #     Specifically, the name must be 1-63 characters long and match the regular
+        #     expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means the first
+        #     character must be a lowercase letter, and all following characters must
+        #     be a dash, lowercase letter, or digit, except the last character, which
+        #     cannot be a dash.
+        # @!attribute [rw] namespace
+        #   @return [Google::Cloud::ServiceDirectory::V1beta1::Namespace]
+        #     Required. A namespace with initial fields set.
+        class CreateNamespaceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # 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.
+        # @!attribute [rw] page_size
+        #   @return [Integer]
+        #     Optional. The maximum number of items to return.
+        # @!attribute [rw] page_token
+        #   @return [String]
+        #     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.
+        #
+        #     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".
+        #
+        #     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.
+        # @!attribute [rw] order_by
+        #   @return [String]
+        #     Optional. The order to list result by.
+        #
+        #     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.
+        class ListNamespacesRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#list_namespaces RegistrationService.ListNamespaces}.
+        # @!attribute [rw] namespaces
+        #   @return [Array<Google::Cloud::ServiceDirectory::V1beta1::Namespace>]
+        #     The list of namespaces.
+        # @!attribute [rw] next_page_token
+        #   @return [String]
+        #     Token to retrieve the next page of results, or empty if there are no
+        #     more results in the list.
+        class ListNamespacesResponse
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#get_namespace RegistrationService.GetNamespace}.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the namespace to retrieve.
+        class GetNamespaceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#update_namespace RegistrationService.UpdateNamespace}.
+        # @!attribute [rw] namespace
+        #   @return [Google::Cloud::ServiceDirectory::V1beta1::Namespace]
+        #     Required. The updated namespace.
+        # @!attribute [rw] update_mask
+        #   @return [Google::Protobuf::FieldMask]
+        #     Required. List of fields to be updated in this request.
+        class UpdateNamespaceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#delete_namespace RegistrationService.DeleteNamespace}.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the namespace to delete.
+        class DeleteNamespaceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#create_service RegistrationService.CreateService}.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Required. The resource name of the namespace this service will belong to.
+        # @!attribute [rw] service_id
+        #   @return [String]
+        #     Required. The Resource ID must be 1-63 characters long, and comply with
+        #     <a href="https://www.ietf.org/rfc/rfc1035.txt" target="_blank">RFC1035</a>.
+        #     Specifically, the name must be 1-63 characters long and match the regular
+        #     expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means the first
+        #     character must be a lowercase letter, and all following characters must
+        #     be a dash, lowercase letter, or digit, except the last character, which
+        #     cannot be a dash.
+        # @!attribute [rw] service
+        #   @return [Google::Cloud::ServiceDirectory::V1beta1::Service]
+        #     Required. A service  with initial fields set.
+        class CreateServiceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # 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
+        #     like to list.
+        # @!attribute [rw] page_size
+        #   @return [Integer]
+        #     Optional. The maximum number of items to return.
+        # @!attribute [rw] page_token
+        #   @return [String]
+        #     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.
+        #
+        #     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".
+        #
+        #     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.
+        # @!attribute [rw] order_by
+        #   @return [String]
+        #     Optional. The order to list result by.
+        class ListServicesRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#list_services RegistrationService.ListServices}.
+        # @!attribute [rw] services
+        #   @return [Array<Google::Cloud::ServiceDirectory::V1beta1::Service>]
+        #     The list of services.
+        # @!attribute [rw] next_page_token
+        #   @return [String]
+        #     Token to retrieve the next page of results, or empty if there are no
+        #     more results in the list.
+        class ListServicesResponse
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # 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.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the service to get.
+        class GetServiceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#update_service RegistrationService.UpdateService}.
+        # @!attribute [rw] service
+        #   @return [Google::Cloud::ServiceDirectory::V1beta1::Service]
+        #     Required. The updated service.
+        # @!attribute [rw] update_mask
+        #   @return [Google::Protobuf::FieldMask]
+        #     Required. List of fields to be updated in this request.
+        class UpdateServiceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#delete_service RegistrationService.DeleteService}.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the service to delete.
+        class DeleteServiceRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#create_endpoint RegistrationService.CreateEndpoint}.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Required. The resource name of the service that this endpoint provides.
+        # @!attribute [rw] endpoint_id
+        #   @return [String]
+        #     Required. The Resource ID must be 1-63 characters long, and comply with
+        #     <a href="https://www.ietf.org/rfc/rfc1035.txt" target="_blank">RFC1035</a>.
+        #     Specifically, the name must be 1-63 characters long and match the regular
+        #     expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means the first
+        #     character must be a lowercase letter, and all following characters must
+        #     be a dash, lowercase letter, or digit, except the last character, which
+        #     cannot be a dash.
+        # @!attribute [rw] endpoint
+        #   @return [Google::Cloud::ServiceDirectory::V1beta1::Endpoint]
+        #     Required. A endpoint with initial fields set.
+        class CreateEndpointRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # 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
+        #     list.
+        # @!attribute [rw] page_size
+        #   @return [Integer]
+        #     Optional. The maximum number of items to return.
+        # @!attribute [rw] page_token
+        #   @return [String]
+        #     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.
+        #
+        #     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.
+        # @!attribute [rw] order_by
+        #   @return [String]
+        #     Optional. The order to list result by.
+        class ListEndpointsRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#list_endpoints RegistrationService.ListEndpoints}.
+        # @!attribute [rw] endpoints
+        #   @return [Array<Google::Cloud::ServiceDirectory::V1beta1::Endpoint>]
+        #     The list of endpoints.
+        # @!attribute [rw] next_page_token
+        #   @return [String]
+        #     Token to retrieve the next page of results, or empty if there are no
+        #     more results in the list.
+        class ListEndpointsResponse
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#get_endpoint RegistrationService.GetEndpoint}.
+        # This should not be used to lookup endpoints at runtime. Instead, use
+        # the `resolve` method.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the endpoint to get.
+        class GetEndpointRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#update_endpoint RegistrationService.UpdateEndpoint}.
+        # @!attribute [rw] endpoint
+        #   @return [Google::Cloud::ServiceDirectory::V1beta1::Endpoint]
+        #     Required. The updated endpoint.
+        # @!attribute [rw] update_mask
+        #   @return [Google::Protobuf::FieldMask]
+        #     Required. List of fields to be updated in this request.
+        class UpdateEndpointRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for {Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client#delete_endpoint RegistrationService.DeleteEndpoint}.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the endpoint to delete.
+        class DeleteEndpointRequest
+          include Google::Protobuf::MessageExts
+          extend Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end