google-cloud-app_engine-v1 0.3.1 → 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -1
  3. data/AUTHENTICATION.md +15 -33
  4. data/README.md +1 -1
  5. data/lib/google/appengine/v1/app_yaml_pb.rb +2 -2
  6. data/lib/google/appengine/v1/appengine_pb.rb +2 -2
  7. data/lib/google/appengine/v1/application_pb.rb +2 -2
  8. data/lib/google/appengine/v1/audit_data_pb.rb +2 -2
  9. data/lib/google/appengine/v1/certificate_pb.rb +2 -2
  10. data/lib/google/appengine/v1/deploy_pb.rb +2 -2
  11. data/lib/google/appengine/v1/deployed_files_pb.rb +1 -1
  12. data/lib/google/appengine/v1/domain_mapping_pb.rb +1 -1
  13. data/lib/google/appengine/v1/domain_pb.rb +1 -1
  14. data/lib/google/appengine/v1/firewall_pb.rb +1 -1
  15. data/lib/google/appengine/v1/instance_pb.rb +2 -2
  16. data/lib/google/appengine/v1/location_pb.rb +2 -2
  17. data/lib/google/appengine/v1/network_settings_pb.rb +1 -1
  18. data/lib/google/appengine/v1/operation_pb.rb +2 -2
  19. data/lib/google/appengine/v1/service_pb.rb +2 -2
  20. data/lib/google/appengine/v1/version_pb.rb +2 -2
  21. data/lib/google/cloud/app_engine/v1/applications/client.rb +139 -50
  22. data/lib/google/cloud/app_engine/v1/applications/operations.rb +149 -37
  23. data/lib/google/cloud/app_engine/v1/authorized_certificates/client.rb +151 -57
  24. data/lib/google/cloud/app_engine/v1/authorized_domains/client.rb +59 -41
  25. data/lib/google/cloud/app_engine/v1/domain_mappings/client.rb +173 -57
  26. data/lib/google/cloud/app_engine/v1/domain_mappings/operations.rb +149 -37
  27. data/lib/google/cloud/app_engine/v1/firewall/client.rb +174 -61
  28. data/lib/google/cloud/app_engine/v1/instances/client.rb +143 -53
  29. data/lib/google/cloud/app_engine/v1/instances/operations.rb +149 -37
  30. data/lib/google/cloud/app_engine/v1/services/client.rb +143 -53
  31. data/lib/google/cloud/app_engine/v1/services/operations.rb +149 -37
  32. data/lib/google/cloud/app_engine/v1/version.rb +1 -1
  33. data/lib/google/cloud/app_engine/v1/versions/client.rb +173 -57
  34. data/lib/google/cloud/app_engine/v1/versions/operations.rb +149 -37
  35. data/proto_docs/google/api/field_behavior.rb +7 -1
  36. data/proto_docs/google/api/resource.rb +10 -71
  37. metadata +5 -5
@@ -82,7 +82,7 @@ module Google
82
82
  # Create credentials
83
83
  credentials = @config.credentials
84
84
  credentials ||= Credentials.default scope: @config.scope
85
- if credentials.is_a?(String) || credentials.is_a?(Hash)
85
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
86
86
  credentials = Credentials.new credentials, scope: @config.scope
87
87
  end
88
88
  @quota_project_id = @config.quota_project
@@ -143,6 +143,27 @@ module Google
143
143
  #
144
144
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
145
145
  #
146
+ # @example Basic example
147
+ # require "google/longrunning"
148
+ #
149
+ # # Create a client object. The client can be reused for multiple calls.
150
+ # client = Google::Longrunning::Operations::Client.new
151
+ #
152
+ # # Create a request. To set request fields, pass in keyword arguments.
153
+ # request = Google::Longrunning::ListOperationsRequest.new
154
+ #
155
+ # # Call the list_operations method.
156
+ # result = client.list_operations request
157
+ #
158
+ # # The returned object is of type Gapic::PagedEnumerable. You can
159
+ # # iterate over all elements by calling #each, and the enumerable
160
+ # # will lazily make API calls to fetch subsequent pages. Other
161
+ # # methods are also available for managing paging directly.
162
+ # result.each do |response|
163
+ # # Each element is of type ::Google::Longrunning::Operation.
164
+ # p response
165
+ # end
166
+ #
146
167
  def list_operations request, options = nil
