google-cloud-parameter_manager-v1 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +0 -1
  3. data/lib/google/cloud/parameter_manager/v1/bindings_override.rb +1 -1
  4. data/lib/google/cloud/parameter_manager/v1/parameter_manager/client.rb +1329 -151
  5. data/lib/google/cloud/parameter_manager/v1/parameter_manager/credentials.rb +1 -1
  6. data/lib/google/cloud/parameter_manager/v1/parameter_manager/paths.rb +41 -1
  7. data/lib/google/cloud/parameter_manager/v1/parameter_manager/rest/client.rb +1244 -143
  8. data/lib/google/cloud/parameter_manager/v1/parameter_manager/rest/service_stub.rb +676 -1
  9. data/lib/google/cloud/parameter_manager/v1/parameter_manager/rest.rb +1 -1
  10. data/lib/google/cloud/parameter_manager/v1/parameter_manager.rb +1 -1
  11. data/lib/google/cloud/parameter_manager/v1/rest.rb +1 -1
  12. data/lib/google/cloud/parameter_manager/v1/version.rb +1 -1
  13. data/lib/google/cloud/parameter_manager/v1.rb +1 -1
  14. data/lib/google/cloud/parametermanager/v1/service_pb.rb +20 -1
  15. data/lib/google/cloud/parametermanager/v1/service_services_pb.rb +23 -1
  16. data/lib/google-cloud-parameter_manager-v1.rb +1 -1
  17. data/proto_docs/google/api/client.rb +1 -1
  18. data/proto_docs/google/api/field_behavior.rb +1 -1
  19. data/proto_docs/google/api/field_info.rb +1 -1
  20. data/proto_docs/google/api/launch_stage.rb +1 -1
  21. data/proto_docs/google/api/resource.rb +1 -1
  22. data/proto_docs/google/cloud/parametermanager/v1/service.rb +458 -5
  23. data/proto_docs/google/iam/v1/resource_policy_member.rb +1 -1
  24. data/proto_docs/google/protobuf/duration.rb +1 -1
  25. data/proto_docs/google/protobuf/empty.rb +1 -1
  26. data/proto_docs/google/protobuf/field_mask.rb +1 -1
  27. data/proto_docs/google/protobuf/timestamp.rb +8 -7
  28. metadata +1 -2
  29. data/proto_docs/google/protobuf/any.rb +0 -145
@@ -1,6 +1,6 @@
1
1
  # frozen_string_literal: true
2
2
 
3
- # Copyright 2025 Google LLC
3
+ # Copyright 2026 Google LLC
4
4
  #
5
5
  # Licensed under the Apache License, Version 2.0 (the "License");
6
6
  # you may not use this file except in compliance with the License.
@@ -255,7 +255,11 @@ module Google
255
255
  # Optional. Requested page size. Server may return fewer items than
256
256
  # requested. If unspecified, server will pick an appropriate default.
257
257
  # @param page_token [::String]
258
- # Optional. A token identifying a page of results the server should return.
258
+ # Optional. A page token, received from a previous `ListParameters` call.
259
+ # Provide this to retrieve the subsequent page.
260
+ #
261
+ # When paginating, all other parameters provided to `ListParameters` must
262
+ # match the call that provided the page token.
259
263
  # @param filter [::String]
260
264
  # Optional. Filtering results
261
265
  # @param order_by [::String]
@@ -717,7 +721,11 @@ module Google
717
721
  # Optional. Requested page size. Server may return fewer items than
718
722
  # requested. If unspecified, server will pick an appropriate default.
719
723
  # @param page_token [::String]
720
- # Optional. A token identifying a page of results the server should return.
724
+ # Optional. A page token, received from a previous `ListParameterVersions`
725
+ # call. Provide this to retrieve the subsequent page.
726
+ #
727
+ # When paginating, all other parameters provided to `ListParameterVersions`
728
+ # must match the call that provided the page token.
721
729
  # @param filter [::String]
722
730
  # Optional. Filtering results
723
731
  # @param order_by [::String]
@@ -1237,163 +1245,1179 @@ module Google
1237
1245
  end
1238
1246
 
1239
1247
  ##
1240
- # Configuration class for the ParameterManager REST API.
1248
+ # Lists Templates in a given project and location.
1241
1249
  #
1242
- # This class represents the configuration for ParameterManager REST,
1243
- # providing control over timeouts, retry behavior, logging, transport
1244
- # parameters, and other low-level controls. Certain parameters can also be
1245
- # applied individually to specific RPCs. See
1246
- # {::Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client::Configuration::Rpcs}
1247
- # for a list of RPCs that can be configured independently.
1250
+ # @overload list_templates(request, options = nil)
1251
+ # Pass arguments to `list_templates` via a request object, either of type
1252
+ # {::Google::Cloud::ParameterManager::V1::ListTemplatesRequest} or an equivalent Hash.
1248
1253
  #
1249
- # Configuration can be applied globally to all clients, or to a single client
1250
- # on construction.
1254
+ # @param request [::Google::Cloud::ParameterManager::V1::ListTemplatesRequest, ::Hash]
1255
+ # A request object representing the call parameters. Required. To specify no
1256
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1257
+ # @param options [::Gapic::CallOptions, ::Hash]
1258
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1251
1259
  #
1252
- # @example
1260
+ # @overload list_templates(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1261
+ # Pass arguments to `list_templates` via keyword arguments. Note that at
1262
+ # least one keyword argument is required. To specify no parameters, or to keep all
1263
+ # the default parameter values, pass an empty Hash as a request object (see above).
1253
1264
  #
1254
- # # Modify the global config, setting the timeout for
1255
- # # list_parameters to 20 seconds,
1256
- # # and all remaining timeouts to 10 seconds.
1257
- # ::Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.configure do |config|
1258
- # config.timeout = 10.0
1259
- # config.rpcs.list_parameters.timeout = 20.0
1260
- # end
1265
+ # @param parent [::String]
1266
+ # Required. Parent value for ListTemplatesRequest in the format
1267
+ # `projects/*/locations/*`.
1268
+ # @param page_size [::Integer]
1269
+ # Optional. Requested page size. Server may return fewer items than
1270
+ # requested. If unspecified, server will pick an appropriate default.
1271
+ # @param page_token [::String]
1272
+ # Optional. A page token, received from a previous `ListTemplates` call.
1273
+ # Provide this to retrieve the subsequent page.
1261
1274
  #
1262
- # # Apply the above configuration only to a new client.
1263
- # client = ::Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new do |config|
1264
- # config.timeout = 10.0
1265
- # config.rpcs.list_parameters.timeout = 20.0
1266
- # end
1275
+ # When paginating, all other parameters provided to `ListTemplates` must
1276
+ # match the call that provided the page token.
1277
+ # @param filter [::String]
1278
+ # Optional. Filtering results
1279
+ # @param order_by [::String]
1280
+ # Optional. Hint for how to order the results
1281
+ # @yield [result, operation] Access the result along with the TransportOperation object
1282
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ParameterManager::V1::Template>]
1283
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1267
1284
  #
1268
- # @!attribute [rw] endpoint
1269
- # A custom service endpoint, as a hostname or hostname:port. The default is
1270
- # nil, indicating to use the default endpoint in the current universe domain.
1271
- # @return [::String,nil]
1272
- # @!attribute [rw] credentials
1273
- # Credentials to send with calls. You may provide any of the following types:
1274
- # * (`String`) The path to a service account key file in JSON format
1275
- # * (`Hash`) A service account key as a Hash
1276
- # * (`Google::Auth::Credentials`) A googleauth credentials object
1277
- # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1278
- # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1279
- # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1280
- # * (`nil`) indicating no credentials
1285
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ParameterManager::V1::Template>]
1281
1286
  #
