google-cloud-agent_registry-v1 0.a → 0.1.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.
Files changed (48) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +12 -0
  3. data/AUTHENTICATION.md +122 -0
  4. data/README.md +154 -8
  5. data/lib/google/cloud/agent_registry/v1/agent_registry/client.rb +2651 -0
  6. data/lib/google/cloud/agent_registry/v1/agent_registry/credentials.rb +50 -0
  7. data/lib/google/cloud/agent_registry/v1/agent_registry/operations.rb +843 -0
  8. data/lib/google/cloud/agent_registry/v1/agent_registry/paths.rb +145 -0
  9. data/lib/google/cloud/agent_registry/v1/agent_registry/rest/client.rb +2483 -0
  10. data/lib/google/cloud/agent_registry/v1/agent_registry/rest/operations.rb +927 -0
  11. data/lib/google/cloud/agent_registry/v1/agent_registry/rest/service_stub.rb +1246 -0
  12. data/lib/google/cloud/agent_registry/v1/agent_registry/rest.rb +54 -0
  13. data/lib/google/cloud/agent_registry/v1/agent_registry.rb +56 -0
  14. data/lib/google/cloud/agent_registry/v1/bindings_override.rb +75 -0
  15. data/lib/google/cloud/agent_registry/v1/rest.rb +38 -0
  16. data/lib/google/cloud/agent_registry/v1/version.rb +7 -2
  17. data/lib/google/cloud/agent_registry/v1.rb +45 -0
  18. data/lib/google/cloud/agentregistry/v1/agent_pb.rb +33 -0
  19. data/lib/google/cloud/agentregistry/v1/agentregistry_service_pb.rb +63 -0
  20. data/lib/google/cloud/agentregistry/v1/agentregistry_service_services_pb.rb +81 -0
  21. data/lib/google/cloud/agentregistry/v1/binding_pb.rb +28 -0
  22. data/lib/google/cloud/agentregistry/v1/endpoint_pb.rb +27 -0
  23. data/lib/google/cloud/agentregistry/v1/mcp_server_pb.rb +29 -0
  24. data/lib/google/cloud/agentregistry/v1/properties_pb.rb +24 -0
  25. data/lib/google/cloud/agentregistry/v1/service_pb.rb +33 -0
  26. data/lib/google-cloud-agent_registry-v1.rb +21 -0
  27. data/proto_docs/README.md +4 -0
  28. data/proto_docs/google/api/client.rb +593 -0
  29. data/proto_docs/google/api/field_behavior.rb +85 -0
  30. data/proto_docs/google/api/field_info.rb +88 -0
  31. data/proto_docs/google/api/launch_stage.rb +71 -0
  32. data/proto_docs/google/api/resource.rb +227 -0
  33. data/proto_docs/google/cloud/agentregistry/v1/agent.rb +168 -0
  34. data/proto_docs/google/cloud/agentregistry/v1/agentregistry_service.rb +691 -0
  35. data/proto_docs/google/cloud/agentregistry/v1/binding.rb +105 -0
  36. data/proto_docs/google/cloud/agentregistry/v1/endpoint.rb +72 -0
  37. data/proto_docs/google/cloud/agentregistry/v1/mcp_server.rb +123 -0
  38. data/proto_docs/google/cloud/agentregistry/v1/properties.rb +53 -0
  39. data/proto_docs/google/cloud/agentregistry/v1/service.rb +155 -0
  40. data/proto_docs/google/longrunning/operations.rb +191 -0
  41. data/proto_docs/google/protobuf/any.rb +145 -0
  42. data/proto_docs/google/protobuf/duration.rb +98 -0
  43. data/proto_docs/google/protobuf/empty.rb +34 -0
  44. data/proto_docs/google/protobuf/field_mask.rb +229 -0
  45. data/proto_docs/google/protobuf/struct.rb +108 -0
  46. data/proto_docs/google/protobuf/timestamp.rb +127 -0
  47. data/proto_docs/google/rpc/status.rb +48 -0
  48. metadata +99 -9