147
168
  raise ::ArgumentError, "request must be provided" if request.nil?
148
169
 
@@ -160,16 +181,20 @@ module Google
160
181
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
161
182
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
162
183
 
163
- header_params = {
164
- "name" => request.name
165
- }
184
+ header_params = {}
185
+ if request.name
186
+ header_params["name"] = request.name
187
+ end
188
+
166
189
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
167
190
  metadata[:"x-goog-request-params"] ||= request_params_header
168
191
 
169
192
  options.apply_defaults timeout: @config.rpcs.list_operations.timeout,
170
193
  metadata: metadata,
171
194
  retry_policy: @config.rpcs.list_operations.retry_policy
172
- options.apply_defaults metadata: @config.metadata,
195
+
196
+ options.apply_defaults timeout: @config.timeout,
197
+ metadata: @config.metadata,
173
198
  retry_policy: @config.retry_policy
174
199
 
175
200
  @operations_stub.call_rpc :list_operations, request, options: options do |response, operation|
@@ -213,6 +238,28 @@ module Google
213
238
  #
214
239
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
215
240
  #
241
+ # @example Basic example
242
+ # require "google/longrunning"
243
+ #
244
+ # # Create a client object. The client can be reused for multiple calls.
245
+ # client = Google::Longrunning::Operations::Client.new
246
+ #
247
+ # # Create a request. To set request fields, pass in keyword arguments.
248
+ # request = Google::Longrunning::GetOperationRequest.new
249
+ #
250
+ # # Call the get_operation method.
251
+ # result = client.get_operation request
252
+ #
253
+ # # The returned object is of type Gapic::Operation. You can use this
254
+ # # object to check the status of an operation, cancel it, or wait
255
+ # # for results. Here is how to block until completion:
256
+ # result.wait_until_done! timeout: 60
257
+ # if result.response?
258
+ # p result.response
259
+ # else
260
+ # puts "Error!"
261
+ # end
262
+ #
216
263
  def get_operation request, options = nil
217
264
  raise ::ArgumentError, "request must be provided" if request.nil?
218
265
 
@@ -230,16 +277,20 @@ module Google
230
277
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
231
278
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
232
279
 
233
- header_params = {
234
- "name" => request.name
235
- }
280
+ header_params = {}
281
+ if request.name
282
+ header_params["name"] = request.name
283
+ end
284
+
236
285
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
237
286
  metadata[:"x-goog-request-params"] ||= request_params_header
238
287
 
239
288
  options.apply_defaults timeout: @config.rpcs.get_operation.timeout,
240
289
  metadata: metadata,
241
290
  retry_policy: @config.rpcs.get_operation.retry_policy
242
- options.apply_defaults metadata: @config.metadata,
291
+
292
+ options.apply_defaults timeout: @config.timeout,
293
+ metadata: @config.metadata,
243
294
  retry_policy: @config.retry_policy
244
295
 
245
296
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
@@ -283,6 +334,21 @@ module Google
283
334
  #
284
335
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
285
336
  #
337
+ # @example Basic example
338
+ # require "google/longrunning"
339
+ #
340
+ # # Create a client object. The client can be reused for multiple calls.
341
+ # client = Google::Longrunning::Operations::Client.new
342
+ #
343
+ # # Create a request. To set request fields, pass in keyword arguments.
344
+ # request = Google::Longrunning::DeleteOperationRequest.new
345
+ #
346
+ # # Call the delete_operation method.
347
+ # result = client.delete_operation request
348
+ #
349
+ # # The returned object is of type Google::Protobuf::Empty.
350
+ # p result
351
+ #
286
352
  def delete_operation request, options = nil
