google-apis-apigeeregistry_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,3691 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module ApigeeregistryV1
23
+ # Apigee Registry API
24
+ #
25
+ #
26
+ #
27
+ # @example
28
+ # require 'google/apis/apigeeregistry_v1'
29
+ #
30
+ # Apigeeregistry = Google::Apis::ApigeeregistryV1 # Alias the module
31
+ # service = Apigeeregistry::ApigeeRegistryService.new
32
+ #
33
+ # @see https://cloud.google.com/apigee/docs/api-hub/what-is-api-hub
34
+ class ApigeeRegistryService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ attr_accessor :quota_user
44
+
45
+ def initialize
46
+ super('https://apigeeregistry.googleapis.com/', '',
47
+ client_name: 'google-apis-apigeeregistry_v1',
48
+ client_version: Google::Apis::ApigeeregistryV1::GEM_VERSION)
49
+ @batch_path = 'batch'
50
+ end
51
+
52
+ # Gets information about a location.
53
+ # @param [String] name
54
+ # Resource name for the location.
55
+ # @param [String] fields
56
+ # Selector specifying which fields to include in a partial response.
57
+ # @param [String] quota_user
58
+ # Available to use for quota purposes for server-side applications. Can be any
59
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
60
+ # @param [Google::Apis::RequestOptions] options
61
+ # Request-specific options
62
+ #
63
+ # @yield [result, err] Result & error if block supplied
64
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Location] parsed result object
65
+ # @yieldparam err [StandardError] error object if request failed
66
+ #
67
+ # @return [Google::Apis::ApigeeregistryV1::Location]
68
+ #
69
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
70
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
71
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
72
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
73
+ command = make_simple_command(:get, 'v1/{+name}', options)
74
+ command.response_representation = Google::Apis::ApigeeregistryV1::Location::Representation
75
+ command.response_class = Google::Apis::ApigeeregistryV1::Location
76
+ command.params['name'] = name unless name.nil?
77
+ command.query['fields'] = fields unless fields.nil?
78
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
79
+ execute_or_queue_command(command, &block)
80
+ end
81
+
82
+ # Lists information about the supported locations for this service.
83
+ # @param [String] name
84
+ # The resource that owns the locations collection, if applicable.
85
+ # @param [String] filter
86
+ # A filter to narrow down results to a preferred subset. The filtering language
87
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
88
+ # in [AIP-160](https://google.aip.dev/160).
89
+ # @param [Fixnum] page_size
90
+ # The maximum number of results to return. If not set, the service selects a
91
+ # default.
92
+ # @param [String] page_token
93
+ # A page token received from the `next_page_token` field in the response. Send
94
+ # that page token to receive the subsequent page.
95
+ # @param [String] fields
96
+ # Selector specifying which fields to include in a partial response.
97
+ # @param [String] quota_user
98
+ # Available to use for quota purposes for server-side applications. Can be any
99
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
100
+ # @param [Google::Apis::RequestOptions] options
101
+ # Request-specific options
102
+ #
103
+ # @yield [result, err] Result & error if block supplied
104
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListLocationsResponse] parsed result object
105
+ # @yieldparam err [StandardError] error object if request failed
106
+ #
107
+ # @return [Google::Apis::ApigeeregistryV1::ListLocationsResponse]
108
+ #
109
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
110
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
111
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
112
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
113
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
114
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListLocationsResponse::Representation
115
+ command.response_class = Google::Apis::ApigeeregistryV1::ListLocationsResponse
116
+ command.params['name'] = name unless name.nil?
117
+ command.query['filter'] = filter unless filter.nil?
118
+ command.query['pageSize'] = page_size unless page_size.nil?
119
+ command.query['pageToken'] = page_token unless page_token.nil?
120
+ command.query['fields'] = fields unless fields.nil?
121
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
122
+ execute_or_queue_command(command, &block)
123
+ end
124
+
125
+ # CreateApi creates a specified API.
126
+ # @param [String] parent
127
+ # Required. The parent, which owns this collection of APIs. Format: projects/*/
128
+ # locations/*
129
+ # @param [Google::Apis::ApigeeregistryV1::Api] api_object
130
+ # @param [String] api_id
131
+ # Required. The ID to use for the api, which will become the final component of
132
+ # the api's resource name. This value should be 4-63 characters, and valid
133
+ # characters are /a-z-/. Following AIP-162, IDs must not have the form of a UUID.
134
+ # @param [String] fields
135
+ # Selector specifying which fields to include in a partial response.
136
+ # @param [String] quota_user
137
+ # Available to use for quota purposes for server-side applications. Can be any
138
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
139
+ # @param [Google::Apis::RequestOptions] options
140
+ # Request-specific options
141
+ #
142
+ # @yield [result, err] Result & error if block supplied
143
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Api] parsed result object
144
+ # @yieldparam err [StandardError] error object if request failed
145
+ #
146
+ # @return [Google::Apis::ApigeeregistryV1::Api]
147
+ #
148
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
149
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
150
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
151
+ def create_project_location_api(parent, api_object = nil, api_id: nil, fields: nil, quota_user: nil, options: nil, &block)
152
+ command = make_simple_command(:post, 'v1/{+parent}/apis', options)
153
+ command.request_representation = Google::Apis::ApigeeregistryV1::Api::Representation
154
+ command.request_object = api_object
155
+ command.response_representation = Google::Apis::ApigeeregistryV1::Api::Representation
156
+ command.response_class = Google::Apis::ApigeeregistryV1::Api
157
+ command.params['parent'] = parent unless parent.nil?
158
+ command.query['apiId'] = api_id unless api_id.nil?
159
+ command.query['fields'] = fields unless fields.nil?
160
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
161
+ execute_or_queue_command(command, &block)
162
+ end
163
+
164
+ # DeleteApi removes a specified API and all of the resources that it owns.
165
+ # @param [String] name
166
+ # Required. The name of the API to delete. Format: projects/*/locations/*/apis/*
167
+ # @param [String] fields
168
+ # Selector specifying which fields to include in a partial response.
169
+ # @param [String] quota_user
170
+ # Available to use for quota purposes for server-side applications. Can be any
171
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
172
+ # @param [Google::Apis::RequestOptions] options
173
+ # Request-specific options
174
+ #
175
+ # @yield [result, err] Result & error if block supplied
176
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
177
+ # @yieldparam err [StandardError] error object if request failed
178
+ #
179
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
180
+ #
181
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
182
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
183
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
184
+ def delete_project_location_api(name, fields: nil, quota_user: nil, options: nil, &block)
185
+ command = make_simple_command(:delete, 'v1/{+name}', options)
186
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
187
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
188
+ command.params['name'] = name unless name.nil?
189
+ command.query['fields'] = fields unless fields.nil?
190
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
191
+ execute_or_queue_command(command, &block)
192
+ end
193
+
194
+ # GetApi returns a specified API.
195
+ # @param [String] name
196
+ # Required. The name of the API to retrieve. Format: projects/*/locations/*/apis/
197
+ # *
198
+ # @param [String] fields
199
+ # Selector specifying which fields to include in a partial response.
200
+ # @param [String] quota_user
201
+ # Available to use for quota purposes for server-side applications. Can be any
202
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
203
+ # @param [Google::Apis::RequestOptions] options
204
+ # Request-specific options
205
+ #
206
+ # @yield [result, err] Result & error if block supplied
207
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Api] parsed result object
208
+ # @yieldparam err [StandardError] error object if request failed
209
+ #
210
+ # @return [Google::Apis::ApigeeregistryV1::Api]
211
+ #
212
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
213
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
214
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
215
+ def get_project_location_api(name, fields: nil, quota_user: nil, options: nil, &block)
216
+ command = make_simple_command(:get, 'v1/{+name}', options)
217
+ command.response_representation = Google::Apis::ApigeeregistryV1::Api::Representation
218
+ command.response_class = Google::Apis::ApigeeregistryV1::Api
219
+ command.params['name'] = name unless name.nil?
220
+ command.query['fields'] = fields unless fields.nil?
221
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
222
+ execute_or_queue_command(command, &block)
223
+ end
224
+
225
+ # Gets the access control policy for a resource. Returns an empty policy if the
226
+ # resource exists and does not have a policy set.
227
+ # @param [String] resource
228
+ # REQUIRED: The resource for which the policy is being requested. See the
229
+ # operation documentation for the appropriate value for this field.
230
+ # @param [Fixnum] options_requested_policy_version
231
+ # Optional. The maximum policy version that will be used to format the policy.
232
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
233
+ # rejected. Requests for policies with any conditional role bindings must
234
+ # specify version 3. Policies with no conditional role bindings may specify any
235
+ # valid value or leave the field unset. The policy in the response might use the
236
+ # policy version that you specified, or it might use a lower policy version. For
237
+ # example, if you specify version 3, but the policy has no conditional role
238
+ # bindings, the response uses version 1. To learn which resources support
239
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
240
+ # google.com/iam/help/conditions/resource-policies).
241
+ # @param [String] fields
242
+ # Selector specifying which fields to include in a partial response.
243
+ # @param [String] quota_user
244
+ # Available to use for quota purposes for server-side applications. Can be any
245
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
246
+ # @param [Google::Apis::RequestOptions] options
247
+ # Request-specific options
248
+ #
249
+ # @yield [result, err] Result & error if block supplied
250
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
251
+ # @yieldparam err [StandardError] error object if request failed
252
+ #
253
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
254
+ #
255
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
256
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
257
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
258
+ def get_project_location_api_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
259
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
260
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
261
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
262
+ command.params['resource'] = resource unless resource.nil?
263
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
264
+ command.query['fields'] = fields unless fields.nil?
265
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
266
+ execute_or_queue_command(command, &block)
267
+ end
268
+
269
+ # ListApis returns matching APIs.
270
+ # @param [String] parent
271
+ # Required. The parent, which owns this collection of APIs. Format: projects/*/
272
+ # locations/*
273
+ # @param [String] filter
274
+ # An expression that can be used to filter the list. Filters use the Common
275
+ # Expression Language and can refer to all message fields.
276
+ # @param [Fixnum] page_size
277
+ # The maximum number of APIs to return. The service may return fewer than this
278
+ # value. If unspecified, at most 50 values will be returned. The maximum is 1000;
279
+ # values above 1000 will be coerced to 1000.
280
+ # @param [String] page_token
281
+ # A page token, received from a previous `ListApis` call. Provide this to
282
+ # retrieve the subsequent page. When paginating, all other parameters provided
283
+ # to `ListApis` must match the call that provided the page token.
284
+ # @param [String] fields
285
+ # Selector specifying which fields to include in a partial response.
286
+ # @param [String] quota_user
287
+ # Available to use for quota purposes for server-side applications. Can be any
288
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
289
+ # @param [Google::Apis::RequestOptions] options
290
+ # Request-specific options
291
+ #
292
+ # @yield [result, err] Result & error if block supplied
293
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListApisResponse] parsed result object
294
+ # @yieldparam err [StandardError] error object if request failed
295
+ #
296
+ # @return [Google::Apis::ApigeeregistryV1::ListApisResponse]
297
+ #
298
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
299
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
300
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
301
+ def list_project_location_apis(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
302
+ command = make_simple_command(:get, 'v1/{+parent}/apis', options)
303
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListApisResponse::Representation
304
+ command.response_class = Google::Apis::ApigeeregistryV1::ListApisResponse
305
+ command.params['parent'] = parent unless parent.nil?
306
+ command.query['filter'] = filter unless filter.nil?
307
+ command.query['pageSize'] = page_size unless page_size.nil?
308
+ command.query['pageToken'] = page_token unless page_token.nil?
309
+ command.query['fields'] = fields unless fields.nil?
310
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
311
+ execute_or_queue_command(command, &block)
312
+ end
313
+
314
+ # UpdateApi can be used to modify a specified API.
315
+ # @param [String] name
316
+ # Resource name.
317
+ # @param [Google::Apis::ApigeeregistryV1::Api] api_object
318
+ # @param [Boolean] allow_missing
319
+ # If set to true, and the api is not found, a new api will be created. In this
320
+ # situation, `update_mask` is ignored.
321
+ # @param [String] update_mask
322
+ # The list of fields to be updated. If omitted, all fields are updated that are
323
+ # set in the request message (fields set to default values are ignored). If a "*"
324
+ # is specified, all fields are updated, including fields that are unspecified/
325
+ # default in the request.
326
+ # @param [String] fields
327
+ # Selector specifying which fields to include in a partial response.
328
+ # @param [String] quota_user
329
+ # Available to use for quota purposes for server-side applications. Can be any
330
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
331
+ # @param [Google::Apis::RequestOptions] options
332
+ # Request-specific options
333
+ #
334
+ # @yield [result, err] Result & error if block supplied
335
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Api] parsed result object
336
+ # @yieldparam err [StandardError] error object if request failed
337
+ #
338
+ # @return [Google::Apis::ApigeeregistryV1::Api]
339
+ #
340
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
341
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
342
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
343
+ def patch_project_location_api(name, api_object = nil, allow_missing: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
344
+ command = make_simple_command(:patch, 'v1/{+name}', options)
345
+ command.request_representation = Google::Apis::ApigeeregistryV1::Api::Representation
346
+ command.request_object = api_object
347
+ command.response_representation = Google::Apis::ApigeeregistryV1::Api::Representation
348
+ command.response_class = Google::Apis::ApigeeregistryV1::Api
349
+ command.params['name'] = name unless name.nil?
350
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
351
+ command.query['updateMask'] = update_mask unless update_mask.nil?
352
+ command.query['fields'] = fields unless fields.nil?
353
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
354
+ execute_or_queue_command(command, &block)
355
+ end
356
+
357
+ # Sets the access control policy on the specified resource. Replaces any
358
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
359
+ # PERMISSION_DENIED` errors.
360
+ # @param [String] resource
361
+ # REQUIRED: The resource for which the policy is being specified. See the
362
+ # operation documentation for the appropriate value for this field.
363
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
364
+ # @param [String] fields
365
+ # Selector specifying which fields to include in a partial response.
366
+ # @param [String] quota_user
367
+ # Available to use for quota purposes for server-side applications. Can be any
368
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
369
+ # @param [Google::Apis::RequestOptions] options
370
+ # Request-specific options
371
+ #
372
+ # @yield [result, err] Result & error if block supplied
373
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
374
+ # @yieldparam err [StandardError] error object if request failed
375
+ #
376
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
377
+ #
378
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
379
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
380
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
381
+ def set_api_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
382
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
383
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
384
+ command.request_object = set_iam_policy_request_object
385
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
386
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
387
+ command.params['resource'] = resource unless resource.nil?
388
+ command.query['fields'] = fields unless fields.nil?
389
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
390
+ execute_or_queue_command(command, &block)
391
+ end
392
+
393
+ # Returns permissions that a caller has on the specified resource. If the
394
+ # resource does not exist, this will return an empty set of permissions, not a `
395
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
396
+ # permission-aware UIs and command-line tools, not for authorization checking.
397
+ # This operation may "fail open" without warning.
398
+ # @param [String] resource
399
+ # REQUIRED: The resource for which the policy detail is being requested. See the
400
+ # operation documentation for the appropriate value for this field.
401
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
402
+ # @param [String] fields
403
+ # Selector specifying which fields to include in a partial response.
404
+ # @param [String] quota_user
405
+ # Available to use for quota purposes for server-side applications. Can be any
406
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
407
+ # @param [Google::Apis::RequestOptions] options
408
+ # Request-specific options
409
+ #
410
+ # @yield [result, err] Result & error if block supplied
411
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
412
+ # @yieldparam err [StandardError] error object if request failed
413
+ #
414
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
415
+ #
416
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
417
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
418
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
419
+ def test_api_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
420
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
421
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
422
+ command.request_object = test_iam_permissions_request_object
423
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
424
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
425
+ command.params['resource'] = resource unless resource.nil?
426
+ command.query['fields'] = fields unless fields.nil?
427
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
428
+ execute_or_queue_command(command, &block)
429
+ end
430
+
431
+ # CreateArtifact creates a specified artifact.
432
+ # @param [String] parent
433
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
434
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
435
+ # @param [String] artifact_id
436
+ # Required. The ID to use for the artifact, which will become the final
437
+ # component of the artifact's resource name. This value should be 4-63
438
+ # characters, and valid characters are /a-z-/. Following AIP-162, IDs must not
439
+ # have the form of a UUID.
440
+ # @param [String] fields
441
+ # Selector specifying which fields to include in a partial response.
442
+ # @param [String] quota_user
443
+ # Available to use for quota purposes for server-side applications. Can be any
444
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
445
+ # @param [Google::Apis::RequestOptions] options
446
+ # Request-specific options
447
+ #
448
+ # @yield [result, err] Result & error if block supplied
449
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
450
+ # @yieldparam err [StandardError] error object if request failed
451
+ #
452
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
453
+ #
454
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
455
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
456
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
457
+ def create_project_location_api_artifact(parent, artifact_object = nil, artifact_id: nil, fields: nil, quota_user: nil, options: nil, &block)
458
+ command = make_simple_command(:post, 'v1/{+parent}/artifacts', options)
459
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
460
+ command.request_object = artifact_object
461
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
462
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
463
+ command.params['parent'] = parent unless parent.nil?
464
+ command.query['artifactId'] = artifact_id unless artifact_id.nil?
465
+ command.query['fields'] = fields unless fields.nil?
466
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
467
+ execute_or_queue_command(command, &block)
468
+ end
469
+
470
+ # DeleteArtifact removes a specified artifact.
471
+ # @param [String] name
472
+ # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
473
+ # @param [String] fields
474
+ # Selector specifying which fields to include in a partial response.
475
+ # @param [String] quota_user
476
+ # Available to use for quota purposes for server-side applications. Can be any
477
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
478
+ # @param [Google::Apis::RequestOptions] options
479
+ # Request-specific options
480
+ #
481
+ # @yield [result, err] Result & error if block supplied
482
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
483
+ # @yieldparam err [StandardError] error object if request failed
484
+ #
485
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
486
+ #
487
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
488
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
489
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
490
+ def delete_project_location_api_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
491
+ command = make_simple_command(:delete, 'v1/{+name}', options)
492
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
493
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
494
+ command.params['name'] = name unless name.nil?
495
+ command.query['fields'] = fields unless fields.nil?
496
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
497
+ execute_or_queue_command(command, &block)
498
+ end
499
+
500
+ # GetArtifact returns a specified artifact.
501
+ # @param [String] name
502
+ # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
503
+ # @param [String] fields
504
+ # Selector specifying which fields to include in a partial response.
505
+ # @param [String] quota_user
506
+ # Available to use for quota purposes for server-side applications. Can be any
507
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
508
+ # @param [Google::Apis::RequestOptions] options
509
+ # Request-specific options
510
+ #
511
+ # @yield [result, err] Result & error if block supplied
512
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
513
+ # @yieldparam err [StandardError] error object if request failed
514
+ #
515
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
516
+ #
517
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
518
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
519
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
520
+ def get_project_location_api_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
521
+ command = make_simple_command(:get, 'v1/{+name}', options)
522
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
523
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
524
+ command.params['name'] = name unless name.nil?
525
+ command.query['fields'] = fields unless fields.nil?
526
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
527
+ execute_or_queue_command(command, &block)
528
+ end
529
+
530
+ # GetArtifactContents returns the contents of a specified artifact. If artifacts
531
+ # are stored with GZip compression, the default behavior is to return the
532
+ # artifact uncompressed (the mime_type response field indicates the exact format
533
+ # returned).
534
+ # @param [String] name
535
+ # Required. The name of the artifact whose contents should be retrieved. Format:
536
+ # `parent`/artifacts/*
537
+ # @param [String] fields
538
+ # Selector specifying which fields to include in a partial response.
539
+ # @param [String] quota_user
540
+ # Available to use for quota purposes for server-side applications. Can be any
541
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
542
+ # @param [Google::Apis::RequestOptions] options
543
+ # Request-specific options
544
+ #
545
+ # @yield [result, err] Result & error if block supplied
546
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::HttpBody] parsed result object
547
+ # @yieldparam err [StandardError] error object if request failed
548
+ #
549
+ # @return [Google::Apis::ApigeeregistryV1::HttpBody]
550
+ #
551
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
552
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
553
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
554
+ def get_project_location_api_artifact_contents(name, fields: nil, quota_user: nil, options: nil, &block)
555
+ command = make_simple_command(:get, 'v1/{+name}:getContents', options)
556
+ command.response_representation = Google::Apis::ApigeeregistryV1::HttpBody::Representation
557
+ command.response_class = Google::Apis::ApigeeregistryV1::HttpBody
558
+ command.params['name'] = name unless name.nil?
559
+ command.query['fields'] = fields unless fields.nil?
560
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
561
+ execute_or_queue_command(command, &block)
562
+ end
563
+
564
+ # Gets the access control policy for a resource. Returns an empty policy if the
565
+ # resource exists and does not have a policy set.
566
+ # @param [String] resource
567
+ # REQUIRED: The resource for which the policy is being requested. See the
568
+ # operation documentation for the appropriate value for this field.
569
+ # @param [Fixnum] options_requested_policy_version
570
+ # Optional. The maximum policy version that will be used to format the policy.
571
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
572
+ # rejected. Requests for policies with any conditional role bindings must
573
+ # specify version 3. Policies with no conditional role bindings may specify any
574
+ # valid value or leave the field unset. The policy in the response might use the
575
+ # policy version that you specified, or it might use a lower policy version. For
576
+ # example, if you specify version 3, but the policy has no conditional role
577
+ # bindings, the response uses version 1. To learn which resources support
578
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
579
+ # google.com/iam/help/conditions/resource-policies).
580
+ # @param [String] fields
581
+ # Selector specifying which fields to include in a partial response.
582
+ # @param [String] quota_user
583
+ # Available to use for quota purposes for server-side applications. Can be any
584
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
585
+ # @param [Google::Apis::RequestOptions] options
586
+ # Request-specific options
587
+ #
588
+ # @yield [result, err] Result & error if block supplied
589
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
590
+ # @yieldparam err [StandardError] error object if request failed
591
+ #
592
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
593
+ #
594
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
595
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
596
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
597
+ def get_project_location_api_artifact_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
598
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
599
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
600
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
601
+ command.params['resource'] = resource unless resource.nil?
602
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
603
+ command.query['fields'] = fields unless fields.nil?
604
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
605
+ execute_or_queue_command(command, &block)
606
+ end
607
+
608
+ # ListArtifacts returns matching artifacts.
609
+ # @param [String] parent
610
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
611
+ # @param [String] filter
612
+ # An expression that can be used to filter the list. Filters use the Common
613
+ # Expression Language and can refer to all message fields except contents.
614
+ # @param [Fixnum] page_size
615
+ # The maximum number of artifacts to return. The service may return fewer than
616
+ # this value. If unspecified, at most 50 values will be returned. The maximum is
617
+ # 1000; values above 1000 will be coerced to 1000.
618
+ # @param [String] page_token
619
+ # A page token, received from a previous `ListArtifacts` call. Provide this to
620
+ # retrieve the subsequent page. When paginating, all other parameters provided
621
+ # to `ListArtifacts` must match the call that provided the page token.
622
+ # @param [String] fields
623
+ # Selector specifying which fields to include in a partial response.
624
+ # @param [String] quota_user
625
+ # Available to use for quota purposes for server-side applications. Can be any
626
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
627
+ # @param [Google::Apis::RequestOptions] options
628
+ # Request-specific options
629
+ #
630
+ # @yield [result, err] Result & error if block supplied
631
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListArtifactsResponse] parsed result object
632
+ # @yieldparam err [StandardError] error object if request failed
633
+ #
634
+ # @return [Google::Apis::ApigeeregistryV1::ListArtifactsResponse]
635
+ #
636
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
637
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
638
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
639
+ def list_project_location_api_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
640
+ command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
641
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
642
+ command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
643
+ command.params['parent'] = parent unless parent.nil?
644
+ command.query['filter'] = filter unless filter.nil?
645
+ command.query['pageSize'] = page_size unless page_size.nil?
646
+ command.query['pageToken'] = page_token unless page_token.nil?
647
+ command.query['fields'] = fields unless fields.nil?
648
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
649
+ execute_or_queue_command(command, &block)
650
+ end
651
+
652
+ # ReplaceArtifact can be used to replace a specified artifact.
653
+ # @param [String] name
654
+ # Resource name.
655
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
656
+ # @param [String] fields
657
+ # Selector specifying which fields to include in a partial response.
658
+ # @param [String] quota_user
659
+ # Available to use for quota purposes for server-side applications. Can be any
660
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
661
+ # @param [Google::Apis::RequestOptions] options
662
+ # Request-specific options
663
+ #
664
+ # @yield [result, err] Result & error if block supplied
665
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
666
+ # @yieldparam err [StandardError] error object if request failed
667
+ #
668
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
669
+ #
670
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
671
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
672
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
673
+ def replace_project_location_api_artifact_artifact(name, artifact_object = nil, fields: nil, quota_user: nil, options: nil, &block)
674
+ command = make_simple_command(:put, 'v1/{+name}', options)
675
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
676
+ command.request_object = artifact_object
677
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
678
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
679
+ command.params['name'] = name unless name.nil?
680
+ command.query['fields'] = fields unless fields.nil?
681
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
682
+ execute_or_queue_command(command, &block)
683
+ end
684
+
685
+ # Sets the access control policy on the specified resource. Replaces any
686
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
687
+ # PERMISSION_DENIED` errors.
688
+ # @param [String] resource
689
+ # REQUIRED: The resource for which the policy is being specified. See the
690
+ # operation documentation for the appropriate value for this field.
691
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
692
+ # @param [String] fields
693
+ # Selector specifying which fields to include in a partial response.
694
+ # @param [String] quota_user
695
+ # Available to use for quota purposes for server-side applications. Can be any
696
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
697
+ # @param [Google::Apis::RequestOptions] options
698
+ # Request-specific options
699
+ #
700
+ # @yield [result, err] Result & error if block supplied
701
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
702
+ # @yieldparam err [StandardError] error object if request failed
703
+ #
704
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
705
+ #
706
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
707
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
708
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
709
+ def set_project_location_api_artifact_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
710
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
711
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
712
+ command.request_object = set_iam_policy_request_object
713
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
714
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
715
+ command.params['resource'] = resource unless resource.nil?
716
+ command.query['fields'] = fields unless fields.nil?
717
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
718
+ execute_or_queue_command(command, &block)
719
+ end
720
+
721
+ # Returns permissions that a caller has on the specified resource. If the
722
+ # resource does not exist, this will return an empty set of permissions, not a `
723
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
724
+ # permission-aware UIs and command-line tools, not for authorization checking.
725
+ # This operation may "fail open" without warning.
726
+ # @param [String] resource
727
+ # REQUIRED: The resource for which the policy detail is being requested. See the
728
+ # operation documentation for the appropriate value for this field.
729
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
730
+ # @param [String] fields
731
+ # Selector specifying which fields to include in a partial response.
732
+ # @param [String] quota_user
733
+ # Available to use for quota purposes for server-side applications. Can be any
734
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
735
+ # @param [Google::Apis::RequestOptions] options
736
+ # Request-specific options
737
+ #
738
+ # @yield [result, err] Result & error if block supplied
739
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
740
+ # @yieldparam err [StandardError] error object if request failed
741
+ #
742
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
743
+ #
744
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
745
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
746
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
747
+ def test_project_location_api_artifact_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
748
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
749
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
750
+ command.request_object = test_iam_permissions_request_object
751
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
752
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
753
+ command.params['resource'] = resource unless resource.nil?
754
+ command.query['fields'] = fields unless fields.nil?
755
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
756
+ execute_or_queue_command(command, &block)
757
+ end
758
+
759
+ # CreateApiDeployment creates a specified deployment.
760
+ # @param [String] parent
761
+ # Required. The parent, which owns this collection of deployments. Format:
762
+ # projects/*/locations/*/apis/*
763
+ # @param [Google::Apis::ApigeeregistryV1::ApiDeployment] api_deployment_object
764
+ # @param [String] api_deployment_id
765
+ # Required. The ID to use for the deployment, which will become the final
766
+ # component of the deployment's resource name. This value should be 4-63
767
+ # characters, and valid characters are /a-z-/. Following AIP-162, IDs must not
768
+ # have the form of a UUID.
769
+ # @param [String] fields
770
+ # Selector specifying which fields to include in a partial response.
771
+ # @param [String] quota_user
772
+ # Available to use for quota purposes for server-side applications. Can be any
773
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
774
+ # @param [Google::Apis::RequestOptions] options
775
+ # Request-specific options
776
+ #
777
+ # @yield [result, err] Result & error if block supplied
778
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiDeployment] parsed result object
779
+ # @yieldparam err [StandardError] error object if request failed
780
+ #
781
+ # @return [Google::Apis::ApigeeregistryV1::ApiDeployment]
782
+ #
783
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
784
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
785
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
786
+ def create_project_location_api_deployment(parent, api_deployment_object = nil, api_deployment_id: nil, fields: nil, quota_user: nil, options: nil, &block)
787
+ command = make_simple_command(:post, 'v1/{+parent}/deployments', options)
788
+ command.request_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
789
+ command.request_object = api_deployment_object
790
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
791
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiDeployment
792
+ command.params['parent'] = parent unless parent.nil?
793
+ command.query['apiDeploymentId'] = api_deployment_id unless api_deployment_id.nil?
794
+ command.query['fields'] = fields unless fields.nil?
795
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
796
+ execute_or_queue_command(command, &block)
797
+ end
798
+
799
+ # DeleteApiDeployment removes a specified deployment, all revisions, and all
800
+ # child resources (e.g. artifacts).
801
+ # @param [String] name
802
+ # Required. The name of the deployment to delete. Format: projects/*/locations/*/
803
+ # apis/*/deployments/*
804
+ # @param [Boolean] force
805
+ # If set to true, any child resources will also be deleted. (Otherwise, the
806
+ # request will only work if there are no child resources.)
807
+ # @param [String] fields
808
+ # Selector specifying which fields to include in a partial response.
809
+ # @param [String] quota_user
810
+ # Available to use for quota purposes for server-side applications. Can be any
811
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
812
+ # @param [Google::Apis::RequestOptions] options
813
+ # Request-specific options
814
+ #
815
+ # @yield [result, err] Result & error if block supplied
816
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
817
+ # @yieldparam err [StandardError] error object if request failed
818
+ #
819
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
820
+ #
821
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
822
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
823
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
824
+ def delete_project_location_api_deployment(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
825
+ command = make_simple_command(:delete, 'v1/{+name}', options)
826
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
827
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
828
+ command.params['name'] = name unless name.nil?
829
+ command.query['force'] = force unless force.nil?
830
+ command.query['fields'] = fields unless fields.nil?
831
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
832
+ execute_or_queue_command(command, &block)
833
+ end
834
+
835
+ # DeleteApiDeploymentRevision deletes a revision of a deployment.
836
+ # @param [String] name
837
+ # Required. The name of the deployment revision to be deleted, with a revision
838
+ # ID explicitly included. Example: projects/sample/locations/global/apis/
839
+ # petstore/deployments/prod@c7cfa2a8
840
+ # @param [String] fields
841
+ # Selector specifying which fields to include in a partial response.
842
+ # @param [String] quota_user
843
+ # Available to use for quota purposes for server-side applications. Can be any
844
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
845
+ # @param [Google::Apis::RequestOptions] options
846
+ # Request-specific options
847
+ #
848
+ # @yield [result, err] Result & error if block supplied
849
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiDeployment] parsed result object
850
+ # @yieldparam err [StandardError] error object if request failed
851
+ #
852
+ # @return [Google::Apis::ApigeeregistryV1::ApiDeployment]
853
+ #
854
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
855
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
856
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
857
+ def delete_project_location_api_deployment_revision(name, fields: nil, quota_user: nil, options: nil, &block)
858
+ command = make_simple_command(:delete, 'v1/{+name}:deleteRevision', options)
859
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
860
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiDeployment
861
+ command.params['name'] = name unless name.nil?
862
+ command.query['fields'] = fields unless fields.nil?
863
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
864
+ execute_or_queue_command(command, &block)
865
+ end
866
+
867
+ # GetApiDeployment returns a specified deployment.
868
+ # @param [String] name
869
+ # Required. The name of the deployment to retrieve. Format: projects/*/locations/
870
+ # */apis/*/deployments/*
871
+ # @param [String] fields
872
+ # Selector specifying which fields to include in a partial response.
873
+ # @param [String] quota_user
874
+ # Available to use for quota purposes for server-side applications. Can be any
875
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
876
+ # @param [Google::Apis::RequestOptions] options
877
+ # Request-specific options
878
+ #
879
+ # @yield [result, err] Result & error if block supplied
880
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiDeployment] parsed result object
881
+ # @yieldparam err [StandardError] error object if request failed
882
+ #
883
+ # @return [Google::Apis::ApigeeregistryV1::ApiDeployment]
884
+ #
885
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
886
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
887
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
888
+ def get_project_location_api_deployment(name, fields: nil, quota_user: nil, options: nil, &block)
889
+ command = make_simple_command(:get, 'v1/{+name}', options)
890
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
891
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiDeployment
892
+ command.params['name'] = name unless name.nil?
893
+ command.query['fields'] = fields unless fields.nil?
894
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
895
+ execute_or_queue_command(command, &block)
896
+ end
897
+
898
+ # Gets the access control policy for a resource. Returns an empty policy if the
899
+ # resource exists and does not have a policy set.
900
+ # @param [String] resource
901
+ # REQUIRED: The resource for which the policy is being requested. See the
902
+ # operation documentation for the appropriate value for this field.
903
+ # @param [Fixnum] options_requested_policy_version
904
+ # Optional. The maximum policy version that will be used to format the policy.
905
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
906
+ # rejected. Requests for policies with any conditional role bindings must
907
+ # specify version 3. Policies with no conditional role bindings may specify any
908
+ # valid value or leave the field unset. The policy in the response might use the
909
+ # policy version that you specified, or it might use a lower policy version. For
910
+ # example, if you specify version 3, but the policy has no conditional role
911
+ # bindings, the response uses version 1. To learn which resources support
912
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
913
+ # google.com/iam/help/conditions/resource-policies).
914
+ # @param [String] fields
915
+ # Selector specifying which fields to include in a partial response.
916
+ # @param [String] quota_user
917
+ # Available to use for quota purposes for server-side applications. Can be any
918
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
919
+ # @param [Google::Apis::RequestOptions] options
920
+ # Request-specific options
921
+ #
922
+ # @yield [result, err] Result & error if block supplied
923
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
924
+ # @yieldparam err [StandardError] error object if request failed
925
+ #
926
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
927
+ #
928
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
929
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
930
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
931
+ def get_project_location_api_deployment_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
932
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
933
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
934
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
935
+ command.params['resource'] = resource unless resource.nil?
936
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
937
+ command.query['fields'] = fields unless fields.nil?
938
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
939
+ execute_or_queue_command(command, &block)
940
+ end
941
+
942
+ # ListApiDeployments returns matching deployments.
943
+ # @param [String] parent
944
+ # Required. The parent, which owns this collection of deployments. Format:
945
+ # projects/*/locations/*/apis/*
946
+ # @param [String] filter
947
+ # An expression that can be used to filter the list. Filters use the Common
948
+ # Expression Language and can refer to all message fields.
949
+ # @param [Fixnum] page_size
950
+ # The maximum number of deployments to return. The service may return fewer than
951
+ # this value. If unspecified, at most 50 values will be returned. The maximum is
952
+ # 1000; values above 1000 will be coerced to 1000.
953
+ # @param [String] page_token
954
+ # A page token, received from a previous `ListApiDeployments` call. Provide this
955
+ # to retrieve the subsequent page. When paginating, all other parameters
956
+ # provided to `ListApiDeployments` must match the call that provided the page
957
+ # token.
958
+ # @param [String] fields
959
+ # Selector specifying which fields to include in a partial response.
960
+ # @param [String] quota_user
961
+ # Available to use for quota purposes for server-side applications. Can be any
962
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
963
+ # @param [Google::Apis::RequestOptions] options
964
+ # Request-specific options
965
+ #
966
+ # @yield [result, err] Result & error if block supplied
967
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse] parsed result object
968
+ # @yieldparam err [StandardError] error object if request failed
969
+ #
970
+ # @return [Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse]
971
+ #
972
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
973
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
974
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
975
+ def list_project_location_api_deployments(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
976
+ command = make_simple_command(:get, 'v1/{+parent}/deployments', options)
977
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse::Representation
978
+ command.response_class = Google::Apis::ApigeeregistryV1::ListApiDeploymentsResponse
979
+ command.params['parent'] = parent unless parent.nil?
980
+ command.query['filter'] = filter unless filter.nil?
981
+ command.query['pageSize'] = page_size unless page_size.nil?
982
+ command.query['pageToken'] = page_token unless page_token.nil?
983
+ command.query['fields'] = fields unless fields.nil?
984
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
985
+ execute_or_queue_command(command, &block)
986
+ end
987
+
988
+ # ListApiDeploymentRevisions lists all revisions of a deployment. Revisions are
989
+ # returned in descending order of revision creation time.
990
+ # @param [String] name
991
+ # Required. The name of the deployment to list revisions for.
992
+ # @param [Fixnum] page_size
993
+ # The maximum number of revisions to return per page.
994
+ # @param [String] page_token
995
+ # The page token, received from a previous ListApiDeploymentRevisions call.
996
+ # Provide this to retrieve the subsequent page.
997
+ # @param [String] fields
998
+ # Selector specifying which fields to include in a partial response.
999
+ # @param [String] quota_user
1000
+ # Available to use for quota purposes for server-side applications. Can be any
1001
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1002
+ # @param [Google::Apis::RequestOptions] options
1003
+ # Request-specific options
1004
+ #
1005
+ # @yield [result, err] Result & error if block supplied
1006
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListApiDeploymentRevisionsResponse] parsed result object
1007
+ # @yieldparam err [StandardError] error object if request failed
1008
+ #
1009
+ # @return [Google::Apis::ApigeeregistryV1::ListApiDeploymentRevisionsResponse]
1010
+ #
1011
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1012
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1013
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1014
+ def list_project_location_api_deployment_revisions(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1015
+ command = make_simple_command(:get, 'v1/{+name}:listRevisions', options)
1016
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListApiDeploymentRevisionsResponse::Representation
1017
+ command.response_class = Google::Apis::ApigeeregistryV1::ListApiDeploymentRevisionsResponse
1018
+ command.params['name'] = name unless name.nil?
1019
+ command.query['pageSize'] = page_size unless page_size.nil?
1020
+ command.query['pageToken'] = page_token unless page_token.nil?
1021
+ command.query['fields'] = fields unless fields.nil?
1022
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1023
+ execute_or_queue_command(command, &block)
1024
+ end
1025
+
1026
+ # UpdateApiDeployment can be used to modify a specified deployment.
1027
+ # @param [String] name
1028
+ # Resource name.
1029
+ # @param [Google::Apis::ApigeeregistryV1::ApiDeployment] api_deployment_object
1030
+ # @param [Boolean] allow_missing
1031
+ # If set to true, and the deployment is not found, a new deployment will be
1032
+ # created. In this situation, `update_mask` is ignored.
1033
+ # @param [String] update_mask
1034
+ # The list of fields to be updated. If omitted, all fields are updated that are
1035
+ # set in the request message (fields set to default values are ignored). If a "*"
1036
+ # is specified, all fields are updated, including fields that are unspecified/
1037
+ # default in the request.
1038
+ # @param [String] fields
1039
+ # Selector specifying which fields to include in a partial response.
1040
+ # @param [String] quota_user
1041
+ # Available to use for quota purposes for server-side applications. Can be any
1042
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1043
+ # @param [Google::Apis::RequestOptions] options
1044
+ # Request-specific options
1045
+ #
1046
+ # @yield [result, err] Result & error if block supplied
1047
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiDeployment] parsed result object
1048
+ # @yieldparam err [StandardError] error object if request failed
1049
+ #
1050
+ # @return [Google::Apis::ApigeeregistryV1::ApiDeployment]
1051
+ #
1052
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1053
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1054
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1055
+ def patch_project_location_api_deployment(name, api_deployment_object = nil, allow_missing: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1056
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1057
+ command.request_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
1058
+ command.request_object = api_deployment_object
1059
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
1060
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiDeployment
1061
+ command.params['name'] = name unless name.nil?
1062
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
1063
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1064
+ command.query['fields'] = fields unless fields.nil?
1065
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1066
+ execute_or_queue_command(command, &block)
1067
+ end
1068
+
1069
+ # RollbackApiDeployment sets the current revision to a specified prior revision.
1070
+ # Note that this creates a new revision with a new revision ID.
1071
+ # @param [String] name
1072
+ # Required. The deployment being rolled back.
1073
+ # @param [Google::Apis::ApigeeregistryV1::RollbackApiDeploymentRequest] rollback_api_deployment_request_object
1074
+ # @param [String] fields
1075
+ # Selector specifying which fields to include in a partial response.
1076
+ # @param [String] quota_user
1077
+ # Available to use for quota purposes for server-side applications. Can be any
1078
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1079
+ # @param [Google::Apis::RequestOptions] options
1080
+ # Request-specific options
1081
+ #
1082
+ # @yield [result, err] Result & error if block supplied
1083
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiDeployment] parsed result object
1084
+ # @yieldparam err [StandardError] error object if request failed
1085
+ #
1086
+ # @return [Google::Apis::ApigeeregistryV1::ApiDeployment]
1087
+ #
1088
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1089
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1090
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1091
+ def rollback_api_deployment(name, rollback_api_deployment_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1092
+ command = make_simple_command(:post, 'v1/{+name}:rollback', options)
1093
+ command.request_representation = Google::Apis::ApigeeregistryV1::RollbackApiDeploymentRequest::Representation
1094
+ command.request_object = rollback_api_deployment_request_object
1095
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
1096
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiDeployment
1097
+ command.params['name'] = name unless name.nil?
1098
+ command.query['fields'] = fields unless fields.nil?
1099
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1100
+ execute_or_queue_command(command, &block)
1101
+ end
1102
+
1103
+ # Sets the access control policy on the specified resource. Replaces any
1104
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1105
+ # PERMISSION_DENIED` errors.
1106
+ # @param [String] resource
1107
+ # REQUIRED: The resource for which the policy is being specified. See the
1108
+ # operation documentation for the appropriate value for this field.
1109
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
1110
+ # @param [String] fields
1111
+ # Selector specifying which fields to include in a partial response.
1112
+ # @param [String] quota_user
1113
+ # Available to use for quota purposes for server-side applications. Can be any
1114
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1115
+ # @param [Google::Apis::RequestOptions] options
1116
+ # Request-specific options
1117
+ #
1118
+ # @yield [result, err] Result & error if block supplied
1119
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
1120
+ # @yieldparam err [StandardError] error object if request failed
1121
+ #
1122
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
1123
+ #
1124
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1125
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1126
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1127
+ def set_deployment_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1128
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1129
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
1130
+ command.request_object = set_iam_policy_request_object
1131
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
1132
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
1133
+ command.params['resource'] = resource unless resource.nil?
1134
+ command.query['fields'] = fields unless fields.nil?
1135
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1136
+ execute_or_queue_command(command, &block)
1137
+ end
1138
+
1139
+ # TagApiDeploymentRevision adds a tag to a specified revision of a deployment.
1140
+ # @param [String] name
1141
+ # Required. The name of the deployment to be tagged, including the revision ID.
1142
+ # @param [Google::Apis::ApigeeregistryV1::TagApiDeploymentRevisionRequest] tag_api_deployment_revision_request_object
1143
+ # @param [String] fields
1144
+ # Selector specifying which fields to include in a partial response.
1145
+ # @param [String] quota_user
1146
+ # Available to use for quota purposes for server-side applications. Can be any
1147
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1148
+ # @param [Google::Apis::RequestOptions] options
1149
+ # Request-specific options
1150
+ #
1151
+ # @yield [result, err] Result & error if block supplied
1152
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiDeployment] parsed result object
1153
+ # @yieldparam err [StandardError] error object if request failed
1154
+ #
1155
+ # @return [Google::Apis::ApigeeregistryV1::ApiDeployment]
1156
+ #
1157
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1158
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1159
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1160
+ def tag_project_location_api_deployment_revision(name, tag_api_deployment_revision_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1161
+ command = make_simple_command(:post, 'v1/{+name}:tagRevision', options)
1162
+ command.request_representation = Google::Apis::ApigeeregistryV1::TagApiDeploymentRevisionRequest::Representation
1163
+ command.request_object = tag_api_deployment_revision_request_object
1164
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiDeployment::Representation
1165
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiDeployment
1166
+ command.params['name'] = name unless name.nil?
1167
+ command.query['fields'] = fields unless fields.nil?
1168
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1169
+ execute_or_queue_command(command, &block)
1170
+ end
1171
+
1172
+ # Returns permissions that a caller has on the specified resource. If the
1173
+ # resource does not exist, this will return an empty set of permissions, not a `
1174
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1175
+ # permission-aware UIs and command-line tools, not for authorization checking.
1176
+ # This operation may "fail open" without warning.
1177
+ # @param [String] resource
1178
+ # REQUIRED: The resource for which the policy detail is being requested. See the
1179
+ # operation documentation for the appropriate value for this field.
1180
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1181
+ # @param [String] fields
1182
+ # Selector specifying which fields to include in a partial response.
1183
+ # @param [String] quota_user
1184
+ # Available to use for quota purposes for server-side applications. Can be any
1185
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1186
+ # @param [Google::Apis::RequestOptions] options
1187
+ # Request-specific options
1188
+ #
1189
+ # @yield [result, err] Result & error if block supplied
1190
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
1191
+ # @yieldparam err [StandardError] error object if request failed
1192
+ #
1193
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
1194
+ #
1195
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1196
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1197
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1198
+ def test_deployment_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1199
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1200
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
1201
+ command.request_object = test_iam_permissions_request_object
1202
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
1203
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
1204
+ command.params['resource'] = resource unless resource.nil?
1205
+ command.query['fields'] = fields unless fields.nil?
1206
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1207
+ execute_or_queue_command(command, &block)
1208
+ end
1209
+
1210
+ # CreateArtifact creates a specified artifact.
1211
+ # @param [String] parent
1212
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
1213
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1214
+ # @param [String] artifact_id
1215
+ # Required. The ID to use for the artifact, which will become the final
1216
+ # component of the artifact's resource name. This value should be 4-63
1217
+ # characters, and valid characters are /a-z-/. Following AIP-162, IDs must not
1218
+ # have the form of a UUID.
1219
+ # @param [String] fields
1220
+ # Selector specifying which fields to include in a partial response.
1221
+ # @param [String] quota_user
1222
+ # Available to use for quota purposes for server-side applications. Can be any
1223
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1224
+ # @param [Google::Apis::RequestOptions] options
1225
+ # Request-specific options
1226
+ #
1227
+ # @yield [result, err] Result & error if block supplied
1228
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
1229
+ # @yieldparam err [StandardError] error object if request failed
1230
+ #
1231
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
1232
+ #
1233
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1234
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1235
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1236
+ def create_project_location_api_deployment_artifact(parent, artifact_object = nil, artifact_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1237
+ command = make_simple_command(:post, 'v1/{+parent}/artifacts', options)
1238
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1239
+ command.request_object = artifact_object
1240
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1241
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
1242
+ command.params['parent'] = parent unless parent.nil?
1243
+ command.query['artifactId'] = artifact_id unless artifact_id.nil?
1244
+ command.query['fields'] = fields unless fields.nil?
1245
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1246
+ execute_or_queue_command(command, &block)
1247
+ end
1248
+
1249
+ # DeleteArtifact removes a specified artifact.
1250
+ # @param [String] name
1251
+ # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
1252
+ # @param [String] fields
1253
+ # Selector specifying which fields to include in a partial response.
1254
+ # @param [String] quota_user
1255
+ # Available to use for quota purposes for server-side applications. Can be any
1256
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1257
+ # @param [Google::Apis::RequestOptions] options
1258
+ # Request-specific options
1259
+ #
1260
+ # @yield [result, err] Result & error if block supplied
1261
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
1262
+ # @yieldparam err [StandardError] error object if request failed
1263
+ #
1264
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
1265
+ #
1266
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1267
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1268
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1269
+ def delete_project_location_api_deployment_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
1270
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1271
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
1272
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
1273
+ command.params['name'] = name unless name.nil?
1274
+ command.query['fields'] = fields unless fields.nil?
1275
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1276
+ execute_or_queue_command(command, &block)
1277
+ end
1278
+
1279
+ # GetArtifact returns a specified artifact.
1280
+ # @param [String] name
1281
+ # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
1282
+ # @param [String] fields
1283
+ # Selector specifying which fields to include in a partial response.
1284
+ # @param [String] quota_user
1285
+ # Available to use for quota purposes for server-side applications. Can be any
1286
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1287
+ # @param [Google::Apis::RequestOptions] options
1288
+ # Request-specific options
1289
+ #
1290
+ # @yield [result, err] Result & error if block supplied
1291
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
1292
+ # @yieldparam err [StandardError] error object if request failed
1293
+ #
1294
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
1295
+ #
1296
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1297
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1298
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1299
+ def get_project_location_api_deployment_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
1300
+ command = make_simple_command(:get, 'v1/{+name}', options)
1301
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1302
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
1303
+ command.params['name'] = name unless name.nil?
1304
+ command.query['fields'] = fields unless fields.nil?
1305
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1306
+ execute_or_queue_command(command, &block)
1307
+ end
1308
+
1309
+ # GetArtifactContents returns the contents of a specified artifact. If artifacts
1310
+ # are stored with GZip compression, the default behavior is to return the
1311
+ # artifact uncompressed (the mime_type response field indicates the exact format
1312
+ # returned).
1313
+ # @param [String] name
1314
+ # Required. The name of the artifact whose contents should be retrieved. Format:
1315
+ # `parent`/artifacts/*
1316
+ # @param [String] fields
1317
+ # Selector specifying which fields to include in a partial response.
1318
+ # @param [String] quota_user
1319
+ # Available to use for quota purposes for server-side applications. Can be any
1320
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1321
+ # @param [Google::Apis::RequestOptions] options
1322
+ # Request-specific options
1323
+ #
1324
+ # @yield [result, err] Result & error if block supplied
1325
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::HttpBody] parsed result object
1326
+ # @yieldparam err [StandardError] error object if request failed
1327
+ #
1328
+ # @return [Google::Apis::ApigeeregistryV1::HttpBody]
1329
+ #
1330
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1331
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1332
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1333
+ def get_project_location_api_deployment_artifact_contents(name, fields: nil, quota_user: nil, options: nil, &block)
1334
+ command = make_simple_command(:get, 'v1/{+name}:getContents', options)
1335
+ command.response_representation = Google::Apis::ApigeeregistryV1::HttpBody::Representation
1336
+ command.response_class = Google::Apis::ApigeeregistryV1::HttpBody
1337
+ command.params['name'] = name unless name.nil?
1338
+ command.query['fields'] = fields unless fields.nil?
1339
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1340
+ execute_or_queue_command(command, &block)
1341
+ end
1342
+
1343
+ # ListArtifacts returns matching artifacts.
1344
+ # @param [String] parent
1345
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
1346
+ # @param [String] filter
1347
+ # An expression that can be used to filter the list. Filters use the Common
1348
+ # Expression Language and can refer to all message fields except contents.
1349
+ # @param [Fixnum] page_size
1350
+ # The maximum number of artifacts to return. The service may return fewer than
1351
+ # this value. If unspecified, at most 50 values will be returned. The maximum is
1352
+ # 1000; values above 1000 will be coerced to 1000.
1353
+ # @param [String] page_token
1354
+ # A page token, received from a previous `ListArtifacts` call. Provide this to
1355
+ # retrieve the subsequent page. When paginating, all other parameters provided
1356
+ # to `ListArtifacts` must match the call that provided the page token.
1357
+ # @param [String] fields
1358
+ # Selector specifying which fields to include in a partial response.
1359
+ # @param [String] quota_user
1360
+ # Available to use for quota purposes for server-side applications. Can be any
1361
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1362
+ # @param [Google::Apis::RequestOptions] options
1363
+ # Request-specific options
1364
+ #
1365
+ # @yield [result, err] Result & error if block supplied
1366
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListArtifactsResponse] parsed result object
1367
+ # @yieldparam err [StandardError] error object if request failed
1368
+ #
1369
+ # @return [Google::Apis::ApigeeregistryV1::ListArtifactsResponse]
1370
+ #
1371
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1372
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1373
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1374
+ def list_project_location_api_deployment_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1375
+ command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
1376
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
1377
+ command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
1378
+ command.params['parent'] = parent unless parent.nil?
1379
+ command.query['filter'] = filter unless filter.nil?
1380
+ command.query['pageSize'] = page_size unless page_size.nil?
1381
+ command.query['pageToken'] = page_token unless page_token.nil?
1382
+ command.query['fields'] = fields unless fields.nil?
1383
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1384
+ execute_or_queue_command(command, &block)
1385
+ end
1386
+
1387
+ # ReplaceArtifact can be used to replace a specified artifact.
1388
+ # @param [String] name
1389
+ # Resource name.
1390
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1391
+ # @param [String] fields
1392
+ # Selector specifying which fields to include in a partial response.
1393
+ # @param [String] quota_user
1394
+ # Available to use for quota purposes for server-side applications. Can be any
1395
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1396
+ # @param [Google::Apis::RequestOptions] options
1397
+ # Request-specific options
1398
+ #
1399
+ # @yield [result, err] Result & error if block supplied
1400
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
1401
+ # @yieldparam err [StandardError] error object if request failed
1402
+ #
1403
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
1404
+ #
1405
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1406
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1407
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1408
+ def replace_project_location_api_deployment_artifact_artifact(name, artifact_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1409
+ command = make_simple_command(:put, 'v1/{+name}', options)
1410
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1411
+ command.request_object = artifact_object
1412
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1413
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
1414
+ command.params['name'] = name unless name.nil?
1415
+ command.query['fields'] = fields unless fields.nil?
1416
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1417
+ execute_or_queue_command(command, &block)
1418
+ end
1419
+
1420
+ # CreateApiVersion creates a specified version.
1421
+ # @param [String] parent
1422
+ # Required. The parent, which owns this collection of versions. Format: projects/
1423
+ # */locations/*/apis/*
1424
+ # @param [Google::Apis::ApigeeregistryV1::ApiVersion] api_version_object
1425
+ # @param [String] api_version_id
1426
+ # Required. The ID to use for the version, which will become the final component
1427
+ # of the version's resource name. This value should be 1-63 characters, and
1428
+ # valid characters are /a-z-/. Following AIP-162, IDs must not have the form of
1429
+ # a UUID.
1430
+ # @param [String] fields
1431
+ # Selector specifying which fields to include in a partial response.
1432
+ # @param [String] quota_user
1433
+ # Available to use for quota purposes for server-side applications. Can be any
1434
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1435
+ # @param [Google::Apis::RequestOptions] options
1436
+ # Request-specific options
1437
+ #
1438
+ # @yield [result, err] Result & error if block supplied
1439
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiVersion] parsed result object
1440
+ # @yieldparam err [StandardError] error object if request failed
1441
+ #
1442
+ # @return [Google::Apis::ApigeeregistryV1::ApiVersion]
1443
+ #
1444
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1445
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1446
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1447
+ def create_project_location_api_version(parent, api_version_object = nil, api_version_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1448
+ command = make_simple_command(:post, 'v1/{+parent}/versions', options)
1449
+ command.request_representation = Google::Apis::ApigeeregistryV1::ApiVersion::Representation
1450
+ command.request_object = api_version_object
1451
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiVersion::Representation
1452
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiVersion
1453
+ command.params['parent'] = parent unless parent.nil?
1454
+ command.query['apiVersionId'] = api_version_id unless api_version_id.nil?
1455
+ command.query['fields'] = fields unless fields.nil?
1456
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1457
+ execute_or_queue_command(command, &block)
1458
+ end
1459
+
1460
+ # DeleteApiVersion removes a specified version and all of the resources that it
1461
+ # owns.
1462
+ # @param [String] name
1463
+ # Required. The name of the version to delete. Format: projects/*/locations/*/
1464
+ # apis/*/versions/*
1465
+ # @param [String] fields
1466
+ # Selector specifying which fields to include in a partial response.
1467
+ # @param [String] quota_user
1468
+ # Available to use for quota purposes for server-side applications. Can be any
1469
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1470
+ # @param [Google::Apis::RequestOptions] options
1471
+ # Request-specific options
1472
+ #
1473
+ # @yield [result, err] Result & error if block supplied
1474
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
1475
+ # @yieldparam err [StandardError] error object if request failed
1476
+ #
1477
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
1478
+ #
1479
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1480
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1481
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1482
+ def delete_project_location_api_version(name, fields: nil, quota_user: nil, options: nil, &block)
1483
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1484
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
1485
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
1486
+ command.params['name'] = name unless name.nil?
1487
+ command.query['fields'] = fields unless fields.nil?
1488
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1489
+ execute_or_queue_command(command, &block)
1490
+ end
1491
+
1492
+ # GetApiVersion returns a specified version.
1493
+ # @param [String] name
1494
+ # Required. The name of the version to retrieve. Format: projects/*/locations/*/
1495
+ # apis/*/versions/*
1496
+ # @param [String] fields
1497
+ # Selector specifying which fields to include in a partial response.
1498
+ # @param [String] quota_user
1499
+ # Available to use for quota purposes for server-side applications. Can be any
1500
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1501
+ # @param [Google::Apis::RequestOptions] options
1502
+ # Request-specific options
1503
+ #
1504
+ # @yield [result, err] Result & error if block supplied
1505
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiVersion] parsed result object
1506
+ # @yieldparam err [StandardError] error object if request failed
1507
+ #
1508
+ # @return [Google::Apis::ApigeeregistryV1::ApiVersion]
1509
+ #
1510
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1511
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1512
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1513
+ def get_project_location_api_version(name, fields: nil, quota_user: nil, options: nil, &block)
1514
+ command = make_simple_command(:get, 'v1/{+name}', options)
1515
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiVersion::Representation
1516
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiVersion
1517
+ command.params['name'] = name unless name.nil?
1518
+ command.query['fields'] = fields unless fields.nil?
1519
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1520
+ execute_or_queue_command(command, &block)
1521
+ end
1522
+
1523
+ # Gets the access control policy for a resource. Returns an empty policy if the
1524
+ # resource exists and does not have a policy set.
1525
+ # @param [String] resource
1526
+ # REQUIRED: The resource for which the policy is being requested. See the
1527
+ # operation documentation for the appropriate value for this field.
1528
+ # @param [Fixnum] options_requested_policy_version
1529
+ # Optional. The maximum policy version that will be used to format the policy.
1530
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1531
+ # rejected. Requests for policies with any conditional role bindings must
1532
+ # specify version 3. Policies with no conditional role bindings may specify any
1533
+ # valid value or leave the field unset. The policy in the response might use the
1534
+ # policy version that you specified, or it might use a lower policy version. For
1535
+ # example, if you specify version 3, but the policy has no conditional role
1536
+ # bindings, the response uses version 1. To learn which resources support
1537
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1538
+ # google.com/iam/help/conditions/resource-policies).
1539
+ # @param [String] fields
1540
+ # Selector specifying which fields to include in a partial response.
1541
+ # @param [String] quota_user
1542
+ # Available to use for quota purposes for server-side applications. Can be any
1543
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1544
+ # @param [Google::Apis::RequestOptions] options
1545
+ # Request-specific options
1546
+ #
1547
+ # @yield [result, err] Result & error if block supplied
1548
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
1549
+ # @yieldparam err [StandardError] error object if request failed
1550
+ #
1551
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
1552
+ #
1553
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1554
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1555
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1556
+ def get_project_location_api_version_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
1557
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
1558
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
1559
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
1560
+ command.params['resource'] = resource unless resource.nil?
1561
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1562
+ command.query['fields'] = fields unless fields.nil?
1563
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1564
+ execute_or_queue_command(command, &block)
1565
+ end
1566
+
1567
+ # ListApiVersions returns matching versions.
1568
+ # @param [String] parent
1569
+ # Required. The parent, which owns this collection of versions. Format: projects/
1570
+ # */locations/*/apis/*
1571
+ # @param [String] filter
1572
+ # An expression that can be used to filter the list. Filters use the Common
1573
+ # Expression Language and can refer to all message fields.
1574
+ # @param [Fixnum] page_size
1575
+ # The maximum number of versions to return. The service may return fewer than
1576
+ # this value. If unspecified, at most 50 values will be returned. The maximum is
1577
+ # 1000; values above 1000 will be coerced to 1000.
1578
+ # @param [String] page_token
1579
+ # A page token, received from a previous `ListApiVersions` call. Provide this to
1580
+ # retrieve the subsequent page. When paginating, all other parameters provided
1581
+ # to `ListApiVersions` must match the call that provided the page token.
1582
+ # @param [String] fields
1583
+ # Selector specifying which fields to include in a partial response.
1584
+ # @param [String] quota_user
1585
+ # Available to use for quota purposes for server-side applications. Can be any
1586
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1587
+ # @param [Google::Apis::RequestOptions] options
1588
+ # Request-specific options
1589
+ #
1590
+ # @yield [result, err] Result & error if block supplied
1591
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListApiVersionsResponse] parsed result object
1592
+ # @yieldparam err [StandardError] error object if request failed
1593
+ #
1594
+ # @return [Google::Apis::ApigeeregistryV1::ListApiVersionsResponse]
1595
+ #
1596
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1597
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1598
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1599
+ def list_project_location_api_versions(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1600
+ command = make_simple_command(:get, 'v1/{+parent}/versions', options)
1601
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListApiVersionsResponse::Representation
1602
+ command.response_class = Google::Apis::ApigeeregistryV1::ListApiVersionsResponse
1603
+ command.params['parent'] = parent unless parent.nil?
1604
+ command.query['filter'] = filter unless filter.nil?
1605
+ command.query['pageSize'] = page_size unless page_size.nil?
1606
+ command.query['pageToken'] = page_token unless page_token.nil?
1607
+ command.query['fields'] = fields unless fields.nil?
1608
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1609
+ execute_or_queue_command(command, &block)
1610
+ end
1611
+
1612
+ # UpdateApiVersion can be used to modify a specified version.
1613
+ # @param [String] name
1614
+ # Resource name.
1615
+ # @param [Google::Apis::ApigeeregistryV1::ApiVersion] api_version_object
1616
+ # @param [Boolean] allow_missing
1617
+ # If set to true, and the version is not found, a new version will be created.
1618
+ # In this situation, `update_mask` is ignored.
1619
+ # @param [String] update_mask
1620
+ # The list of fields to be updated. If omitted, all fields are updated that are
1621
+ # set in the request message (fields set to default values are ignored). If a "*"
1622
+ # is specified, all fields are updated, including fields that are unspecified/
1623
+ # default in the request.
1624
+ # @param [String] fields
1625
+ # Selector specifying which fields to include in a partial response.
1626
+ # @param [String] quota_user
1627
+ # Available to use for quota purposes for server-side applications. Can be any
1628
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1629
+ # @param [Google::Apis::RequestOptions] options
1630
+ # Request-specific options
1631
+ #
1632
+ # @yield [result, err] Result & error if block supplied
1633
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiVersion] parsed result object
1634
+ # @yieldparam err [StandardError] error object if request failed
1635
+ #
1636
+ # @return [Google::Apis::ApigeeregistryV1::ApiVersion]
1637
+ #
1638
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1639
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1640
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1641
+ def patch_project_location_api_version(name, api_version_object = nil, allow_missing: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1642
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1643
+ command.request_representation = Google::Apis::ApigeeregistryV1::ApiVersion::Representation
1644
+ command.request_object = api_version_object
1645
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiVersion::Representation
1646
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiVersion
1647
+ command.params['name'] = name unless name.nil?
1648
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
1649
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1650
+ command.query['fields'] = fields unless fields.nil?
1651
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1652
+ execute_or_queue_command(command, &block)
1653
+ end
1654
+
1655
+ # Sets the access control policy on the specified resource. Replaces any
1656
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1657
+ # PERMISSION_DENIED` errors.
1658
+ # @param [String] resource
1659
+ # REQUIRED: The resource for which the policy is being specified. See the
1660
+ # operation documentation for the appropriate value for this field.
1661
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
1662
+ # @param [String] fields
1663
+ # Selector specifying which fields to include in a partial response.
1664
+ # @param [String] quota_user
1665
+ # Available to use for quota purposes for server-side applications. Can be any
1666
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1667
+ # @param [Google::Apis::RequestOptions] options
1668
+ # Request-specific options
1669
+ #
1670
+ # @yield [result, err] Result & error if block supplied
1671
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
1672
+ # @yieldparam err [StandardError] error object if request failed
1673
+ #
1674
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
1675
+ #
1676
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1677
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1678
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1679
+ def set_version_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1680
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
1681
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
1682
+ command.request_object = set_iam_policy_request_object
1683
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
1684
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
1685
+ command.params['resource'] = resource unless resource.nil?
1686
+ command.query['fields'] = fields unless fields.nil?
1687
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1688
+ execute_or_queue_command(command, &block)
1689
+ end
1690
+
1691
+ # Returns permissions that a caller has on the specified resource. If the
1692
+ # resource does not exist, this will return an empty set of permissions, not a `
1693
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
1694
+ # permission-aware UIs and command-line tools, not for authorization checking.
1695
+ # This operation may "fail open" without warning.
1696
+ # @param [String] resource
1697
+ # REQUIRED: The resource for which the policy detail is being requested. See the
1698
+ # operation documentation for the appropriate value for this field.
1699
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
1700
+ # @param [String] fields
1701
+ # Selector specifying which fields to include in a partial response.
1702
+ # @param [String] quota_user
1703
+ # Available to use for quota purposes for server-side applications. Can be any
1704
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1705
+ # @param [Google::Apis::RequestOptions] options
1706
+ # Request-specific options
1707
+ #
1708
+ # @yield [result, err] Result & error if block supplied
1709
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
1710
+ # @yieldparam err [StandardError] error object if request failed
1711
+ #
1712
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
1713
+ #
1714
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1715
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1716
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1717
+ def test_version_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1718
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
1719
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
1720
+ command.request_object = test_iam_permissions_request_object
1721
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
1722
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
1723
+ command.params['resource'] = resource unless resource.nil?
1724
+ command.query['fields'] = fields unless fields.nil?
1725
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1726
+ execute_or_queue_command(command, &block)
1727
+ end
1728
+
1729
+ # CreateArtifact creates a specified artifact.
1730
+ # @param [String] parent
1731
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
1732
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1733
+ # @param [String] artifact_id
1734
+ # Required. The ID to use for the artifact, which will become the final
1735
+ # component of the artifact's resource name. This value should be 4-63
1736
+ # characters, and valid characters are /a-z-/. Following AIP-162, IDs must not
1737
+ # have the form of a UUID.
1738
+ # @param [String] fields
1739
+ # Selector specifying which fields to include in a partial response.
1740
+ # @param [String] quota_user
1741
+ # Available to use for quota purposes for server-side applications. Can be any
1742
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1743
+ # @param [Google::Apis::RequestOptions] options
1744
+ # Request-specific options
1745
+ #
1746
+ # @yield [result, err] Result & error if block supplied
1747
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
1748
+ # @yieldparam err [StandardError] error object if request failed
1749
+ #
1750
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
1751
+ #
1752
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1753
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1754
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1755
+ def create_project_location_api_version_artifact(parent, artifact_object = nil, artifact_id: nil, fields: nil, quota_user: nil, options: nil, &block)
1756
+ command = make_simple_command(:post, 'v1/{+parent}/artifacts', options)
1757
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1758
+ command.request_object = artifact_object
1759
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1760
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
1761
+ command.params['parent'] = parent unless parent.nil?
1762
+ command.query['artifactId'] = artifact_id unless artifact_id.nil?
1763
+ command.query['fields'] = fields unless fields.nil?
1764
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1765
+ execute_or_queue_command(command, &block)
1766
+ end
1767
+
1768
+ # DeleteArtifact removes a specified artifact.
1769
+ # @param [String] name
1770
+ # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
1771
+ # @param [String] fields
1772
+ # Selector specifying which fields to include in a partial response.
1773
+ # @param [String] quota_user
1774
+ # Available to use for quota purposes for server-side applications. Can be any
1775
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1776
+ # @param [Google::Apis::RequestOptions] options
1777
+ # Request-specific options
1778
+ #
1779
+ # @yield [result, err] Result & error if block supplied
1780
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
1781
+ # @yieldparam err [StandardError] error object if request failed
1782
+ #
1783
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
1784
+ #
1785
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1786
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1787
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1788
+ def delete_project_location_api_version_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
1789
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1790
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
1791
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
1792
+ command.params['name'] = name unless name.nil?
1793
+ command.query['fields'] = fields unless fields.nil?
1794
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1795
+ execute_or_queue_command(command, &block)
1796
+ end
1797
+
1798
+ # GetArtifact returns a specified artifact.
1799
+ # @param [String] name
1800
+ # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
1801
+ # @param [String] fields
1802
+ # Selector specifying which fields to include in a partial response.
1803
+ # @param [String] quota_user
1804
+ # Available to use for quota purposes for server-side applications. Can be any
1805
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1806
+ # @param [Google::Apis::RequestOptions] options
1807
+ # Request-specific options
1808
+ #
1809
+ # @yield [result, err] Result & error if block supplied
1810
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
1811
+ # @yieldparam err [StandardError] error object if request failed
1812
+ #
1813
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
1814
+ #
1815
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1816
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1817
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1818
+ def get_project_location_api_version_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
1819
+ command = make_simple_command(:get, 'v1/{+name}', options)
1820
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1821
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
1822
+ command.params['name'] = name unless name.nil?
1823
+ command.query['fields'] = fields unless fields.nil?
1824
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1825
+ execute_or_queue_command(command, &block)
1826
+ end
1827
+
1828
+ # GetArtifactContents returns the contents of a specified artifact. If artifacts
1829
+ # are stored with GZip compression, the default behavior is to return the
1830
+ # artifact uncompressed (the mime_type response field indicates the exact format
1831
+ # returned).
1832
+ # @param [String] name
1833
+ # Required. The name of the artifact whose contents should be retrieved. Format:
1834
+ # `parent`/artifacts/*
1835
+ # @param [String] fields
1836
+ # Selector specifying which fields to include in a partial response.
1837
+ # @param [String] quota_user
1838
+ # Available to use for quota purposes for server-side applications. Can be any
1839
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1840
+ # @param [Google::Apis::RequestOptions] options
1841
+ # Request-specific options
1842
+ #
1843
+ # @yield [result, err] Result & error if block supplied
1844
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::HttpBody] parsed result object
1845
+ # @yieldparam err [StandardError] error object if request failed
1846
+ #
1847
+ # @return [Google::Apis::ApigeeregistryV1::HttpBody]
1848
+ #
1849
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1850
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1851
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1852
+ def get_project_location_api_version_artifact_contents(name, fields: nil, quota_user: nil, options: nil, &block)
1853
+ command = make_simple_command(:get, 'v1/{+name}:getContents', options)
1854
+ command.response_representation = Google::Apis::ApigeeregistryV1::HttpBody::Representation
1855
+ command.response_class = Google::Apis::ApigeeregistryV1::HttpBody
1856
+ command.params['name'] = name unless name.nil?
1857
+ command.query['fields'] = fields unless fields.nil?
1858
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1859
+ execute_or_queue_command(command, &block)
1860
+ end
1861
+
1862
+ # Gets the access control policy for a resource. Returns an empty policy if the
1863
+ # resource exists and does not have a policy set.
1864
+ # @param [String] resource
1865
+ # REQUIRED: The resource for which the policy is being requested. See the
1866
+ # operation documentation for the appropriate value for this field.
1867
+ # @param [Fixnum] options_requested_policy_version
1868
+ # Optional. The maximum policy version that will be used to format the policy.
1869
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1870
+ # rejected. Requests for policies with any conditional role bindings must
1871
+ # specify version 3. Policies with no conditional role bindings may specify any
1872
+ # valid value or leave the field unset. The policy in the response might use the
1873
+ # policy version that you specified, or it might use a lower policy version. For
1874
+ # example, if you specify version 3, but the policy has no conditional role
1875
+ # bindings, the response uses version 1. To learn which resources support
1876
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1877
+ # google.com/iam/help/conditions/resource-policies).
1878
+ # @param [String] fields
1879
+ # Selector specifying which fields to include in a partial response.
1880
+ # @param [String] quota_user
1881
+ # Available to use for quota purposes for server-side applications. Can be any
1882
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1883
+ # @param [Google::Apis::RequestOptions] options
1884
+ # Request-specific options
1885
+ #
1886
+ # @yield [result, err] Result & error if block supplied
1887
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
1888
+ # @yieldparam err [StandardError] error object if request failed
1889
+ #
1890
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
1891
+ #
1892
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1893
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1894
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1895
+ def get_project_location_api_version_artifact_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
1896
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
1897
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
1898
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
1899
+ command.params['resource'] = resource unless resource.nil?
1900
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
1901
+ command.query['fields'] = fields unless fields.nil?
1902
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1903
+ execute_or_queue_command(command, &block)
1904
+ end
1905
+
1906
+ # ListArtifacts returns matching artifacts.
1907
+ # @param [String] parent
1908
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
1909
+ # @param [String] filter
1910
+ # An expression that can be used to filter the list. Filters use the Common
1911
+ # Expression Language and can refer to all message fields except contents.
1912
+ # @param [Fixnum] page_size
1913
+ # The maximum number of artifacts to return. The service may return fewer than
1914
+ # this value. If unspecified, at most 50 values will be returned. The maximum is
1915
+ # 1000; values above 1000 will be coerced to 1000.
1916
+ # @param [String] page_token
1917
+ # A page token, received from a previous `ListArtifacts` call. Provide this to
1918
+ # retrieve the subsequent page. When paginating, all other parameters provided
1919
+ # to `ListArtifacts` must match the call that provided the page token.
1920
+ # @param [String] fields
1921
+ # Selector specifying which fields to include in a partial response.
1922
+ # @param [String] quota_user
1923
+ # Available to use for quota purposes for server-side applications. Can be any
1924
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1925
+ # @param [Google::Apis::RequestOptions] options
1926
+ # Request-specific options
1927
+ #
1928
+ # @yield [result, err] Result & error if block supplied
1929
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListArtifactsResponse] parsed result object
1930
+ # @yieldparam err [StandardError] error object if request failed
1931
+ #
1932
+ # @return [Google::Apis::ApigeeregistryV1::ListArtifactsResponse]
1933
+ #
1934
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1935
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1936
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1937
+ def list_project_location_api_version_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1938
+ command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
1939
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
1940
+ command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
1941
+ command.params['parent'] = parent unless parent.nil?
1942
+ command.query['filter'] = filter unless filter.nil?
1943
+ command.query['pageSize'] = page_size unless page_size.nil?
1944
+ command.query['pageToken'] = page_token unless page_token.nil?
1945
+ command.query['fields'] = fields unless fields.nil?
1946
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1947
+ execute_or_queue_command(command, &block)
1948
+ end
1949
+
1950
+ # ReplaceArtifact can be used to replace a specified artifact.
1951
+ # @param [String] name
1952
+ # Resource name.
1953
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
1954
+ # @param [String] fields
1955
+ # Selector specifying which fields to include in a partial response.
1956
+ # @param [String] quota_user
1957
+ # Available to use for quota purposes for server-side applications. Can be any
1958
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1959
+ # @param [Google::Apis::RequestOptions] options
1960
+ # Request-specific options
1961
+ #
1962
+ # @yield [result, err] Result & error if block supplied
1963
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
1964
+ # @yieldparam err [StandardError] error object if request failed
1965
+ #
1966
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
1967
+ #
1968
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1969
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1970
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1971
+ def replace_project_location_api_version_artifact_artifact(name, artifact_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1972
+ command = make_simple_command(:put, 'v1/{+name}', options)
1973
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1974
+ command.request_object = artifact_object
1975
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
1976
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
1977
+ command.params['name'] = name unless name.nil?
1978
+ command.query['fields'] = fields unless fields.nil?
1979
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1980
+ execute_or_queue_command(command, &block)
1981
+ end
1982
+
1983
+ # Sets the access control policy on the specified resource. Replaces any
1984
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
1985
+ # PERMISSION_DENIED` errors.
1986
+ # @param [String] resource
1987
+ # REQUIRED: The resource for which the policy is being specified. See the
1988
+ # operation documentation for the appropriate value for this field.
1989
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
1990
+ # @param [String] fields
1991
+ # Selector specifying which fields to include in a partial response.
1992
+ # @param [String] quota_user
1993
+ # Available to use for quota purposes for server-side applications. Can be any
1994
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1995
+ # @param [Google::Apis::RequestOptions] options
1996
+ # Request-specific options
1997
+ #
1998
+ # @yield [result, err] Result & error if block supplied
1999
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
2000
+ # @yieldparam err [StandardError] error object if request failed
2001
+ #
2002
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
2003
+ #
2004
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2005
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2006
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2007
+ def set_project_location_api_version_artifact_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2008
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2009
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
2010
+ command.request_object = set_iam_policy_request_object
2011
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
2012
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
2013
+ command.params['resource'] = resource unless resource.nil?
2014
+ command.query['fields'] = fields unless fields.nil?
2015
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2016
+ execute_or_queue_command(command, &block)
2017
+ end
2018
+
2019
+ # Returns permissions that a caller has on the specified resource. If the
2020
+ # resource does not exist, this will return an empty set of permissions, not a `
2021
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
2022
+ # permission-aware UIs and command-line tools, not for authorization checking.
2023
+ # This operation may "fail open" without warning.
2024
+ # @param [String] resource
2025
+ # REQUIRED: The resource for which the policy detail is being requested. See the
2026
+ # operation documentation for the appropriate value for this field.
2027
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
2028
+ # @param [String] fields
2029
+ # Selector specifying which fields to include in a partial response.
2030
+ # @param [String] quota_user
2031
+ # Available to use for quota purposes for server-side applications. Can be any
2032
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2033
+ # @param [Google::Apis::RequestOptions] options
2034
+ # Request-specific options
2035
+ #
2036
+ # @yield [result, err] Result & error if block supplied
2037
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
2038
+ # @yieldparam err [StandardError] error object if request failed
2039
+ #
2040
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
2041
+ #
2042
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2043
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2044
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2045
+ def test_project_location_api_version_artifact_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2046
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2047
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
2048
+ command.request_object = test_iam_permissions_request_object
2049
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
2050
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
2051
+ command.params['resource'] = resource unless resource.nil?
2052
+ command.query['fields'] = fields unless fields.nil?
2053
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2054
+ execute_or_queue_command(command, &block)
2055
+ end
2056
+
2057
+ # CreateApiSpec creates a specified spec.
2058
+ # @param [String] parent
2059
+ # Required. The parent, which owns this collection of specs. Format: projects/*/
2060
+ # locations/*/apis/*/versions/*
2061
+ # @param [Google::Apis::ApigeeregistryV1::ApiSpec] api_spec_object
2062
+ # @param [String] api_spec_id
2063
+ # Required. The ID to use for the spec, which will become the final component of
2064
+ # the spec's resource name. This value should be 4-63 characters, and valid
2065
+ # characters are /a-z-/. Following AIP-162, IDs must not have the form of a UUID.
2066
+ # @param [String] fields
2067
+ # Selector specifying which fields to include in a partial response.
2068
+ # @param [String] quota_user
2069
+ # Available to use for quota purposes for server-side applications. Can be any
2070
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2071
+ # @param [Google::Apis::RequestOptions] options
2072
+ # Request-specific options
2073
+ #
2074
+ # @yield [result, err] Result & error if block supplied
2075
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiSpec] parsed result object
2076
+ # @yieldparam err [StandardError] error object if request failed
2077
+ #
2078
+ # @return [Google::Apis::ApigeeregistryV1::ApiSpec]
2079
+ #
2080
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2081
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2082
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2083
+ def create_project_location_api_version_spec(parent, api_spec_object = nil, api_spec_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2084
+ command = make_simple_command(:post, 'v1/{+parent}/specs', options)
2085
+ command.request_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2086
+ command.request_object = api_spec_object
2087
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2088
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiSpec
2089
+ command.params['parent'] = parent unless parent.nil?
2090
+ command.query['apiSpecId'] = api_spec_id unless api_spec_id.nil?
2091
+ command.query['fields'] = fields unless fields.nil?
2092
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2093
+ execute_or_queue_command(command, &block)
2094
+ end
2095
+
2096
+ # DeleteApiSpec removes a specified spec, all revisions, and all child resources
2097
+ # (e.g. artifacts).
2098
+ # @param [String] name
2099
+ # Required. The name of the spec to delete. Format: projects/*/locations/*/apis/*
2100
+ # /versions/*/specs/*
2101
+ # @param [Boolean] force
2102
+ # If set to true, any child resources will also be deleted. (Otherwise, the
2103
+ # request will only work if there are no child resources.)
2104
+ # @param [String] fields
2105
+ # Selector specifying which fields to include in a partial response.
2106
+ # @param [String] quota_user
2107
+ # Available to use for quota purposes for server-side applications. Can be any
2108
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2109
+ # @param [Google::Apis::RequestOptions] options
2110
+ # Request-specific options
2111
+ #
2112
+ # @yield [result, err] Result & error if block supplied
2113
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
2114
+ # @yieldparam err [StandardError] error object if request failed
2115
+ #
2116
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
2117
+ #
2118
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2119
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2120
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2121
+ def delete_project_location_api_version_spec(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
2122
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2123
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
2124
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
2125
+ command.params['name'] = name unless name.nil?
2126
+ command.query['force'] = force unless force.nil?
2127
+ command.query['fields'] = fields unless fields.nil?
2128
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2129
+ execute_or_queue_command(command, &block)
2130
+ end
2131
+
2132
+ # DeleteApiSpecRevision deletes a revision of a spec.
2133
+ # @param [String] name
2134
+ # Required. The name of the spec revision to be deleted, with a revision ID
2135
+ # explicitly included. Example: projects/sample/locations/global/apis/petstore/
2136
+ # versions/1.0.0/specs/openapi.yaml@c7cfa2a8
2137
+ # @param [String] fields
2138
+ # Selector specifying which fields to include in a partial response.
2139
+ # @param [String] quota_user
2140
+ # Available to use for quota purposes for server-side applications. Can be any
2141
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2142
+ # @param [Google::Apis::RequestOptions] options
2143
+ # Request-specific options
2144
+ #
2145
+ # @yield [result, err] Result & error if block supplied
2146
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiSpec] parsed result object
2147
+ # @yieldparam err [StandardError] error object if request failed
2148
+ #
2149
+ # @return [Google::Apis::ApigeeregistryV1::ApiSpec]
2150
+ #
2151
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2152
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2153
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2154
+ def delete_project_location_api_version_spec_revision(name, fields: nil, quota_user: nil, options: nil, &block)
2155
+ command = make_simple_command(:delete, 'v1/{+name}:deleteRevision', options)
2156
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2157
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiSpec
2158
+ command.params['name'] = name unless name.nil?
2159
+ command.query['fields'] = fields unless fields.nil?
2160
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2161
+ execute_or_queue_command(command, &block)
2162
+ end
2163
+
2164
+ # GetApiSpec returns a specified spec.
2165
+ # @param [String] name
2166
+ # Required. The name of the spec to retrieve. Format: projects/*/locations/*/
2167
+ # apis/*/versions/*/specs/*
2168
+ # @param [String] fields
2169
+ # Selector specifying which fields to include in a partial response.
2170
+ # @param [String] quota_user
2171
+ # Available to use for quota purposes for server-side applications. Can be any
2172
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2173
+ # @param [Google::Apis::RequestOptions] options
2174
+ # Request-specific options
2175
+ #
2176
+ # @yield [result, err] Result & error if block supplied
2177
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiSpec] parsed result object
2178
+ # @yieldparam err [StandardError] error object if request failed
2179
+ #
2180
+ # @return [Google::Apis::ApigeeregistryV1::ApiSpec]
2181
+ #
2182
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2183
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2184
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2185
+ def get_project_location_api_version_spec(name, fields: nil, quota_user: nil, options: nil, &block)
2186
+ command = make_simple_command(:get, 'v1/{+name}', options)
2187
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2188
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiSpec
2189
+ command.params['name'] = name unless name.nil?
2190
+ command.query['fields'] = fields unless fields.nil?
2191
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2192
+ execute_or_queue_command(command, &block)
2193
+ end
2194
+
2195
+ # GetApiSpecContents returns the contents of a specified spec. If specs are
2196
+ # stored with GZip compression, the default behavior is to return the spec
2197
+ # uncompressed (the mime_type response field indicates the exact format returned)
2198
+ # .
2199
+ # @param [String] name
2200
+ # Required. The name of the spec whose contents should be retrieved. Format:
2201
+ # projects/*/locations/*/apis/*/versions/*/specs/*
2202
+ # @param [String] fields
2203
+ # Selector specifying which fields to include in a partial response.
2204
+ # @param [String] quota_user
2205
+ # Available to use for quota purposes for server-side applications. Can be any
2206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2207
+ # @param [Google::Apis::RequestOptions] options
2208
+ # Request-specific options
2209
+ #
2210
+ # @yield [result, err] Result & error if block supplied
2211
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::HttpBody] parsed result object
2212
+ # @yieldparam err [StandardError] error object if request failed
2213
+ #
2214
+ # @return [Google::Apis::ApigeeregistryV1::HttpBody]
2215
+ #
2216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2219
+ def get_project_location_api_version_spec_contents(name, fields: nil, quota_user: nil, options: nil, &block)
2220
+ command = make_simple_command(:get, 'v1/{+name}:getContents', options)
2221
+ command.response_representation = Google::Apis::ApigeeregistryV1::HttpBody::Representation
2222
+ command.response_class = Google::Apis::ApigeeregistryV1::HttpBody
2223
+ command.params['name'] = name unless name.nil?
2224
+ command.query['fields'] = fields unless fields.nil?
2225
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2226
+ execute_or_queue_command(command, &block)
2227
+ end
2228
+
2229
+ # Gets the access control policy for a resource. Returns an empty policy if the
2230
+ # resource exists and does not have a policy set.
2231
+ # @param [String] resource
2232
+ # REQUIRED: The resource for which the policy is being requested. See the
2233
+ # operation documentation for the appropriate value for this field.
2234
+ # @param [Fixnum] options_requested_policy_version
2235
+ # Optional. The maximum policy version that will be used to format the policy.
2236
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
2237
+ # rejected. Requests for policies with any conditional role bindings must
2238
+ # specify version 3. Policies with no conditional role bindings may specify any
2239
+ # valid value or leave the field unset. The policy in the response might use the
2240
+ # policy version that you specified, or it might use a lower policy version. For
2241
+ # example, if you specify version 3, but the policy has no conditional role
2242
+ # bindings, the response uses version 1. To learn which resources support
2243
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2244
+ # google.com/iam/help/conditions/resource-policies).
2245
+ # @param [String] fields
2246
+ # Selector specifying which fields to include in a partial response.
2247
+ # @param [String] quota_user
2248
+ # Available to use for quota purposes for server-side applications. Can be any
2249
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2250
+ # @param [Google::Apis::RequestOptions] options
2251
+ # Request-specific options
2252
+ #
2253
+ # @yield [result, err] Result & error if block supplied
2254
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
2255
+ # @yieldparam err [StandardError] error object if request failed
2256
+ #
2257
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
2258
+ #
2259
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2260
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2261
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2262
+ def get_project_location_api_version_spec_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
2263
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
2264
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
2265
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
2266
+ command.params['resource'] = resource unless resource.nil?
2267
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
2268
+ command.query['fields'] = fields unless fields.nil?
2269
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2270
+ execute_or_queue_command(command, &block)
2271
+ end
2272
+
2273
+ # ListApiSpecs returns matching specs.
2274
+ # @param [String] parent
2275
+ # Required. The parent, which owns this collection of specs. Format: projects/*/
2276
+ # locations/*/apis/*/versions/*
2277
+ # @param [String] filter
2278
+ # An expression that can be used to filter the list. Filters use the Common
2279
+ # Expression Language and can refer to all message fields except contents.
2280
+ # @param [Fixnum] page_size
2281
+ # The maximum number of specs to return. The service may return fewer than this
2282
+ # value. If unspecified, at most 50 values will be returned. The maximum is 1000;
2283
+ # values above 1000 will be coerced to 1000.
2284
+ # @param [String] page_token
2285
+ # A page token, received from a previous `ListApiSpecs` call. Provide this to
2286
+ # retrieve the subsequent page. When paginating, all other parameters provided
2287
+ # to `ListApiSpecs` must match the call that provided the page token.
2288
+ # @param [String] fields
2289
+ # Selector specifying which fields to include in a partial response.
2290
+ # @param [String] quota_user
2291
+ # Available to use for quota purposes for server-side applications. Can be any
2292
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2293
+ # @param [Google::Apis::RequestOptions] options
2294
+ # Request-specific options
2295
+ #
2296
+ # @yield [result, err] Result & error if block supplied
2297
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListApiSpecsResponse] parsed result object
2298
+ # @yieldparam err [StandardError] error object if request failed
2299
+ #
2300
+ # @return [Google::Apis::ApigeeregistryV1::ListApiSpecsResponse]
2301
+ #
2302
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2303
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2304
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2305
+ def list_project_location_api_version_specs(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2306
+ command = make_simple_command(:get, 'v1/{+parent}/specs', options)
2307
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListApiSpecsResponse::Representation
2308
+ command.response_class = Google::Apis::ApigeeregistryV1::ListApiSpecsResponse
2309
+ command.params['parent'] = parent unless parent.nil?
2310
+ command.query['filter'] = filter unless filter.nil?
2311
+ command.query['pageSize'] = page_size unless page_size.nil?
2312
+ command.query['pageToken'] = page_token unless page_token.nil?
2313
+ command.query['fields'] = fields unless fields.nil?
2314
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2315
+ execute_or_queue_command(command, &block)
2316
+ end
2317
+
2318
+ # ListApiSpecRevisions lists all revisions of a spec. Revisions are returned in
2319
+ # descending order of revision creation time.
2320
+ # @param [String] name
2321
+ # Required. The name of the spec to list revisions for.
2322
+ # @param [Fixnum] page_size
2323
+ # The maximum number of revisions to return per page.
2324
+ # @param [String] page_token
2325
+ # The page token, received from a previous ListApiSpecRevisions call. Provide
2326
+ # this to retrieve the subsequent page.
2327
+ # @param [String] fields
2328
+ # Selector specifying which fields to include in a partial response.
2329
+ # @param [String] quota_user
2330
+ # Available to use for quota purposes for server-side applications. Can be any
2331
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2332
+ # @param [Google::Apis::RequestOptions] options
2333
+ # Request-specific options
2334
+ #
2335
+ # @yield [result, err] Result & error if block supplied
2336
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListApiSpecRevisionsResponse] parsed result object
2337
+ # @yieldparam err [StandardError] error object if request failed
2338
+ #
2339
+ # @return [Google::Apis::ApigeeregistryV1::ListApiSpecRevisionsResponse]
2340
+ #
2341
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2342
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2343
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2344
+ def list_project_location_api_version_spec_revisions(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2345
+ command = make_simple_command(:get, 'v1/{+name}:listRevisions', options)
2346
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListApiSpecRevisionsResponse::Representation
2347
+ command.response_class = Google::Apis::ApigeeregistryV1::ListApiSpecRevisionsResponse
2348
+ command.params['name'] = name unless name.nil?
2349
+ command.query['pageSize'] = page_size unless page_size.nil?
2350
+ command.query['pageToken'] = page_token unless page_token.nil?
2351
+ command.query['fields'] = fields unless fields.nil?
2352
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2353
+ execute_or_queue_command(command, &block)
2354
+ end
2355
+
2356
+ # UpdateApiSpec can be used to modify a specified spec.
2357
+ # @param [String] name
2358
+ # Resource name.
2359
+ # @param [Google::Apis::ApigeeregistryV1::ApiSpec] api_spec_object
2360
+ # @param [Boolean] allow_missing
2361
+ # If set to true, and the spec is not found, a new spec will be created. In this
2362
+ # situation, `update_mask` is ignored.
2363
+ # @param [String] update_mask
2364
+ # The list of fields to be updated. If omitted, all fields are updated that are
2365
+ # set in the request message (fields set to default values are ignored). If a "*"
2366
+ # is specified, all fields are updated, including fields that are unspecified/
2367
+ # default in the request.
2368
+ # @param [String] fields
2369
+ # Selector specifying which fields to include in a partial response.
2370
+ # @param [String] quota_user
2371
+ # Available to use for quota purposes for server-side applications. Can be any
2372
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2373
+ # @param [Google::Apis::RequestOptions] options
2374
+ # Request-specific options
2375
+ #
2376
+ # @yield [result, err] Result & error if block supplied
2377
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiSpec] parsed result object
2378
+ # @yieldparam err [StandardError] error object if request failed
2379
+ #
2380
+ # @return [Google::Apis::ApigeeregistryV1::ApiSpec]
2381
+ #
2382
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2383
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2384
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2385
+ def patch_project_location_api_version_spec(name, api_spec_object = nil, allow_missing: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2386
+ command = make_simple_command(:patch, 'v1/{+name}', options)
2387
+ command.request_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2388
+ command.request_object = api_spec_object
2389
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2390
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiSpec
2391
+ command.params['name'] = name unless name.nil?
2392
+ command.query['allowMissing'] = allow_missing unless allow_missing.nil?
2393
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2394
+ command.query['fields'] = fields unless fields.nil?
2395
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2396
+ execute_or_queue_command(command, &block)
2397
+ end
2398
+
2399
+ # RollbackApiSpec sets the current revision to a specified prior revision. Note
2400
+ # that this creates a new revision with a new revision ID.
2401
+ # @param [String] name
2402
+ # Required. The spec being rolled back.
2403
+ # @param [Google::Apis::ApigeeregistryV1::RollbackApiSpecRequest] rollback_api_spec_request_object
2404
+ # @param [String] fields
2405
+ # Selector specifying which fields to include in a partial response.
2406
+ # @param [String] quota_user
2407
+ # Available to use for quota purposes for server-side applications. Can be any
2408
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2409
+ # @param [Google::Apis::RequestOptions] options
2410
+ # Request-specific options
2411
+ #
2412
+ # @yield [result, err] Result & error if block supplied
2413
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiSpec] parsed result object
2414
+ # @yieldparam err [StandardError] error object if request failed
2415
+ #
2416
+ # @return [Google::Apis::ApigeeregistryV1::ApiSpec]
2417
+ #
2418
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2419
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2420
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2421
+ def rollback_api_spec(name, rollback_api_spec_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2422
+ command = make_simple_command(:post, 'v1/{+name}:rollback', options)
2423
+ command.request_representation = Google::Apis::ApigeeregistryV1::RollbackApiSpecRequest::Representation
2424
+ command.request_object = rollback_api_spec_request_object
2425
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2426
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiSpec
2427
+ command.params['name'] = name unless name.nil?
2428
+ command.query['fields'] = fields unless fields.nil?
2429
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2430
+ execute_or_queue_command(command, &block)
2431
+ end
2432
+
2433
+ # Sets the access control policy on the specified resource. Replaces any
2434
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2435
+ # PERMISSION_DENIED` errors.
2436
+ # @param [String] resource
2437
+ # REQUIRED: The resource for which the policy is being specified. See the
2438
+ # operation documentation for the appropriate value for this field.
2439
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
2440
+ # @param [String] fields
2441
+ # Selector specifying which fields to include in a partial response.
2442
+ # @param [String] quota_user
2443
+ # Available to use for quota purposes for server-side applications. Can be any
2444
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2445
+ # @param [Google::Apis::RequestOptions] options
2446
+ # Request-specific options
2447
+ #
2448
+ # @yield [result, err] Result & error if block supplied
2449
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
2450
+ # @yieldparam err [StandardError] error object if request failed
2451
+ #
2452
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
2453
+ #
2454
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2455
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2456
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2457
+ def set_spec_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2458
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2459
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
2460
+ command.request_object = set_iam_policy_request_object
2461
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
2462
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
2463
+ command.params['resource'] = resource unless resource.nil?
2464
+ command.query['fields'] = fields unless fields.nil?
2465
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2466
+ execute_or_queue_command(command, &block)
2467
+ end
2468
+
2469
+ # TagApiSpecRevision adds a tag to a specified revision of a spec.
2470
+ # @param [String] name
2471
+ # Required. The name of the spec to be tagged, including the revision ID.
2472
+ # @param [Google::Apis::ApigeeregistryV1::TagApiSpecRevisionRequest] tag_api_spec_revision_request_object
2473
+ # @param [String] fields
2474
+ # Selector specifying which fields to include in a partial response.
2475
+ # @param [String] quota_user
2476
+ # Available to use for quota purposes for server-side applications. Can be any
2477
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2478
+ # @param [Google::Apis::RequestOptions] options
2479
+ # Request-specific options
2480
+ #
2481
+ # @yield [result, err] Result & error if block supplied
2482
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ApiSpec] parsed result object
2483
+ # @yieldparam err [StandardError] error object if request failed
2484
+ #
2485
+ # @return [Google::Apis::ApigeeregistryV1::ApiSpec]
2486
+ #
2487
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2488
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2489
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2490
+ def tag_project_location_api_version_spec_revision(name, tag_api_spec_revision_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2491
+ command = make_simple_command(:post, 'v1/{+name}:tagRevision', options)
2492
+ command.request_representation = Google::Apis::ApigeeregistryV1::TagApiSpecRevisionRequest::Representation
2493
+ command.request_object = tag_api_spec_revision_request_object
2494
+ command.response_representation = Google::Apis::ApigeeregistryV1::ApiSpec::Representation
2495
+ command.response_class = Google::Apis::ApigeeregistryV1::ApiSpec
2496
+ command.params['name'] = name unless name.nil?
2497
+ command.query['fields'] = fields unless fields.nil?
2498
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2499
+ execute_or_queue_command(command, &block)
2500
+ end
2501
+
2502
+ # Returns permissions that a caller has on the specified resource. If the
2503
+ # resource does not exist, this will return an empty set of permissions, not a `
2504
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
2505
+ # permission-aware UIs and command-line tools, not for authorization checking.
2506
+ # This operation may "fail open" without warning.
2507
+ # @param [String] resource
2508
+ # REQUIRED: The resource for which the policy detail is being requested. See the
2509
+ # operation documentation for the appropriate value for this field.
2510
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
2511
+ # @param [String] fields
2512
+ # Selector specifying which fields to include in a partial response.
2513
+ # @param [String] quota_user
2514
+ # Available to use for quota purposes for server-side applications. Can be any
2515
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2516
+ # @param [Google::Apis::RequestOptions] options
2517
+ # Request-specific options
2518
+ #
2519
+ # @yield [result, err] Result & error if block supplied
2520
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
2521
+ # @yieldparam err [StandardError] error object if request failed
2522
+ #
2523
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
2524
+ #
2525
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2526
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2527
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2528
+ def test_spec_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2529
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2530
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
2531
+ command.request_object = test_iam_permissions_request_object
2532
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
2533
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
2534
+ command.params['resource'] = resource unless resource.nil?
2535
+ command.query['fields'] = fields unless fields.nil?
2536
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2537
+ execute_or_queue_command(command, &block)
2538
+ end
2539
+
2540
+ # CreateArtifact creates a specified artifact.
2541
+ # @param [String] parent
2542
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
2543
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
2544
+ # @param [String] artifact_id
2545
+ # Required. The ID to use for the artifact, which will become the final
2546
+ # component of the artifact's resource name. This value should be 4-63
2547
+ # characters, and valid characters are /a-z-/. Following AIP-162, IDs must not
2548
+ # have the form of a UUID.
2549
+ # @param [String] fields
2550
+ # Selector specifying which fields to include in a partial response.
2551
+ # @param [String] quota_user
2552
+ # Available to use for quota purposes for server-side applications. Can be any
2553
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2554
+ # @param [Google::Apis::RequestOptions] options
2555
+ # Request-specific options
2556
+ #
2557
+ # @yield [result, err] Result & error if block supplied
2558
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
2559
+ # @yieldparam err [StandardError] error object if request failed
2560
+ #
2561
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
2562
+ #
2563
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2564
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2565
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2566
+ def create_project_location_api_version_spec_artifact(parent, artifact_object = nil, artifact_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2567
+ command = make_simple_command(:post, 'v1/{+parent}/artifacts', options)
2568
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2569
+ command.request_object = artifact_object
2570
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2571
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
2572
+ command.params['parent'] = parent unless parent.nil?
2573
+ command.query['artifactId'] = artifact_id unless artifact_id.nil?
2574
+ command.query['fields'] = fields unless fields.nil?
2575
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2576
+ execute_or_queue_command(command, &block)
2577
+ end
2578
+
2579
+ # DeleteArtifact removes a specified artifact.
2580
+ # @param [String] name
2581
+ # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
2582
+ # @param [String] fields
2583
+ # Selector specifying which fields to include in a partial response.
2584
+ # @param [String] quota_user
2585
+ # Available to use for quota purposes for server-side applications. Can be any
2586
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2587
+ # @param [Google::Apis::RequestOptions] options
2588
+ # Request-specific options
2589
+ #
2590
+ # @yield [result, err] Result & error if block supplied
2591
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
2592
+ # @yieldparam err [StandardError] error object if request failed
2593
+ #
2594
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
2595
+ #
2596
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2597
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2598
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2599
+ def delete_project_location_api_version_spec_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
2600
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2601
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
2602
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
2603
+ command.params['name'] = name unless name.nil?
2604
+ command.query['fields'] = fields unless fields.nil?
2605
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2606
+ execute_or_queue_command(command, &block)
2607
+ end
2608
+
2609
+ # GetArtifact returns a specified artifact.
2610
+ # @param [String] name
2611
+ # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
2612
+ # @param [String] fields
2613
+ # Selector specifying which fields to include in a partial response.
2614
+ # @param [String] quota_user
2615
+ # Available to use for quota purposes for server-side applications. Can be any
2616
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2617
+ # @param [Google::Apis::RequestOptions] options
2618
+ # Request-specific options
2619
+ #
2620
+ # @yield [result, err] Result & error if block supplied
2621
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
2622
+ # @yieldparam err [StandardError] error object if request failed
2623
+ #
2624
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
2625
+ #
2626
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2627
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2628
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2629
+ def get_project_location_api_version_spec_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
2630
+ command = make_simple_command(:get, 'v1/{+name}', options)
2631
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2632
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
2633
+ command.params['name'] = name unless name.nil?
2634
+ command.query['fields'] = fields unless fields.nil?
2635
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2636
+ execute_or_queue_command(command, &block)
2637
+ end
2638
+
2639
+ # GetArtifactContents returns the contents of a specified artifact. If artifacts
2640
+ # are stored with GZip compression, the default behavior is to return the
2641
+ # artifact uncompressed (the mime_type response field indicates the exact format
2642
+ # returned).
2643
+ # @param [String] name
2644
+ # Required. The name of the artifact whose contents should be retrieved. Format:
2645
+ # `parent`/artifacts/*
2646
+ # @param [String] fields
2647
+ # Selector specifying which fields to include in a partial response.
2648
+ # @param [String] quota_user
2649
+ # Available to use for quota purposes for server-side applications. Can be any
2650
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2651
+ # @param [Google::Apis::RequestOptions] options
2652
+ # Request-specific options
2653
+ #
2654
+ # @yield [result, err] Result & error if block supplied
2655
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::HttpBody] parsed result object
2656
+ # @yieldparam err [StandardError] error object if request failed
2657
+ #
2658
+ # @return [Google::Apis::ApigeeregistryV1::HttpBody]
2659
+ #
2660
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2661
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2662
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2663
+ def get_project_location_api_version_spec_artifact_contents(name, fields: nil, quota_user: nil, options: nil, &block)
2664
+ command = make_simple_command(:get, 'v1/{+name}:getContents', options)
2665
+ command.response_representation = Google::Apis::ApigeeregistryV1::HttpBody::Representation
2666
+ command.response_class = Google::Apis::ApigeeregistryV1::HttpBody
2667
+ command.params['name'] = name unless name.nil?
2668
+ command.query['fields'] = fields unless fields.nil?
2669
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2670
+ execute_or_queue_command(command, &block)
2671
+ end
2672
+
2673
+ # Gets the access control policy for a resource. Returns an empty policy if the
2674
+ # resource exists and does not have a policy set.
2675
+ # @param [String] resource
2676
+ # REQUIRED: The resource for which the policy is being requested. See the
2677
+ # operation documentation for the appropriate value for this field.
2678
+ # @param [Fixnum] options_requested_policy_version
2679
+ # Optional. The maximum policy version that will be used to format the policy.
2680
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
2681
+ # rejected. Requests for policies with any conditional role bindings must
2682
+ # specify version 3. Policies with no conditional role bindings may specify any
2683
+ # valid value or leave the field unset. The policy in the response might use the
2684
+ # policy version that you specified, or it might use a lower policy version. For
2685
+ # example, if you specify version 3, but the policy has no conditional role
2686
+ # bindings, the response uses version 1. To learn which resources support
2687
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2688
+ # google.com/iam/help/conditions/resource-policies).
2689
+ # @param [String] fields
2690
+ # Selector specifying which fields to include in a partial response.
2691
+ # @param [String] quota_user
2692
+ # Available to use for quota purposes for server-side applications. Can be any
2693
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2694
+ # @param [Google::Apis::RequestOptions] options
2695
+ # Request-specific options
2696
+ #
2697
+ # @yield [result, err] Result & error if block supplied
2698
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
2699
+ # @yieldparam err [StandardError] error object if request failed
2700
+ #
2701
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
2702
+ #
2703
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2704
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2705
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2706
+ def get_project_location_api_version_spec_artifact_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
2707
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
2708
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
2709
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
2710
+ command.params['resource'] = resource unless resource.nil?
2711
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
2712
+ command.query['fields'] = fields unless fields.nil?
2713
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2714
+ execute_or_queue_command(command, &block)
2715
+ end
2716
+
2717
+ # ListArtifacts returns matching artifacts.
2718
+ # @param [String] parent
2719
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
2720
+ # @param [String] filter
2721
+ # An expression that can be used to filter the list. Filters use the Common
2722
+ # Expression Language and can refer to all message fields except contents.
2723
+ # @param [Fixnum] page_size
2724
+ # The maximum number of artifacts to return. The service may return fewer than
2725
+ # this value. If unspecified, at most 50 values will be returned. The maximum is
2726
+ # 1000; values above 1000 will be coerced to 1000.
2727
+ # @param [String] page_token
2728
+ # A page token, received from a previous `ListArtifacts` call. Provide this to
2729
+ # retrieve the subsequent page. When paginating, all other parameters provided
2730
+ # to `ListArtifacts` must match the call that provided the page token.
2731
+ # @param [String] fields
2732
+ # Selector specifying which fields to include in a partial response.
2733
+ # @param [String] quota_user
2734
+ # Available to use for quota purposes for server-side applications. Can be any
2735
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2736
+ # @param [Google::Apis::RequestOptions] options
2737
+ # Request-specific options
2738
+ #
2739
+ # @yield [result, err] Result & error if block supplied
2740
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListArtifactsResponse] parsed result object
2741
+ # @yieldparam err [StandardError] error object if request failed
2742
+ #
2743
+ # @return [Google::Apis::ApigeeregistryV1::ListArtifactsResponse]
2744
+ #
2745
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2746
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2747
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2748
+ def list_project_location_api_version_spec_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2749
+ command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
2750
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
2751
+ command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
2752
+ command.params['parent'] = parent unless parent.nil?
2753
+ command.query['filter'] = filter unless filter.nil?
2754
+ command.query['pageSize'] = page_size unless page_size.nil?
2755
+ command.query['pageToken'] = page_token unless page_token.nil?
2756
+ command.query['fields'] = fields unless fields.nil?
2757
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2758
+ execute_or_queue_command(command, &block)
2759
+ end
2760
+
2761
+ # ReplaceArtifact can be used to replace a specified artifact.
2762
+ # @param [String] name
2763
+ # Resource name.
2764
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
2765
+ # @param [String] fields
2766
+ # Selector specifying which fields to include in a partial response.
2767
+ # @param [String] quota_user
2768
+ # Available to use for quota purposes for server-side applications. Can be any
2769
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2770
+ # @param [Google::Apis::RequestOptions] options
2771
+ # Request-specific options
2772
+ #
2773
+ # @yield [result, err] Result & error if block supplied
2774
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
2775
+ # @yieldparam err [StandardError] error object if request failed
2776
+ #
2777
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
2778
+ #
2779
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2780
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2781
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2782
+ def replace_project_location_api_version_spec_artifact_artifact(name, artifact_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2783
+ command = make_simple_command(:put, 'v1/{+name}', options)
2784
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2785
+ command.request_object = artifact_object
2786
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2787
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
2788
+ command.params['name'] = name unless name.nil?
2789
+ command.query['fields'] = fields unless fields.nil?
2790
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2791
+ execute_or_queue_command(command, &block)
2792
+ end
2793
+
2794
+ # Sets the access control policy on the specified resource. Replaces any
2795
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
2796
+ # PERMISSION_DENIED` errors.
2797
+ # @param [String] resource
2798
+ # REQUIRED: The resource for which the policy is being specified. See the
2799
+ # operation documentation for the appropriate value for this field.
2800
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
2801
+ # @param [String] fields
2802
+ # Selector specifying which fields to include in a partial response.
2803
+ # @param [String] quota_user
2804
+ # Available to use for quota purposes for server-side applications. Can be any
2805
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2806
+ # @param [Google::Apis::RequestOptions] options
2807
+ # Request-specific options
2808
+ #
2809
+ # @yield [result, err] Result & error if block supplied
2810
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
2811
+ # @yieldparam err [StandardError] error object if request failed
2812
+ #
2813
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
2814
+ #
2815
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2816
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2817
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2818
+ def set_project_location_api_version_spec_artifact_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2819
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
2820
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
2821
+ command.request_object = set_iam_policy_request_object
2822
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
2823
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
2824
+ command.params['resource'] = resource unless resource.nil?
2825
+ command.query['fields'] = fields unless fields.nil?
2826
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2827
+ execute_or_queue_command(command, &block)
2828
+ end
2829
+
2830
+ # Returns permissions that a caller has on the specified resource. If the
2831
+ # resource does not exist, this will return an empty set of permissions, not a `
2832
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
2833
+ # permission-aware UIs and command-line tools, not for authorization checking.
2834
+ # This operation may "fail open" without warning.
2835
+ # @param [String] resource
2836
+ # REQUIRED: The resource for which the policy detail is being requested. See the
2837
+ # operation documentation for the appropriate value for this field.
2838
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
2839
+ # @param [String] fields
2840
+ # Selector specifying which fields to include in a partial response.
2841
+ # @param [String] quota_user
2842
+ # Available to use for quota purposes for server-side applications. Can be any
2843
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2844
+ # @param [Google::Apis::RequestOptions] options
2845
+ # Request-specific options
2846
+ #
2847
+ # @yield [result, err] Result & error if block supplied
2848
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
2849
+ # @yieldparam err [StandardError] error object if request failed
2850
+ #
2851
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
2852
+ #
2853
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2854
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2855
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2856
+ def test_project_location_api_version_spec_artifact_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2857
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
2858
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
2859
+ command.request_object = test_iam_permissions_request_object
2860
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
2861
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
2862
+ command.params['resource'] = resource unless resource.nil?
2863
+ command.query['fields'] = fields unless fields.nil?
2864
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2865
+ execute_or_queue_command(command, &block)
2866
+ end
2867
+
2868
+ # CreateArtifact creates a specified artifact.
2869
+ # @param [String] parent
2870
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
2871
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
2872
+ # @param [String] artifact_id
2873
+ # Required. The ID to use for the artifact, which will become the final
2874
+ # component of the artifact's resource name. This value should be 4-63
2875
+ # characters, and valid characters are /a-z-/. Following AIP-162, IDs must not
2876
+ # have the form of a UUID.
2877
+ # @param [String] fields
2878
+ # Selector specifying which fields to include in a partial response.
2879
+ # @param [String] quota_user
2880
+ # Available to use for quota purposes for server-side applications. Can be any
2881
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2882
+ # @param [Google::Apis::RequestOptions] options
2883
+ # Request-specific options
2884
+ #
2885
+ # @yield [result, err] Result & error if block supplied
2886
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
2887
+ # @yieldparam err [StandardError] error object if request failed
2888
+ #
2889
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
2890
+ #
2891
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2892
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2893
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2894
+ def create_project_location_artifact(parent, artifact_object = nil, artifact_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2895
+ command = make_simple_command(:post, 'v1/{+parent}/artifacts', options)
2896
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2897
+ command.request_object = artifact_object
2898
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2899
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
2900
+ command.params['parent'] = parent unless parent.nil?
2901
+ command.query['artifactId'] = artifact_id unless artifact_id.nil?
2902
+ command.query['fields'] = fields unless fields.nil?
2903
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2904
+ execute_or_queue_command(command, &block)
2905
+ end
2906
+
2907
+ # DeleteArtifact removes a specified artifact.
2908
+ # @param [String] name
2909
+ # Required. The name of the artifact to delete. Format: `parent`/artifacts/*
2910
+ # @param [String] fields
2911
+ # Selector specifying which fields to include in a partial response.
2912
+ # @param [String] quota_user
2913
+ # Available to use for quota purposes for server-side applications. Can be any
2914
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2915
+ # @param [Google::Apis::RequestOptions] options
2916
+ # Request-specific options
2917
+ #
2918
+ # @yield [result, err] Result & error if block supplied
2919
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
2920
+ # @yieldparam err [StandardError] error object if request failed
2921
+ #
2922
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
2923
+ #
2924
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2925
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2926
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2927
+ def delete_project_location_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
2928
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2929
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
2930
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
2931
+ command.params['name'] = name unless name.nil?
2932
+ command.query['fields'] = fields unless fields.nil?
2933
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2934
+ execute_or_queue_command(command, &block)
2935
+ end
2936
+
2937
+ # GetArtifact returns a specified artifact.
2938
+ # @param [String] name
2939
+ # Required. The name of the artifact to retrieve. Format: `parent`/artifacts/*
2940
+ # @param [String] fields
2941
+ # Selector specifying which fields to include in a partial response.
2942
+ # @param [String] quota_user
2943
+ # Available to use for quota purposes for server-side applications. Can be any
2944
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2945
+ # @param [Google::Apis::RequestOptions] options
2946
+ # Request-specific options
2947
+ #
2948
+ # @yield [result, err] Result & error if block supplied
2949
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
2950
+ # @yieldparam err [StandardError] error object if request failed
2951
+ #
2952
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
2953
+ #
2954
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2955
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2956
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2957
+ def get_project_location_artifact(name, fields: nil, quota_user: nil, options: nil, &block)
2958
+ command = make_simple_command(:get, 'v1/{+name}', options)
2959
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
2960
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
2961
+ command.params['name'] = name unless name.nil?
2962
+ command.query['fields'] = fields unless fields.nil?
2963
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2964
+ execute_or_queue_command(command, &block)
2965
+ end
2966
+
2967
+ # GetArtifactContents returns the contents of a specified artifact. If artifacts
2968
+ # are stored with GZip compression, the default behavior is to return the
2969
+ # artifact uncompressed (the mime_type response field indicates the exact format
2970
+ # returned).
2971
+ # @param [String] name
2972
+ # Required. The name of the artifact whose contents should be retrieved. Format:
2973
+ # `parent`/artifacts/*
2974
+ # @param [String] fields
2975
+ # Selector specifying which fields to include in a partial response.
2976
+ # @param [String] quota_user
2977
+ # Available to use for quota purposes for server-side applications. Can be any
2978
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2979
+ # @param [Google::Apis::RequestOptions] options
2980
+ # Request-specific options
2981
+ #
2982
+ # @yield [result, err] Result & error if block supplied
2983
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::HttpBody] parsed result object
2984
+ # @yieldparam err [StandardError] error object if request failed
2985
+ #
2986
+ # @return [Google::Apis::ApigeeregistryV1::HttpBody]
2987
+ #
2988
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2989
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2990
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2991
+ def get_project_location_artifact_contents(name, fields: nil, quota_user: nil, options: nil, &block)
2992
+ command = make_simple_command(:get, 'v1/{+name}:getContents', options)
2993
+ command.response_representation = Google::Apis::ApigeeregistryV1::HttpBody::Representation
2994
+ command.response_class = Google::Apis::ApigeeregistryV1::HttpBody
2995
+ command.params['name'] = name unless name.nil?
2996
+ command.query['fields'] = fields unless fields.nil?
2997
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2998
+ execute_or_queue_command(command, &block)
2999
+ end
3000
+
3001
+ # Gets the access control policy for a resource. Returns an empty policy if the
3002
+ # resource exists and does not have a policy set.
3003
+ # @param [String] resource
3004
+ # REQUIRED: The resource for which the policy is being requested. See the
3005
+ # operation documentation for the appropriate value for this field.
3006
+ # @param [Fixnum] options_requested_policy_version
3007
+ # Optional. The maximum policy version that will be used to format the policy.
3008
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
3009
+ # rejected. Requests for policies with any conditional role bindings must
3010
+ # specify version 3. Policies with no conditional role bindings may specify any
3011
+ # valid value or leave the field unset. The policy in the response might use the
3012
+ # policy version that you specified, or it might use a lower policy version. For
3013
+ # example, if you specify version 3, but the policy has no conditional role
3014
+ # bindings, the response uses version 1. To learn which resources support
3015
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
3016
+ # google.com/iam/help/conditions/resource-policies).
3017
+ # @param [String] fields
3018
+ # Selector specifying which fields to include in a partial response.
3019
+ # @param [String] quota_user
3020
+ # Available to use for quota purposes for server-side applications. Can be any
3021
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3022
+ # @param [Google::Apis::RequestOptions] options
3023
+ # Request-specific options
3024
+ #
3025
+ # @yield [result, err] Result & error if block supplied
3026
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
3027
+ # @yieldparam err [StandardError] error object if request failed
3028
+ #
3029
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
3030
+ #
3031
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3032
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3033
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3034
+ def get_project_location_artifact_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
3035
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
3036
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
3037
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
3038
+ command.params['resource'] = resource unless resource.nil?
3039
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
3040
+ command.query['fields'] = fields unless fields.nil?
3041
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3042
+ execute_or_queue_command(command, &block)
3043
+ end
3044
+
3045
+ # ListArtifacts returns matching artifacts.
3046
+ # @param [String] parent
3047
+ # Required. The parent, which owns this collection of artifacts. Format: `parent`
3048
+ # @param [String] filter
3049
+ # An expression that can be used to filter the list. Filters use the Common
3050
+ # Expression Language and can refer to all message fields except contents.
3051
+ # @param [Fixnum] page_size
3052
+ # The maximum number of artifacts to return. The service may return fewer than
3053
+ # this value. If unspecified, at most 50 values will be returned. The maximum is
3054
+ # 1000; values above 1000 will be coerced to 1000.
3055
+ # @param [String] page_token
3056
+ # A page token, received from a previous `ListArtifacts` call. Provide this to
3057
+ # retrieve the subsequent page. When paginating, all other parameters provided
3058
+ # to `ListArtifacts` must match the call that provided the page token.
3059
+ # @param [String] fields
3060
+ # Selector specifying which fields to include in a partial response.
3061
+ # @param [String] quota_user
3062
+ # Available to use for quota purposes for server-side applications. Can be any
3063
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3064
+ # @param [Google::Apis::RequestOptions] options
3065
+ # Request-specific options
3066
+ #
3067
+ # @yield [result, err] Result & error if block supplied
3068
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListArtifactsResponse] parsed result object
3069
+ # @yieldparam err [StandardError] error object if request failed
3070
+ #
3071
+ # @return [Google::Apis::ApigeeregistryV1::ListArtifactsResponse]
3072
+ #
3073
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3074
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3075
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3076
+ def list_project_location_artifacts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3077
+ command = make_simple_command(:get, 'v1/{+parent}/artifacts', options)
3078
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListArtifactsResponse::Representation
3079
+ command.response_class = Google::Apis::ApigeeregistryV1::ListArtifactsResponse
3080
+ command.params['parent'] = parent unless parent.nil?
3081
+ command.query['filter'] = filter unless filter.nil?
3082
+ command.query['pageSize'] = page_size unless page_size.nil?
3083
+ command.query['pageToken'] = page_token unless page_token.nil?
3084
+ command.query['fields'] = fields unless fields.nil?
3085
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3086
+ execute_or_queue_command(command, &block)
3087
+ end
3088
+
3089
+ # ReplaceArtifact can be used to replace a specified artifact.
3090
+ # @param [String] name
3091
+ # Resource name.
3092
+ # @param [Google::Apis::ApigeeregistryV1::Artifact] artifact_object
3093
+ # @param [String] fields
3094
+ # Selector specifying which fields to include in a partial response.
3095
+ # @param [String] quota_user
3096
+ # Available to use for quota purposes for server-side applications. Can be any
3097
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3098
+ # @param [Google::Apis::RequestOptions] options
3099
+ # Request-specific options
3100
+ #
3101
+ # @yield [result, err] Result & error if block supplied
3102
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Artifact] parsed result object
3103
+ # @yieldparam err [StandardError] error object if request failed
3104
+ #
3105
+ # @return [Google::Apis::ApigeeregistryV1::Artifact]
3106
+ #
3107
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3108
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3109
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3110
+ def replace_project_location_artifact_artifact(name, artifact_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3111
+ command = make_simple_command(:put, 'v1/{+name}', options)
3112
+ command.request_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
3113
+ command.request_object = artifact_object
3114
+ command.response_representation = Google::Apis::ApigeeregistryV1::Artifact::Representation
3115
+ command.response_class = Google::Apis::ApigeeregistryV1::Artifact
3116
+ command.params['name'] = name unless name.nil?
3117
+ command.query['fields'] = fields unless fields.nil?
3118
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3119
+ execute_or_queue_command(command, &block)
3120
+ end
3121
+
3122
+ # Sets the access control policy on the specified resource. Replaces any
3123
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
3124
+ # PERMISSION_DENIED` errors.
3125
+ # @param [String] resource
3126
+ # REQUIRED: The resource for which the policy is being specified. See the
3127
+ # operation documentation for the appropriate value for this field.
3128
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
3129
+ # @param [String] fields
3130
+ # Selector specifying which fields to include in a partial response.
3131
+ # @param [String] quota_user
3132
+ # Available to use for quota purposes for server-side applications. Can be any
3133
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3134
+ # @param [Google::Apis::RequestOptions] options
3135
+ # Request-specific options
3136
+ #
3137
+ # @yield [result, err] Result & error if block supplied
3138
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
3139
+ # @yieldparam err [StandardError] error object if request failed
3140
+ #
3141
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
3142
+ #
3143
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3144
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3145
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3146
+ def set_project_location_artifact_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3147
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
3148
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
3149
+ command.request_object = set_iam_policy_request_object
3150
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
3151
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
3152
+ command.params['resource'] = resource unless resource.nil?
3153
+ command.query['fields'] = fields unless fields.nil?
3154
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3155
+ execute_or_queue_command(command, &block)
3156
+ end
3157
+
3158
+ # Returns permissions that a caller has on the specified resource. If the
3159
+ # resource does not exist, this will return an empty set of permissions, not a `
3160
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
3161
+ # permission-aware UIs and command-line tools, not for authorization checking.
3162
+ # This operation may "fail open" without warning.
3163
+ # @param [String] resource
3164
+ # REQUIRED: The resource for which the policy detail is being requested. See the
3165
+ # operation documentation for the appropriate value for this field.
3166
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
3167
+ # @param [String] fields
3168
+ # Selector specifying which fields to include in a partial response.
3169
+ # @param [String] quota_user
3170
+ # Available to use for quota purposes for server-side applications. Can be any
3171
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3172
+ # @param [Google::Apis::RequestOptions] options
3173
+ # Request-specific options
3174
+ #
3175
+ # @yield [result, err] Result & error if block supplied
3176
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
3177
+ # @yieldparam err [StandardError] error object if request failed
3178
+ #
3179
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
3180
+ #
3181
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3182
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3183
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3184
+ def test_project_location_artifact_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3185
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
3186
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
3187
+ command.request_object = test_iam_permissions_request_object
3188
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
3189
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
3190
+ command.params['resource'] = resource unless resource.nil?
3191
+ command.query['fields'] = fields unless fields.nil?
3192
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3193
+ execute_or_queue_command(command, &block)
3194
+ end
3195
+
3196
+ # Provisions instance resources for the Registry.
3197
+ # @param [String] parent
3198
+ # Required. Parent resource of the Instance, of the form: `projects/*/locations/*
3199
+ # `
3200
+ # @param [Google::Apis::ApigeeregistryV1::Instance] instance_object
3201
+ # @param [String] instance_id
3202
+ # Required. Identifier to assign to the Instance. Must be unique within scope of
3203
+ # the parent resource.
3204
+ # @param [String] fields
3205
+ # Selector specifying which fields to include in a partial response.
3206
+ # @param [String] quota_user
3207
+ # Available to use for quota purposes for server-side applications. Can be any
3208
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3209
+ # @param [Google::Apis::RequestOptions] options
3210
+ # Request-specific options
3211
+ #
3212
+ # @yield [result, err] Result & error if block supplied
3213
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Operation] parsed result object
3214
+ # @yieldparam err [StandardError] error object if request failed
3215
+ #
3216
+ # @return [Google::Apis::ApigeeregistryV1::Operation]
3217
+ #
3218
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3219
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3220
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3221
+ def create_project_location_instance(parent, instance_object = nil, instance_id: nil, fields: nil, quota_user: nil, options: nil, &block)
3222
+ command = make_simple_command(:post, 'v1/{+parent}/instances', options)
3223
+ command.request_representation = Google::Apis::ApigeeregistryV1::Instance::Representation
3224
+ command.request_object = instance_object
3225
+ command.response_representation = Google::Apis::ApigeeregistryV1::Operation::Representation
3226
+ command.response_class = Google::Apis::ApigeeregistryV1::Operation
3227
+ command.params['parent'] = parent unless parent.nil?
3228
+ command.query['instanceId'] = instance_id unless instance_id.nil?
3229
+ command.query['fields'] = fields unless fields.nil?
3230
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3231
+ execute_or_queue_command(command, &block)
3232
+ end
3233
+
3234
+ # Deletes the Registry instance.
3235
+ # @param [String] name
3236
+ # Required. The name of the Instance to delete. Format: `projects/*/locations/*/
3237
+ # instances/*`.
3238
+ # @param [String] fields
3239
+ # Selector specifying which fields to include in a partial response.
3240
+ # @param [String] quota_user
3241
+ # Available to use for quota purposes for server-side applications. Can be any
3242
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3243
+ # @param [Google::Apis::RequestOptions] options
3244
+ # Request-specific options
3245
+ #
3246
+ # @yield [result, err] Result & error if block supplied
3247
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Operation] parsed result object
3248
+ # @yieldparam err [StandardError] error object if request failed
3249
+ #
3250
+ # @return [Google::Apis::ApigeeregistryV1::Operation]
3251
+ #
3252
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3253
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3254
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3255
+ def delete_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
3256
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3257
+ command.response_representation = Google::Apis::ApigeeregistryV1::Operation::Representation
3258
+ command.response_class = Google::Apis::ApigeeregistryV1::Operation
3259
+ command.params['name'] = name unless name.nil?
3260
+ command.query['fields'] = fields unless fields.nil?
3261
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3262
+ execute_or_queue_command(command, &block)
3263
+ end
3264
+
3265
+ # Gets details of a single Instance.
3266
+ # @param [String] name
3267
+ # Required. The name of the Instance to retrieve. Format: `projects/*/locations/*
3268
+ # /instances/*`.
3269
+ # @param [String] fields
3270
+ # Selector specifying which fields to include in a partial response.
3271
+ # @param [String] quota_user
3272
+ # Available to use for quota purposes for server-side applications. Can be any
3273
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3274
+ # @param [Google::Apis::RequestOptions] options
3275
+ # Request-specific options
3276
+ #
3277
+ # @yield [result, err] Result & error if block supplied
3278
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Instance] parsed result object
3279
+ # @yieldparam err [StandardError] error object if request failed
3280
+ #
3281
+ # @return [Google::Apis::ApigeeregistryV1::Instance]
3282
+ #
3283
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3284
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3285
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3286
+ def get_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
3287
+ command = make_simple_command(:get, 'v1/{+name}', options)
3288
+ command.response_representation = Google::Apis::ApigeeregistryV1::Instance::Representation
3289
+ command.response_class = Google::Apis::ApigeeregistryV1::Instance
3290
+ command.params['name'] = name unless name.nil?
3291
+ command.query['fields'] = fields unless fields.nil?
3292
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3293
+ execute_or_queue_command(command, &block)
3294
+ end
3295
+
3296
+ # Gets the access control policy for a resource. Returns an empty policy if the
3297
+ # resource exists and does not have a policy set.
3298
+ # @param [String] resource
3299
+ # REQUIRED: The resource for which the policy is being requested. See the
3300
+ # operation documentation for the appropriate value for this field.
3301
+ # @param [Fixnum] options_requested_policy_version
3302
+ # Optional. The maximum policy version that will be used to format the policy.
3303
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
3304
+ # rejected. Requests for policies with any conditional role bindings must
3305
+ # specify version 3. Policies with no conditional role bindings may specify any
3306
+ # valid value or leave the field unset. The policy in the response might use the
3307
+ # policy version that you specified, or it might use a lower policy version. For
3308
+ # example, if you specify version 3, but the policy has no conditional role
3309
+ # bindings, the response uses version 1. To learn which resources support
3310
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
3311
+ # google.com/iam/help/conditions/resource-policies).
3312
+ # @param [String] fields
3313
+ # Selector specifying which fields to include in a partial response.
3314
+ # @param [String] quota_user
3315
+ # Available to use for quota purposes for server-side applications. Can be any
3316
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3317
+ # @param [Google::Apis::RequestOptions] options
3318
+ # Request-specific options
3319
+ #
3320
+ # @yield [result, err] Result & error if block supplied
3321
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
3322
+ # @yieldparam err [StandardError] error object if request failed
3323
+ #
3324
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
3325
+ #
3326
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3327
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3328
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3329
+ def get_project_location_instance_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
3330
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
3331
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
3332
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
3333
+ command.params['resource'] = resource unless resource.nil?
3334
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
3335
+ command.query['fields'] = fields unless fields.nil?
3336
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3337
+ execute_or_queue_command(command, &block)
3338
+ end
3339
+
3340
+ # Sets the access control policy on the specified resource. Replaces any
3341
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
3342
+ # PERMISSION_DENIED` errors.
3343
+ # @param [String] resource
3344
+ # REQUIRED: The resource for which the policy is being specified. See the
3345
+ # operation documentation for the appropriate value for this field.
3346
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
3347
+ # @param [String] fields
3348
+ # Selector specifying which fields to include in a partial response.
3349
+ # @param [String] quota_user
3350
+ # Available to use for quota purposes for server-side applications. Can be any
3351
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3352
+ # @param [Google::Apis::RequestOptions] options
3353
+ # Request-specific options
3354
+ #
3355
+ # @yield [result, err] Result & error if block supplied
3356
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
3357
+ # @yieldparam err [StandardError] error object if request failed
3358
+ #
3359
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
3360
+ #
3361
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3362
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3363
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3364
+ def set_instance_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3365
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
3366
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
3367
+ command.request_object = set_iam_policy_request_object
3368
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
3369
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
3370
+ command.params['resource'] = resource unless resource.nil?
3371
+ command.query['fields'] = fields unless fields.nil?
3372
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3373
+ execute_or_queue_command(command, &block)
3374
+ end
3375
+
3376
+ # Returns permissions that a caller has on the specified resource. If the
3377
+ # resource does not exist, this will return an empty set of permissions, not a `
3378
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
3379
+ # permission-aware UIs and command-line tools, not for authorization checking.
3380
+ # This operation may "fail open" without warning.
3381
+ # @param [String] resource
3382
+ # REQUIRED: The resource for which the policy detail is being requested. See the
3383
+ # operation documentation for the appropriate value for this field.
3384
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
3385
+ # @param [String] fields
3386
+ # Selector specifying which fields to include in a partial response.
3387
+ # @param [String] quota_user
3388
+ # Available to use for quota purposes for server-side applications. Can be any
3389
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3390
+ # @param [Google::Apis::RequestOptions] options
3391
+ # Request-specific options
3392
+ #
3393
+ # @yield [result, err] Result & error if block supplied
3394
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
3395
+ # @yieldparam err [StandardError] error object if request failed
3396
+ #
3397
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
3398
+ #
3399
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3400
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3401
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3402
+ def test_instance_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3403
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
3404
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
3405
+ command.request_object = test_iam_permissions_request_object
3406
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
3407
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
3408
+ command.params['resource'] = resource unless resource.nil?
3409
+ command.query['fields'] = fields unless fields.nil?
3410
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3411
+ execute_or_queue_command(command, &block)
3412
+ end
3413
+
3414
+ # Starts asynchronous cancellation on a long-running operation. The server makes
3415
+ # a best effort to cancel the operation, but success is not guaranteed. If the
3416
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
3417
+ # Clients can use Operations.GetOperation or other methods to check whether the
3418
+ # cancellation succeeded or whether the operation completed despite cancellation.
3419
+ # On successful cancellation, the operation is not deleted; instead, it becomes
3420
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
3421
+ # corresponding to `Code.CANCELLED`.
3422
+ # @param [String] name
3423
+ # The name of the operation resource to be cancelled.
3424
+ # @param [Google::Apis::ApigeeregistryV1::CancelOperationRequest] cancel_operation_request_object
3425
+ # @param [String] fields
3426
+ # Selector specifying which fields to include in a partial response.
3427
+ # @param [String] quota_user
3428
+ # Available to use for quota purposes for server-side applications. Can be any
3429
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3430
+ # @param [Google::Apis::RequestOptions] options
3431
+ # Request-specific options
3432
+ #
3433
+ # @yield [result, err] Result & error if block supplied
3434
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
3435
+ # @yieldparam err [StandardError] error object if request failed
3436
+ #
3437
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
3438
+ #
3439
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3440
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3441
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3442
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3443
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
3444
+ command.request_representation = Google::Apis::ApigeeregistryV1::CancelOperationRequest::Representation
3445
+ command.request_object = cancel_operation_request_object
3446
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
3447
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
3448
+ command.params['name'] = name unless name.nil?
3449
+ command.query['fields'] = fields unless fields.nil?
3450
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3451
+ execute_or_queue_command(command, &block)
3452
+ end
3453
+
3454
+ # Deletes a long-running operation. This method indicates that the client is no
3455
+ # longer interested in the operation result. It does not cancel the operation.
3456
+ # If the server doesn't support this method, it returns `google.rpc.Code.
3457
+ # UNIMPLEMENTED`.
3458
+ # @param [String] name
3459
+ # The name of the operation resource to be deleted.
3460
+ # @param [String] fields
3461
+ # Selector specifying which fields to include in a partial response.
3462
+ # @param [String] quota_user
3463
+ # Available to use for quota purposes for server-side applications. Can be any
3464
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3465
+ # @param [Google::Apis::RequestOptions] options
3466
+ # Request-specific options
3467
+ #
3468
+ # @yield [result, err] Result & error if block supplied
3469
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Empty] parsed result object
3470
+ # @yieldparam err [StandardError] error object if request failed
3471
+ #
3472
+ # @return [Google::Apis::ApigeeregistryV1::Empty]
3473
+ #
3474
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3475
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3476
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3477
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
3478
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3479
+ command.response_representation = Google::Apis::ApigeeregistryV1::Empty::Representation
3480
+ command.response_class = Google::Apis::ApigeeregistryV1::Empty
3481
+ command.params['name'] = name unless name.nil?
3482
+ command.query['fields'] = fields unless fields.nil?
3483
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3484
+ execute_or_queue_command(command, &block)
3485
+ end
3486
+
3487
+ # Gets the latest state of a long-running operation. Clients can use this method
3488
+ # to poll the operation result at intervals as recommended by the API service.
3489
+ # @param [String] name
3490
+ # The name of the operation resource.
3491
+ # @param [String] fields
3492
+ # Selector specifying which fields to include in a partial response.
3493
+ # @param [String] quota_user
3494
+ # Available to use for quota purposes for server-side applications. Can be any
3495
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3496
+ # @param [Google::Apis::RequestOptions] options
3497
+ # Request-specific options
3498
+ #
3499
+ # @yield [result, err] Result & error if block supplied
3500
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Operation] parsed result object
3501
+ # @yieldparam err [StandardError] error object if request failed
3502
+ #
3503
+ # @return [Google::Apis::ApigeeregistryV1::Operation]
3504
+ #
3505
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3506
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3507
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3508
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
3509
+ command = make_simple_command(:get, 'v1/{+name}', options)
3510
+ command.response_representation = Google::Apis::ApigeeregistryV1::Operation::Representation
3511
+ command.response_class = Google::Apis::ApigeeregistryV1::Operation
3512
+ command.params['name'] = name unless name.nil?
3513
+ command.query['fields'] = fields unless fields.nil?
3514
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3515
+ execute_or_queue_command(command, &block)
3516
+ end
3517
+
3518
+ # Lists operations that match the specified filter in the request. If the server
3519
+ # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
3520
+ # binding allows API services to override the binding to use different resource
3521
+ # name schemes, such as `users/*/operations`. To override the binding, API
3522
+ # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
3523
+ # service configuration. For backwards compatibility, the default name includes
3524
+ # the operations collection id, however overriding users must ensure the name
3525
+ # binding is the parent resource, without the operations collection id.
3526
+ # @param [String] name
3527
+ # The name of the operation's parent resource.
3528
+ # @param [String] filter
3529
+ # The standard list filter.
3530
+ # @param [Fixnum] page_size
3531
+ # The standard list page size.
3532
+ # @param [String] page_token
3533
+ # The standard list page token.
3534
+ # @param [String] fields
3535
+ # Selector specifying which fields to include in a partial response.
3536
+ # @param [String] quota_user
3537
+ # Available to use for quota purposes for server-side applications. Can be any
3538
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3539
+ # @param [Google::Apis::RequestOptions] options
3540
+ # Request-specific options
3541
+ #
3542
+ # @yield [result, err] Result & error if block supplied
3543
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::ListOperationsResponse] parsed result object
3544
+ # @yieldparam err [StandardError] error object if request failed
3545
+ #
3546
+ # @return [Google::Apis::ApigeeregistryV1::ListOperationsResponse]
3547
+ #
3548
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3549
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3550
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3551
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3552
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
3553
+ command.response_representation = Google::Apis::ApigeeregistryV1::ListOperationsResponse::Representation
3554
+ command.response_class = Google::Apis::ApigeeregistryV1::ListOperationsResponse
3555
+ command.params['name'] = name unless name.nil?
3556
+ command.query['filter'] = filter unless filter.nil?
3557
+ command.query['pageSize'] = page_size unless page_size.nil?
3558
+ command.query['pageToken'] = page_token unless page_token.nil?
3559
+ command.query['fields'] = fields unless fields.nil?
3560
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3561
+ execute_or_queue_command(command, &block)
3562
+ end
3563
+
3564
+ # Gets the access control policy for a resource. Returns an empty policy if the
3565
+ # resource exists and does not have a policy set.
3566
+ # @param [String] resource
3567
+ # REQUIRED: The resource for which the policy is being requested. See the
3568
+ # operation documentation for the appropriate value for this field.
3569
+ # @param [Fixnum] options_requested_policy_version
3570
+ # Optional. The maximum policy version that will be used to format the policy.
3571
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
3572
+ # rejected. Requests for policies with any conditional role bindings must
3573
+ # specify version 3. Policies with no conditional role bindings may specify any
3574
+ # valid value or leave the field unset. The policy in the response might use the
3575
+ # policy version that you specified, or it might use a lower policy version. For
3576
+ # example, if you specify version 3, but the policy has no conditional role
3577
+ # bindings, the response uses version 1. To learn which resources support
3578
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
3579
+ # google.com/iam/help/conditions/resource-policies).
3580
+ # @param [String] fields
3581
+ # Selector specifying which fields to include in a partial response.
3582
+ # @param [String] quota_user
3583
+ # Available to use for quota purposes for server-side applications. Can be any
3584
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3585
+ # @param [Google::Apis::RequestOptions] options
3586
+ # Request-specific options
3587
+ #
3588
+ # @yield [result, err] Result & error if block supplied
3589
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
3590
+ # @yieldparam err [StandardError] error object if request failed
3591
+ #
3592
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
3593
+ #
3594
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3595
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3596
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3597
+ def get_project_location_runtime_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
3598
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
3599
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
3600
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
3601
+ command.params['resource'] = resource unless resource.nil?
3602
+ command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
3603
+ command.query['fields'] = fields unless fields.nil?
3604
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3605
+ execute_or_queue_command(command, &block)
3606
+ end
3607
+
3608
+ # Sets the access control policy on the specified resource. Replaces any
3609
+ # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
3610
+ # PERMISSION_DENIED` errors.
3611
+ # @param [String] resource
3612
+ # REQUIRED: The resource for which the policy is being specified. See the
3613
+ # operation documentation for the appropriate value for this field.
3614
+ # @param [Google::Apis::ApigeeregistryV1::SetIamPolicyRequest] set_iam_policy_request_object
3615
+ # @param [String] fields
3616
+ # Selector specifying which fields to include in a partial response.
3617
+ # @param [String] quota_user
3618
+ # Available to use for quota purposes for server-side applications. Can be any
3619
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3620
+ # @param [Google::Apis::RequestOptions] options
3621
+ # Request-specific options
3622
+ #
3623
+ # @yield [result, err] Result & error if block supplied
3624
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::Policy] parsed result object
3625
+ # @yieldparam err [StandardError] error object if request failed
3626
+ #
3627
+ # @return [Google::Apis::ApigeeregistryV1::Policy]
3628
+ #
3629
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3630
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3631
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3632
+ def set_runtime_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3633
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
3634
+ command.request_representation = Google::Apis::ApigeeregistryV1::SetIamPolicyRequest::Representation
3635
+ command.request_object = set_iam_policy_request_object
3636
+ command.response_representation = Google::Apis::ApigeeregistryV1::Policy::Representation
3637
+ command.response_class = Google::Apis::ApigeeregistryV1::Policy
3638
+ command.params['resource'] = resource unless resource.nil?
3639
+ command.query['fields'] = fields unless fields.nil?
3640
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3641
+ execute_or_queue_command(command, &block)
3642
+ end
3643
+
3644
+ # Returns permissions that a caller has on the specified resource. If the
3645
+ # resource does not exist, this will return an empty set of permissions, not a `
3646
+ # NOT_FOUND` error. Note: This operation is designed to be used for building
3647
+ # permission-aware UIs and command-line tools, not for authorization checking.
3648
+ # This operation may "fail open" without warning.
3649
+ # @param [String] resource
3650
+ # REQUIRED: The resource for which the policy detail is being requested. See the
3651
+ # operation documentation for the appropriate value for this field.
3652
+ # @param [Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest] test_iam_permissions_request_object
3653
+ # @param [String] fields
3654
+ # Selector specifying which fields to include in a partial response.
3655
+ # @param [String] quota_user
3656
+ # Available to use for quota purposes for server-side applications. Can be any
3657
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3658
+ # @param [Google::Apis::RequestOptions] options
3659
+ # Request-specific options
3660
+ #
3661
+ # @yield [result, err] Result & error if block supplied
3662
+ # @yieldparam result [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse] parsed result object
3663
+ # @yieldparam err [StandardError] error object if request failed
3664
+ #
3665
+ # @return [Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse]
3666
+ #
3667
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3668
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3669
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3670
+ def test_runtime_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3671
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
3672
+ command.request_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsRequest::Representation
3673
+ command.request_object = test_iam_permissions_request_object
3674
+ command.response_representation = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse::Representation
3675
+ command.response_class = Google::Apis::ApigeeregistryV1::TestIamPermissionsResponse
3676
+ command.params['resource'] = resource unless resource.nil?
3677
+ command.query['fields'] = fields unless fields.nil?
3678
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3679
+ execute_or_queue_command(command, &block)
3680
+ end
3681
+
3682
+ protected
3683
+
3684
+ def apply_command_defaults(command)
3685
+ command.query['key'] = key unless key.nil?
3686
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3687
+ end
3688
+ end
3689
+ end
3690
+ end
3691
+ end