@@ -0,0 +1,691 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module AgentRegistry
23
+ module V1
24
+ # Message for requesting list of Agents
25
+ # @!attribute [rw] parent
26
+ # @return [::String]
27
+ # Required. Parent value for ListAgentsRequest
28
+ # @!attribute [rw] page_size
29
+ # @return [::Integer]
30
+ # Optional. Requested page size. Server may return fewer items than
31
+ # requested. If unspecified, server will pick an appropriate default.
32
+ # @!attribute [rw] page_token
33
+ # @return [::String]
34
+ # Optional. A token identifying a page of results the server should return.
35
+ # @!attribute [rw] filter
36
+ # @return [::String]
37
+ # Optional. Filtering results
38
+ # @!attribute [rw] order_by
39
+ # @return [::String]
40
+ # Optional. Hint for how to order the results
41
+ class ListAgentsRequest
42
+ include ::Google::Protobuf::MessageExts
43
+ extend ::Google::Protobuf::MessageExts::ClassMethods
44
+ end
45
+
46
+ # Message for response to listing Agents
47
+ # @!attribute [rw] agents
48
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::Agent>]
49
+ # The list of Agents.
50
+ # @!attribute [rw] next_page_token
51
+ # @return [::String]
52
+ # A token identifying a page of results the server should return.
53
+ class ListAgentsResponse
54
+ include ::Google::Protobuf::MessageExts
55
+ extend ::Google::Protobuf::MessageExts::ClassMethods
56
+ end
57
+
58
+ # Message for searching Agents
59
+ # @!attribute [rw] parent
60
+ # @return [::String]
61
+ # Required. Parent value for SearchAgentsRequest. Format:
62
+ # `projects/{project}/locations/{location}`.
63
+ # @!attribute [rw] search_string
64
+ # @return [::String]
65
+ # Optional. Search criteria used to select the Agents to return. If no search
66
+ # criteria is specified then all accessible Agents will be returned.
67
+ #
68
+ # Search expressions can be used to restrict results based upon searchable
69
+ # fields, where the operators can be used along with the suffix wildcard
70
+ # symbol `*`. See
71
+ # [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools)
72
+ # for more details.
73
+ #
74
+ # Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`.
75
+ #
76
+ # Searchable fields:
77
+ #
78
+ # | Field | `=` | `:` | `*` | Keyword Search |
79
+ # |--------------------|-----|-----|-----|----------------|
80
+ # | agentId | Yes | Yes | Yes | Included |
81
+ # | name | No | Yes | Yes | Included |
82
+ # | displayName | No | Yes | Yes | Included |
83
+ # | description | No | Yes | No | Included |
84
+ # | skills | No | Yes | No | Included |
85
+ # | skills.id | No | Yes | No | Included |
86
+ # | skills.name | No | Yes | No | Included |
87
+ # | skills.description | No | Yes | No | Included |
88
+ # | skills.tags | No | Yes | No | Included |
89
+ # | skills.examples | No | Yes | No | Included |
90
+ #
91
+ # Examples:
92
+ #
93
+ # * `agentId="urn:agent:projects-123:projects:123:locations:us-central1:reasoningEngines:1234"`
94
+ # to find the agent with the specified agent ID.
95
+ # * `name:important` to find agents whose name contains `important` as a
96
+ # word.
97
+ # * `displayName:works*` to find agents whose display name contains words
98
+ # that start with `works`.
99
+ # * `skills.tags:test` to find agents whose skills tags contain `test`.
100
+ # * `planner OR booking` to find agents whose metadata contains the words
101
+ # `planner` or `booking`.
102
+ # @!attribute [rw] page_size
103
+ # @return [::Integer]
104
+ # Optional. The maximum number of search results to return per page. The page
105
+ # size is capped at `100`, even if a larger value is specified. A negative
106
+ # value will result in an `INVALID_ARGUMENT` error. If unspecified or set to
107
+ # `0`, a default value of `20` will be used. The server may return fewer
108
+ # results than requested.
109
+ # @!attribute [rw] page_token
110
+ # @return [::String]
111
+ # Optional. If present, retrieve the next batch of results from the preceding
112
+ # call to this method. `page_token` must be the value of `next_page_token`
113
+ # from the previous response. The values of all other method parameters, must
114
+ # be identical to those in the previous call.
115
+ class SearchAgentsRequest
116
+ include ::Google::Protobuf::MessageExts
117
+ extend ::Google::Protobuf::MessageExts::ClassMethods
118
+ end
119
+
120
+ # Message for response to searching Agents
121
+ # @!attribute [rw] agents
122
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::Agent>]
123
+ # A list of Agents that match the `search_string`.
124
+ # @!attribute [rw] next_page_token
125
+ # @return [::String]
126
+ # If there are more results than those appearing in this response, then
127
+ # `next_page_token` is included. To get the next set of results, call this
128
+ # method again using the value of `next_page_token` as `page_token`.
129
+ class SearchAgentsResponse
130
+ include ::Google::Protobuf::MessageExts
131
+ extend ::Google::Protobuf::MessageExts::ClassMethods
132
+ end
133
+
134
+ # Message for getting a Agent
135
+ # @!attribute [rw] name
136
+ # @return [::String]
137
+ # Required. Name of the resource
138
+ class GetAgentRequest
139
+ include ::Google::Protobuf::MessageExts
140
+ extend ::Google::Protobuf::MessageExts::ClassMethods
141
+ end
142
+
143
+ # Message for requesting list of Endpoints
144
+ # @!attribute [rw] parent
145
+ # @return [::String]
146
+ # Required. The project and location to list endpoints in.
147
+ # Expected format: `projects/{project}/locations/{location}`.
148
+ # @!attribute [rw] page_size
149
+ # @return [::Integer]
150
+ # Optional. Requested page size. Server may return fewer items than
151
+ # requested. If unspecified, server will pick an appropriate default.
152
+ # @!attribute [rw] page_token
153
+ # @return [::String]
154
+ # Optional. A token identifying a page of results the server should return.
155
+ # @!attribute [rw] filter
156
+ # @return [::String]
157
+ # Optional. A query string used to filter the list of endpoints returned.
158
+ # The filter expression must follow AIP-160 syntax.
159
+ #
160
+ # Filtering is supported on the `name`, `display_name`, `description`,
161
+ # `version`, and `interfaces` fields.
162
+ #
163
+ # Some examples:
164
+ #
165
+ # * `name = "projects/p1/locations/l1/endpoints/e1"`
166
+ # * `display_name = "my-endpoint"`
167
+ # * `description = "my-endpoint-description"`
168
+ # * `version = "v1"`
169
+ # * `interfaces.transport = "HTTP_JSON"`
170
+ class ListEndpointsRequest
171
+ include ::Google::Protobuf::MessageExts
172
+ extend ::Google::Protobuf::MessageExts::ClassMethods
173
+ end
174
+
175
+ # Message for response to listing Endpoints
176
+ # @!attribute [rw] endpoints
177
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::Endpoint>]
178
+ # The list of Endpoint resources matching the parent and filter criteria in
179
+ # the request. Each Endpoint resource follows the format:
180
+ # `projects/{project}/locations/{location}/endpoints/{endpoint}`.
181
+ # @!attribute [rw] next_page_token
182
+ # @return [::String]
183
+ # A token identifying a page of results the server should return.
184
+ # Used in
185
+ # [page_token][google.cloud.agentregistry.v1main.ListEndpointsRequest.page_token].
186
+ class ListEndpointsResponse
187
+ include ::Google::Protobuf::MessageExts
188
+ extend ::Google::Protobuf::MessageExts::ClassMethods
189
+ end
190
+
191
+ # Message for getting a Endpoint
192
+ # @!attribute [rw] name
193
+ # @return [::String]
194
+ # Required. The name of the endpoint to retrieve.
195
+ # Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`
196
+ class GetEndpointRequest
197
+ include ::Google::Protobuf::MessageExts
198
+ extend ::Google::Protobuf::MessageExts::ClassMethods
199
+ end
200
+
201
+ # Message for requesting list of McpServers
202
+ # @!attribute [rw] parent
203
+ # @return [::String]
204
+ # Required. Parent value for ListMcpServersRequest. Format:
205
+ # `projects/{project}/locations/{location}`.
206
+ # @!attribute [rw] page_size
207
+ # @return [::Integer]
208
+ # Optional. Requested page size. Server may return fewer items than
209
+ # requested. If unspecified, server will pick an appropriate default.
210
+ # @!attribute [rw] page_token
211
+ # @return [::String]
212
+ # Optional. A token identifying a page of results the server should return.
213
+ # @!attribute [rw] filter
214
+ # @return [::String]
215
+ # Optional. Filtering results
216
+ # @!attribute [rw] order_by
217
+ # @return [::String]
218
+ # Optional. Hint for how to order the results
219
+ class ListMcpServersRequest
220
+ include ::Google::Protobuf::MessageExts
221
+ extend ::Google::Protobuf::MessageExts::ClassMethods
222
+ end
223
+
224
+ # Message for response to listing McpServers
225
+ # @!attribute [rw] mcp_servers
226
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::McpServer>]
227
+ # The list of McpServers.
228
+ # @!attribute [rw] next_page_token
229
+ # @return [::String]
230
+ # A token identifying a page of results the server should return.
231
+ class ListMcpServersResponse
232
+ include ::Google::Protobuf::MessageExts
233
+ extend ::Google::Protobuf::MessageExts::ClassMethods
234
+ end
235
+
236
+ # Message for searching MCP Servers
237
+ # @!attribute [rw] parent
238
+ # @return [::String]
239
+ # Required. Parent value for SearchMcpServersRequest. Format:
240
+ # `projects/{project}/locations/{location}`.
241
+ # @!attribute [rw] search_string
242
+ # @return [::String]
243
+ # Optional. Search criteria used to select the MCP Servers to return. If no
244
+ # search criteria is specified then all accessible MCP Servers will be
245
+ # returned.
246
+ #
247
+ # Search expressions can be used to restrict results based upon searchable
248
+ # fields, where the operators can be used along with the suffix wildcard
249
+ # symbol `*`. See
250
+ # [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools)
251
+ # for more details.
252
+ #
253
+ # Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`.
254
+ #
255
+ # Searchable fields:
256
+ #
257
+ # | Field | `=` | `:` | `*` | Keyword Search |
258
+ # |--------------------|-----|-----|-----|----------------|
259
+ # | mcpServerId | Yes | Yes | Yes | Included |
260
+ # | name | No | Yes | Yes | Included |
261
+ # | displayName | No | Yes | Yes | Included |
262
+ #
263
+ # Examples:
264
+ #
265
+ # * `mcpServerId="urn:mcp:projects-123:projects:123:locations:us-central1:agentregistry:services:service-id"`
266
+ # to find the MCP Server with the specified MCP Server ID.
267
+ # * `name:important` to find MCP Servers whose name contains `important` as a
268
+ # word.
269
+ # * `displayName:works*` to find MCP Servers whose display name contains
270
+ # words that start with `works`.
271
+ # * `planner OR booking` to find MCP Servers whose metadata contains the
272
+ # words `planner` or `booking`.
273
+ # * `mcpServerId:service-id AND (displayName:planner OR
274
+ # displayName:booking)` to find MCP Servers whose MCP Server ID contains
275
+ # `service-id` and whose display name contains `planner` or
276
+ # `booking`.
277
+ # @!attribute [rw] page_size
278
+ # @return [::Integer]
279
+ # Optional. The maximum number of search results to return per page. The page
280
+ # size is capped at `100`, even if a larger value is specified. A negative
281
+ # value will result in an `INVALID_ARGUMENT` error. If unspecified or set to
282
+ # `0`, a default value of `20` will be used. The server may return fewer
283
+ # results than requested.
284
+ # @!attribute [rw] page_token
285
+ # @return [::String]
286
+ # Optional. If present, retrieve the next batch of results from the preceding
287
+ # call to this method. `page_token` must be the value of `next_page_token`
288
+ # from the previous response. The values of all other method parameters, must
289
+ # be identical to those in the previous call.
290
+ class SearchMcpServersRequest
291
+ include ::Google::Protobuf::MessageExts
292
+ extend ::Google::Protobuf::MessageExts::ClassMethods
293
+ end
294
+
295
+ # Message for response to searching MCP Servers
296
+ # @!attribute [rw] mcp_servers
297
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::McpServer>]
298
+ # A list of McpServers that match the `search_string`.
299
+ # @!attribute [rw] next_page_token
300
+ # @return [::String]
301
+ # If there are more results than those appearing in this response, then
302
+ # `next_page_token` is included. To get the next set of results, call this
303
+ # method again using the value of `next_page_token` as `page_token`.
304
+ class SearchMcpServersResponse
305
+ include ::Google::Protobuf::MessageExts
306
+ extend ::Google::Protobuf::MessageExts::ClassMethods
307
+ end
308
+
309
+ # Message for getting a McpServer
310
+ # @!attribute [rw] name
311
+ # @return [::String]
312
+ # Required. Name of the resource
313
+ class GetMcpServerRequest
314
+ include ::Google::Protobuf::MessageExts
315
+ extend ::Google::Protobuf::MessageExts::ClassMethods
316
+ end
317
+
318
+ # Message for requesting list of Services
319
+ # @!attribute [rw] parent
320
+ # @return [::String]
321
+ # Required. The project and location to list services in.
322
+ # Expected format: `projects/{project}/locations/{location}`.
323
+ # @!attribute [rw] page_size
324
+ # @return [::Integer]
325
+ # Optional. Requested page size. Server may return fewer items than
326
+ # requested. If unspecified, server will pick an appropriate default.
327
+ # @!attribute [rw] page_token
328
+ # @return [::String]
329
+ # Optional. A token identifying a page of results the server should return.
330
+ # @!attribute [rw] filter
331
+ # @return [::String]
332
+ # Optional. A query string used to filter the list of services returned.
333
+ # The filter expression must follow AIP-160 syntax.
334
+ #
335
+ # Filtering is supported on the `name`, `display_name`, `description`,
336
+ # and `labels` fields.
337
+ #
338
+ # Some examples:
339
+ #
340
+ # * `name = "projects/p1/locations/l1/services/s1"`
341
+ # * `display_name = "my-service"`
342
+ # * `description : "myservice description"`
343
+ # * `labels.env = "prod"`
344
+ class ListServicesRequest
345
+ include ::Google::Protobuf::MessageExts
346
+ extend ::Google::Protobuf::MessageExts::ClassMethods
347
+ end
348
+
349
+ # Message for response to listing Services
350
+ # @!attribute [rw] services
351
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::Service>]
352
+ # The list of Service resources matching the parent and filter criteria in
353
+ # the request. Each Service resource follows the format:
354
+ # `projects/{project}/locations/{location}/services/{service}`.
355
+ # @!attribute [rw] next_page_token
356
+ # @return [::String]
357
+ # A token identifying a page of results the server should return.
358
+ # Used in
359
+ # [page_token][google.cloud.agentregistry.v1main.ListServicesRequest.page_token].
360
+ class ListServicesResponse
361
+ include ::Google::Protobuf::MessageExts
362
+ extend ::Google::Protobuf::MessageExts::ClassMethods
363
+ end
364
+
365
+ # Message for getting a Service
366
+ # @!attribute [rw] name
367
+ # @return [::String]
368
+ # Required. The name of the Service.
369
+ # Format: `projects/{project}/locations/{location}/services/{service}`.
370
+ class GetServiceRequest
371
+ include ::Google::Protobuf::MessageExts
372
+ extend ::Google::Protobuf::MessageExts::ClassMethods
373
+ end
374
+
375
+ # Message for creating a Service
376
+ # @!attribute [rw] parent
377
+ # @return [::String]
378
+ # Required. The project and location to create the Service in.
379
+ # Expected format: `projects/{project}/locations/{location}`.
380
+ # @!attribute [rw] service_id
381
+ # @return [::String]
382
+ # Required. The ID to use for the service, which will become the final
383
+ # component of the service's resource name.
384
+ #
385
+ # This value should be 4-63 characters, and valid characters
386
+ # are `/[a-z][0-9]-/`.
387
+ # @!attribute [rw] service
388
+ # @return [::Google::Cloud::AgentRegistry::V1::Service]
389
+ # Required. The Service resource that is being created.
390
+ # Format: `projects/{project}/locations/{location}/services/{service}`.
391
+ # @!attribute [rw] request_id
392
+ # @return [::String]
393
+ # Optional. An optional request ID to identify requests. Specify a unique
394
+ # request ID so that if you must retry your request, the server will know to
395
+ # ignore the request if it has already been completed. The server will
396
+ # guarantee that for at least 60 minutes since the first request.
397
+ #
398
+ # For example, consider a situation where you make an initial request and the
399
+ # request times out. If you make the request again with the same request
400
+ # ID, the server can check if original operation with the same request ID
401
+ # was received, and if so, will ignore the second request. This prevents
402
+ # clients from accidentally creating duplicate commitments.
403
+ #
404
+ # The request ID must be a valid UUID with the exception that zero UUID is
405
+ # not supported (00000000-0000-0000-0000-000000000000).
406
+ class CreateServiceRequest
407
+ include ::Google::Protobuf::MessageExts
408
+ extend ::Google::Protobuf::MessageExts::ClassMethods
409
+ end
410
+
411
+ # Message for fetching available Bindings.
412
+ # @!attribute [rw] source_identifier
413
+ # @return [::String]
414
+ # The identifier of the source Agent.
415
+ # Format:
416
+ #
417
+ # * `urn:agent:{publisher}:{namespace}:{name}`
418
+ # @!attribute [rw] target_identifier
419
+ # @return [::String]
420
+ # Optional. The identifier of the target Agent, MCP Server, or Endpoint.
421
+ # Format:
422
+ #
423
+ # * `urn:agent:{publisher}:{namespace}:{name}`
424
+ # * `urn:mcp:{publisher}:{namespace}:{name}`
425
+ # * `urn:endpoint:{publisher}:{namespace}:{name}`
426
+ # @!attribute [rw] parent
427
+ # @return [::String]
428
+ # Required. The parent, in the format
429
+ # `projects/{project}/locations/{location}`.
430
+ # @!attribute [rw] page_size
431
+ # @return [::Integer]
432
+ # Optional. Requested page size. Server may return fewer items than
433
+ # requested. Page size is 500 if unspecified and is capped at `500` even if a
434
+ # larger value is given.
435
+ # @!attribute [rw] page_token
436
+ # @return [::String]
437
+ # Optional. A token identifying a page of results the server should return.
438
+ class FetchAvailableBindingsRequest
439
+ include ::Google::Protobuf::MessageExts
440
+ extend ::Google::Protobuf::MessageExts::ClassMethods
441
+ end
442
+
443
+ # Message for response to fetching available Bindings.
444
+ # @!attribute [rw] bindings
445
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::Binding>]
446
+ # The list of Bindings.
447
+ # @!attribute [rw] next_page_token
448
+ # @return [::String]
449
+ # A token identifying a page of results the server should return.
450
+ class FetchAvailableBindingsResponse
451
+ include ::Google::Protobuf::MessageExts
452
+ extend ::Google::Protobuf::MessageExts::ClassMethods
453
+ end
454
+
455
+ # Message for updating a Service
456
+ # @!attribute [rw] update_mask
457
+ # @return [::Google::Protobuf::FieldMask]
458
+ # Optional. Field mask is used to specify the fields to be overwritten in the
459
+ # Service resource by the update.
460
+ # The fields specified in the update_mask are relative to the resource, not
461
+ # the full request. A field will be overwritten if it is in the mask. If the
462
+ # user does not provide a mask then all fields present in the request will be
463
+ # overwritten.
464
+ # @!attribute [rw] service
465
+ # @return [::Google::Cloud::AgentRegistry::V1::Service]
466
+ # Required. The Service resource that is being updated.
467
+ # Format: `projects/{project}/locations/{location}/services/{service}`.
468
+ # @!attribute [rw] request_id
469
+ # @return [::String]
470
+ # Optional. An optional request ID to identify requests. Specify a unique
471
+ # request ID so that if you must retry your request, the server will know to
472
+ # ignore the request if it has already been completed. The server will
473
+ # guarantee that for at least 60 minutes since the first request.
474
+ #
475
+ # For example, consider a situation where you make an initial request and the
476
+ # request times out. If you make the request again with the same request
477
+ # ID, the server can check if original operation with the same request ID
478
+ # was received, and if so, will ignore the second request. This prevents
479
+ # clients from accidentally creating duplicate commitments.
480
+ #
481
+ # The request ID must be a valid UUID with the exception that zero UUID is
482
+ # not supported (00000000-0000-0000-0000-000000000000).
483
+ class UpdateServiceRequest
484
+ include ::Google::Protobuf::MessageExts
485
+ extend ::Google::Protobuf::MessageExts::ClassMethods
486
+ end
487
+
488
+ # Message for deleting a Service
489
+ # @!attribute [rw] name
490
+ # @return [::String]
491
+ # Required. The name of the Service.
492
+ # Format: `projects/{project}/locations/{location}/services/{service}`.
493
+ # @!attribute [rw] request_id
494
+ # @return [::String]
495
+ # Optional. An optional request ID to identify requests. Specify a unique
496
+ # request ID so that if you must retry your request, the server will know to
497
+ # ignore the request if it has already been completed. The server will
498
+ # guarantee that for at least 60 minutes after the first request.
499
+ #
500
+ # For example, consider a situation where you make an initial request and the
501
+ # request times out. If you make the request again with the same request
502
+ # ID, the server can check if original operation with the same request ID
503
+ # was received, and if so, will ignore the second request. This prevents
504
+ # clients from accidentally creating duplicate commitments.
505
+ #
506
+ # The request ID must be a valid UUID with the exception that zero UUID is
507
+ # not supported (00000000-0000-0000-0000-000000000000).
508
+ class DeleteServiceRequest
509
+ include ::Google::Protobuf::MessageExts
510
+ extend ::Google::Protobuf::MessageExts::ClassMethods
511
+ end
512
+
513
+ # Represents the metadata of the long-running operation.
514
+ # @!attribute [r] create_time
515
+ # @return [::Google::Protobuf::Timestamp]
516
+ # Output only. The time the operation was created.
517
+ # @!attribute [r] end_time
518
+ # @return [::Google::Protobuf::Timestamp]
519
+ # Output only. The time the operation finished running.
520
+ # @!attribute [r] target
521
+ # @return [::String]
522
+ # Output only. Server-defined resource path for the target of the operation.
523
+ # @!attribute [r] verb
524
+ # @return [::String]
525
+ # Output only. Name of the verb executed by the operation.
526
+ # @!attribute [r] status_message
527
+ # @return [::String]
528
+ # Output only. Human-readable status of the operation, if any.
529
+ # @!attribute [r] requested_cancellation
530
+ # @return [::Boolean]
531
+ # Output only. Identifies whether the user has requested cancellation
532
+ # of the operation. Operations that have been cancelled successfully
533
+ # have
534
+ # {::Google::Longrunning::Operation#error google.longrunning.Operation.error}
535
+ # value with a {::Google::Rpc::Status#code google.rpc.Status.code} of `1`,
536
+ # corresponding to `Code.CANCELLED`.
537
+ # @!attribute [r] api_version
538
+ # @return [::String]
539
+ # Output only. API version used to start the operation.
540
+ class OperationMetadata
541
+ include ::Google::Protobuf::MessageExts
542
+ extend ::Google::Protobuf::MessageExts::ClassMethods
543
+ end
544
+
545
+ # Message for requesting a list of Bindings.
546
+ # @!attribute [rw] parent
547
+ # @return [::String]
548
+ # Required. The project and location to list bindings in.
549
+ # Expected format: `projects/{project}/locations/{location}`.
550
+ # @!attribute [rw] page_size
551
+ # @return [::Integer]
552
+ # Optional. Requested page size. Server may return fewer items than
553
+ # requested. Page size is 500 if unspecified and is capped at `500` even if a
554
+ # larger value is given.
555
+ # @!attribute [rw] page_token
556
+ # @return [::String]
557
+ # Optional. A token identifying a page of results the server should return.
558
+ # @!attribute [rw] filter
559
+ # @return [::String]
560
+ # Optional. A query string used to filter the list of bindings returned.
561
+ # The filter expression must follow AIP-160 syntax.
562
+ # @!attribute [rw] order_by
563
+ # @return [::String]
564
+ # Optional. Hint for how to order the results
565
+ class ListBindingsRequest
566
+ include ::Google::Protobuf::MessageExts
567
+ extend ::Google::Protobuf::MessageExts::ClassMethods
568
+ end
569
+
570
+ # Message for response to listing Bindings
571
+ # @!attribute [rw] bindings
572
+ # @return [::Array<::Google::Cloud::AgentRegistry::V1::Binding>]
573
+ # The list of Binding resources matching the parent and filter criteria in
574
+ # the request. Each Binding resource follows the format:
575
+ # `projects/{project}/locations/{location}/bindings/{binding}`.
576
+ # @!attribute [rw] next_page_token
577
+ # @return [::String]
578
+ # A token identifying a page of results the server should return.
579
+ # Used in
580
+ # [page_token][google.cloud.agentregistry.v1main.ListBindingsRequest.page_token].
581
+ class ListBindingsResponse
582
+ include ::Google::Protobuf::MessageExts
583
+ extend ::Google::Protobuf::MessageExts::ClassMethods
584
+ end
585
+
586
+ # Message for getting a Binding
587
+ # @!attribute [rw] name
588
+ # @return [::String]
589
+ # Required. The name of the Binding.
590
+ # Format: `projects/{project}/locations/{location}/bindings/{binding}`.
591
+ class GetBindingRequest
592
+ include ::Google::Protobuf::MessageExts
593
+ extend ::Google::Protobuf::MessageExts::ClassMethods
594
+ end
595
+
596
+ # Message for creating a Binding
597
+ # @!attribute [rw] parent
598
+ # @return [::String]
599
+ # Required. The project and location to create the Binding in.
600
+ # Expected format: `projects/{project}/locations/{location}`.
601
+ # @!attribute [rw] binding_id
602
+ # @return [::String]
603
+ # Required. The ID to use for the binding, which will become the final
604
+ # component of the binding's resource name.
605
+ #
606
+ # This value should be 4-63 characters, and must conform to RFC-1034.
607
+ # Specifically, it must match the regular expression
608
+ # `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
609
+ # @!attribute [rw] binding
610
+ # @return [::Google::Cloud::AgentRegistry::V1::Binding]
611
+ # Required. The Binding resource that is being created.
612
+ # @!attribute [rw] request_id
613
+ # @return [::String]
614
+ # Optional. An optional request ID to identify requests. Specify a unique
615
+ # request ID so that if you must retry your request, the server will know to
616
+ # ignore the request if it has already been completed. The server will
617
+ # guarantee that for at least 60 minutes since the first request.
618
+ #
619
+ # For example, consider a situation where you make an initial request and the
620
+ # request times out. If you make the request again with the same request
621
+ # ID, the server can check if original operation with the same request ID
622
+ # was received, and if so, will ignore the second request. This prevents
623
+ # clients from accidentally creating duplicate commitments.
624
+ #
625
+ # The request ID must be a valid UUID with the exception that zero UUID is
626
+ # not supported (00000000-0000-0000-0000-000000000000).
627
+ class CreateBindingRequest
628
+ include ::Google::Protobuf::MessageExts
629
+ extend ::Google::Protobuf::MessageExts::ClassMethods
630
+ end
631
+
632
+ # Message for updating a Binding
633
+ # @!attribute [rw] binding
634
+ # @return [::Google::Cloud::AgentRegistry::V1::Binding]
635
+ # Required. The Binding resource that is being updated.
636
+ # @!attribute [rw] update_mask
637
+ # @return [::Google::Protobuf::FieldMask]
638
+ # Optional. Field mask is used to specify the fields to be overwritten in the
639
+ # Binding resource by the update.
640
+ # The fields specified in the update_mask are relative to the resource, not
641
+ # the full request. A field will be overwritten if it is in the mask. If the
642
+ # user does not provide a mask then all fields present in the request will be
643
+ # overwritten.
644
+ # @!attribute [rw] request_id
645
+ # @return [::String]
646
+ # Optional. An optional request ID to identify requests. Specify a unique
647
+ # request ID so that if you must retry your request, the server will know to
648
+ # ignore the request if it has already been completed. The server will
649
+ # guarantee that for at least 60 minutes since the first request.
650
+ #
651
+ # For example, consider a situation where you make an initial request and the
652
+ # request times out. If you make the request again with the same request
653
+ # ID, the server can check if original operation with the same request ID
654
+ # was received, and if so, will ignore the second request. This prevents
655
+ # clients from accidentally creating duplicate commitments.
656
+ #
657
+ # The request ID must be a valid UUID with the exception that zero UUID is
658
+ # not supported (00000000-0000-0000-0000-000000000000).
659
+ class UpdateBindingRequest
660
+ include ::Google::Protobuf::MessageExts
661
+ extend ::Google::Protobuf::MessageExts::ClassMethods
662
+ end
663
+
664
+ # Message for deleting a Binding
665
+ # @!attribute [rw] name
666
+ # @return [::String]
667
+ # Required. The name of the Binding.
668
+ # Format: `projects/{project}/locations/{location}/bindings/{binding}`.
669
+ # @!attribute [rw] request_id
670
+ # @return [::String]
671
+ # Optional. An optional request ID to identify requests. Specify a unique
672
+ # request ID so that if you must retry your request, the server will know to
673
+ # ignore the request if it has already been completed. The server will
674
+ # guarantee that for at least 60 minutes after the first request.
675
+ #
676
+ # For example, consider a situation where you make an initial request and the
677
+ # request times out. If you make the request again with the same request
678
+ # ID, the server can check if original operation with the same request ID
679
+ # was received, and if so, will ignore the second request. This prevents
680
+ # clients from accidentally creating duplicate commitments.
681
+ #
682
+ # The request ID must be a valid UUID with the exception that zero UUID is
683
+ # not supported (00000000-0000-0000-0000-000000000000).
684
+ class DeleteBindingRequest
685
+ include ::Google::Protobuf::MessageExts
686
+ extend ::Google::Protobuf::MessageExts::ClassMethods
687
+ end
688
+ end
689
+ end
690
+ end
691
+ end