287
353
  raise ::ArgumentError, "request must be provided" if request.nil?
288
354
 
@@ -300,16 +366,20 @@ module Google
300
366
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
301
367
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
302
368
 
303
- header_params = {
304
- "name" => request.name
305
- }
369
+ header_params = {}
370
+ if request.name
371
+ header_params["name"] = request.name
372
+ end
373
+
306
374
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
307
375
  metadata[:"x-goog-request-params"] ||= request_params_header
308
376
 
309
377
  options.apply_defaults timeout: @config.rpcs.delete_operation.timeout,
310
378
  metadata: metadata,
311
379
  retry_policy: @config.rpcs.delete_operation.retry_policy
312
- options.apply_defaults metadata: @config.metadata,
380
+
381
+ options.apply_defaults timeout: @config.timeout,
382
+ metadata: @config.metadata,
313
383
  retry_policy: @config.retry_policy
314
384
 
315
385
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
@@ -358,6 +428,21 @@ module Google
358
428
  #
359
429
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
360
430
  #
431
+ # @example Basic example
432
+ # require "google/longrunning"
433
+ #
434
+ # # Create a client object. The client can be reused for multiple calls.
435
+ # client = Google::Longrunning::Operations::Client.new
436
+ #
437
+ # # Create a request. To set request fields, pass in keyword arguments.
438
+ # request = Google::Longrunning::CancelOperationRequest.new
439
+ #
440
+ # # Call the cancel_operation method.
441
+ # result = client.cancel_operation request
442
+ #
443
+ # # The returned object is of type Google::Protobuf::Empty.
444
+ # p result
445
+ #
361
446
  def cancel_operation request, options = nil
362
447
  raise ::ArgumentError, "request must be provided" if request.nil?
363
448
 
@@ -375,16 +460,20 @@ module Google
375
460
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
376
461
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
377
462
 
378
- header_params = {
379
- "name" => request.name
380
- }
463
+ header_params = {}
464
+ if request.name
465
+ header_params["name"] = request.name
466
+ end
467
+
381
468
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
382
469
  metadata[:"x-goog-request-params"] ||= request_params_header
383
470
 
384
471
  options.apply_defaults timeout: @config.rpcs.cancel_operation.timeout,
385
472
  metadata: metadata,
386
473
  retry_policy: @config.rpcs.cancel_operation.retry_policy
387
- options.apply_defaults metadata: @config.metadata,
474
+
475
+ options.apply_defaults timeout: @config.timeout,
476
+ metadata: @config.metadata,
388
477
  retry_policy: @config.retry_policy
389
478
 
390
479
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
@@ -396,9 +485,9 @@ module Google
396
485
  end
397
486
 
398
487
  ##
399
- # Waits for the specified long-running operation until it is done or reaches
400
- # at most a specified timeout, returning the latest state. If the operation
401
- # is already done, the latest state is immediately returned. If the timeout
488
+ # Waits until the specified long-running operation is done or reaches at most
489
+ # a specified timeout, returning the latest state. If the operation is
490
+ # already done, the latest state is immediately returned. If the timeout
402
491
  # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
403
492
  # timeout is used. If the server does not support this method, it returns
404
493
  # `google.rpc.Code.UNIMPLEMENTED`.
@@ -436,6 +525,28 @@ module Google
436
525
  #
437
526
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
438
527
  #
528
+ # @example Basic example
529
+ # require "google/longrunning"
530
+ #
531
+ # # Create a client object. The client can be reused for multiple calls.
532
+ # client = Google::Longrunning::Operations::Client.new
533
+ #
534
+ # # Create a request. To set request fields, pass in keyword arguments.
535
+ # request = Google::Longrunning::WaitOperationRequest.new
536
+ #
537
+ # # Call the wait_operation method.
538
+ # result = client.wait_operation request
539
+ #
540
+ # # The returned object is of type Gapic::Operation. You can use this
541
+ # # object to check the status of an operation, cancel it, or wait
542
+ # # for results. Here is how to block until completion:
543
+ # result.wait_until_done! timeout: 60
544
+ # if result.response?
545
+ # p result.response
546
+ # else
547
+ # puts "Error!"
548
+ # end
549
+ #
439
550
  def wait_operation request, options = nil