1282
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
1283
- # external source for authentication to Google Cloud, you must validate it before
1284
- # providing it to a Google API client library. Providing an unvalidated credential
1285
- # configuration to Google APIs can compromise the security of your systems and data.
1286
- # For more information, refer to [Validate credential configurations from external
1287
- # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1288
- # @return [::Object]
1289
- # @!attribute [rw] scope
1290
- # The OAuth scopes
1291
- # @return [::Array<::String>]
1292
- # @!attribute [rw] lib_name
1293
- # The library name as recorded in instrumentation and logging
1294
- # @return [::String]
1295
- # @!attribute [rw] lib_version
1296
- # The library version as recorded in instrumentation and logging
1297
- # @return [::String]
1298
- # @!attribute [rw] timeout
1299
- # The call timeout in seconds.
1300
- # @return [::Numeric]
1301
- # @!attribute [rw] metadata
1302
- # Additional headers to be sent with the call.
1303
- # @return [::Hash{::Symbol=>::String}]
1304
- # @!attribute [rw] retry_policy
1305
- # The retry policy. The value is a hash with the following keys:
1306
- # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1307
- # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1308
- # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1309
- # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1310
- # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1311
- # trigger a retry.
1312
- # @return [::Hash]
1313
- # @!attribute [rw] quota_project
1314
- # A separate project against which to charge quota.
1315
- # @return [::String]
1316
- # @!attribute [rw] universe_domain
1317
- # The universe domain within which to make requests. This determines the
1318
- # default endpoint URL. The default value of nil uses the environment
1319
- # universe (usually the default "googleapis.com" universe).
1320
- # @return [::String,nil]
1321
- # @!attribute [rw] logger
1322
- # A custom logger to use for request/response debug logging, or the value
1323
- # `:default` (the default) to construct a default logger, or `nil` to
1324
- # explicitly disable logging.
1325
- # @return [::Logger,:default,nil]
1287
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1326
1288
  #
1327
- class Configuration
1328
- extend ::Gapic::Config
1289
+ # @example Basic example
1290
+ # require "google/cloud/parameter_manager/v1"
1291
+ #
1292
+ # # Create a client object. The client can be reused for multiple calls.
1293
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1294
+ #
1295
+ # # Create a request. To set request fields, pass in keyword arguments.
1296
+ # request = Google::Cloud::ParameterManager::V1::ListTemplatesRequest.new
1297
+ #
1298
+ # # Call the list_templates method.
1299
+ # result = client.list_templates request
1300
+ #
1301
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1302
+ # # over elements, and API calls will be issued to fetch pages as needed.
1303
+ # result.each do |item|
1304
+ # # Each element is of type ::Google::Cloud::ParameterManager::V1::Template.
1305
+ # p item
1306
+ # end
1307
+ #
1308
+ def list_templates request, options = nil
1309
+ raise ::ArgumentError, "request must be provided" if request.nil?
1329
1310
 
1330
- # @private
1331
- # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1332
- DEFAULT_ENDPOINT = "parametermanager.googleapis.com"
1311
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::ListTemplatesRequest
1333
1312
 
1334
- config_attr :endpoint, nil, ::String, nil
1335
- config_attr :credentials, nil do |value|
1336
- allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
1337
- allowed.any? { |klass| klass === value }
1338
- end
1339
- config_attr :scope, nil, ::String, ::Array, nil
1340
- config_attr :lib_name, nil, ::String, nil
1341
- config_attr :lib_version, nil, ::String, nil
1342
- config_attr :timeout, nil, ::Numeric, nil
1343
- config_attr :metadata, nil, ::Hash, nil
1344
- config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1345
- config_attr :quota_project, nil, ::String, nil
1346
- config_attr :universe_domain, nil, ::String, nil
1313
+ # Converts hash and nil to an options object
1314
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1347
1315
 
1348
- # @private
1349
- # Overrides for http bindings for the RPCs of this service
1350
- # are only used when this service is used as mixin, and only
1351
- # by the host service.
1352
- # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1353
- config_attr :bindings_override, {}, ::Hash, nil
1354
- config_attr :logger, :default, ::Logger, nil, :default
1316
+ # Customize the options with defaults
1317
+ call_metadata = @config.rpcs.list_templates.metadata.to_h
1355
1318
 
1356
- # @private
1357
- def initialize parent_config = nil
1358
- @parent_config = parent_config unless parent_config.nil?
1319
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1320
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1321
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1322
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1323
+ transports_version_send: [:rest]
1359
1324
 
1360
- yield self if block_given?
1325
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1326
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1327
+
1328
+ options.apply_defaults timeout: @config.rpcs.list_templates.timeout,
1329
+ metadata: call_metadata,
1330
+ retry_policy: @config.rpcs.list_templates.retry_policy
1331
+
1332
+ options.apply_defaults timeout: @config.timeout,
1333
+ metadata: @config.metadata,
1334
+ retry_policy: @config.retry_policy
1335
+
1336
+ @parameter_manager_stub.list_templates request, options do |result, operation|
1337
+ result = ::Gapic::Rest::PagedEnumerable.new @parameter_manager_stub, :list_templates, "templates", request, result, options
1338
+ yield result, operation if block_given?
1339
+ throw :response, result
1361
1340
  end
1341
+ rescue ::Gapic::Rest::Error => e
1342
+ raise ::Google::Cloud::Error.from_error(e)
1343
+ end
1362
1344
 
1363
- ##
1364
- # Configurations for individual RPCs
1365
- # @return [Rpcs]
1366
- #
1367
- def rpcs
1368
- @rpcs ||= begin
1369
- parent_rpcs = nil
1370
- parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
1371
- Rpcs.new parent_rpcs
1372
- end
1345
+ ##
1346
+ # Gets details of a single Template.
1347
+ #
1348
+ # @overload get_template(request, options = nil)
1349
+ # Pass arguments to `get_template` via a request object, either of type
1350
+ # {::Google::Cloud::ParameterManager::V1::GetTemplateRequest} or an equivalent Hash.
1351
+ #
1352
+ # @param request [::Google::Cloud::ParameterManager::V1::GetTemplateRequest, ::Hash]
1353
+ # A request object representing the call parameters. Required. To specify no
1354
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1355
+ # @param options [::Gapic::CallOptions, ::Hash]
1356
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1357
+ #
1358
+ # @overload get_template(name: nil)
1359
+ # Pass arguments to `get_template` via keyword arguments. Note that at
1360
+ # least one keyword argument is required. To specify no parameters, or to keep all
1361
+ # the default parameter values, pass an empty Hash as a request object (see above).
1362
+ #
1363
+ # @param name [::String]
1364
+ # Required. Name of the resource in the format
1365
+ # `projects/*/locations/*/templates/*`.
1366
+ # @yield [result, operation] Access the result along with the TransportOperation object
1367
+ # @yieldparam result [::Google::Cloud::ParameterManager::V1::Template]
1368
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1369
+ #
1370
+ # @return [::Google::Cloud::ParameterManager::V1::Template]
1371
+ #
1372
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1373
+ #
1374
+ # @example Basic example
1375
+ # require "google/cloud/parameter_manager/v1"
1376
+ #
1377
+ # # Create a client object. The client can be reused for multiple calls.
1378
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1379
+ #
1380
+ # # Create a request. To set request fields, pass in keyword arguments.
1381
+ # request = Google::Cloud::ParameterManager::V1::GetTemplateRequest.new
1382
+ #
1383
+ # # Call the get_template method.
1384
+ # result = client.get_template request
1385
+ #
1386
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::Template.
1387
+ # p result
1388
+ #
1389
+ def get_template request, options = nil
1390
+ raise ::ArgumentError, "request must be provided" if request.nil?
1391
+
1392
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::GetTemplateRequest
1393
+
1394
+ # Converts hash and nil to an options object
1395
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1396
+
1397
+ # Customize the options with defaults
1398
+ call_metadata = @config.rpcs.get_template.metadata.to_h
1399
+
1400
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1401
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1402
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1403
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1404
+ transports_version_send: [:rest]
1405
+
1406
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1407
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1408
+
1409
+ options.apply_defaults timeout: @config.rpcs.get_template.timeout,
1410
+ metadata: call_metadata,
1411
+ retry_policy: @config.rpcs.get_template.retry_policy
1412
+
1413
+ options.apply_defaults timeout: @config.timeout,
1414
+ metadata: @config.metadata,
1415
+ retry_policy: @config.retry_policy
1416
+
1417
+ @parameter_manager_stub.get_template request, options do |result, operation|
1418
+ yield result, operation if block_given?
1373
1419
  end
