google-cloud-service_directory-v1beta1 0.6.0 → 0.7.2
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/AUTHENTICATION.md +8 -8
- data/README.md +1 -1
- data/lib/google/cloud/service_directory/v1beta1/lookup_service/client.rb +63 -56
- data/lib/google/cloud/service_directory/v1beta1/registration_service/client.rb +205 -141
- 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/namespace_pb.rb +3 -0
- data/lib/google/cloud/servicedirectory/v1beta1/registration_service_services_pb.rb +6 -6
- data/lib/google/cloud/servicedirectory/v1beta1/service_pb.rb +3 -0
- data/proto_docs/google/api/field_behavior.rb +7 -1
- 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
- data/proto_docs/google/type/expr.rb +35 -12
- metadata +16 -9
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 70ab0cfcafe400def5b567105502bb2e63648502f3f1cdb6d2af24d8e1e8939c
|
4
|
+
data.tar.gz: 74fc52eab7bb8ad708c1998d6c1bcfdb84c2c10a271eef717652b09288552c2a
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 275360801dd674154ef6239cdd804f30f6a6c82eb711828430e1f3c0e4893e2116725a2f4d957ea37da0c0082a2b110dcbca063c9f7bffcafb160125b045d733
|
7
|
+
data.tar.gz: 194b06dd93f23188e89c119597b126bbafe39887e3855ac9360d79cfcff53561e77840dd3bd1c82be0e8eeb8227692880769309d66ce6101ac4524d4ad3cccf7
|
data/AUTHENTICATION.md
CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-service_directory-v1beta1
|
|
66
66
|
checks for credentials are configured on the service Credentials class (such as
|
67
67
|
{::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Credentials}):
|
68
68
|
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
69
|
+
* `SERVICE_DIRECTORY_CREDENTIALS` - Path to JSON file, or JSON contents
|
70
|
+
* `SERVICE_DIRECTORY_KEYFILE` - Path to JSON file, or JSON contents
|
71
|
+
* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
|
72
|
+
* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
|
73
|
+
* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
|
74
74
|
|
75
75
|
```ruby
|
76
76
|
require "google/cloud/service_directory/v1beta1"
|
@@ -82,8 +82,8 @@ client = ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.new
|
|
82
82
|
|
83
83
|
### Configuration
|
84
84
|
|
85
|
-
The **Credentials JSON** can be configured instead of
|
86
|
-
environment
|
85
|
+
The path to the **Credentials JSON** file can be configured instead of storing
|
86
|
+
it in an environment variable. Either on an individual client initialization:
|
87
87
|
|
88
88
|
```ruby
|
89
89
|
require "google/cloud/service_directory/v1beta1"
|
@@ -93,7 +93,7 @@ client = ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.new d
|
|
93
93
|
end
|
94
94
|
```
|
95
95
|
|
96
|
-
Or
|
96
|
+
Or globally for all clients:
|
97
97
|
|
98
98
|
```ruby
|
99
99
|
require "google/cloud/service_directory/v1beta1"
|
data/README.md
CHANGED
@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
|
|
33
33
|
require "google/cloud/service_directory/v1beta1"
|
34
34
|
|
35
35
|
client = ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.new
|
36
|
-
request =
|
36
|
+
request = ::Google::Cloud::ServiceDirectory::V1beta1::ResolveServiceRequest.new # (request fields as keyword arguments...)
|
37
37
|
response = client.resolve_service request
|
38
38
|
```
|
39
39
|
|
@@ -41,13 +41,12 @@ module Google
|
|
41
41
|
# See {::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client::Configuration}
|
42
42
|
# for a description of the configuration fields.
|
43
43
|
#
|
44
|
-
#
|
44
|
+
# @example
|
45
45
|
#
|
46
|
-
#
|
47
|
-
#
|
48
|
-
#
|
49
|
-
#
|
50
|
-
# end
|
46
|
+
# # Modify the configuration for all LookupService clients
|
47
|
+
# ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.configure do |config|
|
48
|
+
# config.timeout = 10.0
|
49
|
+
# end
|
51
50
|
#
|
52
51
|
# @yield [config] Configure the Client client.
|
53
52
|
# @yieldparam config [Client::Configuration]
|
@@ -67,10 +66,7 @@ module Google
|
|
67
66
|
|
68
67
|
default_config.timeout = 15.0
|
69
68
|
default_config.retry_policy = {
|
70
|
-
initial_delay: 1.0,
|
71
|
-
max_delay: 60.0,
|
72
|
-
multiplier: 1.3,
|
73
|
-
retry_codes: [14, 2]
|
69
|
+
initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 2]
|
74
70
|
}
|
75
71
|
|
76
72
|
default_config
|
@@ -102,19 +98,15 @@ module Google
|
|
102
98
|
##
|
103
99
|
# Create a new LookupService client object.
|
104
100
|
#
|
105
|
-
#
|
106
|
-
#
|
107
|
-
# To create a new LookupService client with the default
|
108
|
-
# configuration:
|
109
|
-
#
|
110
|
-
# client = ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.new
|
101
|
+
# @example
|
111
102
|
#
|
112
|
-
#
|
113
|
-
#
|
103
|
+
# # Create a client using the default configuration
|
104
|
+
# client = ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.new
|
114
105
|
#
|
115
|
-
#
|
116
|
-
#
|
117
|
-
#
|
106
|
+
# # Create a client using a custom configuration
|
107
|
+
# client = ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.new do |config|
|
108
|
+
# config.timeout = 10.0
|
109
|
+
# end
|
118
110
|
#
|
119
111
|
# @yield [config] Configure the LookupService client.
|
120
112
|
# @yieldparam config [Client::Configuration]
|
@@ -134,14 +126,13 @@ module Google
|
|
134
126
|
|
135
127
|
# Create credentials
|
136
128
|
credentials = @config.credentials
|
137
|
-
# Use self-signed JWT if the
|
129
|
+
# Use self-signed JWT if the endpoint is unchanged from default,
|
138
130
|
# but only if the default endpoint does not have a region prefix.
|
139
|
-
enable_self_signed_jwt = @config.
|
140
|
-
@config.endpoint == Client.configure.endpoint &&
|
131
|
+
enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
|
141
132
|
!@config.endpoint.split(".").first.include?("-")
|
142
133
|
credentials ||= Credentials.default scope: @config.scope,
|
143
134
|
enable_self_signed_jwt: enable_self_signed_jwt
|
144
|
-
if credentials.is_a?(String) || credentials.is_a?(Hash)
|
135
|
+
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
145
136
|
credentials = Credentials.new credentials, scope: @config.scope
|
146
137
|
end
|
147
138
|
@quota_project_id = @config.quota_project
|
@@ -187,22 +178,37 @@ module Google
|
|
187
178
|
# @param endpoint_filter [::String]
|
188
179
|
# Optional. The filter applied to the endpoints of the resolved service.
|
189
180
|
#
|
190
|
-
# General filter string syntax:
|
191
|
-
#
|
192
|
-
#
|
193
|
-
#
|
194
|
-
#
|
195
|
-
#
|
196
|
-
#
|
181
|
+
# General `filter` string syntax:
|
182
|
+
# `<field> <operator> <value> (<logical connector>)`
|
183
|
+
#
|
184
|
+
# * `<field>` can be `name`, `address`, `port`, or `metadata.<key>` for
|
185
|
+
# map field
|
186
|
+
# * `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
|
187
|
+
# means `HAS`, and is roughly the same as `=`
|
188
|
+
# * `<value>` must be the same data type as field
|
189
|
+
# * `<logical connector>` can be `AND`, `OR`, `NOT`
|
197
190
|
#
|
198
191
|
# Examples of valid filters:
|
199
|
-
#
|
200
|
-
#
|
201
|
-
#
|
202
|
-
#
|
203
|
-
#
|
204
|
-
#
|
205
|
-
#
|
192
|
+
#
|
193
|
+
# * `metadata.owner` returns endpoints that have a annotation with the key
|
194
|
+
# `owner`, this is the same as `metadata:owner`
|
195
|
+
# * `metadata.protocol=gRPC` returns endpoints that have key/value
|
196
|
+
# `protocol=gRPC`
|
197
|
+
# * `address=192.108.1.105` returns endpoints that have this address
|
198
|
+
# * `port>8080` returns endpoints that have port number larger than 8080
|
199
|
+
# *
|
200
|
+
# `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
|
201
|
+
# returns endpoints that have name that is alphabetically later than the
|
202
|
+
# string, so "endpoint-e" is returned but "endpoint-a" is not
|
203
|
+
# * `metadata.owner!=sd AND metadata.foo=bar` returns endpoints that have
|
204
|
+
# `owner` in annotation key but value is not `sd` AND have key/value
|
205
|
+
# `foo=bar`
|
206
|
+
# * `doesnotexist.foo=bar` returns an empty list. Note that endpoint
|
207
|
+
# doesn't have a field called "doesnotexist". Since the filter does not
|
208
|
+
# match any endpoint, it returns no results
|
209
|
+
#
|
210
|
+
# For more information about filtering, see
|
211
|
+
# [API Filtering](https://aip.dev/160).
|
206
212
|
#
|
207
213
|
# @yield [response, operation] Access the result along with the RPC operation
|
208
214
|
# @yieldparam response [::Google::Cloud::ServiceDirectory::V1beta1::ResolveServiceResponse]
|
@@ -238,7 +244,9 @@ module Google
|
|
238
244
|
options.apply_defaults timeout: @config.rpcs.resolve_service.timeout,
|
239
245
|
metadata: metadata,
|
240
246
|
retry_policy: @config.rpcs.resolve_service.retry_policy
|
241
|
-
|
247
|
+
|
248
|
+
options.apply_defaults timeout: @config.timeout,
|
249
|
+
metadata: @config.metadata,
|
242
250
|
retry_policy: @config.retry_policy
|
243
251
|
|
244
252
|
@lookup_service_stub.call_rpc :resolve_service, request, options: options do |response, operation|
|
@@ -262,22 +270,21 @@ module Google
|
|
262
270
|
# Configuration can be applied globally to all clients, or to a single client
|
263
271
|
# on construction.
|
264
272
|
#
|
265
|
-
#
|
266
|
-
#
|
267
|
-
#
|
268
|
-
# to 20 seconds,
|
269
|
-
#
|
270
|
-
#
|
271
|
-
#
|
272
|
-
#
|
273
|
-
#
|
274
|
-
#
|
275
|
-
#
|
276
|
-
#
|
277
|
-
#
|
278
|
-
#
|
279
|
-
#
|
280
|
-
# end
|
273
|
+
# @example
|
274
|
+
#
|
275
|
+
# # Modify the global config, setting the timeout for
|
276
|
+
# # resolve_service to 20 seconds,
|
277
|
+
# # and all remaining timeouts to 10 seconds.
|
278
|
+
# ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.configure do |config|
|
279
|
+
# config.timeout = 10.0
|
280
|
+
# config.rpcs.resolve_service.timeout = 20.0
|
281
|
+
# end
|
282
|
+
#
|
283
|
+
# # Apply the above configuration only to a new client.
|
284
|
+
# client = ::Google::Cloud::ServiceDirectory::V1beta1::LookupService::Client.new do |config|
|
285
|
+
# config.timeout = 10.0
|
286
|
+
# config.rpcs.resolve_service.timeout = 20.0
|
287
|
+
# end
|
281
288
|
#
|
282
289
|
# @!attribute [rw] endpoint
|
283
290
|
# The hostname or hostname:port of the service endpoint.
|
@@ -55,13 +55,12 @@ module Google
|
|
55
55
|
# See {::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client::Configuration}
|
56
56
|
# for a description of the configuration fields.
|
57
57
|
#
|
58
|
-
#
|
58
|
+
# @example
|
59
59
|
#
|
60
|
-
#
|
61
|
-
#
|
62
|
-
#
|
63
|
-
#
|
64
|
-
# end
|
60
|
+
# # Modify the configuration for all RegistrationService clients
|
61
|
+
# ::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client.configure do |config|
|
62
|
+
# config.timeout = 10.0
|
63
|
+
# end
|
65
64
|
#
|
66
65
|
# @yield [config] Configure the Client client.
|
67
66
|
# @yieldparam config [Client::Configuration]
|
@@ -81,10 +80,7 @@ module Google
|
|
81
80
|
|
82
81
|
default_config.timeout = 15.0
|
83
82
|
default_config.retry_policy = {
|
84
|
-
initial_delay: 1.0,
|
85
|
-
max_delay: 60.0,
|
86
|
-
multiplier: 1.3,
|
87
|
-
retry_codes: [14, 2]
|
83
|
+
initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 2]
|
88
84
|
}
|
89
85
|
|
90
86
|
default_config
|
@@ -116,19 +112,15 @@ module Google
|
|
116
112
|
##
|
117
113
|
# Create a new RegistrationService client object.
|
118
114
|
#
|
119
|
-
#
|
120
|
-
#
|
121
|
-
# To create a new RegistrationService client with the default
|
122
|
-
# configuration:
|
123
|
-
#
|
124
|
-
# client = ::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client.new
|
115
|
+
# @example
|
125
116
|
#
|
126
|
-
#
|
127
|
-
#
|
117
|
+
# # Create a client using the default configuration
|
118
|
+
# client = ::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client.new
|
128
119
|
#
|
129
|
-
#
|
130
|
-
#
|
131
|
-
#
|
120
|
+
# # Create a client using a custom configuration
|
121
|
+
# client = ::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client.new do |config|
|
122
|
+
# config.timeout = 10.0
|
123
|
+
# end
|
132
124
|
#
|
133
125
|
# @yield [config] Configure the RegistrationService client.
|
134
126
|
# @yieldparam config [Client::Configuration]
|
@@ -148,14 +140,13 @@ module Google
|
|
148
140
|
|
149
141
|
# Create credentials
|
150
142
|
credentials = @config.credentials
|
151
|
-
# Use self-signed JWT if the
|
143
|
+
# Use self-signed JWT if the endpoint is unchanged from default,
|
152
144
|
# but only if the default endpoint does not have a region prefix.
|
153
|
-
enable_self_signed_jwt = @config.
|
154
|
-
@config.endpoint == Client.configure.endpoint &&
|
145
|
+
enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
|
155
146
|
!@config.endpoint.split(".").first.include?("-")
|
156
147
|
credentials ||= Credentials.default scope: @config.scope,
|
157
148
|
enable_self_signed_jwt: enable_self_signed_jwt
|
158
|
-
if credentials.is_a?(String) || credentials.is_a?(Hash)
|
149
|
+
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
159
150
|
credentials = Credentials.new credentials, scope: @config.scope
|
160
151
|
end
|
161
152
|
@quota_project_id = @config.quota_project
|
@@ -173,7 +164,7 @@ module Google
|
|
173
164
|
# Service calls
|
174
165
|
|
175
166
|
##
|
176
|
-
# Creates a namespace, and returns the new
|
167
|
+
# Creates a namespace, and returns the new namespace.
|
177
168
|
#
|
178
169
|
# @overload create_namespace(request, options = nil)
|
179
170
|
# Pass arguments to `create_namespace` via a request object, either of type
|
@@ -238,7 +229,9 @@ module Google
|
|
238
229
|
options.apply_defaults timeout: @config.rpcs.create_namespace.timeout,
|
239
230
|
metadata: metadata,
|
240
231
|
retry_policy: @config.rpcs.create_namespace.retry_policy
|
241
|
-
|
232
|
+
|
233
|
+
options.apply_defaults timeout: @config.timeout,
|
234
|
+
metadata: @config.metadata,
|
242
235
|
retry_policy: @config.retry_policy
|
243
236
|
|
244
237
|
@registration_service_stub.call_rpc :create_namespace, request, options: options do |response, operation|
|
@@ -268,46 +261,51 @@ module Google
|
|
268
261
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
269
262
|
#
|
270
263
|
# @param parent [::String]
|
271
|
-
# Required. The resource name of the project and location whose namespaces
|
272
|
-
# list.
|
264
|
+
# Required. The resource name of the project and location whose namespaces you'd like
|
265
|
+
# to list.
|
273
266
|
# @param page_size [::Integer]
|
274
267
|
# Optional. The maximum number of items to return.
|
275
268
|
# @param page_token [::String]
|
276
269
|
# Optional. The next_page_token value returned from a previous List request, if any.
|
277
270
|
# @param filter [::String]
|
278
|
-
# Optional. The filter to list
|
271
|
+
# Optional. The filter to list results by.
|
279
272
|
#
|
280
|
-
# General filter string syntax:
|
281
|
-
#
|
282
|
-
#
|
283
|
-
#
|
284
|
-
#
|
285
|
-
#
|
286
|
-
#
|
273
|
+
# General `filter` string syntax:
|
274
|
+
# `<field> <operator> <value> (<logical connector>)`
|
275
|
+
#
|
276
|
+
# * `<field>` can be `name` or `labels.<key>` for map field
|
277
|
+
# * `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
|
278
|
+
# means `HAS`, and is roughly the same as `=`
|
279
|
+
# * `<value>` must be the same data type as field
|
280
|
+
# * `<logical connector>` can be `AND`, `OR`, `NOT`
|
287
281
|
#
|
288
282
|
# Examples of valid filters:
|
289
|
-
#
|
290
|
-
#
|
291
|
-
#
|
292
|
-
#
|
293
|
-
# *
|
294
|
-
#
|
295
|
-
#
|
296
|
-
# *
|
297
|
-
#
|
298
|
-
# *
|
299
|
-
#
|
300
|
-
#
|
283
|
+
#
|
284
|
+
# * `labels.owner` returns namespaces that have a label with the key
|
285
|
+
# `owner`, this is the same as `labels:owner`
|
286
|
+
# * `labels.owner=sd` returns namespaces that have key/value `owner=sd`
|
287
|
+
# * `name>projects/my-project/locations/us-east1/namespaces/namespace-c`
|
288
|
+
# returns namespaces that have name that is alphabetically later than the
|
289
|
+
# string, so "namespace-e" is returned but "namespace-a" is not
|
290
|
+
# * `labels.owner!=sd AND labels.foo=bar` returns namespaces that have
|
291
|
+
# `owner` in label key but value is not `sd` AND have key/value `foo=bar`
|
292
|
+
# * `doesnotexist.foo=bar` returns an empty list. Note that namespace
|
293
|
+
# doesn't have a field called "doesnotexist". Since the filter does not
|
294
|
+
# match any namespaces, it returns no results
|
295
|
+
#
|
296
|
+
# For more information about filtering, see
|
297
|
+
# [API Filtering](https://aip.dev/160).
|
301
298
|
# @param order_by [::String]
|
302
|
-
# Optional. The order to list
|
299
|
+
# Optional. The order to list results by.
|
300
|
+
#
|
301
|
+
# General `order_by` string syntax: `<field> (<asc|desc>) (,)`
|
303
302
|
#
|
304
|
-
#
|
305
|
-
#
|
306
|
-
#
|
307
|
-
#
|
308
|
-
#
|
309
|
-
#
|
310
|
-
# by name in ascending order.
|
303
|
+
# * `<field>` allows value: `name`
|
304
|
+
# * `<asc|desc>` ascending or descending order by `<field>`. If this is
|
305
|
+
# left blank, `asc` is used
|
306
|
+
#
|
307
|
+
# Note that an empty `order_by` string results in default order, which is
|
308
|
+
# order by `name` in ascending order.
|
311
309
|
#
|
312
310
|
# @yield [response, operation] Access the result along with the RPC operation
|
313
311
|
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ServiceDirectory::V1beta1::Namespace>]
|
@@ -343,7 +341,9 @@ module Google
|
|
343
341
|
options.apply_defaults timeout: @config.rpcs.list_namespaces.timeout,
|
344
342
|
metadata: metadata,
|
345
343
|
retry_policy: @config.rpcs.list_namespaces.retry_policy
|
346
|
-
|
344
|
+
|
345
|
+
options.apply_defaults timeout: @config.timeout,
|
346
|
+
metadata: @config.metadata,
|
347
347
|
retry_policy: @config.retry_policy
|
348
348
|
|
349
349
|
@registration_service_stub.call_rpc :list_namespaces, request, options: options do |response, operation|
|
@@ -410,7 +410,9 @@ module Google
|
|
410
410
|
options.apply_defaults timeout: @config.rpcs.get_namespace.timeout,
|
411
411
|
metadata: metadata,
|
412
412
|
retry_policy: @config.rpcs.get_namespace.retry_policy
|
413
|
-
|
413
|
+
|
414
|
+
options.apply_defaults timeout: @config.timeout,
|
415
|
+
metadata: @config.metadata,
|
414
416
|
retry_policy: @config.retry_policy
|
415
417
|
|
416
418
|
@registration_service_stub.call_rpc :get_namespace, request, options: options do |response, operation|
|
@@ -478,7 +480,9 @@ module Google
|
|
478
480
|
options.apply_defaults timeout: @config.rpcs.update_namespace.timeout,
|
479
481
|
metadata: metadata,
|
480
482
|
retry_policy: @config.rpcs.update_namespace.retry_policy
|
481
|
-
|
483
|
+
|
484
|
+
options.apply_defaults timeout: @config.timeout,
|
485
|
+
metadata: @config.metadata,
|
482
486
|
retry_policy: @config.retry_policy
|
483
487
|
|
484
488
|
@registration_service_stub.call_rpc :update_namespace, request, options: options do |response, operation|
|
@@ -545,7 +549,9 @@ module Google
|
|
545
549
|
options.apply_defaults timeout: @config.rpcs.delete_namespace.timeout,
|
546
550
|
metadata: metadata,
|
547
551
|
retry_policy: @config.rpcs.delete_namespace.retry_policy
|
548
|
-
|
552
|
+
|
553
|
+
options.apply_defaults timeout: @config.timeout,
|
554
|
+
metadata: @config.metadata,
|
549
555
|
retry_policy: @config.retry_policy
|
550
556
|
|
551
557
|
@registration_service_stub.call_rpc :delete_namespace, request, options: options do |response, operation|
|
@@ -557,7 +563,7 @@ module Google
|
|
557
563
|
end
|
558
564
|
|
559
565
|
##
|
560
|
-
# Creates a service, and returns the new
|
566
|
+
# Creates a service, and returns the new service.
|
561
567
|
#
|
562
568
|
# @overload create_service(request, options = nil)
|
563
569
|
# Pass arguments to `create_service` via a request object, either of type
|
@@ -621,7 +627,9 @@ module Google
|
|
621
627
|
options.apply_defaults timeout: @config.rpcs.create_service.timeout,
|
622
628
|
metadata: metadata,
|
623
629
|
retry_policy: @config.rpcs.create_service.retry_policy
|
624
|
-
|
630
|
+
|
631
|
+
options.apply_defaults timeout: @config.timeout,
|
632
|
+
metadata: @config.metadata,
|
625
633
|
retry_policy: @config.retry_policy
|
626
634
|
|
627
635
|
@registration_service_stub.call_rpc :create_service, request, options: options do |response, operation|
|
@@ -651,7 +659,7 @@ module Google
|
|
651
659
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
652
660
|
#
|
653
661
|
# @param parent [::String]
|
654
|
-
# Required. The resource name of the namespace whose services
|
662
|
+
# Required. The resource name of the namespace whose services you'd
|
655
663
|
# like to list.
|
656
664
|
# @param page_size [::Integer]
|
657
665
|
# Optional. The maximum number of items to return.
|
@@ -659,31 +667,47 @@ module Google
|
|
659
667
|
# Optional. The next_page_token value returned from a previous List request,
|
660
668
|
# if any.
|
661
669
|
# @param filter [::String]
|
662
|
-
# Optional. The filter to list
|
670
|
+
# Optional. The filter to list results by.
|
671
|
+
#
|
672
|
+
# General `filter` string syntax:
|
673
|
+
# `<field> <operator> <value> (<logical connector>)`
|
663
674
|
#
|
664
|
-
#
|
665
|
-
#
|
666
|
-
#
|
667
|
-
#
|
668
|
-
#
|
669
|
-
# <value> must be the same data type as field.
|
670
|
-
# <logical connector> can be "AND, OR, NOT".
|
675
|
+
# * `<field>` can be `name` or `metadata.<key>` for map field
|
676
|
+
# * `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
|
677
|
+
# means `HAS`, and is roughly the same as `=`
|
678
|
+
# * `<value>` must be the same data type as field
|
679
|
+
# * `<logical connector>` can be `AND`, `OR`, `NOT`
|
671
680
|
#
|
672
681
|
# Examples of valid filters:
|
673
|
-
#
|
674
|
-
#
|
675
|
-
#
|
676
|
-
#
|
677
|
-
#
|
678
|
-
#
|
679
|
-
#
|
680
|
-
#
|
681
|
-
#
|
682
|
-
# *
|
683
|
-
#
|
684
|
-
#
|
682
|
+
#
|
683
|
+
# * `metadata.owner` returns services that have a metadata with the key
|
684
|
+
# `owner`, this is the same as `metadata:owner`
|
685
|
+
# * `metadata.protocol=gRPC` returns services that have key/value
|
686
|
+
# `protocol=gRPC`
|
687
|
+
# *
|
688
|
+
# `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/service-c`
|
689
|
+
# returns services that have name that is alphabetically later than the
|
690
|
+
# string, so "service-e" is returned but "service-a" is not
|
691
|
+
# * `metadata.owner!=sd AND metadata.foo=bar` returns services that have
|
692
|
+
# `owner` in metadata key but value is not `sd` AND have key/value
|
693
|
+
# `foo=bar`
|
694
|
+
# * `doesnotexist.foo=bar` returns an empty list. Note that service
|
695
|
+
# doesn't have a field called "doesnotexist". Since the filter does not
|
696
|
+
# match any services, it returns no results
|
697
|
+
#
|
698
|
+
# For more information about filtering, see
|
699
|
+
# [API Filtering](https://aip.dev/160).
|
685
700
|
# @param order_by [::String]
|
686
|
-
# Optional. The order to list
|
701
|
+
# Optional. The order to list results by.
|
702
|
+
#
|
703
|
+
# General `order_by` string syntax: `<field> (<asc|desc>) (,)`
|
704
|
+
#
|
705
|
+
# * `<field>` allows value: `name`
|
706
|
+
# * `<asc|desc>` ascending or descending order by `<field>`. If this is
|
707
|
+
# left blank, `asc` is used
|
708
|
+
#
|
709
|
+
# Note that an empty `order_by` string results in default order, which is
|
710
|
+
# order by `name` in ascending order.
|
687
711
|
#
|
688
712
|
# @yield [response, operation] Access the result along with the RPC operation
|
689
713
|
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ServiceDirectory::V1beta1::Service>]
|
@@ -719,7 +743,9 @@ module Google
|
|
719
743
|
options.apply_defaults timeout: @config.rpcs.list_services.timeout,
|
720
744
|
metadata: metadata,
|
721
745
|
retry_policy: @config.rpcs.list_services.retry_policy
|
722
|
-
|
746
|
+
|
747
|
+
options.apply_defaults timeout: @config.timeout,
|
748
|
+
metadata: @config.metadata,
|
723
749
|
retry_policy: @config.retry_policy
|
724
750
|
|
725
751
|
@registration_service_stub.call_rpc :list_services, request, options: options do |response, operation|
|
@@ -786,7 +812,9 @@ module Google
|
|
786
812
|
options.apply_defaults timeout: @config.rpcs.get_service.timeout,
|
787
813
|
metadata: metadata,
|
788
814
|
retry_policy: @config.rpcs.get_service.retry_policy
|
789
|
-
|
815
|
+
|
816
|
+
options.apply_defaults timeout: @config.timeout,
|
817
|
+
metadata: @config.metadata,
|
790
818
|
retry_policy: @config.retry_policy
|
791
819
|
|
792
820
|
@registration_service_stub.call_rpc :get_service, request, options: options do |response, operation|
|
@@ -854,7 +882,9 @@ module Google
|
|
854
882
|
options.apply_defaults timeout: @config.rpcs.update_service.timeout,
|
855
883
|
metadata: metadata,
|
856
884
|
retry_policy: @config.rpcs.update_service.retry_policy
|
857
|
-
|
885
|
+
|
886
|
+
options.apply_defaults timeout: @config.timeout,
|
887
|
+
metadata: @config.metadata,
|
858
888
|
retry_policy: @config.retry_policy
|
859
889
|
|
860
890
|
@registration_service_stub.call_rpc :update_service, request, options: options do |response, operation|
|
@@ -921,7 +951,9 @@ module Google
|
|
921
951
|
options.apply_defaults timeout: @config.rpcs.delete_service.timeout,
|
922
952
|
metadata: metadata,
|
923
953
|
retry_policy: @config.rpcs.delete_service.retry_policy
|
924
|
-
|
954
|
+
|
955
|
+
options.apply_defaults timeout: @config.timeout,
|
956
|
+
metadata: @config.metadata,
|
925
957
|
retry_policy: @config.retry_policy
|
926
958
|
|
927
959
|
@registration_service_stub.call_rpc :delete_service, request, options: options do |response, operation|
|
@@ -933,7 +965,7 @@ module Google
|
|
933
965
|
end
|
934
966
|
|
935
967
|
##
|
936
|
-
# Creates
|
968
|
+
# Creates an endpoint, and returns the new endpoint.
|
937
969
|
#
|
938
970
|
# @overload create_endpoint(request, options = nil)
|
939
971
|
# Pass arguments to `create_endpoint` via a request object, either of type
|
@@ -997,7 +1029,9 @@ module Google
|
|
997
1029
|
options.apply_defaults timeout: @config.rpcs.create_endpoint.timeout,
|
998
1030
|
metadata: metadata,
|
999
1031
|
retry_policy: @config.rpcs.create_endpoint.retry_policy
|
1000
|
-
|
1032
|
+
|
1033
|
+
options.apply_defaults timeout: @config.timeout,
|
1034
|
+
metadata: @config.metadata,
|
1001
1035
|
retry_policy: @config.retry_policy
|
1002
1036
|
|
1003
1037
|
@registration_service_stub.call_rpc :create_endpoint, request, options: options do |response, operation|
|
@@ -1027,7 +1061,7 @@ module Google
|
|
1027
1061
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
1028
1062
|
#
|
1029
1063
|
# @param parent [::String]
|
1030
|
-
# Required. The resource name of the service whose endpoints
|
1064
|
+
# Required. The resource name of the service whose endpoints you'd like to
|
1031
1065
|
# list.
|
1032
1066
|
# @param page_size [::Integer]
|
1033
1067
|
# Optional. The maximum number of items to return.
|
@@ -1035,33 +1069,50 @@ module Google
|
|
1035
1069
|
# Optional. The next_page_token value returned from a previous List request,
|
1036
1070
|
# if any.
|
1037
1071
|
# @param filter [::String]
|
1038
|
-
# Optional. The filter to list
|
1072
|
+
# Optional. The filter to list results by.
|
1073
|
+
#
|
1074
|
+
# General `filter` string syntax:
|
1075
|
+
# `<field> <operator> <value> (<logical connector>)`
|
1039
1076
|
#
|
1040
|
-
#
|
1041
|
-
#
|
1042
|
-
#
|
1043
|
-
#
|
1044
|
-
#
|
1045
|
-
#
|
1046
|
-
# <logical connector> can be "AND, OR, NOT".
|
1077
|
+
# * `<field>` can be `name`, `address`, `port`, or `metadata.<key>` for map
|
1078
|
+
# field
|
1079
|
+
# * `<operator>` can be `<`, `>`, `<=`, `>=`, `!=`, `=`, `:`. Of which `:`
|
1080
|
+
# means `HAS`, and is roughly the same as `=`
|
1081
|
+
# * `<value>` must be the same data type as field
|
1082
|
+
# * `<logical connector>` can be `AND`, `OR`, `NOT`
|
1047
1083
|
#
|
1048
1084
|
# Examples of valid filters:
|
1049
|
-
#
|
1050
|
-
#
|
1051
|
-
#
|
1052
|
-
#
|
1053
|
-
#
|
1054
|
-
# *
|
1055
|
-
# *
|
1056
|
-
#
|
1057
|
-
#
|
1058
|
-
#
|
1059
|
-
#
|
1060
|
-
# *
|
1061
|
-
#
|
1062
|
-
#
|
1085
|
+
#
|
1086
|
+
# * `metadata.owner` returns endpoints that have a metadata with the key
|
1087
|
+
# `owner`, this is the same as `metadata:owner`
|
1088
|
+
# * `metadata.protocol=gRPC` returns endpoints that have key/value
|
1089
|
+
# `protocol=gRPC`
|
1090
|
+
# * `address=192.108.1.105` returns endpoints that have this address
|
1091
|
+
# * `port>8080` returns endpoints that have port number larger than 8080
|
1092
|
+
# *
|
1093
|
+
# `name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c`
|
1094
|
+
# returns endpoints that have name that is alphabetically later than the
|
1095
|
+
# string, so "endpoint-e" is returned but "endpoint-a" is not
|
1096
|
+
# * `metadata.owner!=sd AND metadata.foo=bar` returns endpoints that have
|
1097
|
+
# `owner` in metadata key but value is not `sd` AND have key/value
|
1098
|
+
# `foo=bar`
|
1099
|
+
# * `doesnotexist.foo=bar` returns an empty list. Note that endpoint
|
1100
|
+
# doesn't have a field called "doesnotexist". Since the filter does not
|
1101
|
+
# match any endpoints, it returns no results
|
1102
|
+
#
|
1103
|
+
# For more information about filtering, see
|
1104
|
+
# [API Filtering](https://aip.dev/160).
|
1063
1105
|
# @param order_by [::String]
|
1064
|
-
# Optional. The order to list
|
1106
|
+
# Optional. The order to list results by.
|
1107
|
+
#
|
1108
|
+
# General `order_by` string syntax: `<field> (<asc|desc>) (,)`
|
1109
|
+
#
|
1110
|
+
# * `<field>` allows values: `name`, `address`, `port`
|
1111
|
+
# * `<asc|desc>` ascending or descending order by `<field>`. If this is
|
1112
|
+
# left blank, `asc` is used
|
1113
|
+
#
|
1114
|
+
# Note that an empty `order_by` string results in default order, which is
|
1115
|
+
# order by `name` in ascending order.
|
1065
1116
|
#
|
1066
1117
|
# @yield [response, operation] Access the result along with the RPC operation
|
1067
1118
|
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ServiceDirectory::V1beta1::Endpoint>]
|
@@ -1097,7 +1148,9 @@ module Google
|
|
1097
1148
|
options.apply_defaults timeout: @config.rpcs.list_endpoints.timeout,
|
1098
1149
|
metadata: metadata,
|
1099
1150
|
retry_policy: @config.rpcs.list_endpoints.retry_policy
|
1100
|
-
|
1151
|
+
|
1152
|
+
options.apply_defaults timeout: @config.timeout,
|
1153
|
+
metadata: @config.metadata,
|
1101
1154
|
retry_policy: @config.retry_policy
|
1102
1155
|
|
1103
1156
|
@registration_service_stub.call_rpc :list_endpoints, request, options: options do |response, operation|
|
@@ -1110,7 +1163,7 @@ module Google
|
|
1110
1163
|
end
|
1111
1164
|
|
1112
1165
|
##
|
1113
|
-
# Gets
|
1166
|
+
# Gets an endpoint.
|
1114
1167
|
#
|
1115
1168
|
# @overload get_endpoint(request, options = nil)
|
1116
1169
|
# Pass arguments to `get_endpoint` via a request object, either of type
|
@@ -1164,7 +1217,9 @@ module Google
|
|
1164
1217
|
options.apply_defaults timeout: @config.rpcs.get_endpoint.timeout,
|
1165
1218
|
metadata: metadata,
|
1166
1219
|
retry_policy: @config.rpcs.get_endpoint.retry_policy
|
1167
|
-
|
1220
|
+
|
1221
|
+
options.apply_defaults timeout: @config.timeout,
|
1222
|
+
metadata: @config.metadata,
|
1168
1223
|
retry_policy: @config.retry_policy
|
1169
1224
|
|
1170
1225
|
@registration_service_stub.call_rpc :get_endpoint, request, options: options do |response, operation|
|
@@ -1176,7 +1231,7 @@ module Google
|
|
1176
1231
|
end
|
1177
1232
|
|
1178
1233
|
##
|
1179
|
-
# Updates
|
1234
|
+
# Updates an endpoint.
|
1180
1235
|
#
|
1181
1236
|
# @overload update_endpoint(request, options = nil)
|
1182
1237
|
# Pass arguments to `update_endpoint` via a request object, either of type
|
@@ -1232,7 +1287,9 @@ module Google
|
|
1232
1287
|
options.apply_defaults timeout: @config.rpcs.update_endpoint.timeout,
|
1233
1288
|
metadata: metadata,
|
1234
1289
|
retry_policy: @config.rpcs.update_endpoint.retry_policy
|
1235
|
-
|
1290
|
+
|
1291
|
+
options.apply_defaults timeout: @config.timeout,
|
1292
|
+
metadata: @config.metadata,
|
1236
1293
|
retry_policy: @config.retry_policy
|
1237
1294
|
|
1238
1295
|
@registration_service_stub.call_rpc :update_endpoint, request, options: options do |response, operation|
|
@@ -1244,7 +1301,7 @@ module Google
|
|
1244
1301
|
end
|
1245
1302
|
|
1246
1303
|
##
|
1247
|
-
# Deletes
|
1304
|
+
# Deletes an endpoint.
|
1248
1305
|
#
|
1249
1306
|
# @overload delete_endpoint(request, options = nil)
|
1250
1307
|
# Pass arguments to `delete_endpoint` via a request object, either of type
|
@@ -1298,7 +1355,9 @@ module Google
|
|
1298
1355
|
options.apply_defaults timeout: @config.rpcs.delete_endpoint.timeout,
|
1299
1356
|
metadata: metadata,
|
1300
1357
|
retry_policy: @config.rpcs.delete_endpoint.retry_policy
|
1301
|
-
|
1358
|
+
|
1359
|
+
options.apply_defaults timeout: @config.timeout,
|
1360
|
+
metadata: @config.metadata,
|
1302
1361
|
retry_policy: @config.retry_policy
|
1303
1362
|
|
1304
1363
|
@registration_service_stub.call_rpc :delete_endpoint, request, options: options do |response, operation|
|
@@ -1368,7 +1427,9 @@ module Google
|
|
1368
1427
|
options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
|
1369
1428
|
metadata: metadata,
|
1370
1429
|
retry_policy: @config.rpcs.get_iam_policy.retry_policy
|
1371
|
-
|
1430
|
+
|
1431
|
+
options.apply_defaults timeout: @config.timeout,
|
1432
|
+
metadata: @config.metadata,
|
1372
1433
|
retry_policy: @config.retry_policy
|
1373
1434
|
|
1374
1435
|
@registration_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
|
@@ -1440,7 +1501,9 @@ module Google
|
|
1440
1501
|
options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
|
1441
1502
|
metadata: metadata,
|
1442
1503
|
retry_policy: @config.rpcs.set_iam_policy.retry_policy
|
1443
|
-
|
1504
|
+
|
1505
|
+
options.apply_defaults timeout: @config.timeout,
|
1506
|
+
metadata: @config.metadata,
|
1444
1507
|
retry_policy: @config.retry_policy
|
1445
1508
|
|
1446
1509
|
@registration_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
|
@@ -1512,7 +1575,9 @@ module Google
|
|
1512
1575
|
options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
|
1513
1576
|
metadata: metadata,
|
1514
1577
|
retry_policy: @config.rpcs.test_iam_permissions.retry_policy
|
1515
|
-
|
1578
|
+
|
1579
|
+
options.apply_defaults timeout: @config.timeout,
|
1580
|
+
metadata: @config.metadata,
|
1516
1581
|
retry_policy: @config.retry_policy
|
1517
1582
|
|
1518
1583
|
@registration_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
|
@@ -1536,22 +1601,21 @@ module Google
|
|
1536
1601
|
# Configuration can be applied globally to all clients, or to a single client
|
1537
1602
|
# on construction.
|
1538
1603
|
#
|
1539
|
-
#
|
1540
|
-
#
|
1541
|
-
#
|
1542
|
-
# to 20 seconds,
|
1543
|
-
#
|
1544
|
-
#
|
1545
|
-
#
|
1546
|
-
#
|
1547
|
-
#
|
1548
|
-
#
|
1549
|
-
#
|
1550
|
-
#
|
1551
|
-
#
|
1552
|
-
#
|
1553
|
-
#
|
1554
|
-
# end
|
1604
|
+
# @example
|
1605
|
+
#
|
1606
|
+
# # Modify the global config, setting the timeout for
|
1607
|
+
# # create_namespace to 20 seconds,
|
1608
|
+
# # and all remaining timeouts to 10 seconds.
|
1609
|
+
# ::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client.configure do |config|
|
1610
|
+
# config.timeout = 10.0
|
1611
|
+
# config.rpcs.create_namespace.timeout = 20.0
|
1612
|
+
# end
|
1613
|
+
#
|
1614
|
+
# # Apply the above configuration only to a new client.
|
1615
|
+
# client = ::Google::Cloud::ServiceDirectory::V1beta1::RegistrationService::Client.new do |config|
|
1616
|
+
# config.timeout = 10.0
|
1617
|
+
# config.rpcs.create_namespace.timeout = 20.0
|
1618
|
+
# end
|
1555
1619
|
#
|
1556
1620
|
# @!attribute [rw] endpoint
|
1557
1621
|
# The hostname or hostname:port of the service endpoint.
|