440
551
  raise ::ArgumentError, "request must be provided" if request.nil?
441
552
 
@@ -456,7 +567,9 @@ module Google
456
567
  options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
457
568
  metadata: metadata,
458
569
  retry_policy: @config.rpcs.wait_operation.retry_policy
459
- options.apply_defaults metadata: @config.metadata,
570
+
571
+ options.apply_defaults timeout: @config.timeout,
572
+ metadata: @config.metadata,
460
573
  retry_policy: @config.retry_policy
461
574
 
462
575
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
@@ -481,22 +594,21 @@ module Google
481
594
  # Configuration can be applied globally to all clients, or to a single client
482
595
  # on construction.
483
596
  #
484
- # # Examples
485
- #
486
- # To modify the global config, setting the timeout for list_operations
487
- # to 20 seconds, and all remaining timeouts to 10 seconds:
488
- #
489
- # ::Google::Longrunning::Operations::Client.configure do |config|
490
- # config.timeout = 10.0
491
- # config.rpcs.list_operations.timeout = 20.0
492
- # end
493
- #
494
- # To apply the above configuration only to a new client:
495
- #
496
- # client = ::Google::Longrunning::Operations::Client.new do |config|
497
- # config.timeout = 10.0
498
- # config.rpcs.list_operations.timeout = 20.0
499
- # end
597
+ # @example
598
+ #
599
+ # # Modify the global config, setting the timeout for
600
+ # # list_operations to 20 seconds,
601
+ # # and all remaining timeouts to 10 seconds.
602
+ # ::Google::Longrunning::Operations::Client.configure do |config|
603
+ # config.timeout = 10.0
604
+ # config.rpcs.list_operations.timeout = 20.0
605
+ # end
606
+ #
607
+ # # Apply the above configuration only to a new client.
608
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
609
+ # config.timeout = 10.0
610
+ # config.rpcs.list_operations.timeout = 20.0
611
+ # end
500
612
  #
501
613
  # @!attribute [rw] endpoint
502
614
  # The hostname or hostname:port of the service endpoint.
@@ -40,13 +40,12 @@ module Google
40
40
  # See {::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client::Configuration}
41
41
  # for a description of the configuration fields.
42
42
  #
43
- # ## Example
43
+ # @example
44
44
  #
45
- # To modify the configuration for all AuthorizedCertificates clients:
46
- #
47
- # ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.configure do |config|
48
- # config.timeout = 10.0
49
- # end
45
+ # # Modify the configuration for all AuthorizedCertificates clients
46
+ # ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.configure do |config|
47
+ # config.timeout = 10.0
48
+ # end
50
49
  #
51
50
  # @yield [config] Configure the Client client.
52
51
  # @yieldparam config [Client::Configuration]
@@ -93,19 +92,15 @@ module Google
93
92
  ##
94
93
  # Create a new AuthorizedCertificates client object.
95
94
  #
96
- # ## Examples
97
- #
98
- # To create a new AuthorizedCertificates client with the default
99
- # configuration:
100
- #
101
- # client = ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new
95
+ # @example
102
96
  #
103
- # To create a new AuthorizedCertificates client with a custom
104
- # configuration:
97
+ # # Create a client using the default configuration
98
+ # client = ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new
105
99
  #
106
- # client = ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new do |config|
107
- # config.timeout = 10.0
108
- # end
100
+ # # Create a client using a custom configuration
101
+ # client = ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new do |config|
102
+ # config.timeout = 10.0
103
+ # end
109
104
  #
110
105
  # @yield [config] Configure the AuthorizedCertificates client.
111
106
  # @yieldparam config [Client::Configuration]
@@ -125,14 +120,13 @@ module Google
125
120
 