1420
+ rescue ::Gapic::Rest::Error => e
1421
+ raise ::Google::Cloud::Error.from_error(e)
1422
+ end
1374
1423
 
1375
- ##
1376
- # Configuration RPC class for the ParameterManager API.
1377
- #
1378
- # Includes fields providing the configuration for each RPC in this service.
1379
- # Each configuration object is of type `Gapic::Config::Method` and includes
1380
- # the following configuration fields:
1381
- #
1382
- # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
1383
- # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
1384
- # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
1385
- # include the following keys:
1386
- # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1387
- # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1388
- # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1389
- # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1390
- # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1391
- # trigger a retry.
1392
- #
1393
- class Rpcs
1394
- ##
1395
- # RPC-specific configuration for `list_parameters`
1396
- # @return [::Gapic::Config::Method]
1424
+ ##
1425
+ # Creates a new Template in a given project and location.
1426
+ #
1427
+ # @overload create_template(request, options = nil)
1428
+ # Pass arguments to `create_template` via a request object, either of type
1429
+ # {::Google::Cloud::ParameterManager::V1::CreateTemplateRequest} or an equivalent Hash.
1430
+ #
1431
+ # @param request [::Google::Cloud::ParameterManager::V1::CreateTemplateRequest, ::Hash]
1432
+ # A request object representing the call parameters. Required. To specify no
1433
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1434
+ # @param options [::Gapic::CallOptions, ::Hash]
1435
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1436
+ #
1437
+ # @overload create_template(parent: nil, template_id: nil, template: nil, request_id: nil)
1438
+ # Pass arguments to `create_template` via keyword arguments. Note that at
1439
+ # least one keyword argument is required. To specify no parameters, or to keep all
1440
+ # the default parameter values, pass an empty Hash as a request object (see above).
1441
+ #
1442
+ # @param parent [::String]
1443
+ # Required. Value for parent in the format
1444
+ # `projects/*/locations/*`.
1445
+ # @param template_id [::String]
1446
+ # Required. Id of the Template resource
1447
+ # @param template [::Google::Cloud::ParameterManager::V1::Template, ::Hash]
1448
+ # Required. The Template resource being created
1449
+ # @param request_id [::String]
1450
+ # Optional. An optional request ID to identify requests. Specify a unique
1451
+ # request ID so that if you must retry your request, the server will know to
1452
+ # ignore the request if it has already been completed. The server will
1453
+ # guarantee that for at least 60 minutes since the first request.
1454
+ #
1455
+ # For example, consider a situation where you make an initial request and the
1456
+ # request times out. If you make the request again with the same request
1457
+ # ID, the server can check if original operation with the same request ID
1458
+ # was received, and if so, will ignore the second request. This prevents
1459
+ # clients from accidentally creating duplicate commitments.
1460
+ #
1461
+ # The request ID must be a valid UUID with the exception that zero UUID is
1462
+ # not supported (00000000-0000-0000-0000-000000000000).
1463
+ # @yield [result, operation] Access the result along with the TransportOperation object
1464
+ # @yieldparam result [::Google::Cloud::ParameterManager::V1::Template]
1465
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1466
+ #
1467
+ # @return [::Google::Cloud::ParameterManager::V1::Template]
1468
+ #
1469
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1470
+ #
1471
+ # @example Basic example
1472
+ # require "google/cloud/parameter_manager/v1"
1473
+ #
1474
+ # # Create a client object. The client can be reused for multiple calls.
1475
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1476
+ #
1477
+ # # Create a request. To set request fields, pass in keyword arguments.
1478
+ # request = Google::Cloud::ParameterManager::V1::CreateTemplateRequest.new
1479
+ #
1480
+ # # Call the create_template method.
1481
+ # result = client.create_template request
1482
+ #
1483
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::Template.
1484
+ # p result
1485
+ #
1486
+ def create_template request, options = nil
1487
+ raise ::ArgumentError, "request must be provided" if request.nil?
1488
+
1489
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::CreateTemplateRequest
1490
+
1491
+ # Converts hash and nil to an options object
1492
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1493
+
1494
+ # Customize the options with defaults
1495
+ call_metadata = @config.rpcs.create_template.metadata.to_h
1496
+
1497
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1498
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1499
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1500
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1501
+ transports_version_send: [:rest]
1502
+
1503
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1504
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1505
+
1506
+ options.apply_defaults timeout: @config.rpcs.create_template.timeout,
1507
+ metadata: call_metadata,
1508
+ retry_policy: @config.rpcs.create_template.retry_policy
1509
+
1510
+ options.apply_defaults timeout: @config.timeout,
1511
+ metadata: @config.metadata,
1512
+ retry_policy: @config.retry_policy
1513
+
1514
+ @parameter_manager_stub.create_template request, options do |result, operation|
1515
+ yield result, operation if block_given?
1516
+ end
1517
+ rescue ::Gapic::Rest::Error => e
1518
+ raise ::Google::Cloud::Error.from_error(e)
1519
+ end
1520
+
1521
+ ##
1522
+ # Updates a single Template.
1523
+ #
1524
+ # @overload update_template(request, options = nil)
1525
+ # Pass arguments to `update_template` via a request object, either of type
1526
+ # {::Google::Cloud::ParameterManager::V1::UpdateTemplateRequest} or an equivalent Hash.
1527
+ #
1528
+ # @param request [::Google::Cloud::ParameterManager::V1::UpdateTemplateRequest, ::Hash]
1529
+ # A request object representing the call parameters. Required. To specify no
1530
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1531
+ # @param options [::Gapic::CallOptions, ::Hash]
1532
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1533
+ #
1534
+ # @overload update_template(update_mask: nil, template: nil, request_id: nil)
1535
+ # Pass arguments to `update_template` via keyword arguments. Note that at
1536
+ # least one keyword argument is required. To specify no parameters, or to keep all
1537
+ # the default parameter values, pass an empty Hash as a request object (see above).
1538
+ #
1539
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1540
+ # Optional. Field mask is used to specify the fields to be overwritten in the
1541
+ # Template resource by the update.
1542
+ # The fields specified in the update_mask are relative to the resource, not
1543
+ # the full request. A mutable field will be overwritten if it is in the
1544
+ # mask. If the user does not provide a mask then all mutable fields present
1545
+ # in the request will be overwritten.
1546
+ # @param template [::Google::Cloud::ParameterManager::V1::Template, ::Hash]
1547
+ # Required. The Template resource being updated
1548
+ # @param request_id [::String]
1549
+ # Optional. An optional request ID to identify requests. Specify a unique
1550
+ # request ID so that if you must retry your request, the server will know to
1551
+ # ignore the request if it has already been completed. The server will
1552
+ # guarantee that for at least 60 minutes since the first request.
1553
+ #
1554
+ # For example, consider a situation where you make an initial request and the
1555
+ # request times out. If you make the request again with the same request
1556
+ # ID, the server can check if original operation with the same request ID
1557
+ # was received, and if so, will ignore the second request. This prevents
1558
+ # clients from accidentally creating duplicate commitments.
1559
+ #
1560
+ # The request ID must be a valid UUID with the exception that zero UUID is
1561
+ # not supported (00000000-0000-0000-0000-000000000000).
1562
+ # @yield [result, operation] Access the result along with the TransportOperation object
1563
+ # @yieldparam result [::Google::Cloud::ParameterManager::V1::Template]
1564
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1565
+ #
1566
+ # @return [::Google::Cloud::ParameterManager::V1::Template]
1567
+ #
1568
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1569
+ #
1570
+ # @example Basic example
1571
+ # require "google/cloud/parameter_manager/v1"
1572
+ #
1573
+ # # Create a client object. The client can be reused for multiple calls.
1574
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1575
+ #
1576
+ # # Create a request. To set request fields, pass in keyword arguments.
1577
+ # request = Google::Cloud::ParameterManager::V1::UpdateTemplateRequest.new
1578
+ #
1579
+ # # Call the update_template method.
1580
+ # result = client.update_template request
1581
+ #
1582
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::Template.
1583
+ # p result
1584
+ #
1585
+ def update_template request, options = nil
1586
+ raise ::ArgumentError, "request must be provided" if request.nil?
1587
+
1588
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::UpdateTemplateRequest
1589
+
1590
+ # Converts hash and nil to an options object
1591
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1592
+
1593
+ # Customize the options with defaults
1594
+ call_metadata = @config.rpcs.update_template.metadata.to_h
1595
+
1596
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1597
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1598
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1599
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1600
+ transports_version_send: [:rest]
1601
+
1602
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1603
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1604
+
1605
+ options.apply_defaults timeout: @config.rpcs.update_template.timeout,
1606
+ metadata: call_metadata,
1607
+ retry_policy: @config.rpcs.update_template.retry_policy
1608
+
1609
+ options.apply_defaults timeout: @config.timeout,
1610
+ metadata: @config.metadata,
1611
+ retry_policy: @config.retry_policy
1612
+
1613
+ @parameter_manager_stub.update_template request, options do |result, operation|
1614
+ yield result, operation if block_given?
1615
+ end
1616
+ rescue ::Gapic::Rest::Error => e
1617
+ raise ::Google::Cloud::Error.from_error(e)
1618
+ end
1619
+
1620
+ ##
1621
+ # Deletes a single Template.
1622
+ #
1623
+ # @overload delete_template(request, options = nil)
1624
+ # Pass arguments to `delete_template` via a request object, either of type
1625
+ # {::Google::Cloud::ParameterManager::V1::DeleteTemplateRequest} or an equivalent Hash.
1626
+ #
1627
+ # @param request [::Google::Cloud::ParameterManager::V1::DeleteTemplateRequest, ::Hash]
1628
+ # A request object representing the call parameters. Required. To specify no
1629
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1630
+ # @param options [::Gapic::CallOptions, ::Hash]
1631
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1632
+ #
1633
+ # @overload delete_template(name: nil, request_id: nil)
1634
+ # Pass arguments to `delete_template` via keyword arguments. Note that at
1635
+ # least one keyword argument is required. To specify no parameters, or to keep all
1636
+ # the default parameter values, pass an empty Hash as a request object (see above).
1637
+ #
1638
+ # @param name [::String]
1639
+ # Required. Name of the resource in the format
1640
+ # `projects/*/locations/*/templates/*`.
1641
+ # @param request_id [::String]
1642
+ # Optional. An optional request ID to identify requests. Specify a unique
1643
+ # request ID so that if you must retry your request, the server will know to
1644
+ # ignore the request if it has already been completed. The server will
1645
+ # guarantee that for at least 60 minutes after the first request.
1646
+ #
1647
+ # For example, consider a situation where you make an initial request and the
1648
+ # request times out. If you make the request again with the same request
1649
+ # ID, the server can check if original operation with the same request ID
1650
+ # was received, and if so, will ignore the second request. This prevents
1651
+ # clients from accidentally creating duplicate commitments.
1652
+ #
1653
+ # The request ID must be a valid UUID with the exception that zero UUID is
1654
+ # not supported (00000000-0000-0000-0000-000000000000).
1655
+ # @yield [result, operation] Access the result along with the TransportOperation object
1656
+ # @yieldparam result [::Google::Protobuf::Empty]
1657
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1658
+ #
1659
+ # @return [::Google::Protobuf::Empty]
1660
+ #
1661
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1662
+ #
1663
+ # @example Basic example
1664
+ # require "google/cloud/parameter_manager/v1"
1665
+ #
1666
+ # # Create a client object. The client can be reused for multiple calls.
1667
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1668
+ #
1669
+ # # Create a request. To set request fields, pass in keyword arguments.
1670
+ # request = Google::Cloud::ParameterManager::V1::DeleteTemplateRequest.new
1671
+ #
1672
+ # # Call the delete_template method.
1673
+ # result = client.delete_template request
1674
+ #
1675
+ # # The returned object is of type Google::Protobuf::Empty.
1676
+ # p result
1677
+ #
1678
+ def delete_template request, options = nil
1679
+ raise ::ArgumentError, "request must be provided" if request.nil?
1680
+
1681
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::DeleteTemplateRequest
1682
+
1683
+ # Converts hash and nil to an options object
1684
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1685
+
1686
+ # Customize the options with defaults
1687
+ call_metadata = @config.rpcs.delete_template.metadata.to_h
1688
+
1689
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1690
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1691
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1692
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1693
+ transports_version_send: [:rest]
1694
+
1695
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1696
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1697
+
1698
+ options.apply_defaults timeout: @config.rpcs.delete_template.timeout,
1699
+ metadata: call_metadata,
1700
+ retry_policy: @config.rpcs.delete_template.retry_policy
1701
+
1702
+ options.apply_defaults timeout: @config.timeout,
1703
+ metadata: @config.metadata,
1704
+ retry_policy: @config.retry_policy
1705
+
1706
+ @parameter_manager_stub.delete_template request, options do |result, operation|
1707
+ yield result, operation if block_given?
1708
+ end
1709
+ rescue ::Gapic::Rest::Error => e
1710
+ raise ::Google::Cloud::Error.from_error(e)
1711
+ end
1712
+
1713
+ ##
1714
+ # Lists TemplateVersions in a given project, location, and template.
1715
+ #
1716
+ # @overload list_template_versions(request, options = nil)
1717
+ # Pass arguments to `list_template_versions` via a request object, either of type
1718
+ # {::Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest} or an equivalent Hash.
1719
+ #
1720
+ # @param request [::Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest, ::Hash]
1721
+ # A request object representing the call parameters. Required. To specify no
1722
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1723
+ # @param options [::Gapic::CallOptions, ::Hash]
1724
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1725
+ #
1726
+ # @overload list_template_versions(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1727
+ # Pass arguments to `list_template_versions` via keyword arguments. Note that at
1728
+ # least one keyword argument is required. To specify no parameters, or to keep all
1729
+ # the default parameter values, pass an empty Hash as a request object (see above).
1730
+ #
1731
+ # @param parent [::String]
1732
+ # Required. Parent value for ListTemplateVersionsRequest in the format
1733
+ # `projects/*/locations/*/templates/*`.
1734
+ # @param page_size [::Integer]
1735
+ # Optional. Requested page size. Server may return fewer items than
1736
+ # requested. If unspecified, server will pick an appropriate default.
1737
+ # @param page_token [::String]
1738
+ # Optional. A page token, received from a previous `ListTemplateVersions`
1739
+ # call. Provide this to retrieve the subsequent page.
1740
+ #
1741
+ # When paginating, all other parameters provided to `ListTemplateVersions`
1742
+ # must match the call that provided the page token.
1743
+ # @param filter [::String]
1744
+ # Optional. Filtering results
1745
+ # @param order_by [::String]
1746
+ # Optional. Hint for how to order the results
1747
+ # @yield [result, operation] Access the result along with the TransportOperation object
1748
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ParameterManager::V1::TemplateVersion>]
1749
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1750
+ #
1751
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::ParameterManager::V1::TemplateVersion>]
1752
+ #
1753
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1754
+ #
1755
+ # @example Basic example
1756
+ # require "google/cloud/parameter_manager/v1"
1757
+ #
1758
+ # # Create a client object. The client can be reused for multiple calls.
1759
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1760
+ #
1761
+ # # Create a request. To set request fields, pass in keyword arguments.
1762
+ # request = Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest.new
1763
+ #
1764
+ # # Call the list_template_versions method.
1765
+ # result = client.list_template_versions request
1766
+ #
1767
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1768
+ # # over elements, and API calls will be issued to fetch pages as needed.
1769
+ # result.each do |item|
1770
+ # # Each element is of type ::Google::Cloud::ParameterManager::V1::TemplateVersion.
1771
+ # p item
1772
+ # end
1773
+ #
1774
+ def list_template_versions request, options = nil
1775
+ raise ::ArgumentError, "request must be provided" if request.nil?
1776
+
1777
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest
1778
+
1779
+ # Converts hash and nil to an options object
1780
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1781
+
1782
+ # Customize the options with defaults
1783
+ call_metadata = @config.rpcs.list_template_versions.metadata.to_h
1784
+
1785
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1786
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1787
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1788
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1789
+ transports_version_send: [:rest]
1790
+
1791
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1792
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1793
+
1794
+ options.apply_defaults timeout: @config.rpcs.list_template_versions.timeout,
1795
+ metadata: call_metadata,
1796
+ retry_policy: @config.rpcs.list_template_versions.retry_policy
1797
+
1798
+ options.apply_defaults timeout: @config.timeout,
1799
+ metadata: @config.metadata,
1800
+ retry_policy: @config.retry_policy
1801
+
1802
+ @parameter_manager_stub.list_template_versions request, options do |result, operation|
1803
+ result = ::Gapic::Rest::PagedEnumerable.new @parameter_manager_stub, :list_template_versions, "template_versions", request, result, options
1804
+ yield result, operation if block_given?
1805
+ throw :response, result
1806
+ end
1807
+ rescue ::Gapic::Rest::Error => e
1808
+ raise ::Google::Cloud::Error.from_error(e)
1809
+ end
1810
+
1811
+ ##
1812
+ # Gets details of a single TemplateVersion.
1813
+ #
1814
+ # @overload get_template_version(request, options = nil)
1815
+ # Pass arguments to `get_template_version` via a request object, either of type
1816
+ # {::Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest} or an equivalent Hash.
1817
+ #
1818
+ # @param request [::Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest, ::Hash]
1819
+ # A request object representing the call parameters. Required. To specify no
1820
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1821
+ # @param options [::Gapic::CallOptions, ::Hash]
1822
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1823
+ #
1824
+ # @overload get_template_version(name: nil, view: nil)
1825
+ # Pass arguments to `get_template_version` via keyword arguments. Note that at
1826
+ # least one keyword argument is required. To specify no parameters, or to keep all
1827
+ # the default parameter values, pass an empty Hash as a request object (see above).
1828
+ #
1829
+ # @param name [::String]
1830
+ # Required. Name of the resource in the format
1831
+ # `projects/*/locations/*/templates/*/versions/*`.
1832
+ # @param view [::Google::Cloud::ParameterManager::V1::View]
1833
+ # Optional. Specifies the view of the TemplateVersion to return.
1834
+ # In the default FULL view, all metadata & payload associated with the
1835
+ # TemplateVersion will be returned.
1836
+ # @yield [result, operation] Access the result along with the TransportOperation object
1837
+ # @yieldparam result [::Google::Cloud::ParameterManager::V1::TemplateVersion]
1838
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1839
+ #
1840
+ # @return [::Google::Cloud::ParameterManager::V1::TemplateVersion]
1841
+ #
1842
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1843
+ #
1844
+ # @example Basic example
1845
+ # require "google/cloud/parameter_manager/v1"
1846
+ #
1847
+ # # Create a client object. The client can be reused for multiple calls.
1848
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1849
+ #
1850
+ # # Create a request. To set request fields, pass in keyword arguments.
1851
+ # request = Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest.new
1852
+ #
1853
+ # # Call the get_template_version method.
1854
+ # result = client.get_template_version request
1855
+ #
1856
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::TemplateVersion.
1857
+ # p result
1858
+ #
1859
+ def get_template_version request, options = nil
1860
+ raise ::ArgumentError, "request must be provided" if request.nil?
1861
+
1862
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest
1863
+
1864
+ # Converts hash and nil to an options object
1865
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1866
+
1867
+ # Customize the options with defaults
1868
+ call_metadata = @config.rpcs.get_template_version.metadata.to_h
1869
+
1870
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1871
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1872
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1873
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1874
+ transports_version_send: [:rest]
1875
+
1876
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1877
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1878
+
1879
+ options.apply_defaults timeout: @config.rpcs.get_template_version.timeout,
1880
+ metadata: call_metadata,
1881
+ retry_policy: @config.rpcs.get_template_version.retry_policy
1882
+
1883
+ options.apply_defaults timeout: @config.timeout,
1884
+ metadata: @config.metadata,
1885
+ retry_policy: @config.retry_policy
1886
+
1887
+ @parameter_manager_stub.get_template_version request, options do |result, operation|
1888
+ yield result, operation if block_given?
1889
+ end
1890
+ rescue ::Gapic::Rest::Error => e
1891
+ raise ::Google::Cloud::Error.from_error(e)
1892
+ end
1893
+
1894
+ ##
1895
+ # Creates a new TemplateVersion in a given project, location, and template.
1896
+ #
1897
+ # @overload create_template_version(request, options = nil)
1898
+ # Pass arguments to `create_template_version` via a request object, either of type
1899
+ # {::Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest} or an equivalent Hash.
1900
+ #
1901
+ # @param request [::Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest, ::Hash]
1902
+ # A request object representing the call parameters. Required. To specify no
1903
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1904
+ # @param options [::Gapic::CallOptions, ::Hash]
1905
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1906
+ #
1907
+ # @overload create_template_version(parent: nil, template_version_id: nil, template_version: nil, request_id: nil)
1908
+ # Pass arguments to `create_template_version` via keyword arguments. Note that at
1909
+ # least one keyword argument is required. To specify no parameters, or to keep all
1910
+ # the default parameter values, pass an empty Hash as a request object (see above).
1911
+ #
1912
+ # @param parent [::String]
1913
+ # Required. Value for parent in the format
1914
+ # `projects/*/locations/*/templates/*`.
1915
+ # @param template_version_id [::String]
1916
+ # Required. Id of the TemplateVersion resource
1917
+ # @param template_version [::Google::Cloud::ParameterManager::V1::TemplateVersion, ::Hash]
1918
+ # Required. The TemplateVersion resource being created
1919
+ # @param request_id [::String]
1920
+ # Optional. An optional request ID to identify requests. Specify a unique
1921
+ # request ID so that if you must retry your request, the server will know to
1922
+ # ignore the request if it has already been completed. The server will
1923
+ # guarantee that for at least 60 minutes since the first request.
1924
+ #
1925
+ # For example, consider a situation where you make an initial request and the
1926
+ # request times out. If you make the request again with the same request
1927
+ # ID, the server can check if original operation with the same request ID
1928
+ # was received, and if so, will ignore the second request. This prevents
1929
+ # clients from accidentally creating duplicate commitments.
1930
+ #
1931
+ # The request ID must be a valid UUID with the exception that zero UUID is
1932
+ # not supported (00000000-0000-0000-0000-000000000000).
1933
+ # @yield [result, operation] Access the result along with the TransportOperation object
1934
+ # @yieldparam result [::Google::Cloud::ParameterManager::V1::TemplateVersion]
1935
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1936
+ #
1937
+ # @return [::Google::Cloud::ParameterManager::V1::TemplateVersion]
1938
+ #
1939
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1940
+ #
1941
+ # @example Basic example
1942
+ # require "google/cloud/parameter_manager/v1"
1943
+ #
1944
+ # # Create a client object. The client can be reused for multiple calls.
1945
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
1946
+ #
1947
+ # # Create a request. To set request fields, pass in keyword arguments.
1948
+ # request = Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest.new
1949
+ #
1950
+ # # Call the create_template_version method.
1951
+ # result = client.create_template_version request
1952
+ #
1953
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::TemplateVersion.
1954
+ # p result
1955
+ #
1956
+ def create_template_version request, options = nil
1957
+ raise ::ArgumentError, "request must be provided" if request.nil?
1958
+
1959
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest
1960
+
1961
+ # Converts hash and nil to an options object
1962
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1963
+
1964
+ # Customize the options with defaults
1965
+ call_metadata = @config.rpcs.create_template_version.metadata.to_h
1966
+
1967
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1968
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1969
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1970
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
1971
+ transports_version_send: [:rest]
1972
+
1973
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1974
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1975
+
1976
+ options.apply_defaults timeout: @config.rpcs.create_template_version.timeout,
1977
+ metadata: call_metadata,
1978
+ retry_policy: @config.rpcs.create_template_version.retry_policy
1979
+
1980
+ options.apply_defaults timeout: @config.timeout,
1981
+ metadata: @config.metadata,
1982
+ retry_policy: @config.retry_policy
1983
+
1984
+ @parameter_manager_stub.create_template_version request, options do |result, operation|
1985
+ yield result, operation if block_given?
1986
+ end
1987
+ rescue ::Gapic::Rest::Error => e
1988
+ raise ::Google::Cloud::Error.from_error(e)
1989
+ end
1990
+
1991
+ ##
1992
+ # Updates a single TemplateVersion.
1993
+ #
1994
+ # @overload update_template_version(request, options = nil)
1995
+ # Pass arguments to `update_template_version` via a request object, either of type
1996
+ # {::Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest} or an equivalent Hash.
1997
+ #
1998
+ # @param request [::Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest, ::Hash]
1999
+ # A request object representing the call parameters. Required. To specify no
2000
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2001
+ # @param options [::Gapic::CallOptions, ::Hash]
2002
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2003
+ #
2004
+ # @overload update_template_version(update_mask: nil, template_version: nil, request_id: nil)
2005
+ # Pass arguments to `update_template_version` via keyword arguments. Note that at
2006
+ # least one keyword argument is required. To specify no parameters, or to keep all
2007
+ # the default parameter values, pass an empty Hash as a request object (see above).
2008
+ #
2009
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2010
+ # Optional. Field mask is used to specify the fields to be overwritten in the
2011
+ # TemplateVersion resource by the update.
2012
+ # The fields specified in the update_mask are relative to the resource, not
2013
+ # the full request. A mutable field will be overwritten if it is in the
2014
+ # mask. If the user does not provide a mask then all mutable fields present
2015
+ # in the request will be overwritten.
2016
+ # @param template_version [::Google::Cloud::ParameterManager::V1::TemplateVersion, ::Hash]
2017
+ # Required. The TemplateVersion resource being updated
2018
+ # @param request_id [::String]
2019
+ # Optional. An optional request ID to identify requests. Specify a unique
2020
+ # request ID so that if you must retry your request, the server will know to
2021
+ # ignore the request if it has already been completed. The server will
2022
+ # guarantee that for at least 60 minutes since the first request.
2023
+ #
2024
+ # For example, consider a situation where you make an initial request and the
2025
+ # request times out. If you make the request again with the same request
2026
+ # ID, the server can check if original operation with the same request ID
2027
+ # was received, and if so, will ignore the second request. This prevents
2028
+ # clients from accidentally creating duplicate commitments.
2029
+ #
2030
+ # The request ID must be a valid UUID with the exception that zero UUID is
2031
+ # not supported (00000000-0000-0000-0000-000000000000).
2032
+ # @yield [result, operation] Access the result along with the TransportOperation object
2033
+ # @yieldparam result [::Google::Cloud::ParameterManager::V1::TemplateVersion]
2034
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2035
+ #
2036
+ # @return [::Google::Cloud::ParameterManager::V1::TemplateVersion]
2037
+ #
2038
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2039
+ #
2040
+ # @example Basic example
2041
+ # require "google/cloud/parameter_manager/v1"
2042
+ #
2043
+ # # Create a client object. The client can be reused for multiple calls.
2044
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
2045
+ #
2046
+ # # Create a request. To set request fields, pass in keyword arguments.
2047
+ # request = Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest.new
2048
+ #
2049
+ # # Call the update_template_version method.
2050
+ # result = client.update_template_version request
2051
+ #
2052
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::TemplateVersion.
2053
+ # p result
2054
+ #
2055
+ def update_template_version request, options = nil
2056
+ raise ::ArgumentError, "request must be provided" if request.nil?
2057
+
2058
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest
2059
+
2060
+ # Converts hash and nil to an options object
2061
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2062
+
2063
+ # Customize the options with defaults
2064
+ call_metadata = @config.rpcs.update_template_version.metadata.to_h
2065
+
2066
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2067
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2068
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2069
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
2070
+ transports_version_send: [:rest]
2071
+
2072
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2073
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2074
+
2075
+ options.apply_defaults timeout: @config.rpcs.update_template_version.timeout,
2076
+ metadata: call_metadata,
2077
+ retry_policy: @config.rpcs.update_template_version.retry_policy
2078
+
2079
+ options.apply_defaults timeout: @config.timeout,
2080
+ metadata: @config.metadata,
2081
+ retry_policy: @config.retry_policy
2082
+
2083
+ @parameter_manager_stub.update_template_version request, options do |result, operation|
2084
+ yield result, operation if block_given?
2085
+ end
2086
+ rescue ::Gapic::Rest::Error => e
2087
+ raise ::Google::Cloud::Error.from_error(e)
2088
+ end
2089
+
2090
+ ##
2091
+ # Deletes a single TemplateVersion.
2092
+ #
2093
+ # @overload delete_template_version(request, options = nil)
2094
+ # Pass arguments to `delete_template_version` via a request object, either of type
2095
+ # {::Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest} or an equivalent Hash.
2096
+ #
2097
+ # @param request [::Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest, ::Hash]
2098
+ # A request object representing the call parameters. Required. To specify no
2099
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2100
+ # @param options [::Gapic::CallOptions, ::Hash]
2101
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2102
+ #
2103
+ # @overload delete_template_version(name: nil, request_id: nil)
2104
+ # Pass arguments to `delete_template_version` via keyword arguments. Note that at
2105
+ # least one keyword argument is required. To specify no parameters, or to keep all
2106
+ # the default parameter values, pass an empty Hash as a request object (see above).
2107
+ #
2108
+ # @param name [::String]
2109
+ # Required. Name of the resource in the format
2110
+ # `projects/*/locations/*/templates/*/versions/*`.
2111
+ # @param request_id [::String]
2112
+ # Optional. An optional request ID to identify requests. Specify a unique
2113
+ # request ID so that if you must retry your request, the server will know to
2114
+ # ignore the request if it has already been completed. The server will
2115
+ # guarantee that for at least 60 minutes after the first request.
2116
+ #
2117
+ # For example, consider a situation where you make an initial request and the
2118
+ # request times out. If you make the request again with the same request
2119
+ # ID, the server can check if original operation with the same request ID
2120
+ # was received, and if so, will ignore the second request. This prevents
2121
+ # clients from accidentally creating duplicate commitments.
2122
+ #
2123
+ # The request ID must be a valid UUID with the exception that zero UUID is
2124
+ # not supported (00000000-0000-0000-0000-000000000000).
2125
+ # @yield [result, operation] Access the result along with the TransportOperation object
2126
+ # @yieldparam result [::Google::Protobuf::Empty]
2127
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2128
+ #
2129
+ # @return [::Google::Protobuf::Empty]
2130
+ #
2131
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2132
+ #
2133
+ # @example Basic example
2134
+ # require "google/cloud/parameter_manager/v1"
2135
+ #
2136
+ # # Create a client object. The client can be reused for multiple calls.
2137
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
2138
+ #
2139
+ # # Create a request. To set request fields, pass in keyword arguments.
2140
+ # request = Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest.new
2141
+ #
2142
+ # # Call the delete_template_version method.
2143
+ # result = client.delete_template_version request
2144
+ #
2145
+ # # The returned object is of type Google::Protobuf::Empty.
2146
+ # p result
2147
+ #
2148
+ def delete_template_version request, options = nil
2149
+ raise ::ArgumentError, "request must be provided" if request.nil?
2150
+
2151
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest
2152
+
2153
+ # Converts hash and nil to an options object
2154
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2155
+
2156
+ # Customize the options with defaults
2157
+ call_metadata = @config.rpcs.delete_template_version.metadata.to_h
2158
+
2159
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2160
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2161
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2162
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
2163
+ transports_version_send: [:rest]
2164
+
2165
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2166
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2167
+
2168
+ options.apply_defaults timeout: @config.rpcs.delete_template_version.timeout,
2169
+ metadata: call_metadata,
2170
+ retry_policy: @config.rpcs.delete_template_version.retry_policy
2171
+
2172
+ options.apply_defaults timeout: @config.timeout,
2173
+ metadata: @config.metadata,
2174
+ retry_policy: @config.retry_policy
2175
+
2176
+ @parameter_manager_stub.delete_template_version request, options do |result, operation|
2177
+ yield result, operation if block_given?
2178
+ end
2179
+ rescue ::Gapic::Rest::Error => e
2180
+ raise ::Google::Cloud::Error.from_error(e)
2181
+ end
2182
+
2183
+ ##
2184
+ # Gets rendered version of a TemplateVersion.
2185
+ #
2186
+ # @overload render_template_version(request, options = nil)
2187
+ # Pass arguments to `render_template_version` via a request object, either of type
2188
+ # {::Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest} or an equivalent Hash.
2189
+ #
2190
+ # @param request [::Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest, ::Hash]
2191
+ # A request object representing the call parameters. Required. To specify no
2192
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2193
+ # @param options [::Gapic::CallOptions, ::Hash]
2194
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2195
+ #
2196
+ # @overload render_template_version(name: nil, parameter_version: nil)
2197
+ # Pass arguments to `render_template_version` via keyword arguments. Note that at
2198
+ # least one keyword argument is required. To specify no parameters, or to keep all
2199
+ # the default parameter values, pass an empty Hash as a request object (see above).
2200
+ #
2201
+ # @param name [::String]
2202
+ # Required. Name of the resource
2203
+ # @param parameter_version [::String]
2204
+ # Required. Parameter version used to render the template version.
2205
+ # @yield [result, operation] Access the result along with the TransportOperation object
2206
+ # @yieldparam result [::Google::Cloud::ParameterManager::V1::RenderTemplateVersionResponse]
2207
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2208
+ #
2209
+ # @return [::Google::Cloud::ParameterManager::V1::RenderTemplateVersionResponse]
2210
+ #
2211
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2212
+ #
2213
+ # @example Basic example
2214
+ # require "google/cloud/parameter_manager/v1"
2215
+ #
2216
+ # # Create a client object. The client can be reused for multiple calls.
2217
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new
2218
+ #
2219
+ # # Create a request. To set request fields, pass in keyword arguments.
2220
+ # request = Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest.new
2221
+ #
2222
+ # # Call the render_template_version method.
2223
+ # result = client.render_template_version request
2224
+ #
2225
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::RenderTemplateVersionResponse.
2226
+ # p result
2227
+ #
2228
+ def render_template_version request, options = nil
2229
+ raise ::ArgumentError, "request must be provided" if request.nil?
2230
+
2231
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest
2232
+
2233
+ # Converts hash and nil to an options object
2234
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2235
+
2236
+ # Customize the options with defaults
2237
+ call_metadata = @config.rpcs.render_template_version.metadata.to_h
2238
+
2239
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2240
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2241
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2242
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION,
2243
+ transports_version_send: [:rest]
2244
+
2245
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2246
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2247
+
2248
+ options.apply_defaults timeout: @config.rpcs.render_template_version.timeout,
2249
+ metadata: call_metadata,
2250
+ retry_policy: @config.rpcs.render_template_version.retry_policy
2251
+
2252
+ options.apply_defaults timeout: @config.timeout,
2253
+ metadata: @config.metadata,
2254
+ retry_policy: @config.retry_policy
2255
+
2256
+ @parameter_manager_stub.render_template_version request, options do |result, operation|
2257
+ yield result, operation if block_given?
2258
+ end
2259
+ rescue ::Gapic::Rest::Error => e
2260
+ raise ::Google::Cloud::Error.from_error(e)
2261
+ end
2262
+
2263
+ ##
2264
+ # Configuration class for the ParameterManager REST API.
2265
+ #
2266
+ # This class represents the configuration for ParameterManager REST,
2267
+ # providing control over timeouts, retry behavior, logging, transport
2268
+ # parameters, and other low-level controls. Certain parameters can also be
2269
+ # applied individually to specific RPCs. See
2270
+ # {::Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client::Configuration::Rpcs}
2271
+ # for a list of RPCs that can be configured independently.
2272
+ #
2273
+ # Configuration can be applied globally to all clients, or to a single client
2274
+ # on construction.
2275
+ #
2276
+ # @example
2277
+ #
2278
+ # # Modify the global config, setting the timeout for
2279
+ # # list_parameters to 20 seconds,
2280
+ # # and all remaining timeouts to 10 seconds.
2281
+ # ::Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.configure do |config|
2282
+ # config.timeout = 10.0
2283
+ # config.rpcs.list_parameters.timeout = 20.0
2284
+ # end
2285
+ #
2286
+ # # Apply the above configuration only to a new client.
2287
+ # client = ::Google::Cloud::ParameterManager::V1::ParameterManager::Rest::Client.new do |config|
2288
+ # config.timeout = 10.0
2289
+ # config.rpcs.list_parameters.timeout = 20.0
2290
+ # end
2291
+ #
2292
+ # @!attribute [rw] endpoint
2293
+ # A custom service endpoint, as a hostname or hostname:port. The default is
2294
+ # nil, indicating to use the default endpoint in the current universe domain.
2295
+ # @return [::String,nil]
2296
+ # @!attribute [rw] credentials
2297
+ # Credentials to send with calls. You may provide any of the following types:
2298
+ # * (`String`) The path to a service account key file in JSON format
2299
+ # * (`Hash`) A service account key as a Hash
2300
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
2301
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2302
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2303
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2304
+ # * (`nil`) indicating no credentials
2305
+ #
2306
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
2307
+ # external source for authentication to Google Cloud, you must validate it before
2308
+ # providing it to a Google API client library. Providing an unvalidated credential
2309
+ # configuration to Google APIs can compromise the security of your systems and data.
2310
+ # For more information, refer to [Validate credential configurations from external
2311
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
2312
+ # @return [::Object]
2313
+ # @!attribute [rw] scope
2314
+ # The OAuth scopes
2315
+ # @return [::Array<::String>]
2316
+ # @!attribute [rw] lib_name
2317
+ # The library name as recorded in instrumentation and logging
2318
+ # @return [::String]
2319
+ # @!attribute [rw] lib_version
2320
+ # The library version as recorded in instrumentation and logging
2321
+ # @return [::String]
2322
+ # @!attribute [rw] timeout
2323
+ # The call timeout in seconds.
2324
+ # @return [::Numeric]
2325
+ # @!attribute [rw] metadata
2326
+ # Additional headers to be sent with the call.
2327
+ # @return [::Hash{::Symbol=>::String}]
2328
+ # @!attribute [rw] retry_policy
2329
+ # The retry policy. The value is a hash with the following keys:
2330
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
2331
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
2332
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
2333
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
2334
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
2335
+ # trigger a retry.
2336
+ # @return [::Hash]
2337
+ # @!attribute [rw] quota_project
2338
+ # A separate project against which to charge quota.
2339
+ # @return [::String]
2340
+ # @!attribute [rw] universe_domain
2341
+ # The universe domain within which to make requests. This determines the
2342
+ # default endpoint URL. The default value of nil uses the environment
2343
+ # universe (usually the default "googleapis.com" universe).
2344
+ # @return [::String,nil]
2345
+ # @!attribute [rw] logger
2346
+ # A custom logger to use for request/response debug logging, or the value
2347
+ # `:default` (the default) to construct a default logger, or `nil` to
2348
+ # explicitly disable logging.
2349
+ # @return [::Logger,:default,nil]
2350
+ #
2351
+ class Configuration
2352
+ extend ::Gapic::Config
2353
+
2354
+ # @private
2355
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
2356
+ DEFAULT_ENDPOINT = "parametermanager.googleapis.com"
2357
+
2358
+ config_attr :endpoint, nil, ::String, nil
2359
+ config_attr :credentials, nil do |value|
2360
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
2361
+ allowed.any? { |klass| klass === value }
2362
+ end
2363
+ config_attr :scope, nil, ::String, ::Array, nil
2364
+ config_attr :lib_name, nil, ::String, nil
2365
+ config_attr :lib_version, nil, ::String, nil
2366
+ config_attr :timeout, nil, ::Numeric, nil
2367
+ config_attr :metadata, nil, ::Hash, nil
2368
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2369
+ config_attr :quota_project, nil, ::String, nil
2370
+ config_attr :universe_domain, nil, ::String, nil
2371
+
2372
+ # @private
2373
+ # Overrides for http bindings for the RPCs of this service
2374
+ # are only used when this service is used as mixin, and only
2375
+ # by the host service.
2376
+ # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
2377
+ config_attr :bindings_override, {}, ::Hash, nil
2378
+ config_attr :logger, :default, ::Logger, nil, :default
2379
+
2380
+ # @private
2381
+ def initialize parent_config = nil
2382
+ @parent_config = parent_config unless parent_config.nil?
2383
+
2384
+ yield self if block_given?
2385
+ end
2386
+
2387
+ ##
2388
+ # Configurations for individual RPCs
2389
+ # @return [Rpcs]
2390
+ #
2391
+ def rpcs
2392
+ @rpcs ||= begin
2393
+ parent_rpcs = nil
2394
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
2395
+ Rpcs.new parent_rpcs
2396
+ end
2397
+ end
2398
+
2399
+ ##
2400
+ # Configuration RPC class for the ParameterManager API.
2401
+ #
2402
+ # Includes fields providing the configuration for each RPC in this service.
2403
+ # Each configuration object is of type `Gapic::Config::Method` and includes
2404
+ # the following configuration fields:
2405
+ #
2406
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
2407
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
2408
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
2409
+ # include the following keys:
2410
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
2411
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
2412
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
2413
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
2414
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
2415
+ # trigger a retry.
2416
+ #
2417
+ class Rpcs
2418
+ ##
2419
+ # RPC-specific configuration for `list_parameters`
2420
+ # @return [::Gapic::Config::Method]
1397
2421
  #
