google-cloud-service_directory-v1beta1 0.4.5 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/LICENSE.md +188 -190
- data/README.md +66 -2
- data/lib/google/cloud/service_directory/v1beta1.rb +3 -0
- data/lib/google/cloud/service_directory/v1beta1/lookup_service/client.rb +44 -23
- data/lib/google/cloud/service_directory/v1beta1/registration_service/client.rb +152 -108
- data/lib/google/cloud/service_directory/v1beta1/registration_service/paths.rb +17 -0
- data/lib/google/cloud/service_directory/v1beta1/version.rb +1 -1
- data/lib/google/cloud/servicedirectory/v1beta1/endpoint_pb.rb +4 -0
- data/lib/google/cloud/servicedirectory/v1beta1/lookup_service_services_pb.rb +2 -2
- data/lib/google/cloud/servicedirectory/v1beta1/namespace_pb.rb +3 -0
- data/lib/google/cloud/servicedirectory/v1beta1/registration_service_services_pb.rb +25 -25
- data/lib/google/cloud/servicedirectory/v1beta1/service_pb.rb +3 -0
- data/proto_docs/google/api/field_behavior.rb +6 -0
- data/proto_docs/google/api/resource.rb +50 -14
- data/proto_docs/google/cloud/servicedirectory/v1beta1/endpoint.rb +48 -12
- data/proto_docs/google/cloud/servicedirectory/v1beta1/lookup_service.rb +29 -14
- data/proto_docs/google/cloud/servicedirectory/v1beta1/namespace.rb +9 -3
- data/proto_docs/google/cloud/servicedirectory/v1beta1/registration_service.rb +115 -77
- data/proto_docs/google/cloud/servicedirectory/v1beta1/service.rb +35 -6
- data/proto_docs/google/protobuf/timestamp.rb +129 -0
- metadata +22 -13
@@ -83,6 +83,23 @@ module Google
|
|
83
83
|
"projects/#{project}/locations/#{location}/namespaces/#{namespace}"
|
84
84
|
end
|
85
85
|
|
86
|
+
##
|
87
|
+
# Create a fully-qualified Network resource string.
|
88
|
+
#
|
89
|
+
# The resource will be in the following format:
|
90
|
+
#
|
91
|
+
# `projects/{project}/locations/global/networks/{network}`
|
92
|
+
#
|
93
|
+
# @param project [String]
|
94
|
+
# @param network [String]
|
95
|
+
#
|
96
|
+
# @return [::String]
|
97
|
+
def network_path project:, network:
|
98
|
+
raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
|
99
|
+
|
100
|
+
"projects/#{project}/locations/global/networks/#{network}"
|
101
|
+
end
|
102
|
+
|
86
103
|
##
|
87
104
|
# Create a fully-qualified Service resource string.
|
88
105
|
#
|
@@ -5,6 +5,7 @@ require 'google/protobuf'
|
|
5
5
|
|
6
6
|
require 'google/api/field_behavior_pb'
|
7
7
|
require 'google/api/resource_pb'
|
8
|
+
require 'google/protobuf/timestamp_pb'
|
8
9
|
require 'google/api/annotations_pb'
|
9
10
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
10
11
|
add_file("google/cloud/servicedirectory/v1beta1/endpoint.proto", :syntax => :proto3) do
|
@@ -13,6 +14,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
13
14
|
optional :address, :string, 2
|
14
15
|
optional :port, :int32, 3
|
15
16
|
map :metadata, :string, :string, 4
|
17
|
+
optional :network, :string, 5
|
18
|
+
optional :create_time, :message, 6, "google.protobuf.Timestamp"
|
19
|
+
optional :update_time, :message, 7, "google.protobuf.Timestamp"
|
16
20
|
end
|
17
21
|
end
|
18
22
|
end
|
@@ -27,7 +27,7 @@ module Google
|
|
27
27
|
# Service Directory API for looking up service data at runtime.
|
28
28
|
class Service
|
29
29
|
|
30
|
-
include GRPC::GenericService
|
30
|
+
include ::GRPC::GenericService
|
31
31
|
|
32
32
|
self.marshal_class_method = :encode
|
33
33
|
self.unmarshal_class_method = :decode
|
@@ -36,7 +36,7 @@ module Google
|
|
36
36
|
# Returns a [service][google.cloud.servicedirectory.v1beta1.Service] and its
|
37
37
|
# associated endpoints.
|
38
38
|
# Resolving a service is not considered an active developer method.
|
39
|
-
rpc :ResolveService, Google::Cloud::ServiceDirectory::V1beta1::ResolveServiceRequest, Google::Cloud::ServiceDirectory::V1beta1::ResolveServiceResponse
|
39
|
+
rpc :ResolveService, ::Google::Cloud::ServiceDirectory::V1beta1::ResolveServiceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::ResolveServiceResponse
|
40
40
|
end
|
41
41
|
|
42
42
|
Stub = Service.rpc_stub_class
|
@@ -5,12 +5,15 @@ require 'google/protobuf'
|
|
5
5
|
|
6
6
|
require 'google/api/field_behavior_pb'
|
7
7
|
require 'google/api/resource_pb'
|
8
|
+
require 'google/protobuf/timestamp_pb'
|
8
9
|
require 'google/api/annotations_pb'
|
9
10
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
10
11
|
add_file("google/cloud/servicedirectory/v1beta1/namespace.proto", :syntax => :proto3) do
|
11
12
|
add_message "google.cloud.servicedirectory.v1beta1.Namespace" do
|
12
13
|
optional :name, :string, 1
|
13
14
|
map :labels, :string, :string, 2
|
15
|
+
optional :create_time, :message, 4, "google.protobuf.Timestamp"
|
16
|
+
optional :update_time, :message, 5, "google.protobuf.Timestamp"
|
14
17
|
end
|
15
18
|
end
|
16
19
|
end
|
@@ -41,50 +41,50 @@ module Google
|
|
41
41
|
# `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
|
42
42
|
class Service
|
43
43
|
|
44
|
-
include GRPC::GenericService
|
44
|
+
include ::GRPC::GenericService
|
45
45
|
|
46
46
|
self.marshal_class_method = :encode
|
47
47
|
self.unmarshal_class_method = :decode
|
48
48
|
self.service_name = 'google.cloud.servicedirectory.v1beta1.RegistrationService'
|
49
49
|
|
50
|
-
# Creates a namespace, and returns the new
|
51
|
-
rpc :CreateNamespace, Google::Cloud::ServiceDirectory::V1beta1::CreateNamespaceRequest, Google::Cloud::ServiceDirectory::V1beta1::Namespace
|
50
|
+
# Creates a namespace, and returns the new namespace.
|
51
|
+
rpc :CreateNamespace, ::Google::Cloud::ServiceDirectory::V1beta1::CreateNamespaceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Namespace
|
52
52
|
# Lists all namespaces.
|
53
|
-
rpc :ListNamespaces, Google::Cloud::ServiceDirectory::V1beta1::ListNamespacesRequest, Google::Cloud::ServiceDirectory::V1beta1::ListNamespacesResponse
|
53
|
+
rpc :ListNamespaces, ::Google::Cloud::ServiceDirectory::V1beta1::ListNamespacesRequest, ::Google::Cloud::ServiceDirectory::V1beta1::ListNamespacesResponse
|
54
54
|
# Gets a namespace.
|
55
|
-
rpc :GetNamespace, Google::Cloud::ServiceDirectory::V1beta1::GetNamespaceRequest, Google::Cloud::ServiceDirectory::V1beta1::Namespace
|
55
|
+
rpc :GetNamespace, ::Google::Cloud::ServiceDirectory::V1beta1::GetNamespaceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Namespace
|
56
56
|
# Updates a namespace.
|
57
|
-
rpc :UpdateNamespace, Google::Cloud::ServiceDirectory::V1beta1::UpdateNamespaceRequest, Google::Cloud::ServiceDirectory::V1beta1::Namespace
|
57
|
+
rpc :UpdateNamespace, ::Google::Cloud::ServiceDirectory::V1beta1::UpdateNamespaceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Namespace
|
58
58
|
# Deletes a namespace. This also deletes all services and endpoints in
|
59
59
|
# the namespace.
|
60
|
-
rpc :DeleteNamespace, Google::Cloud::ServiceDirectory::V1beta1::DeleteNamespaceRequest, Google::Protobuf::Empty
|
61
|
-
# Creates a service, and returns the new
|
62
|
-
rpc :CreateService, Google::Cloud::ServiceDirectory::V1beta1::CreateServiceRequest, Google::Cloud::ServiceDirectory::V1beta1::Service
|
60
|
+
rpc :DeleteNamespace, ::Google::Cloud::ServiceDirectory::V1beta1::DeleteNamespaceRequest, ::Google::Protobuf::Empty
|
61
|
+
# Creates a service, and returns the new service.
|
62
|
+
rpc :CreateService, ::Google::Cloud::ServiceDirectory::V1beta1::CreateServiceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Service
|
63
63
|
# Lists all services belonging to a namespace.
|
64
|
-
rpc :ListServices, Google::Cloud::ServiceDirectory::V1beta1::ListServicesRequest, Google::Cloud::ServiceDirectory::V1beta1::ListServicesResponse
|
64
|
+
rpc :ListServices, ::Google::Cloud::ServiceDirectory::V1beta1::ListServicesRequest, ::Google::Cloud::ServiceDirectory::V1beta1::ListServicesResponse
|
65
65
|
# Gets a service.
|
66
|
-
rpc :GetService, Google::Cloud::ServiceDirectory::V1beta1::GetServiceRequest, Google::Cloud::ServiceDirectory::V1beta1::Service
|
66
|
+
rpc :GetService, ::Google::Cloud::ServiceDirectory::V1beta1::GetServiceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Service
|
67
67
|
# Updates a service.
|
68
|
-
rpc :UpdateService, Google::Cloud::ServiceDirectory::V1beta1::UpdateServiceRequest, Google::Cloud::ServiceDirectory::V1beta1::Service
|
68
|
+
rpc :UpdateService, ::Google::Cloud::ServiceDirectory::V1beta1::UpdateServiceRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Service
|
69
69
|
# Deletes a service. This also deletes all endpoints associated with
|
70
70
|
# the service.
|
71
|
-
rpc :DeleteService, Google::Cloud::ServiceDirectory::V1beta1::DeleteServiceRequest, Google::Protobuf::Empty
|
72
|
-
# Creates
|
73
|
-
rpc :CreateEndpoint, Google::Cloud::ServiceDirectory::V1beta1::CreateEndpointRequest, Google::Cloud::ServiceDirectory::V1beta1::Endpoint
|
71
|
+
rpc :DeleteService, ::Google::Cloud::ServiceDirectory::V1beta1::DeleteServiceRequest, ::Google::Protobuf::Empty
|
72
|
+
# Creates an endpoint, and returns the new endpoint.
|
73
|
+
rpc :CreateEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::CreateEndpointRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Endpoint
|
74
74
|
# Lists all endpoints.
|
75
|
-
rpc :ListEndpoints, Google::Cloud::ServiceDirectory::V1beta1::ListEndpointsRequest, Google::Cloud::ServiceDirectory::V1beta1::ListEndpointsResponse
|
76
|
-
# Gets
|
77
|
-
rpc :GetEndpoint, Google::Cloud::ServiceDirectory::V1beta1::GetEndpointRequest, Google::Cloud::ServiceDirectory::V1beta1::Endpoint
|
78
|
-
# Updates
|
79
|
-
rpc :UpdateEndpoint, Google::Cloud::ServiceDirectory::V1beta1::UpdateEndpointRequest, Google::Cloud::ServiceDirectory::V1beta1::Endpoint
|
80
|
-
# Deletes
|
81
|
-
rpc :DeleteEndpoint, Google::Cloud::ServiceDirectory::V1beta1::DeleteEndpointRequest, Google::Protobuf::Empty
|
75
|
+
rpc :ListEndpoints, ::Google::Cloud::ServiceDirectory::V1beta1::ListEndpointsRequest, ::Google::Cloud::ServiceDirectory::V1beta1::ListEndpointsResponse
|
76
|
+
# Gets an endpoint.
|
77
|
+
rpc :GetEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::GetEndpointRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Endpoint
|
78
|
+
# Updates an endpoint.
|
79
|
+
rpc :UpdateEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::UpdateEndpointRequest, ::Google::Cloud::ServiceDirectory::V1beta1::Endpoint
|
80
|
+
# Deletes an endpoint.
|
81
|
+
rpc :DeleteEndpoint, ::Google::Cloud::ServiceDirectory::V1beta1::DeleteEndpointRequest, ::Google::Protobuf::Empty
|
82
82
|
# Gets the IAM Policy for a resource (namespace or service only).
|
83
|
-
rpc :GetIamPolicy, Google::Iam::V1::GetIamPolicyRequest, Google::Iam::V1::Policy
|
83
|
+
rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy
|
84
84
|
# Sets the IAM Policy for a resource (namespace or service only).
|
85
|
-
rpc :SetIamPolicy, Google::Iam::V1::SetIamPolicyRequest, Google::Iam::V1::Policy
|
85
|
+
rpc :SetIamPolicy, ::Google::Iam::V1::SetIamPolicyRequest, ::Google::Iam::V1::Policy
|
86
86
|
# Tests IAM permissions for a resource (namespace or service only).
|
87
|
-
rpc :TestIamPermissions, Google::Iam::V1::TestIamPermissionsRequest, Google::Iam::V1::TestIamPermissionsResponse
|
87
|
+
rpc :TestIamPermissions, ::Google::Iam::V1::TestIamPermissionsRequest, ::Google::Iam::V1::TestIamPermissionsResponse
|
88
88
|
end
|
89
89
|
|
90
90
|
Stub = Service.rpc_stub_class
|
@@ -6,6 +6,7 @@ require 'google/protobuf'
|
|
6
6
|
require 'google/api/field_behavior_pb'
|
7
7
|
require 'google/api/resource_pb'
|
8
8
|
require 'google/cloud/servicedirectory/v1beta1/endpoint_pb'
|
9
|
+
require 'google/protobuf/timestamp_pb'
|
9
10
|
require 'google/api/annotations_pb'
|
10
11
|
Google::Protobuf::DescriptorPool.generated_pool.build do
|
11
12
|
add_file("google/cloud/servicedirectory/v1beta1/service.proto", :syntax => :proto3) do
|
@@ -13,6 +14,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
13
14
|
optional :name, :string, 1
|
14
15
|
map :metadata, :string, :string, 2
|
15
16
|
repeated :endpoints, :message, 3, "google.cloud.servicedirectory.v1beta1.Endpoint"
|
17
|
+
optional :create_time, :message, 6, "google.protobuf.Timestamp"
|
18
|
+
optional :update_time, :message, 7, "google.protobuf.Timestamp"
|
16
19
|
end
|
17
20
|
end
|
18
21
|
end
|
@@ -54,6 +54,12 @@ module Google
|
|
54
54
|
# This indicates that the field may be set once in a request to create a
|
55
55
|
# resource, but may not be changed thereafter.
|
56
56
|
IMMUTABLE = 5
|
57
|
+
|
58
|
+
# Denotes that a (repeated) field is an unordered list.
|
59
|
+
# This indicates that the service may provide the elements of the list
|
60
|
+
# in any arbitrary order, rather than the order the user originally
|
61
|
+
# provided. Additionally, the list's order may or may not be stable.
|
62
|
+
UNORDERED_LIST = 6
|
57
63
|
end
|
58
64
|
end
|
59
65
|
end
|
@@ -43,12 +43,12 @@ module Google
|
|
43
43
|
#
|
44
44
|
# The ResourceDescriptor Yaml config will look like:
|
45
45
|
#
|
46
|
-
#
|
47
|
-
#
|
48
|
-
#
|
49
|
-
#
|
50
|
-
#
|
51
|
-
#
|
46
|
+
# resources:
|
47
|
+
# - type: "pubsub.googleapis.com/Topic"
|
48
|
+
# name_descriptor:
|
49
|
+
# - pattern: "projects/{project}/topics/{topic}"
|
50
|
+
# parent_type: "cloudresourcemanager.googleapis.com/Project"
|
51
|
+
# parent_name_extractor: "projects/{project}"
|
52
52
|
#
|
53
53
|
# Sometimes, resources have multiple patterns, typically because they can
|
54
54
|
# live under multiple parents.
|
@@ -183,15 +183,24 @@ module Google
|
|
183
183
|
# }
|
184
184
|
# @!attribute [rw] plural
|
185
185
|
# @return [::String]
|
186
|
-
# The plural name used in the resource name, such as
|
187
|
-
# the name of 'projects/\\{project}'
|
188
|
-
#
|
186
|
+
# The plural name used in the resource name and permission names, such as
|
187
|
+
# 'projects' for the resource name of 'projects/\\{project}' and the permission
|
188
|
+
# name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
|
189
|
+
# concept of the `plural` field in k8s CRD spec
|
189
190
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
191
|
+
#
|
192
|
+
# Note: The plural form is required even for singleton resources. See
|
193
|
+
# https://aip.dev/156
|
190
194
|
# @!attribute [rw] singular
|
191
195
|
# @return [::String]
|
192
196
|
# The same concept of the `singular` field in k8s CRD spec
|
193
197
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
194
198
|
# Such as "project" for the `resourcemanager.googleapis.com/Project` type.
|
199
|
+
# @!attribute [rw] style
|
200
|
+
# @return [::Array<::Google::Api::ResourceDescriptor::Style>]
|
201
|
+
# Style flag(s) for this resource.
|
202
|
+
# These indicate that a resource is expected to conform to a given
|
203
|
+
# style. See the specific style flags for additional information.
|
195
204
|
class ResourceDescriptor
|
196
205
|
include ::Google::Protobuf::MessageExts
|
197
206
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -211,6 +220,22 @@ module Google
|
|
211
220
|
# that from being necessary once there are multiple patterns.)
|
212
221
|
FUTURE_MULTI_PATTERN = 2
|
213
222
|
end
|
223
|
+
|
224
|
+
# A flag representing a specific style that a resource claims to conform to.
|
225
|
+
module Style
|
226
|
+
# The unspecified value. Do not use.
|
227
|
+
STYLE_UNSPECIFIED = 0
|
228
|
+
|
229
|
+
# This resource is intended to be "declarative-friendly".
|
230
|
+
#
|
231
|
+
# Declarative-friendly resources must be more strictly consistent, and
|
232
|
+
# setting this to true communicates to tools that this resource should
|
233
|
+
# adhere to declarative-friendly expectations.
|
234
|
+
#
|
235
|
+
# Note: This is used by the API linter (linter.aip.dev) to enable
|
236
|
+
# additional checks.
|
237
|
+
DECLARATIVE_FRIENDLY = 1
|
238
|
+
end
|
214
239
|
end
|
215
240
|
|
216
241
|
# Defines a proto annotation that describes a string field that refers to
|
@@ -226,6 +251,17 @@ module Google
|
|
226
251
|
# type: "pubsub.googleapis.com/Topic"
|
227
252
|
# }];
|
228
253
|
# }
|
254
|
+
#
|
255
|
+
# Occasionally, a field may reference an arbitrary resource. In this case,
|
256
|
+
# APIs use the special value * in their resource reference.
|
257
|
+
#
|
258
|
+
# Example:
|
259
|
+
#
|
260
|
+
# message GetIamPolicyRequest {
|
261
|
+
# string resource = 2 [(google.api.resource_reference) = {
|
262
|
+
# type: "*"
|
263
|
+
# }];
|
264
|
+
# }
|
229
265
|
# @!attribute [rw] child_type
|
230
266
|
# @return [::String]
|
231
267
|
# The resource type of a child collection that the annotated field
|
@@ -234,11 +270,11 @@ module Google
|
|
234
270
|
#
|
235
271
|
# Example:
|
236
272
|
#
|
237
|
-
#
|
238
|
-
#
|
239
|
-
#
|
240
|
-
#
|
241
|
-
#
|
273
|
+
# message ListLogEntriesRequest {
|
274
|
+
# string parent = 1 [(google.api.resource_reference) = {
|
275
|
+
# child_type: "logging.googleapis.com/LogEntry"
|
276
|
+
# };
|
277
|
+
# }
|
242
278
|
class ResourceReference
|
243
279
|
include ::Google::Protobuf::MessageExts
|
244
280
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -27,26 +27,62 @@ module Google
|
|
27
27
|
# @!attribute [rw] name
|
28
28
|
# @return [::String]
|
29
29
|
# Immutable. The resource name for the endpoint in the format
|
30
|
-
#
|
30
|
+
# `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
|
31
31
|
# @!attribute [rw] address
|
32
32
|
# @return [::String]
|
33
|
-
# Optional. An IPv4 or IPv6 address. Service Directory
|
34
|
-
#
|
35
|
-
#
|
36
|
-
#
|
37
|
-
#
|
38
|
-
#
|
39
|
-
#
|
33
|
+
# Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like:
|
34
|
+
#
|
35
|
+
# * `8.8.8`
|
36
|
+
# * `8.8.8.8:53`
|
37
|
+
# * `test:bad:address`
|
38
|
+
# * `[::1]`
|
39
|
+
# * `[::1]:8080`
|
40
|
+
#
|
40
41
|
# Limited to 45 characters.
|
41
42
|
# @!attribute [rw] port
|
42
43
|
# @return [::Integer]
|
43
|
-
# Optional. Service Directory
|
44
|
+
# Optional. Service Directory rejects values outside of `[0, 65535]`.
|
44
45
|
# @!attribute [rw] metadata
|
45
46
|
# @return [::Google::Protobuf::Map{::String => ::String}]
|
46
47
|
# Optional. Metadata for the endpoint. This data can be consumed by service
|
47
|
-
# clients.
|
48
|
-
#
|
49
|
-
#
|
48
|
+
# clients.
|
49
|
+
#
|
50
|
+
# Restrictions:
|
51
|
+
#
|
52
|
+
# * The entire metadata dictionary may contain up to 512 characters,
|
53
|
+
# spread accoss all key-value pairs. Metadata that goes beyond this
|
54
|
+
# limit are rejected
|
55
|
+
# * Valid metadata keys have two segments: an optional prefix and name,
|
56
|
+
# separated by a slash (/). The name segment is required and must be 63
|
57
|
+
# characters or less, beginning and ending with an alphanumeric character
|
58
|
+
# ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and
|
59
|
+
# alphanumerics between. The prefix is optional. If specified, the prefix
|
60
|
+
# must be a DNS subdomain: a series of DNS labels separated by dots (.),
|
61
|
+
# not longer than 253 characters in total, followed by a slash (/).
|
62
|
+
# Metadata that fails to meet these requirements are rejected
|
63
|
+
# * The `(*.)google.com/` and `(*.)googleapis.com/` prefixes are reserved
|
64
|
+
# for system metadata managed by Service Directory. If the user tries
|
65
|
+
# to write to these keyspaces, those entries are silently ignored by
|
66
|
+
# the system
|
67
|
+
#
|
68
|
+
# Note: This field is equivalent to the `annotations` field in the v1 API.
|
69
|
+
# They have the same syntax and read/write to the same location in Service
|
70
|
+
# Directory.
|
71
|
+
# @!attribute [rw] network
|
72
|
+
# @return [::String]
|
73
|
+
# Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
|
74
|
+
# `projects/<project number>/locations/global/networks/*`.
|
75
|
+
#
|
76
|
+
# The project must be specified by project number (project id is rejected).
|
77
|
+
# Incorrectly formatted networks are rejected, but no other validation
|
78
|
+
# is performed on this field (ex. network or project existence, reachability,
|
79
|
+
# or permissions).
|
80
|
+
# @!attribute [r] create_time
|
81
|
+
# @return [::Google::Protobuf::Timestamp]
|
82
|
+
# Output only. The timestamp when the endpoint was created.
|
83
|
+
# @!attribute [r] update_time
|
84
|
+
# @return [::Google::Protobuf::Timestamp]
|
85
|
+
# Output only. The timestamp when the endpoint was last updated.
|
50
86
|
class Endpoint
|
51
87
|
include ::Google::Protobuf::MessageExts
|
52
88
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -35,22 +35,37 @@ module Google
|
|
35
35
|
# @return [::String]
|
36
36
|
# Optional. The filter applied to the endpoints of the resolved service.
|
37
37
|
#
|
38
|
-
# General filter string syntax:
|
39
|
-
#
|
40
|
-
#
|
41
|
-
#
|
42
|
-
#
|
43
|
-
#
|
44
|
-
#
|
38
|
+
# General `filter` string syntax:
|
39
|
+
# `<field> <operator> <value> (<logical connector>)`
|
40
|
+
#
|
41
|
+
# * `<field>` can be `name`, `address`, `port`, or `metadata.<key>` for
|
42
|
+
# map field
|
43
|
+
# * `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
|
44
|
+
# means `HAS`, and is roughly the same as `=`
|
45
|
+
# * `<value>` must be the same data type as field
|
46
|
+
# * `<logical connector>` can be `AND`, `OR`, `NOT`
|
45
47
|
#
|
46
48
|
# Examples of valid filters:
|
47
|
-
#
|
48
|
-
#
|
49
|
-
#
|
50
|
-
#
|
51
|
-
#
|
52
|
-
#
|
53
|
-
#
|
49
|
+
#
|
50
|
+
# * `metadata.owner` returns endpoints that have a annotation with the key
|
51
|
+
# `owner`, this is the same as `metadata:owner`
|
52
|
+
# * `metadata.protocol=gRPC` returns endpoints that have key/value
|
53
|
+
# `protocol=gRPC`
|
54
|
+
# * `address=192.108.1.105` returns endpoints that have this address
|
55
|
+
# * `port>8080` returns endpoints that have port number larger than 8080
|
56
|
+
# *
|
57
|
+
# `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
|
58
|
+
# returns endpoints that have name that is alphabetically later than the
|
59
|
+
# string, so "endpoint-e" is returned but "endpoint-a" is not
|
60
|
+
# * `metadata.owner!=sd AND metadata.foo=bar` returns endpoints that have
|
61
|
+
# `owner` in annotation key but value is not `sd` AND have key/value
|
62
|
+
# `foo=bar`
|
63
|
+
# * `doesnotexist.foo=bar` returns an empty list. Note that endpoint
|
64
|
+
# doesn't have a field called "doesnotexist". Since the filter does not
|
65
|
+
# match any endpoint, it returns no results
|
66
|
+
#
|
67
|
+
# For more information about filtering, see
|
68
|
+
# [API Filtering](https://aip.dev/160).
|
54
69
|
class ResolveServiceRequest
|
55
70
|
include ::Google::Protobuf::MessageExts
|
56
71
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -27,12 +27,18 @@ module Google
|
|
27
27
|
# @!attribute [rw] name
|
28
28
|
# @return [::String]
|
29
29
|
# Immutable. The resource name for the namespace in the format
|
30
|
-
#
|
30
|
+
# `projects/*/locations/*/namespaces/*`.
|
31
31
|
# @!attribute [rw] labels
|
32
32
|
# @return [::Google::Protobuf::Map{::String => ::String}]
|
33
|
-
# Optional. Resource labels associated with this
|
34
|
-
# No more than 64 user labels can be associated with a given resource.
|
33
|
+
# Optional. Resource labels associated with this namespace.
|
34
|
+
# No more than 64 user labels can be associated with a given resource. Label
|
35
35
|
# keys and values can be no longer than 63 characters.
|
36
|
+
# @!attribute [r] create_time
|
37
|
+
# @return [::Google::Protobuf::Timestamp]
|
38
|
+
# Output only. The timestamp when the namespace was created.
|
39
|
+
# @!attribute [r] update_time
|
40
|
+
# @return [::Google::Protobuf::Timestamp]
|
41
|
+
# Output only. The timestamp when the namespace was last updated.
|
36
42
|
class Namespace
|
37
43
|
include ::Google::Protobuf::MessageExts
|
38
44
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|