126
121
  # Create credentials
127
122
  credentials = @config.credentials
128
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
123
+ # Use self-signed JWT if the endpoint is unchanged from default,
129
124
  # but only if the default endpoint does not have a region prefix.
130
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
131
- @config.endpoint == Client.configure.endpoint &&
125
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
132
126
  !@config.endpoint.split(".").first.include?("-")
133
127
  credentials ||= Credentials.default scope: @config.scope,
134
128
  enable_self_signed_jwt: enable_self_signed_jwt
135
- if credentials.is_a?(String) || credentials.is_a?(Hash)
129
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
136
130
  credentials = Credentials.new credentials, scope: @config.scope
137
131
  end
138
132
  @quota_project_id = @config.quota_project
@@ -184,6 +178,27 @@ module Google
184
178
  #
185
179
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
186
180
  #
181
+ # @example Basic example
182
+ # require "google/cloud/app_engine/v1"
183
+ #
184
+ # # Create a client object. The client can be reused for multiple calls.
185
+ # client = Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new
186
+ #
187
+ # # Create a request. To set request fields, pass in keyword arguments.
188
+ # request = Google::Cloud::AppEngine::V1::ListAuthorizedCertificatesRequest.new
189
+ #
190
+ # # Call the list_authorized_certificates method.
191
+ # result = client.list_authorized_certificates request
192
+ #
193
+ # # The returned object is of type Gapic::PagedEnumerable. You can
194
+ # # iterate over all elements by calling #each, and the enumerable
195
+ # # will lazily make API calls to fetch subsequent pages. Other
196
+ # # methods are also available for managing paging directly.
197
+ # result.each do |response|
198
+ # # Each element is of type ::Google::Cloud::AppEngine::V1::AuthorizedCertificate.
199
+ # p response
200
+ # end
201
+ #
187
202
  def list_authorized_certificates request, options = nil
188
203
  raise ::ArgumentError, "request must be provided" if request.nil?
189
204
 
@@ -201,16 +216,20 @@ module Google
201
216
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
202
217
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
203
218
 
204
- header_params = {
205
- "parent" => request.parent
206
- }
219
+ header_params = {}
220
+ if request.parent
221
+ header_params["parent"] = request.parent
222
+ end
223
+
207
224
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
208
225
  metadata[:"x-goog-request-params"] ||= request_params_header
209
226
 
210
227
  options.apply_defaults timeout: @config.rpcs.list_authorized_certificates.timeout,
211
228
  metadata: metadata,
212
229
  retry_policy: @config.rpcs.list_authorized_certificates.retry_policy
213
- options.apply_defaults metadata: @config.metadata,
230
+
231
+ options.apply_defaults timeout: @config.timeout,
232
+ metadata: @config.metadata,
214
233
  retry_policy: @config.retry_policy
215
234
 
216
235
  @authorized_certificates_stub.call_rpc :list_authorized_certificates, request, options: options do |response, operation|
@@ -254,6 +273,21 @@ module Google
254
273
  #
255
274
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
256
275
  #
276
+ # @example Basic example
277
+ # require "google/cloud/app_engine/v1"
278
+ #
279
+ # # Create a client object. The client can be reused for multiple calls.
280
+ # client = Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new
281
+ #
282
+ # # Create a request. To set request fields, pass in keyword arguments.
283
+ # request = Google::Cloud::AppEngine::V1::GetAuthorizedCertificateRequest.new
284
+ #
285
+ # # Call the get_authorized_certificate method.
286
+ # result = client.get_authorized_certificate request
287
+ #
288
+ # # The returned object is of type Google::Cloud::AppEngine::V1::AuthorizedCertificate.
289
+ # p result
290
+ #
257
291
  def get_authorized_certificate request, options = nil
258
292
  raise ::ArgumentError, "request must be provided" if request.nil?
259
293
 
@@ -271,16 +305,20 @@ module Google
271
305
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
272
306
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
273
307
 