1398
2422
  attr_reader :list_parameters
1399
2423
  ##
@@ -1446,6 +2470,61 @@ module Google
1446
2470
  # @return [::Gapic::Config::Method]
1447
2471
  #
1448
2472
  attr_reader :delete_parameter_version
2473
+ ##
2474
+ # RPC-specific configuration for `list_templates`
2475
+ # @return [::Gapic::Config::Method]
2476
+ #
2477
+ attr_reader :list_templates
2478
+ ##
2479
+ # RPC-specific configuration for `get_template`
2480
+ # @return [::Gapic::Config::Method]
2481
+ #
2482
+ attr_reader :get_template
2483
+ ##
2484
+ # RPC-specific configuration for `create_template`
2485
+ # @return [::Gapic::Config::Method]
2486
+ #
2487
+ attr_reader :create_template
2488
+ ##
2489
+ # RPC-specific configuration for `update_template`
2490
+ # @return [::Gapic::Config::Method]
2491
+ #
2492
+ attr_reader :update_template
2493
+ ##
2494
+ # RPC-specific configuration for `delete_template`
2495
+ # @return [::Gapic::Config::Method]
2496
+ #
2497
+ attr_reader :delete_template
2498
+ ##
2499
+ # RPC-specific configuration for `list_template_versions`
2500
+ # @return [::Gapic::Config::Method]
2501
+ #
2502
+ attr_reader :list_template_versions
2503
+ ##
2504
+ # RPC-specific configuration for `get_template_version`
2505
+ # @return [::Gapic::Config::Method]
2506
+ #
2507
+ attr_reader :get_template_version
2508
+ ##
2509
+ # RPC-specific configuration for `create_template_version`
2510
+ # @return [::Gapic::Config::Method]
2511
+ #
2512
+ attr_reader :create_template_version
2513
+ ##
2514
+ # RPC-specific configuration for `update_template_version`
2515
+ # @return [::Gapic::Config::Method]
2516
+ #
2517
+ attr_reader :update_template_version
2518
+ ##
2519
+ # RPC-specific configuration for `delete_template_version`
2520
+ # @return [::Gapic::Config::Method]
2521
+ #
2522
+ attr_reader :delete_template_version
2523
+ ##
2524
+ # RPC-specific configuration for `render_template_version`
2525
+ # @return [::Gapic::Config::Method]
2526
+ #
2527
+ attr_reader :render_template_version
1449
2528
 
