google-apis-certificatemanager_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1031 @@
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 CertificatemanagerV1
23
+ # Certificate Manager API
24
+ #
25
+ #
26
+ #
27
+ # @example
28
+ # require 'google/apis/certificatemanager_v1'
29
+ #
30
+ # Certificatemanager = Google::Apis::CertificatemanagerV1 # Alias the module
31
+ # service = Certificatemanager::CertificateManagerService.new
32
+ #
33
+ # @see https://cloud.google.com/
34
+ class CertificateManagerService < 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://certificatemanager.googleapis.com/', '',
47
+ client_name: 'google-apis-certificatemanager_v1',
48
+ client_version: Google::Apis::CertificatemanagerV1::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::CertificatemanagerV1::Location] parsed result object
65
+ # @yieldparam err [StandardError] error object if request failed
66
+ #
67
+ # @return [Google::Apis::CertificatemanagerV1::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::CertificatemanagerV1::Location::Representation
75
+ command.response_class = Google::Apis::CertificatemanagerV1::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 in [
88
+ # 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::CertificatemanagerV1::ListLocationsResponse] parsed result object
105
+ # @yieldparam err [StandardError] error object if request failed
106
+ #
107
+ # @return [Google::Apis::CertificatemanagerV1::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::CertificatemanagerV1::ListLocationsResponse::Representation
115
+ command.response_class = Google::Apis::CertificatemanagerV1::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
+ # Creates a new CertificateMap in a given project and location.
126
+ # @param [String] parent
127
+ # Required. The parent resource of the certificate map. Must be in the format `
128
+ # projects/*/locations/*`.
129
+ # @param [Google::Apis::CertificatemanagerV1::CertificateMap] certificate_map_object
130
+ # @param [String] certificate_map_id
131
+ # Required. A user-provided name of the certificate map.
132
+ # @param [String] fields
133
+ # Selector specifying which fields to include in a partial response.
134
+ # @param [String] quota_user
135
+ # Available to use for quota purposes for server-side applications. Can be any
136
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
137
+ # @param [Google::Apis::RequestOptions] options
138
+ # Request-specific options
139
+ #
140
+ # @yield [result, err] Result & error if block supplied
141
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
142
+ # @yieldparam err [StandardError] error object if request failed
143
+ #
144
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
145
+ #
146
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
147
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
148
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
149
+ def create_project_location_certificate_map(parent, certificate_map_object = nil, certificate_map_id: nil, fields: nil, quota_user: nil, options: nil, &block)
150
+ command = make_simple_command(:post, 'v1/{+parent}/certificateMaps', options)
151
+ command.request_representation = Google::Apis::CertificatemanagerV1::CertificateMap::Representation
152
+ command.request_object = certificate_map_object
153
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
154
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
155
+ command.params['parent'] = parent unless parent.nil?
156
+ command.query['certificateMapId'] = certificate_map_id unless certificate_map_id.nil?
157
+ command.query['fields'] = fields unless fields.nil?
158
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
159
+ execute_or_queue_command(command, &block)
160
+ end
161
+
162
+ # Deletes a single CertificateMap. A Certificate Map can't be deleted if it
163
+ # contains Certificate Map Entries. Remove all the entries from the map before
164
+ # calling this method.
165
+ # @param [String] name
166
+ # Required. A name of the certificate map to delete. Must be in the format `
167
+ # projects/*/locations/*/certificateMaps/*`.
168
+ # @param [String] fields
169
+ # Selector specifying which fields to include in a partial response.
170
+ # @param [String] quota_user
171
+ # Available to use for quota purposes for server-side applications. Can be any
172
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
173
+ # @param [Google::Apis::RequestOptions] options
174
+ # Request-specific options
175
+ #
176
+ # @yield [result, err] Result & error if block supplied
177
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
178
+ # @yieldparam err [StandardError] error object if request failed
179
+ #
180
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
181
+ #
182
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
183
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
184
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
185
+ def delete_project_location_certificate_map(name, fields: nil, quota_user: nil, options: nil, &block)
186
+ command = make_simple_command(:delete, 'v1/{+name}', options)
187
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
188
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
189
+ command.params['name'] = name unless name.nil?
190
+ command.query['fields'] = fields unless fields.nil?
191
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
192
+ execute_or_queue_command(command, &block)
193
+ end
194
+
195
+ # Gets details of a single CertificateMap.
196
+ # @param [String] name
197
+ # Required. A name of the certificate map to describe. Must be in the format `
198
+ # projects/*/locations/*/certificateMaps/*`.
199
+ # @param [String] fields
200
+ # Selector specifying which fields to include in a partial response.
201
+ # @param [String] quota_user
202
+ # Available to use for quota purposes for server-side applications. Can be any
203
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
204
+ # @param [Google::Apis::RequestOptions] options
205
+ # Request-specific options
206
+ #
207
+ # @yield [result, err] Result & error if block supplied
208
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::CertificateMap] parsed result object
209
+ # @yieldparam err [StandardError] error object if request failed
210
+ #
211
+ # @return [Google::Apis::CertificatemanagerV1::CertificateMap]
212
+ #
213
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
214
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
215
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
216
+ def get_project_location_certificate_map(name, fields: nil, quota_user: nil, options: nil, &block)
217
+ command = make_simple_command(:get, 'v1/{+name}', options)
218
+ command.response_representation = Google::Apis::CertificatemanagerV1::CertificateMap::Representation
219
+ command.response_class = Google::Apis::CertificatemanagerV1::CertificateMap
220
+ command.params['name'] = name unless name.nil?
221
+ command.query['fields'] = fields unless fields.nil?
222
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
223
+ execute_or_queue_command(command, &block)
224
+ end
225
+
226
+ # Lists CertificateMaps in a given project and location.
227
+ # @param [String] parent
228
+ # Required. The project and location from which the certificate maps should be
229
+ # listed, specified in the format `projects/*/locations/*`.
230
+ # @param [String] filter
231
+ # Filter expression to restrict the Certificates Maps returned.
232
+ # @param [String] order_by
233
+ # A list of Certificate Map field names used to specify the order of the
234
+ # returned results. The default sorting order is ascending. To specify
235
+ # descending order for a field, add a suffix " desc".
236
+ # @param [Fixnum] page_size
237
+ # Maximum number of certificate maps to return per call.
238
+ # @param [String] page_token
239
+ # The value returned by the last `ListCertificateMapsResponse`. Indicates that
240
+ # this is a continuation of a prior `ListCertificateMaps` call, and that the
241
+ # system should return the next page of data.
242
+ # @param [String] fields
243
+ # Selector specifying which fields to include in a partial response.
244
+ # @param [String] quota_user
245
+ # Available to use for quota purposes for server-side applications. Can be any
246
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
247
+ # @param [Google::Apis::RequestOptions] options
248
+ # Request-specific options
249
+ #
250
+ # @yield [result, err] Result & error if block supplied
251
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::ListCertificateMapsResponse] parsed result object
252
+ # @yieldparam err [StandardError] error object if request failed
253
+ #
254
+ # @return [Google::Apis::CertificatemanagerV1::ListCertificateMapsResponse]
255
+ #
256
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
257
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
258
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
259
+ def list_project_location_certificate_maps(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
260
+ command = make_simple_command(:get, 'v1/{+parent}/certificateMaps', options)
261
+ command.response_representation = Google::Apis::CertificatemanagerV1::ListCertificateMapsResponse::Representation
262
+ command.response_class = Google::Apis::CertificatemanagerV1::ListCertificateMapsResponse
263
+ command.params['parent'] = parent unless parent.nil?
264
+ command.query['filter'] = filter unless filter.nil?
265
+ command.query['orderBy'] = order_by unless order_by.nil?
266
+ command.query['pageSize'] = page_size unless page_size.nil?
267
+ command.query['pageToken'] = page_token unless page_token.nil?
268
+ command.query['fields'] = fields unless fields.nil?
269
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
270
+ execute_or_queue_command(command, &block)
271
+ end
272
+
273
+ # Updates a CertificateMap.
274
+ # @param [String] name
275
+ # A user-defined name of the Certificate Map. Certificate Map names must be
276
+ # unique globally and match pattern `projects/*/locations/*/certificateMaps/*`.
277
+ # @param [Google::Apis::CertificatemanagerV1::CertificateMap] certificate_map_object
278
+ # @param [String] update_mask
279
+ # Required. The update mask applies to the resource. For the `FieldMask`
280
+ # definition, see https://developers.google.com/protocol-buffers/docs/reference/
281
+ # google.protobuf#fieldmask.
282
+ # @param [String] fields
283
+ # Selector specifying which fields to include in a partial response.
284
+ # @param [String] quota_user
285
+ # Available to use for quota purposes for server-side applications. Can be any
286
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
287
+ # @param [Google::Apis::RequestOptions] options
288
+ # Request-specific options
289
+ #
290
+ # @yield [result, err] Result & error if block supplied
291
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
292
+ # @yieldparam err [StandardError] error object if request failed
293
+ #
294
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
295
+ #
296
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
297
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
298
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
299
+ def patch_project_location_certificate_map(name, certificate_map_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
300
+ command = make_simple_command(:patch, 'v1/{+name}', options)
301
+ command.request_representation = Google::Apis::CertificatemanagerV1::CertificateMap::Representation
302
+ command.request_object = certificate_map_object
303
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
304
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
305
+ command.params['name'] = name unless name.nil?
306
+ command.query['updateMask'] = update_mask unless update_mask.nil?
307
+ command.query['fields'] = fields unless fields.nil?
308
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
309
+ execute_or_queue_command(command, &block)
310
+ end
311
+
312
+ # Creates a new CertificateMapEntry in a given project and location.
313
+ # @param [String] parent
314
+ # Required. The parent resource of the certificate map entry. Must be in the
315
+ # format `projects/*/locations/*/certificateMaps/*`.
316
+ # @param [Google::Apis::CertificatemanagerV1::CertificateMapEntry] certificate_map_entry_object
317
+ # @param [String] certificate_map_entry_id
318
+ # Required. A user-provided name of the certificate map entry.
319
+ # @param [String] fields
320
+ # Selector specifying which fields to include in a partial response.
321
+ # @param [String] quota_user
322
+ # Available to use for quota purposes for server-side applications. Can be any
323
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
324
+ # @param [Google::Apis::RequestOptions] options
325
+ # Request-specific options
326
+ #
327
+ # @yield [result, err] Result & error if block supplied
328
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
329
+ # @yieldparam err [StandardError] error object if request failed
330
+ #
331
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
332
+ #
333
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
334
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
335
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
336
+ def create_project_location_certificate_map_certificate_map_entry(parent, certificate_map_entry_object = nil, certificate_map_entry_id: nil, fields: nil, quota_user: nil, options: nil, &block)
337
+ command = make_simple_command(:post, 'v1/{+parent}/certificateMapEntries', options)
338
+ command.request_representation = Google::Apis::CertificatemanagerV1::CertificateMapEntry::Representation
339
+ command.request_object = certificate_map_entry_object
340
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
341
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
342
+ command.params['parent'] = parent unless parent.nil?
343
+ command.query['certificateMapEntryId'] = certificate_map_entry_id unless certificate_map_entry_id.nil?
344
+ command.query['fields'] = fields unless fields.nil?
345
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
346
+ execute_or_queue_command(command, &block)
347
+ end
348
+
349
+ # Deletes a single CertificateMapEntry.
350
+ # @param [String] name
351
+ # Required. A name of the certificate map entry to delete. Must be in the format
352
+ # `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.
353
+ # @param [String] fields
354
+ # Selector specifying which fields to include in a partial response.
355
+ # @param [String] quota_user
356
+ # Available to use for quota purposes for server-side applications. Can be any
357
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
358
+ # @param [Google::Apis::RequestOptions] options
359
+ # Request-specific options
360
+ #
361
+ # @yield [result, err] Result & error if block supplied
362
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
363
+ # @yieldparam err [StandardError] error object if request failed
364
+ #
365
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
366
+ #
367
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
368
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
369
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
370
+ def delete_project_location_certificate_map_certificate_map_entry(name, fields: nil, quota_user: nil, options: nil, &block)
371
+ command = make_simple_command(:delete, 'v1/{+name}', options)
372
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
373
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
374
+ command.params['name'] = name unless name.nil?
375
+ command.query['fields'] = fields unless fields.nil?
376
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
377
+ execute_or_queue_command(command, &block)
378
+ end
379
+
380
+ # Gets details of a single CertificateMapEntry.
381
+ # @param [String] name
382
+ # Required. A name of the certificate map entry to describe. Must be in the
383
+ # format `projects/*/locations/*/certificateMaps/*/certificateMapEntries/*`.
384
+ # @param [String] fields
385
+ # Selector specifying which fields to include in a partial response.
386
+ # @param [String] quota_user
387
+ # Available to use for quota purposes for server-side applications. Can be any
388
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
389
+ # @param [Google::Apis::RequestOptions] options
390
+ # Request-specific options
391
+ #
392
+ # @yield [result, err] Result & error if block supplied
393
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::CertificateMapEntry] parsed result object
394
+ # @yieldparam err [StandardError] error object if request failed
395
+ #
396
+ # @return [Google::Apis::CertificatemanagerV1::CertificateMapEntry]
397
+ #
398
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
399
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
400
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
401
+ def get_project_location_certificate_map_certificate_map_entry(name, fields: nil, quota_user: nil, options: nil, &block)
402
+ command = make_simple_command(:get, 'v1/{+name}', options)
403
+ command.response_representation = Google::Apis::CertificatemanagerV1::CertificateMapEntry::Representation
404
+ command.response_class = Google::Apis::CertificatemanagerV1::CertificateMapEntry
405
+ command.params['name'] = name unless name.nil?
406
+ command.query['fields'] = fields unless fields.nil?
407
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
408
+ execute_or_queue_command(command, &block)
409
+ end
410
+
411
+ # Lists CertificateMapEntries in a given project and location.
412
+ # @param [String] parent
413
+ # Required. The project, location and certificate map from which the certificate
414
+ # map entries should be listed, specified in the format `projects/*/locations/*/
415
+ # certificateMaps/*`.
416
+ # @param [String] filter
417
+ # Filter expression to restrict the returned Certificate Map Entries.
418
+ # @param [String] order_by
419
+ # A list of Certificate Map Entry field names used to specify the order of the
420
+ # returned results. The default sorting order is ascending. To specify
421
+ # descending order for a field, add a suffix " desc".
422
+ # @param [Fixnum] page_size
423
+ # Maximum number of certificate map entries to return. The service may return
424
+ # fewer than this value. If unspecified, at most 50 certificate map entries will
425
+ # be returned. The maximum value is 1000; values above 1000 will be coerced to
426
+ # 1000.
427
+ # @param [String] page_token
428
+ # The value returned by the last `ListCertificateMapEntriesResponse`. Indicates
429
+ # that this is a continuation of a prior `ListCertificateMapEntries` call, and
430
+ # that the system should return the next page of data.
431
+ # @param [String] fields
432
+ # Selector specifying which fields to include in a partial response.
433
+ # @param [String] quota_user
434
+ # Available to use for quota purposes for server-side applications. Can be any
435
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
436
+ # @param [Google::Apis::RequestOptions] options
437
+ # Request-specific options
438
+ #
439
+ # @yield [result, err] Result & error if block supplied
440
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::ListCertificateMapEntriesResponse] parsed result object
441
+ # @yieldparam err [StandardError] error object if request failed
442
+ #
443
+ # @return [Google::Apis::CertificatemanagerV1::ListCertificateMapEntriesResponse]
444
+ #
445
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
446
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
447
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
448
+ def list_project_location_certificate_map_certificate_map_entries(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
449
+ command = make_simple_command(:get, 'v1/{+parent}/certificateMapEntries', options)
450
+ command.response_representation = Google::Apis::CertificatemanagerV1::ListCertificateMapEntriesResponse::Representation
451
+ command.response_class = Google::Apis::CertificatemanagerV1::ListCertificateMapEntriesResponse
452
+ command.params['parent'] = parent unless parent.nil?
453
+ command.query['filter'] = filter unless filter.nil?
454
+ command.query['orderBy'] = order_by unless order_by.nil?
455
+ command.query['pageSize'] = page_size unless page_size.nil?
456
+ command.query['pageToken'] = page_token unless page_token.nil?
457
+ command.query['fields'] = fields unless fields.nil?
458
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
459
+ execute_or_queue_command(command, &block)
460
+ end
461
+
462
+ # Updates a CertificateMapEntry.
463
+ # @param [String] name
464
+ # A user-defined name of the Certificate Map Entry. Certificate Map Entry names
465
+ # must be unique globally and match pattern `projects/*/locations/*/
466
+ # certificateMaps/*/certificateMapEntries/*`.
467
+ # @param [Google::Apis::CertificatemanagerV1::CertificateMapEntry] certificate_map_entry_object
468
+ # @param [String] update_mask
469
+ # Required. The update mask applies to the resource. For the `FieldMask`
470
+ # definition, see https://developers.google.com/protocol-buffers/docs/reference/
471
+ # google.protobuf#fieldmask.
472
+ # @param [String] fields
473
+ # Selector specifying which fields to include in a partial response.
474
+ # @param [String] quota_user
475
+ # Available to use for quota purposes for server-side applications. Can be any
476
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
477
+ # @param [Google::Apis::RequestOptions] options
478
+ # Request-specific options
479
+ #
480
+ # @yield [result, err] Result & error if block supplied
481
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
482
+ # @yieldparam err [StandardError] error object if request failed
483
+ #
484
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
485
+ #
486
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
487
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
488
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
489
+ def patch_project_location_certificate_map_certificate_map_entry(name, certificate_map_entry_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
490
+ command = make_simple_command(:patch, 'v1/{+name}', options)
491
+ command.request_representation = Google::Apis::CertificatemanagerV1::CertificateMapEntry::Representation
492
+ command.request_object = certificate_map_entry_object
493
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
494
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
495
+ command.params['name'] = name unless name.nil?
496
+ command.query['updateMask'] = update_mask unless update_mask.nil?
497
+ command.query['fields'] = fields unless fields.nil?
498
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
499
+ execute_or_queue_command(command, &block)
500
+ end
501
+
502
+ # Creates a new Certificate in a given project and location.
503
+ # @param [String] parent
504
+ # Required. The parent resource of the certificate. Must be in the format `
505
+ # projects/*/locations/*`.
506
+ # @param [Google::Apis::CertificatemanagerV1::Certificate] certificate_object
507
+ # @param [String] certificate_id
508
+ # Required. A user-provided name of the certificate.
509
+ # @param [String] fields
510
+ # Selector specifying which fields to include in a partial response.
511
+ # @param [String] quota_user
512
+ # Available to use for quota purposes for server-side applications. Can be any
513
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
514
+ # @param [Google::Apis::RequestOptions] options
515
+ # Request-specific options
516
+ #
517
+ # @yield [result, err] Result & error if block supplied
518
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
519
+ # @yieldparam err [StandardError] error object if request failed
520
+ #
521
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
522
+ #
523
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
524
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
525
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
526
+ def create_project_location_certificate(parent, certificate_object = nil, certificate_id: nil, fields: nil, quota_user: nil, options: nil, &block)
527
+ command = make_simple_command(:post, 'v1/{+parent}/certificates', options)
528
+ command.request_representation = Google::Apis::CertificatemanagerV1::Certificate::Representation
529
+ command.request_object = certificate_object
530
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
531
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
532
+ command.params['parent'] = parent unless parent.nil?
533
+ command.query['certificateId'] = certificate_id unless certificate_id.nil?
534
+ command.query['fields'] = fields unless fields.nil?
535
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
536
+ execute_or_queue_command(command, &block)
537
+ end
538
+
539
+ # Deletes a single Certificate.
540
+ # @param [String] name
541
+ # Required. A name of the certificate to delete. Must be in the format `projects/
542
+ # */locations/*/certificates/*`.
543
+ # @param [String] fields
544
+ # Selector specifying which fields to include in a partial response.
545
+ # @param [String] quota_user
546
+ # Available to use for quota purposes for server-side applications. Can be any
547
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
548
+ # @param [Google::Apis::RequestOptions] options
549
+ # Request-specific options
550
+ #
551
+ # @yield [result, err] Result & error if block supplied
552
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
553
+ # @yieldparam err [StandardError] error object if request failed
554
+ #
555
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
556
+ #
557
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
558
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
559
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
560
+ def delete_project_location_certificate(name, fields: nil, quota_user: nil, options: nil, &block)
561
+ command = make_simple_command(:delete, 'v1/{+name}', options)
562
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
563
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
564
+ command.params['name'] = name unless name.nil?
565
+ command.query['fields'] = fields unless fields.nil?
566
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
567
+ execute_or_queue_command(command, &block)
568
+ end
569
+
570
+ # Gets details of a single Certificate.
571
+ # @param [String] name
572
+ # Required. A name of the certificate to describe. Must be in the format `
573
+ # projects/*/locations/*/certificates/*`.
574
+ # @param [String] fields
575
+ # Selector specifying which fields to include in a partial response.
576
+ # @param [String] quota_user
577
+ # Available to use for quota purposes for server-side applications. Can be any
578
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
579
+ # @param [Google::Apis::RequestOptions] options
580
+ # Request-specific options
581
+ #
582
+ # @yield [result, err] Result & error if block supplied
583
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Certificate] parsed result object
584
+ # @yieldparam err [StandardError] error object if request failed
585
+ #
586
+ # @return [Google::Apis::CertificatemanagerV1::Certificate]
587
+ #
588
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
589
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
590
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
591
+ def get_project_location_certificate(name, fields: nil, quota_user: nil, options: nil, &block)
592
+ command = make_simple_command(:get, 'v1/{+name}', options)
593
+ command.response_representation = Google::Apis::CertificatemanagerV1::Certificate::Representation
594
+ command.response_class = Google::Apis::CertificatemanagerV1::Certificate
595
+ command.params['name'] = name unless name.nil?
596
+ command.query['fields'] = fields unless fields.nil?
597
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
598
+ execute_or_queue_command(command, &block)
599
+ end
600
+
601
+ # Lists Certificates in a given project and location.
602
+ # @param [String] parent
603
+ # Required. The project and location from which the certificate should be listed,
604
+ # specified in the format `projects/*/locations/*`.
605
+ # @param [String] filter
606
+ # Filter expression to restrict the Certificates returned.
607
+ # @param [String] order_by
608
+ # A list of Certificate field names used to specify the order of the returned
609
+ # results. The default sorting order is ascending. To specify descending order
610
+ # for a field, add a suffix " desc".
611
+ # @param [Fixnum] page_size
612
+ # Maximum number of certificates to return per call.
613
+ # @param [String] page_token
614
+ # The value returned by the last `ListCertificatesResponse`. Indicates that this
615
+ # is a continuation of a prior `ListCertificates` call, and that the system
616
+ # should return the next page of data.
617
+ # @param [String] fields
618
+ # Selector specifying which fields to include in a partial response.
619
+ # @param [String] quota_user
620
+ # Available to use for quota purposes for server-side applications. Can be any
621
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
622
+ # @param [Google::Apis::RequestOptions] options
623
+ # Request-specific options
624
+ #
625
+ # @yield [result, err] Result & error if block supplied
626
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::ListCertificatesResponse] parsed result object
627
+ # @yieldparam err [StandardError] error object if request failed
628
+ #
629
+ # @return [Google::Apis::CertificatemanagerV1::ListCertificatesResponse]
630
+ #
631
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
632
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
633
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
634
+ def list_project_location_certificates(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
635
+ command = make_simple_command(:get, 'v1/{+parent}/certificates', options)
636
+ command.response_representation = Google::Apis::CertificatemanagerV1::ListCertificatesResponse::Representation
637
+ command.response_class = Google::Apis::CertificatemanagerV1::ListCertificatesResponse
638
+ command.params['parent'] = parent unless parent.nil?
639
+ command.query['filter'] = filter unless filter.nil?
640
+ command.query['orderBy'] = order_by unless order_by.nil?
641
+ command.query['pageSize'] = page_size unless page_size.nil?
642
+ command.query['pageToken'] = page_token unless page_token.nil?
643
+ command.query['fields'] = fields unless fields.nil?
644
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
645
+ execute_or_queue_command(command, &block)
646
+ end
647
+
648
+ # Updates a Certificate.
649
+ # @param [String] name
650
+ # A user-defined name of the certificate. Certificate names must be unique
651
+ # globally and match pattern `projects/*/locations/*/certificates/*`.
652
+ # @param [Google::Apis::CertificatemanagerV1::Certificate] certificate_object
653
+ # @param [String] update_mask
654
+ # Required. The update mask applies to the resource. For the `FieldMask`
655
+ # definition, see https://developers.google.com/protocol-buffers/docs/reference/
656
+ # google.protobuf#fieldmask.
657
+ # @param [String] fields
658
+ # Selector specifying which fields to include in a partial response.
659
+ # @param [String] quota_user
660
+ # Available to use for quota purposes for server-side applications. Can be any
661
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
662
+ # @param [Google::Apis::RequestOptions] options
663
+ # Request-specific options
664
+ #
665
+ # @yield [result, err] Result & error if block supplied
666
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
667
+ # @yieldparam err [StandardError] error object if request failed
668
+ #
669
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
670
+ #
671
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
672
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
673
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
674
+ def patch_project_location_certificate(name, certificate_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
675
+ command = make_simple_command(:patch, 'v1/{+name}', options)
676
+ command.request_representation = Google::Apis::CertificatemanagerV1::Certificate::Representation
677
+ command.request_object = certificate_object
678
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
679
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
680
+ command.params['name'] = name unless name.nil?
681
+ command.query['updateMask'] = update_mask unless update_mask.nil?
682
+ command.query['fields'] = fields unless fields.nil?
683
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
684
+ execute_or_queue_command(command, &block)
685
+ end
686
+
687
+ # Creates a new DnsAuthorization in a given project and location.
688
+ # @param [String] parent
689
+ # Required. The parent resource of the dns authorization. Must be in the format `
690
+ # projects/*/locations/*`.
691
+ # @param [Google::Apis::CertificatemanagerV1::DnsAuthorization] dns_authorization_object
692
+ # @param [String] dns_authorization_id
693
+ # Required. A user-provided name of the dns authorization.
694
+ # @param [String] fields
695
+ # Selector specifying which fields to include in a partial response.
696
+ # @param [String] quota_user
697
+ # Available to use for quota purposes for server-side applications. Can be any
698
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
699
+ # @param [Google::Apis::RequestOptions] options
700
+ # Request-specific options
701
+ #
702
+ # @yield [result, err] Result & error if block supplied
703
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
704
+ # @yieldparam err [StandardError] error object if request failed
705
+ #
706
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
707
+ #
708
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
709
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
710
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
711
+ def create_project_location_dns_authorization(parent, dns_authorization_object = nil, dns_authorization_id: nil, fields: nil, quota_user: nil, options: nil, &block)
712
+ command = make_simple_command(:post, 'v1/{+parent}/dnsAuthorizations', options)
713
+ command.request_representation = Google::Apis::CertificatemanagerV1::DnsAuthorization::Representation
714
+ command.request_object = dns_authorization_object
715
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
716
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
717
+ command.params['parent'] = parent unless parent.nil?
718
+ command.query['dnsAuthorizationId'] = dns_authorization_id unless dns_authorization_id.nil?
719
+ command.query['fields'] = fields unless fields.nil?
720
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
721
+ execute_or_queue_command(command, &block)
722
+ end
723
+
724
+ # Deletes a single DnsAuthorization.
725
+ # @param [String] name
726
+ # Required. A name of the dns authorization to delete. Must be in the format `
727
+ # projects/*/locations/*/dnsAuthorizations/*`.
728
+ # @param [String] fields
729
+ # Selector specifying which fields to include in a partial response.
730
+ # @param [String] quota_user
731
+ # Available to use for quota purposes for server-side applications. Can be any
732
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
733
+ # @param [Google::Apis::RequestOptions] options
734
+ # Request-specific options
735
+ #
736
+ # @yield [result, err] Result & error if block supplied
737
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
738
+ # @yieldparam err [StandardError] error object if request failed
739
+ #
740
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
741
+ #
742
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
743
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
744
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
745
+ def delete_project_location_dns_authorization(name, fields: nil, quota_user: nil, options: nil, &block)
746
+ command = make_simple_command(:delete, 'v1/{+name}', options)
747
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
748
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
749
+ command.params['name'] = name unless name.nil?
750
+ command.query['fields'] = fields unless fields.nil?
751
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
752
+ execute_or_queue_command(command, &block)
753
+ end
754
+
755
+ # Gets details of a single DnsAuthorization.
756
+ # @param [String] name
757
+ # Required. A name of the dns authorization to describe. Must be in the format `
758
+ # projects/*/locations/*/dnsAuthorizations/*`.
759
+ # @param [String] fields
760
+ # Selector specifying which fields to include in a partial response.
761
+ # @param [String] quota_user
762
+ # Available to use for quota purposes for server-side applications. Can be any
763
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
764
+ # @param [Google::Apis::RequestOptions] options
765
+ # Request-specific options
766
+ #
767
+ # @yield [result, err] Result & error if block supplied
768
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::DnsAuthorization] parsed result object
769
+ # @yieldparam err [StandardError] error object if request failed
770
+ #
771
+ # @return [Google::Apis::CertificatemanagerV1::DnsAuthorization]
772
+ #
773
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
774
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
775
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
776
+ def get_project_location_dns_authorization(name, fields: nil, quota_user: nil, options: nil, &block)
777
+ command = make_simple_command(:get, 'v1/{+name}', options)
778
+ command.response_representation = Google::Apis::CertificatemanagerV1::DnsAuthorization::Representation
779
+ command.response_class = Google::Apis::CertificatemanagerV1::DnsAuthorization
780
+ command.params['name'] = name unless name.nil?
781
+ command.query['fields'] = fields unless fields.nil?
782
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
783
+ execute_or_queue_command(command, &block)
784
+ end
785
+
786
+ # Lists DnsAuthorizations in a given project and location.
787
+ # @param [String] parent
788
+ # Required. The project and location from which the dns authorizations should be
789
+ # listed, specified in the format `projects/*/locations/*`.
790
+ # @param [String] filter
791
+ # Filter expression to restrict the Dns Authorizations returned.
792
+ # @param [String] order_by
793
+ # A list of Dns Authorization field names used to specify the order of the
794
+ # returned results. The default sorting order is ascending. To specify
795
+ # descending order for a field, add a suffix " desc".
796
+ # @param [Fixnum] page_size
797
+ # Maximum number of dns authorizations to return per call.
798
+ # @param [String] page_token
799
+ # The value returned by the last `ListDnsAuthorizationsResponse`. Indicates that
800
+ # this is a continuation of a prior `ListDnsAuthorizations` call, and that the
801
+ # system should return the next page of data.
802
+ # @param [String] fields
803
+ # Selector specifying which fields to include in a partial response.
804
+ # @param [String] quota_user
805
+ # Available to use for quota purposes for server-side applications. Can be any
806
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
807
+ # @param [Google::Apis::RequestOptions] options
808
+ # Request-specific options
809
+ #
810
+ # @yield [result, err] Result & error if block supplied
811
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::ListDnsAuthorizationsResponse] parsed result object
812
+ # @yieldparam err [StandardError] error object if request failed
813
+ #
814
+ # @return [Google::Apis::CertificatemanagerV1::ListDnsAuthorizationsResponse]
815
+ #
816
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
817
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
818
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
819
+ def list_project_location_dns_authorizations(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
820
+ command = make_simple_command(:get, 'v1/{+parent}/dnsAuthorizations', options)
821
+ command.response_representation = Google::Apis::CertificatemanagerV1::ListDnsAuthorizationsResponse::Representation
822
+ command.response_class = Google::Apis::CertificatemanagerV1::ListDnsAuthorizationsResponse
823
+ command.params['parent'] = parent unless parent.nil?
824
+ command.query['filter'] = filter unless filter.nil?
825
+ command.query['orderBy'] = order_by unless order_by.nil?
826
+ command.query['pageSize'] = page_size unless page_size.nil?
827
+ command.query['pageToken'] = page_token unless page_token.nil?
828
+ command.query['fields'] = fields unless fields.nil?
829
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
830
+ execute_or_queue_command(command, &block)
831
+ end
832
+
833
+ # Updates a DnsAuthorization.
834
+ # @param [String] name
835
+ # A user-defined name of the dns authorization. DnsAuthorization names must be
836
+ # unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.
837
+ # @param [Google::Apis::CertificatemanagerV1::DnsAuthorization] dns_authorization_object
838
+ # @param [String] update_mask
839
+ # Required. The update mask applies to the resource. For the `FieldMask`
840
+ # definition, see https://developers.google.com/protocol-buffers/docs/reference/
841
+ # google.protobuf#fieldmask.
842
+ # @param [String] fields
843
+ # Selector specifying which fields to include in a partial response.
844
+ # @param [String] quota_user
845
+ # Available to use for quota purposes for server-side applications. Can be any
846
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
847
+ # @param [Google::Apis::RequestOptions] options
848
+ # Request-specific options
849
+ #
850
+ # @yield [result, err] Result & error if block supplied
851
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
852
+ # @yieldparam err [StandardError] error object if request failed
853
+ #
854
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
855
+ #
856
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
857
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
858
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
859
+ def patch_project_location_dns_authorization(name, dns_authorization_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
860
+ command = make_simple_command(:patch, 'v1/{+name}', options)
861
+ command.request_representation = Google::Apis::CertificatemanagerV1::DnsAuthorization::Representation
862
+ command.request_object = dns_authorization_object
863
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
864
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
865
+ command.params['name'] = name unless name.nil?
866
+ command.query['updateMask'] = update_mask unless update_mask.nil?
867
+ command.query['fields'] = fields unless fields.nil?
868
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
869
+ execute_or_queue_command(command, &block)
870
+ end
871
+
872
+ # Starts asynchronous cancellation on a long-running operation. The server makes
873
+ # a best effort to cancel the operation, but success is not guaranteed. If the
874
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
875
+ # Clients can use Operations.GetOperation or other methods to check whether the
876
+ # cancellation succeeded or whether the operation completed despite cancellation.
877
+ # On successful cancellation, the operation is not deleted; instead, it becomes
878
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
879
+ # corresponding to `Code.CANCELLED`.
880
+ # @param [String] name
881
+ # The name of the operation resource to be cancelled.
882
+ # @param [Google::Apis::CertificatemanagerV1::CancelOperationRequest] cancel_operation_request_object
883
+ # @param [String] fields
884
+ # Selector specifying which fields to include in a partial response.
885
+ # @param [String] quota_user
886
+ # Available to use for quota purposes for server-side applications. Can be any
887
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
888
+ # @param [Google::Apis::RequestOptions] options
889
+ # Request-specific options
890
+ #
891
+ # @yield [result, err] Result & error if block supplied
892
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Empty] parsed result object
893
+ # @yieldparam err [StandardError] error object if request failed
894
+ #
895
+ # @return [Google::Apis::CertificatemanagerV1::Empty]
896
+ #
897
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
898
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
899
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
900
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
901
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
902
+ command.request_representation = Google::Apis::CertificatemanagerV1::CancelOperationRequest::Representation
903
+ command.request_object = cancel_operation_request_object
904
+ command.response_representation = Google::Apis::CertificatemanagerV1::Empty::Representation
905
+ command.response_class = Google::Apis::CertificatemanagerV1::Empty
906
+ command.params['name'] = name unless name.nil?
907
+ command.query['fields'] = fields unless fields.nil?
908
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
909
+ execute_or_queue_command(command, &block)
910
+ end
911
+
912
+ # Deletes a long-running operation. This method indicates that the client is no
913
+ # longer interested in the operation result. It does not cancel the operation.
914
+ # If the server doesn't support this method, it returns `google.rpc.Code.
915
+ # UNIMPLEMENTED`.
916
+ # @param [String] name
917
+ # The name of the operation resource to be deleted.
918
+ # @param [String] fields
919
+ # Selector specifying which fields to include in a partial response.
920
+ # @param [String] quota_user
921
+ # Available to use for quota purposes for server-side applications. Can be any
922
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
923
+ # @param [Google::Apis::RequestOptions] options
924
+ # Request-specific options
925
+ #
926
+ # @yield [result, err] Result & error if block supplied
927
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Empty] parsed result object
928
+ # @yieldparam err [StandardError] error object if request failed
929
+ #
930
+ # @return [Google::Apis::CertificatemanagerV1::Empty]
931
+ #
932
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
933
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
934
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
935
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
936
+ command = make_simple_command(:delete, 'v1/{+name}', options)
937
+ command.response_representation = Google::Apis::CertificatemanagerV1::Empty::Representation
938
+ command.response_class = Google::Apis::CertificatemanagerV1::Empty
939
+ command.params['name'] = name unless name.nil?
940
+ command.query['fields'] = fields unless fields.nil?
941
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
942
+ execute_or_queue_command(command, &block)
943
+ end
944
+
945
+ # Gets the latest state of a long-running operation. Clients can use this method
946
+ # to poll the operation result at intervals as recommended by the API service.
947
+ # @param [String] name
948
+ # The name of the operation resource.
949
+ # @param [String] fields
950
+ # Selector specifying which fields to include in a partial response.
951
+ # @param [String] quota_user
952
+ # Available to use for quota purposes for server-side applications. Can be any
953
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
954
+ # @param [Google::Apis::RequestOptions] options
955
+ # Request-specific options
956
+ #
957
+ # @yield [result, err] Result & error if block supplied
958
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::Operation] parsed result object
959
+ # @yieldparam err [StandardError] error object if request failed
960
+ #
961
+ # @return [Google::Apis::CertificatemanagerV1::Operation]
962
+ #
963
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
964
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
965
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
966
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
967
+ command = make_simple_command(:get, 'v1/{+name}', options)
968
+ command.response_representation = Google::Apis::CertificatemanagerV1::Operation::Representation
969
+ command.response_class = Google::Apis::CertificatemanagerV1::Operation
970
+ command.params['name'] = name unless name.nil?
971
+ command.query['fields'] = fields unless fields.nil?
972
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
973
+ execute_or_queue_command(command, &block)
974
+ end
975
+
976
+ # Lists operations that match the specified filter in the request. If the server
977
+ # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
978
+ # binding allows API services to override the binding to use different resource
979
+ # name schemes, such as `users/*/operations`. To override the binding, API
980
+ # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
981
+ # service configuration. For backwards compatibility, the default name includes
982
+ # the operations collection id, however overriding users must ensure the name
983
+ # binding is the parent resource, without the operations collection id.
984
+ # @param [String] name
985
+ # The name of the operation's parent resource.
986
+ # @param [String] filter
987
+ # The standard list filter.
988
+ # @param [Fixnum] page_size
989
+ # The standard list page size.
990
+ # @param [String] page_token
991
+ # The standard list page token.
992
+ # @param [String] fields
993
+ # Selector specifying which fields to include in a partial response.
994
+ # @param [String] quota_user
995
+ # Available to use for quota purposes for server-side applications. Can be any
996
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
997
+ # @param [Google::Apis::RequestOptions] options
998
+ # Request-specific options
999
+ #
1000
+ # @yield [result, err] Result & error if block supplied
1001
+ # @yieldparam result [Google::Apis::CertificatemanagerV1::ListOperationsResponse] parsed result object
1002
+ # @yieldparam err [StandardError] error object if request failed
1003
+ #
1004
+ # @return [Google::Apis::CertificatemanagerV1::ListOperationsResponse]
1005
+ #
1006
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1007
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1008
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1009
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1010
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
1011
+ command.response_representation = Google::Apis::CertificatemanagerV1::ListOperationsResponse::Representation
1012
+ command.response_class = Google::Apis::CertificatemanagerV1::ListOperationsResponse
1013
+ command.params['name'] = name unless name.nil?
1014
+ command.query['filter'] = filter unless filter.nil?
1015
+ command.query['pageSize'] = page_size unless page_size.nil?
1016
+ command.query['pageToken'] = page_token unless page_token.nil?
1017
+ command.query['fields'] = fields unless fields.nil?
1018
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1019
+ execute_or_queue_command(command, &block)
1020
+ end
1021
+
1022
+ protected
1023
+
1024
+ def apply_command_defaults(command)
1025
+ command.query['key'] = key unless key.nil?
1026
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1027
+ end
1028
+ end
1029
+ end
1030
+ end
1031
+ end