274
- header_params = {
275
- "name" => request.name
276
- }
308
+ header_params = {}
309
+ if request.name
310
+ header_params["name"] = request.name
311
+ end
312
+
277
313
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
278
314
  metadata[:"x-goog-request-params"] ||= request_params_header
279
315
 
280
316
  options.apply_defaults timeout: @config.rpcs.get_authorized_certificate.timeout,
281
317
  metadata: metadata,
282
318
  retry_policy: @config.rpcs.get_authorized_certificate.retry_policy
283
- options.apply_defaults metadata: @config.metadata,
319
+
320
+ options.apply_defaults timeout: @config.timeout,
321
+ metadata: @config.metadata,
284
322
  retry_policy: @config.retry_policy
285
323
 
286
324
  @authorized_certificates_stub.call_rpc :get_authorized_certificate, request, options: options do |response, operation|
@@ -322,6 +360,21 @@ module Google
322
360
  #
323
361
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
324
362
  #
363
+ # @example Basic example
364
+ # require "google/cloud/app_engine/v1"
365
+ #
366
+ # # Create a client object. The client can be reused for multiple calls.
367
+ # client = Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new
368
+ #
369
+ # # Create a request. To set request fields, pass in keyword arguments.
370
+ # request = Google::Cloud::AppEngine::V1::CreateAuthorizedCertificateRequest.new
371
+ #
372
+ # # Call the create_authorized_certificate method.
373
+ # result = client.create_authorized_certificate request
374
+ #
375
+ # # The returned object is of type Google::Cloud::AppEngine::V1::AuthorizedCertificate.
376
+ # p result
377
+ #
325
378
  def create_authorized_certificate request, options = nil
326
379
  raise ::ArgumentError, "request must be provided" if request.nil?
327
380
 
@@ -339,16 +392,20 @@ module Google
339
392
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
340
393
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
341
394
 
342
- header_params = {
343
- "parent" => request.parent
344
- }
395
+ header_params = {}
396
+ if request.parent
397
+ header_params["parent"] = request.parent
398
+ end
399
+
345
400
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
346
401
  metadata[:"x-goog-request-params"] ||= request_params_header
347
402
 
348
403
  options.apply_defaults timeout: @config.rpcs.create_authorized_certificate.timeout,
349
404
  metadata: metadata,
350
405
  retry_policy: @config.rpcs.create_authorized_certificate.retry_policy
351
- options.apply_defaults metadata: @config.metadata,
406
+
407
+ options.apply_defaults timeout: @config.timeout,
408
+ metadata: @config.metadata,
352
409
  retry_policy: @config.retry_policy
353
410
 
354
411
  @authorized_certificates_stub.call_rpc :create_authorized_certificate, request, options: options do |response, operation|
@@ -399,6 +456,21 @@ module Google
399
456
  #
400
457
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
401
458
  #
459
+ # @example Basic example
460
+ # require "google/cloud/app_engine/v1"
461
+ #
462
+ # # Create a client object. The client can be reused for multiple calls.
463
+ # client = Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new
464
+ #
465
+ # # Create a request. To set request fields, pass in keyword arguments.
466
+ # request = Google::Cloud::AppEngine::V1::UpdateAuthorizedCertificateRequest.new
467
+ #
468
+ # # Call the update_authorized_certificate method.
469
+ # result = client.update_authorized_certificate request
470
+ #
471
+ # # The returned object is of type Google::Cloud::AppEngine::V1::AuthorizedCertificate.
472
+ # p result
473
+ #
402
474
  def update_authorized_certificate request, options = nil
403
475
  raise ::ArgumentError, "request must be provided" if request.nil?
404
476
 
@@ -416,16 +488,20 @@ module Google
416
488
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
417
489
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
418
490
 
419
- header_params = {
420
- "name" => request.name
421
- }
491
+ header_params = {}
492
+ if request.name
493
+ header_params["name"] = request.name
494
+ end
495
+
422
496
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
423
497
  metadata[:"x-goog-request-params"] ||= request_params_header
424
498
 