1450
2529
  # @private
1451
2530
  def initialize parent_rpcs = nil
@@ -1471,6 +2550,28 @@ module Google
1471
2550
  @update_parameter_version = ::Gapic::Config::Method.new update_parameter_version_config
1472
2551
  delete_parameter_version_config = parent_rpcs.delete_parameter_version if parent_rpcs.respond_to? :delete_parameter_version
1473
2552
  @delete_parameter_version = ::Gapic::Config::Method.new delete_parameter_version_config
2553
+ list_templates_config = parent_rpcs.list_templates if parent_rpcs.respond_to? :list_templates
2554
+ @list_templates = ::Gapic::Config::Method.new list_templates_config
2555
+ get_template_config = parent_rpcs.get_template if parent_rpcs.respond_to? :get_template
2556
+ @get_template = ::Gapic::Config::Method.new get_template_config
2557
+ create_template_config = parent_rpcs.create_template if parent_rpcs.respond_to? :create_template
2558
+ @create_template = ::Gapic::Config::Method.new create_template_config
2559
+ update_template_config = parent_rpcs.update_template if parent_rpcs.respond_to? :update_template
2560
+ @update_template = ::Gapic::Config::Method.new update_template_config
2561
+ delete_template_config = parent_rpcs.delete_template if parent_rpcs.respond_to? :delete_template
2562
+ @delete_template = ::Gapic::Config::Method.new delete_template_config
2563
+ list_template_versions_config = parent_rpcs.list_template_versions if parent_rpcs.respond_to? :list_template_versions
2564
+ @list_template_versions = ::Gapic::Config::Method.new list_template_versions_config
2565
+ get_template_version_config = parent_rpcs.get_template_version if parent_rpcs.respond_to? :get_template_version
2566
+ @get_template_version = ::Gapic::Config::Method.new get_template_version_config
2567
+ create_template_version_config = parent_rpcs.create_template_version if parent_rpcs.respond_to? :create_template_version
2568
+ @create_template_version = ::Gapic::Config::Method.new create_template_version_config
2569
+ update_template_version_config = parent_rpcs.update_template_version if parent_rpcs.respond_to? :update_template_version
2570
+ @update_template_version = ::Gapic::Config::Method.new update_template_version_config
2571
+ delete_template_version_config = parent_rpcs.delete_template_version if parent_rpcs.respond_to? :delete_template_version
2572
+ @delete_template_version = ::Gapic::Config::Method.new delete_template_version_config
2573
+ render_template_version_config = parent_rpcs.render_template_version if parent_rpcs.respond_to? :render_template_version
2574
+ @render_template_version = ::Gapic::Config::Method.new render_template_version_config
1474
2575
 
1475
2576
  yield self if block_given?
1476
2577
  end