425
499
  options.apply_defaults timeout: @config.rpcs.update_authorized_certificate.timeout,
426
500
  metadata: metadata,
427
501
  retry_policy: @config.rpcs.update_authorized_certificate.retry_policy
428
- options.apply_defaults metadata: @config.metadata,
502
+
503
+ options.apply_defaults timeout: @config.timeout,
504
+ metadata: @config.metadata,
429
505
  retry_policy: @config.retry_policy
430
506
 
431
507
  @authorized_certificates_stub.call_rpc :update_authorized_certificate, request, options: options do |response, operation|
@@ -466,6 +542,21 @@ module Google
466
542
  #
467
543
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
468
544
  #
545
+ # @example Basic example
546
+ # require "google/cloud/app_engine/v1"
547
+ #
548
+ # # Create a client object. The client can be reused for multiple calls.
549
+ # client = Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new
550
+ #
551
+ # # Create a request. To set request fields, pass in keyword arguments.
552
+ # request = Google::Cloud::AppEngine::V1::DeleteAuthorizedCertificateRequest.new
553
+ #
554
+ # # Call the delete_authorized_certificate method.
555
+ # result = client.delete_authorized_certificate request
556
+ #
557
+ # # The returned object is of type Google::Protobuf::Empty.
558
+ # p result
559
+ #
469
560
  def delete_authorized_certificate request, options = nil
470
561
  raise ::ArgumentError, "request must be provided" if request.nil?
471
562
 
@@ -483,16 +574,20 @@ module Google
483
574
  gapic_version: ::Google::Cloud::AppEngine::V1::VERSION
484
575
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
485
576
 
486
- header_params = {
487
- "name" => request.name
488
- }
577
+ header_params = {}
578
+ if request.name
579
+ header_params["name"] = request.name
580
+ end
581
+
489
582
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
490
583
  metadata[:"x-goog-request-params"] ||= request_params_header
491
584
 
492
585
  options.apply_defaults timeout: @config.rpcs.delete_authorized_certificate.timeout,
493
586
  metadata: metadata,
494
587
  retry_policy: @config.rpcs.delete_authorized_certificate.retry_policy
495
- options.apply_defaults metadata: @config.metadata,
588
+
589
+ options.apply_defaults timeout: @config.timeout,
590
+ metadata: @config.metadata,
496
591
  retry_policy: @config.retry_policy
497
592
 
498
593
  @authorized_certificates_stub.call_rpc :delete_authorized_certificate, request, options: options do |response, operation|
@@ -516,22 +611,21 @@ module Google
516
611
  # Configuration can be applied globally to all clients, or to a single client
517
612
  # on construction.
518
613
  #
519
- # # Examples
520
- #
521
- # To modify the global config, setting the timeout for list_authorized_certificates
522
- # to 20 seconds, and all remaining timeouts to 10 seconds:
523
- #
524
- # ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.configure do |config|
525
- # config.timeout = 10.0
526
- # config.rpcs.list_authorized_certificates.timeout = 20.0
527
- # end
528
- #
529
- # To apply the above configuration only to a new client:
530
- #
531
- # client = ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new do |config|
532
- # config.timeout = 10.0
533
- # config.rpcs.list_authorized_certificates.timeout = 20.0
534
- # end
614
+ # @example
615
+ #
616
+ # # Modify the global config, setting the timeout for
617
+ # # list_authorized_certificates to 20 seconds,
618
+ # # and all remaining timeouts to 10 seconds.
619
+ # ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.configure do |config|
620
+ # config.timeout = 10.0
621
+ # config.rpcs.list_authorized_certificates.timeout = 20.0
622
+ # end
623
+ #
624
+ # # Apply the above configuration only to a new client.
625
+ # client = ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new do |config|
626
+ # config.timeout = 10.0
627
+ # config.rpcs.list_authorized_certificates.timeout = 20.0
628
+ # end
535
629
  #
536
630
  # @!attribute [rw] endpoint
537
631
  # The hostname or hostname:port of the service endpoint.