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.
@@ -261,7 +261,11 @@ module Google
261
261
  # Optional. Requested page size. Server may return fewer items than
262
262
  # requested. If unspecified, server will pick an appropriate default.
263
263
  # @param page_token [::String]
264
- # Optional. A token identifying a page of results the server should return.
264
+ # Optional. A page token, received from a previous `ListParameters` call.
265
+ # Provide this to retrieve the subsequent page.
266
+ #
267
+ # When paginating, all other parameters provided to `ListParameters` must
268
+ # match the call that provided the page token.
265
269
  # @param filter [::String]
266
270
  # Optional. Filtering results
267
271
  # @param order_by [::String]
@@ -758,7 +762,11 @@ module Google
758
762
  # Optional. Requested page size. Server may return fewer items than
759
763
  # requested. If unspecified, server will pick an appropriate default.
760
764
  # @param page_token [::String]
761
- # Optional. A token identifying a page of results the server should return.
765
+ # Optional. A page token, received from a previous `ListParameterVersions`
766
+ # call. Provide this to retrieve the subsequent page.
767
+ #
768
+ # When paginating, all other parameters provided to `ListParameterVersions`
769
+ # must match the call that provided the page token.
762
770
  # @param filter [::String]
763
771
  # Optional. Filtering results
764
772
  # @param order_by [::String]
@@ -1320,178 +1328,1271 @@ module Google
1320
1328
  end
1321
1329
 
1322
1330
  ##
1323
- # Configuration class for the ParameterManager API.
1331
+ # Lists Templates in a given project and location.
1324
1332
  #
1325
- # This class represents the configuration for ParameterManager,
1326
- # providing control over timeouts, retry behavior, logging, transport
1327
- # parameters, and other low-level controls. Certain parameters can also be
1328
- # applied individually to specific RPCs. See
1329
- # {::Google::Cloud::ParameterManager::V1::ParameterManager::Client::Configuration::Rpcs}
1330
- # for a list of RPCs that can be configured independently.
1333
+ # @overload list_templates(request, options = nil)
1334
+ # Pass arguments to `list_templates` via a request object, either of type
1335
+ # {::Google::Cloud::ParameterManager::V1::ListTemplatesRequest} or an equivalent Hash.
1331
1336
  #
1332
- # Configuration can be applied globally to all clients, or to a single client
1333
- # on construction.
1337
+ # @param request [::Google::Cloud::ParameterManager::V1::ListTemplatesRequest, ::Hash]
1338
+ # A request object representing the call parameters. Required. To specify no
1339
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1340
+ # @param options [::Gapic::CallOptions, ::Hash]
1341
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1334
1342
  #
1335
- # @example
1343
+ # @overload list_templates(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1344
+ # Pass arguments to `list_templates` via keyword arguments. Note that at
1345
+ # least one keyword argument is required. To specify no parameters, or to keep all
1346
+ # the default parameter values, pass an empty Hash as a request object (see above).
1336
1347
  #
1337
- # # Modify the global config, setting the timeout for
1338
- # # list_parameters to 20 seconds,
1339
- # # and all remaining timeouts to 10 seconds.
1340
- # ::Google::Cloud::ParameterManager::V1::ParameterManager::Client.configure do |config|
1341
- # config.timeout = 10.0
1342
- # config.rpcs.list_parameters.timeout = 20.0
1343
- # end
1348
+ # @param parent [::String]
1349
+ # Required. Parent value for ListTemplatesRequest in the format
1350
+ # `projects/*/locations/*`.
1351
+ # @param page_size [::Integer]
1352
+ # Optional. Requested page size. Server may return fewer items than
1353
+ # requested. If unspecified, server will pick an appropriate default.
1354
+ # @param page_token [::String]
1355
+ # Optional. A page token, received from a previous `ListTemplates` call.
1356
+ # Provide this to retrieve the subsequent page.
1344
1357
  #
1345
- # # Apply the above configuration only to a new client.
1346
- # client = ::Google::Cloud::ParameterManager::V1::ParameterManager::Client.new do |config|
1347
- # config.timeout = 10.0
1348
- # config.rpcs.list_parameters.timeout = 20.0
1349
- # end
1358
+ # When paginating, all other parameters provided to `ListTemplates` must
1359
+ # match the call that provided the page token.
1360
+ # @param filter [::String]
1361
+ # Optional. Filtering results
1362
+ # @param order_by [::String]
1363
+ # Optional. Hint for how to order the results
1350
1364
  #
1351
- # @!attribute [rw] endpoint
1352
- # A custom service endpoint, as a hostname or hostname:port. The default is
1353
- # nil, indicating to use the default endpoint in the current universe domain.
1354
- # @return [::String,nil]
1355
- # @!attribute [rw] credentials
1356
- # Credentials to send with calls. You may provide any of the following types:
1357
- # * (`Google::Auth::Credentials`) A googleauth credentials object
1358
- # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1359
- # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1360
- # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1361
- # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1362
- # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1363
- # * (`nil`) indicating no credentials
1365
+ # @yield [response, operation] Access the result along with the RPC operation
1366
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ParameterManager::V1::Template>]
1367
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1364
1368
  #
1365
- # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
1366
- # is deprecated. Providing an unvalidated credential configuration to
1367
- # Google APIs can compromise the security of your systems and data.
1369
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::ParameterManager::V1::Template>]
1368
1370
  #
1369
- # @example
1371
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1370
1372
  #
1371
- # # The recommended way to provide credentials is to use the `make_creds` method
1372
- # # on the appropriate credentials class for your environment.
1373
+ # @example Basic example
1374
+ # require "google/cloud/parameter_manager/v1"
1373
1375
  #
1374
- # require "googleauth"
1376
+ # # Create a client object. The client can be reused for multiple calls.
1377
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
1375
1378
  #
1376
- # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
1377
- # json_key_io: ::File.open("/path/to/keyfile.json")
1378
- # )
1379
+ # # Create a request. To set request fields, pass in keyword arguments.
1380
+ # request = Google::Cloud::ParameterManager::V1::ListTemplatesRequest.new
1379
1381
  #
1380
- # client = ::Google::Cloud::ParameterManager::V1::ParameterManager::Client.new do |config|
1381
- # config.credentials = credentials
1382
- # end
1382
+ # # Call the list_templates method.
1383
+ # result = client.list_templates request
1383
1384
  #
1384
- # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
1385
- # external source for authentication to Google Cloud, you must validate it before
1386
- # providing it to a Google API client library. Providing an unvalidated credential
1387
- # configuration to Google APIs can compromise the security of your systems and data.
1388
- # For more information, refer to [Validate credential configurations from external
1389
- # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1390
- # @return [::Object]
1391
- # @!attribute [rw] scope
1392
- # The OAuth scopes
1393
- # @return [::Array<::String>]
1394
- # @!attribute [rw] lib_name
1395
- # The library name as recorded in instrumentation and logging
1396
- # @return [::String]
1397
- # @!attribute [rw] lib_version
1398
- # The library version as recorded in instrumentation and logging
1399
- # @return [::String]
1400
- # @!attribute [rw] channel_args
1401
- # Extra parameters passed to the gRPC channel. Note: this is ignored if a
1402
- # `GRPC::Core::Channel` object is provided as the credential.
1403
- # @return [::Hash]
1404
- # @!attribute [rw] interceptors
1405
- # An array of interceptors that are run before calls are executed.
1406
- # @return [::Array<::GRPC::ClientInterceptor>]
1407
- # @!attribute [rw] timeout
1408
- # The call timeout in seconds.
1409
- # @return [::Numeric]
1410
- # @!attribute [rw] metadata
1411
- # Additional gRPC headers to be sent with the call.
1412
- # @return [::Hash{::Symbol=>::String}]
1413
- # @!attribute [rw] retry_policy
1414
- # The retry policy. The value is a hash with the following keys:
1415
- # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1416
- # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1417
- # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1418
- # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
1419
- # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1420
- # trigger a retry.
1421
- # @return [::Hash]
1422
- # @!attribute [rw] quota_project
1423
- # A separate project against which to charge quota.
1424
- # @return [::String]
1425
- # @!attribute [rw] universe_domain
1426
- # The universe domain within which to make requests. This determines the
1427
- # default endpoint URL. The default value of nil uses the environment
1428
- # universe (usually the default "googleapis.com" universe).
1429
- # @return [::String,nil]
1430
- # @!attribute [rw] logger
1431
- # A custom logger to use for request/response debug logging, or the value
1432
- # `:default` (the default) to construct a default logger, or `nil` to
1433
- # explicitly disable logging.
1434
- # @return [::Logger,:default,nil]
1385
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1386
+ # # over elements, and API calls will be issued to fetch pages as needed.
1387
+ # result.each do |item|
1388
+ # # Each element is of type ::Google::Cloud::ParameterManager::V1::Template.
1389
+ # p item
1390
+ # end
1435
1391
  #
1436
- class Configuration
1437
- extend ::Gapic::Config
1392
+ def list_templates request, options = nil
1393
+ raise ::ArgumentError, "request must be provided" if request.nil?
1438
1394
 
1439
- # @private
1440
- # The endpoint specific to the default "googleapis.com" universe. Deprecated.
1441
- DEFAULT_ENDPOINT = "parametermanager.googleapis.com"
1395
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::ListTemplatesRequest
1442
1396
 
1443
- config_attr :endpoint, nil, ::String, nil
1444
- config_attr :credentials, nil do |value|
1445
- allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
1446
- allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC::Core::Channel
1447
- allowed.any? { |klass| klass === value }
1448
- end
1449
- config_attr :scope, nil, ::String, ::Array, nil
1450
- config_attr :lib_name, nil, ::String, nil
1451
- config_attr :lib_version, nil, ::String, nil
1452
- config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
1453
- config_attr :interceptors, nil, ::Array, nil
1454
- config_attr :timeout, nil, ::Numeric, nil
1455
- config_attr :metadata, nil, ::Hash, nil
1456
- config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1457
- config_attr :quota_project, nil, ::String, nil
1458
- config_attr :universe_domain, nil, ::String, nil
1459
- config_attr :logger, :default, ::Logger, nil, :default
1397
+ # Converts hash and nil to an options object
1398
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1460
1399
 
1461
- # @private
1462
- def initialize parent_config = nil
1463
- @parent_config = parent_config unless parent_config.nil?
1400
+ # Customize the options with defaults
1401
+ metadata = @config.rpcs.list_templates.metadata.to_h
1464
1402
 
1465
- yield self if block_given?
1403
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1404
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1405
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1406
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
1407
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1408
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1409
+
1410
+ header_params = {}
1411
+ if request.parent
1412
+ header_params["parent"] = request.parent
1466
1413
  end
1467
1414
 
1468
- ##
1469
- # Configurations for individual RPCs
1470
- # @return [Rpcs]
1471
- #
1472
- def rpcs
1473
- @rpcs ||= begin
1474
- parent_rpcs = nil
1475
- parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
1476
- Rpcs.new parent_rpcs
1477
- end
1415
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1416
+ metadata[:"x-goog-request-params"] ||= request_params_header
1417
+
1418
+ options.apply_defaults timeout: @config.rpcs.list_templates.timeout,
1419
+ metadata: metadata,
1420
+ retry_policy: @config.rpcs.list_templates.retry_policy
1421
+
1422
+ options.apply_defaults timeout: @config.timeout,
1423
+ metadata: @config.metadata,
1424
+ retry_policy: @config.retry_policy
1425
+
1426
+ @parameter_manager_stub.call_rpc :list_templates, request, options: options do |response, operation|
1427
+ response = ::Gapic::PagedEnumerable.new @parameter_manager_stub, :list_templates, request, response, operation, options
1428
+ yield response, operation if block_given?
1429
+ throw :response, response
1478
1430
  end
1431
+ rescue ::GRPC::BadStatus => e
1432
+ raise ::Google::Cloud::Error.from_error(e)
1433
+ end
1479
1434
 
1480
- ##
1481
- # Configuration for the channel pool
1482
- # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
1483
- #
1484
- def channel_pool
1485
- @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
1435
+ ##
1436
+ # Gets details of a single Template.
1437
+ #
1438
+ # @overload get_template(request, options = nil)
1439
+ # Pass arguments to `get_template` via a request object, either of type
1440
+ # {::Google::Cloud::ParameterManager::V1::GetTemplateRequest} or an equivalent Hash.
1441
+ #
1442
+ # @param request [::Google::Cloud::ParameterManager::V1::GetTemplateRequest, ::Hash]
1443
+ # A request object representing the call parameters. Required. To specify no
1444
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1445
+ # @param options [::Gapic::CallOptions, ::Hash]
1446
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1447
+ #
1448
+ # @overload get_template(name: nil)
1449
+ # Pass arguments to `get_template` via keyword arguments. Note that at
1450
+ # least one keyword argument is required. To specify no parameters, or to keep all
1451
+ # the default parameter values, pass an empty Hash as a request object (see above).
1452
+ #
1453
+ # @param name [::String]
1454
+ # Required. Name of the resource in the format
1455
+ # `projects/*/locations/*/templates/*`.
1456
+ #
1457
+ # @yield [response, operation] Access the result along with the RPC operation
1458
+ # @yieldparam response [::Google::Cloud::ParameterManager::V1::Template]
1459
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1460
+ #
1461
+ # @return [::Google::Cloud::ParameterManager::V1::Template]
1462
+ #
1463
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1464
+ #
1465
+ # @example Basic example
1466
+ # require "google/cloud/parameter_manager/v1"
1467
+ #
1468
+ # # Create a client object. The client can be reused for multiple calls.
1469
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
1470
+ #
1471
+ # # Create a request. To set request fields, pass in keyword arguments.
1472
+ # request = Google::Cloud::ParameterManager::V1::GetTemplateRequest.new
1473
+ #
1474
+ # # Call the get_template method.
1475
+ # result = client.get_template request
1476
+ #
1477
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::Template.
1478
+ # p result
1479
+ #
1480
+ def get_template request, options = nil
1481
+ raise ::ArgumentError, "request must be provided" if request.nil?
1482
+
1483
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::GetTemplateRequest
1484
+
1485
+ # Converts hash and nil to an options object
1486
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1487
+
1488
+ # Customize the options with defaults
1489
+ metadata = @config.rpcs.get_template.metadata.to_h
1490
+
1491
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1492
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1493
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1494
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
1495
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1496
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1497
+
1498
+ header_params = {}
1499
+ if request.name
1500
+ header_params["name"] = request.name
1486
1501
  end
1487
1502
 
1488
- ##
1489
- # Configuration RPC class for the ParameterManager API.
1490
- #
1491
- # Includes fields providing the configuration for each RPC in this service.
1492
- # Each configuration object is of type `Gapic::Config::Method` and includes
1493
- # the following configuration fields:
1494
- #
1503
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1504
+ metadata[:"x-goog-request-params"] ||= request_params_header
1505
+
1506
+ options.apply_defaults timeout: @config.rpcs.get_template.timeout,
1507
+ metadata: metadata,
1508
+ retry_policy: @config.rpcs.get_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.call_rpc :get_template, request, options: options do |response, operation|
1515
+ yield response, operation if block_given?
1516
+ end
1517
+ rescue ::GRPC::BadStatus => e
1518
+ raise ::Google::Cloud::Error.from_error(e)
1519
+ end
1520
+
1521
+ ##
1522
+ # Creates a new Template in a given project and location.
1523
+ #
1524
+ # @overload create_template(request, options = nil)
1525
+ # Pass arguments to `create_template` via a request object, either of type
1526
+ # {::Google::Cloud::ParameterManager::V1::CreateTemplateRequest} or an equivalent Hash.
1527
+ #
1528
+ # @param request [::Google::Cloud::ParameterManager::V1::CreateTemplateRequest, ::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 create_template(parent: nil, template_id: nil, template: nil, request_id: nil)
1535
+ # Pass arguments to `create_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 parent [::String]
1540
+ # Required. Value for parent in the format
1541
+ # `projects/*/locations/*`.
1542
+ # @param template_id [::String]
1543
+ # Required. Id of the Template resource
1544
+ # @param template [::Google::Cloud::ParameterManager::V1::Template, ::Hash]
1545
+ # Required. The Template resource being created
1546
+ # @param request_id [::String]
1547
+ # Optional. An optional request ID to identify requests. Specify a unique
1548
+ # request ID so that if you must retry your request, the server will know to
1549
+ # ignore the request if it has already been completed. The server will
1550
+ # guarantee that for at least 60 minutes since the first request.
1551
+ #
1552
+ # For example, consider a situation where you make an initial request and the
1553
+ # request times out. If you make the request again with the same request
1554
+ # ID, the server can check if original operation with the same request ID
1555
+ # was received, and if so, will ignore the second request. This prevents
1556
+ # clients from accidentally creating duplicate commitments.
1557
+ #
1558
+ # The request ID must be a valid UUID with the exception that zero UUID is
1559
+ # not supported (00000000-0000-0000-0000-000000000000).
1560
+ #
1561
+ # @yield [response, operation] Access the result along with the RPC operation
1562
+ # @yieldparam response [::Google::Cloud::ParameterManager::V1::Template]
1563
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1564
+ #
1565
+ # @return [::Google::Cloud::ParameterManager::V1::Template]
1566
+ #
1567
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1568
+ #
1569
+ # @example Basic example
1570
+ # require "google/cloud/parameter_manager/v1"
1571
+ #
1572
+ # # Create a client object. The client can be reused for multiple calls.
1573
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
1574
+ #
1575
+ # # Create a request. To set request fields, pass in keyword arguments.
1576
+ # request = Google::Cloud::ParameterManager::V1::CreateTemplateRequest.new
1577
+ #
1578
+ # # Call the create_template method.
1579
+ # result = client.create_template request
1580
+ #
1581
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::Template.
1582
+ # p result
1583
+ #
1584
+ def create_template request, options = nil
1585
+ raise ::ArgumentError, "request must be provided" if request.nil?
1586
+
1587
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::CreateTemplateRequest
1588
+
1589
+ # Converts hash and nil to an options object
1590
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1591
+
1592
+ # Customize the options with defaults
1593
+ metadata = @config.rpcs.create_template.metadata.to_h
1594
+
1595
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1596
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1597
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1598
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
1599
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1600
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1601
+
1602
+ header_params = {}
1603
+ if request.parent
1604
+ header_params["parent"] = request.parent
1605
+ end
1606
+
1607
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1608
+ metadata[:"x-goog-request-params"] ||= request_params_header
1609
+
1610
+ options.apply_defaults timeout: @config.rpcs.create_template.timeout,
1611
+ metadata: metadata,
1612
+ retry_policy: @config.rpcs.create_template.retry_policy
1613
+
1614
+ options.apply_defaults timeout: @config.timeout,
1615
+ metadata: @config.metadata,
1616
+ retry_policy: @config.retry_policy
1617
+
1618
+ @parameter_manager_stub.call_rpc :create_template, request, options: options do |response, operation|
1619
+ yield response, operation if block_given?
1620
+ end
1621
+ rescue ::GRPC::BadStatus => e
1622
+ raise ::Google::Cloud::Error.from_error(e)
1623
+ end
1624
+
1625
+ ##
1626
+ # Updates a single Template.
1627
+ #
1628
+ # @overload update_template(request, options = nil)
1629
+ # Pass arguments to `update_template` via a request object, either of type
1630
+ # {::Google::Cloud::ParameterManager::V1::UpdateTemplateRequest} or an equivalent Hash.
1631
+ #
1632
+ # @param request [::Google::Cloud::ParameterManager::V1::UpdateTemplateRequest, ::Hash]
1633
+ # A request object representing the call parameters. Required. To specify no
1634
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1635
+ # @param options [::Gapic::CallOptions, ::Hash]
1636
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1637
+ #
1638
+ # @overload update_template(update_mask: nil, template: nil, request_id: nil)
1639
+ # Pass arguments to `update_template` via keyword arguments. Note that at
1640
+ # least one keyword argument is required. To specify no parameters, or to keep all
1641
+ # the default parameter values, pass an empty Hash as a request object (see above).
1642
+ #
1643
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1644
+ # Optional. Field mask is used to specify the fields to be overwritten in the
1645
+ # Template resource by the update.
1646
+ # The fields specified in the update_mask are relative to the resource, not
1647
+ # the full request. A mutable field will be overwritten if it is in the
1648
+ # mask. If the user does not provide a mask then all mutable fields present
1649
+ # in the request will be overwritten.
1650
+ # @param template [::Google::Cloud::ParameterManager::V1::Template, ::Hash]
1651
+ # Required. The Template resource being updated
1652
+ # @param request_id [::String]
1653
+ # Optional. An optional request ID to identify requests. Specify a unique
1654
+ # request ID so that if you must retry your request, the server will know to
1655
+ # ignore the request if it has already been completed. The server will
1656
+ # guarantee that for at least 60 minutes since the first request.
1657
+ #
1658
+ # For example, consider a situation where you make an initial request and the
1659
+ # request times out. If you make the request again with the same request
1660
+ # ID, the server can check if original operation with the same request ID
1661
+ # was received, and if so, will ignore the second request. This prevents
1662
+ # clients from accidentally creating duplicate commitments.
1663
+ #
1664
+ # The request ID must be a valid UUID with the exception that zero UUID is
1665
+ # not supported (00000000-0000-0000-0000-000000000000).
1666
+ #
1667
+ # @yield [response, operation] Access the result along with the RPC operation
1668
+ # @yieldparam response [::Google::Cloud::ParameterManager::V1::Template]
1669
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1670
+ #
1671
+ # @return [::Google::Cloud::ParameterManager::V1::Template]
1672
+ #
1673
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1674
+ #
1675
+ # @example Basic example
1676
+ # require "google/cloud/parameter_manager/v1"
1677
+ #
1678
+ # # Create a client object. The client can be reused for multiple calls.
1679
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
1680
+ #
1681
+ # # Create a request. To set request fields, pass in keyword arguments.
1682
+ # request = Google::Cloud::ParameterManager::V1::UpdateTemplateRequest.new
1683
+ #
1684
+ # # Call the update_template method.
1685
+ # result = client.update_template request
1686
+ #
1687
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::Template.
1688
+ # p result
1689
+ #
1690
+ def update_template request, options = nil
1691
+ raise ::ArgumentError, "request must be provided" if request.nil?
1692
+
1693
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::UpdateTemplateRequest
1694
+
1695
+ # Converts hash and nil to an options object
1696
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1697
+
1698
+ # Customize the options with defaults
1699
+ metadata = @config.rpcs.update_template.metadata.to_h
1700
+
1701
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1702
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1703
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1704
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
1705
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1706
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1707
+
1708
+ header_params = {}
1709
+ if request.template&.name
1710
+ header_params["template.name"] = request.template.name
1711
+ end
1712
+
1713
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1714
+ metadata[:"x-goog-request-params"] ||= request_params_header
1715
+
1716
+ options.apply_defaults timeout: @config.rpcs.update_template.timeout,
1717
+ metadata: metadata,
1718
+ retry_policy: @config.rpcs.update_template.retry_policy
1719
+
1720
+ options.apply_defaults timeout: @config.timeout,
1721
+ metadata: @config.metadata,
1722
+ retry_policy: @config.retry_policy
1723
+
1724
+ @parameter_manager_stub.call_rpc :update_template, request, options: options do |response, operation|
1725
+ yield response, operation if block_given?
1726
+ end
1727
+ rescue ::GRPC::BadStatus => e
1728
+ raise ::Google::Cloud::Error.from_error(e)
1729
+ end
1730
+
1731
+ ##
1732
+ # Deletes a single Template.
1733
+ #
1734
+ # @overload delete_template(request, options = nil)
1735
+ # Pass arguments to `delete_template` via a request object, either of type
1736
+ # {::Google::Cloud::ParameterManager::V1::DeleteTemplateRequest} or an equivalent Hash.
1737
+ #
1738
+ # @param request [::Google::Cloud::ParameterManager::V1::DeleteTemplateRequest, ::Hash]
1739
+ # A request object representing the call parameters. Required. To specify no
1740
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1741
+ # @param options [::Gapic::CallOptions, ::Hash]
1742
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1743
+ #
1744
+ # @overload delete_template(name: nil, request_id: nil)
1745
+ # Pass arguments to `delete_template` via keyword arguments. Note that at
1746
+ # least one keyword argument is required. To specify no parameters, or to keep all
1747
+ # the default parameter values, pass an empty Hash as a request object (see above).
1748
+ #
1749
+ # @param name [::String]
1750
+ # Required. Name of the resource in the format
1751
+ # `projects/*/locations/*/templates/*`.
1752
+ # @param request_id [::String]
1753
+ # Optional. An optional request ID to identify requests. Specify a unique
1754
+ # request ID so that if you must retry your request, the server will know to
1755
+ # ignore the request if it has already been completed. The server will
1756
+ # guarantee that for at least 60 minutes after the first request.
1757
+ #
1758
+ # For example, consider a situation where you make an initial request and the
1759
+ # request times out. If you make the request again with the same request
1760
+ # ID, the server can check if original operation with the same request ID
1761
+ # was received, and if so, will ignore the second request. This prevents
1762
+ # clients from accidentally creating duplicate commitments.
1763
+ #
1764
+ # The request ID must be a valid UUID with the exception that zero UUID is
1765
+ # not supported (00000000-0000-0000-0000-000000000000).
1766
+ #
1767
+ # @yield [response, operation] Access the result along with the RPC operation
1768
+ # @yieldparam response [::Google::Protobuf::Empty]
1769
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1770
+ #
1771
+ # @return [::Google::Protobuf::Empty]
1772
+ #
1773
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1774
+ #
1775
+ # @example Basic example
1776
+ # require "google/cloud/parameter_manager/v1"
1777
+ #
1778
+ # # Create a client object. The client can be reused for multiple calls.
1779
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
1780
+ #
1781
+ # # Create a request. To set request fields, pass in keyword arguments.
1782
+ # request = Google::Cloud::ParameterManager::V1::DeleteTemplateRequest.new
1783
+ #
1784
+ # # Call the delete_template method.
1785
+ # result = client.delete_template request
1786
+ #
1787
+ # # The returned object is of type Google::Protobuf::Empty.
1788
+ # p result
1789
+ #
1790
+ def delete_template request, options = nil
1791
+ raise ::ArgumentError, "request must be provided" if request.nil?
1792
+
1793
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::DeleteTemplateRequest
1794
+
1795
+ # Converts hash and nil to an options object
1796
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1797
+
1798
+ # Customize the options with defaults
1799
+ metadata = @config.rpcs.delete_template.metadata.to_h
1800
+
1801
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1802
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1803
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1804
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
1805
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1806
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1807
+
1808
+ header_params = {}
1809
+ if request.name
1810
+ header_params["name"] = request.name
1811
+ end
1812
+
1813
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1814
+ metadata[:"x-goog-request-params"] ||= request_params_header
1815
+
1816
+ options.apply_defaults timeout: @config.rpcs.delete_template.timeout,
1817
+ metadata: metadata,
1818
+ retry_policy: @config.rpcs.delete_template.retry_policy
1819
+
1820
+ options.apply_defaults timeout: @config.timeout,
1821
+ metadata: @config.metadata,
1822
+ retry_policy: @config.retry_policy
1823
+
1824
+ @parameter_manager_stub.call_rpc :delete_template, request, options: options do |response, operation|
1825
+ yield response, operation if block_given?
1826
+ end
1827
+ rescue ::GRPC::BadStatus => e
1828
+ raise ::Google::Cloud::Error.from_error(e)
1829
+ end
1830
+
1831
+ ##
1832
+ # Lists TemplateVersions in a given project, location, and template.
1833
+ #
1834
+ # @overload list_template_versions(request, options = nil)
1835
+ # Pass arguments to `list_template_versions` via a request object, either of type
1836
+ # {::Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest} or an equivalent Hash.
1837
+ #
1838
+ # @param request [::Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest, ::Hash]
1839
+ # A request object representing the call parameters. Required. To specify no
1840
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1841
+ # @param options [::Gapic::CallOptions, ::Hash]
1842
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1843
+ #
1844
+ # @overload list_template_versions(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1845
+ # Pass arguments to `list_template_versions` via keyword arguments. Note that at
1846
+ # least one keyword argument is required. To specify no parameters, or to keep all
1847
+ # the default parameter values, pass an empty Hash as a request object (see above).
1848
+ #
1849
+ # @param parent [::String]
1850
+ # Required. Parent value for ListTemplateVersionsRequest in the format
1851
+ # `projects/*/locations/*/templates/*`.
1852
+ # @param page_size [::Integer]
1853
+ # Optional. Requested page size. Server may return fewer items than
1854
+ # requested. If unspecified, server will pick an appropriate default.
1855
+ # @param page_token [::String]
1856
+ # Optional. A page token, received from a previous `ListTemplateVersions`
1857
+ # call. Provide this to retrieve the subsequent page.
1858
+ #
1859
+ # When paginating, all other parameters provided to `ListTemplateVersions`
1860
+ # must match the call that provided the page token.
1861
+ # @param filter [::String]
1862
+ # Optional. Filtering results
1863
+ # @param order_by [::String]
1864
+ # Optional. Hint for how to order the results
1865
+ #
1866
+ # @yield [response, operation] Access the result along with the RPC operation
1867
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ParameterManager::V1::TemplateVersion>]
1868
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1869
+ #
1870
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::ParameterManager::V1::TemplateVersion>]
1871
+ #
1872
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1873
+ #
1874
+ # @example Basic example
1875
+ # require "google/cloud/parameter_manager/v1"
1876
+ #
1877
+ # # Create a client object. The client can be reused for multiple calls.
1878
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
1879
+ #
1880
+ # # Create a request. To set request fields, pass in keyword arguments.
1881
+ # request = Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest.new
1882
+ #
1883
+ # # Call the list_template_versions method.
1884
+ # result = client.list_template_versions request
1885
+ #
1886
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1887
+ # # over elements, and API calls will be issued to fetch pages as needed.
1888
+ # result.each do |item|
1889
+ # # Each element is of type ::Google::Cloud::ParameterManager::V1::TemplateVersion.
1890
+ # p item
1891
+ # end
1892
+ #
1893
+ def list_template_versions request, options = nil
1894
+ raise ::ArgumentError, "request must be provided" if request.nil?
1895
+
1896
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::ListTemplateVersionsRequest
1897
+
1898
+ # Converts hash and nil to an options object
1899
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1900
+
1901
+ # Customize the options with defaults
1902
+ metadata = @config.rpcs.list_template_versions.metadata.to_h
1903
+
1904
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1905
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1906
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1907
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
1908
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1909
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1910
+
1911
+ header_params = {}
1912
+ if request.parent
1913
+ header_params["parent"] = request.parent
1914
+ end
1915
+
1916
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1917
+ metadata[:"x-goog-request-params"] ||= request_params_header
1918
+
1919
+ options.apply_defaults timeout: @config.rpcs.list_template_versions.timeout,
1920
+ metadata: metadata,
1921
+ retry_policy: @config.rpcs.list_template_versions.retry_policy
1922
+
1923
+ options.apply_defaults timeout: @config.timeout,
1924
+ metadata: @config.metadata,
1925
+ retry_policy: @config.retry_policy
1926
+
1927
+ @parameter_manager_stub.call_rpc :list_template_versions, request, options: options do |response, operation|
1928
+ response = ::Gapic::PagedEnumerable.new @parameter_manager_stub, :list_template_versions, request, response, operation, options
1929
+ yield response, operation if block_given?
1930
+ throw :response, response
1931
+ end
1932
+ rescue ::GRPC::BadStatus => e
1933
+ raise ::Google::Cloud::Error.from_error(e)
1934
+ end
1935
+
1936
+ ##
1937
+ # Gets details of a single TemplateVersion.
1938
+ #
1939
+ # @overload get_template_version(request, options = nil)
1940
+ # Pass arguments to `get_template_version` via a request object, either of type
1941
+ # {::Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest} or an equivalent Hash.
1942
+ #
1943
+ # @param request [::Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest, ::Hash]
1944
+ # A request object representing the call parameters. Required. To specify no
1945
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1946
+ # @param options [::Gapic::CallOptions, ::Hash]
1947
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1948
+ #
1949
+ # @overload get_template_version(name: nil, view: nil)
1950
+ # Pass arguments to `get_template_version` via keyword arguments. Note that at
1951
+ # least one keyword argument is required. To specify no parameters, or to keep all
1952
+ # the default parameter values, pass an empty Hash as a request object (see above).
1953
+ #
1954
+ # @param name [::String]
1955
+ # Required. Name of the resource in the format
1956
+ # `projects/*/locations/*/templates/*/versions/*`.
1957
+ # @param view [::Google::Cloud::ParameterManager::V1::View]
1958
+ # Optional. Specifies the view of the TemplateVersion to return.
1959
+ # In the default FULL view, all metadata & payload associated with the
1960
+ # TemplateVersion will be returned.
1961
+ #
1962
+ # @yield [response, operation] Access the result along with the RPC operation
1963
+ # @yieldparam response [::Google::Cloud::ParameterManager::V1::TemplateVersion]
1964
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1965
+ #
1966
+ # @return [::Google::Cloud::ParameterManager::V1::TemplateVersion]
1967
+ #
1968
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1969
+ #
1970
+ # @example Basic example
1971
+ # require "google/cloud/parameter_manager/v1"
1972
+ #
1973
+ # # Create a client object. The client can be reused for multiple calls.
1974
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
1975
+ #
1976
+ # # Create a request. To set request fields, pass in keyword arguments.
1977
+ # request = Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest.new
1978
+ #
1979
+ # # Call the get_template_version method.
1980
+ # result = client.get_template_version request
1981
+ #
1982
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::TemplateVersion.
1983
+ # p result
1984
+ #
1985
+ def get_template_version request, options = nil
1986
+ raise ::ArgumentError, "request must be provided" if request.nil?
1987
+
1988
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::GetTemplateVersionRequest
1989
+
1990
+ # Converts hash and nil to an options object
1991
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1992
+
1993
+ # Customize the options with defaults
1994
+ metadata = @config.rpcs.get_template_version.metadata.to_h
1995
+
1996
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1997
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1998
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1999
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
2000
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2001
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2002
+
2003
+ header_params = {}
2004
+ if request.name
2005
+ header_params["name"] = request.name
2006
+ end
2007
+
2008
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2009
+ metadata[:"x-goog-request-params"] ||= request_params_header
2010
+
2011
+ options.apply_defaults timeout: @config.rpcs.get_template_version.timeout,
2012
+ metadata: metadata,
2013
+ retry_policy: @config.rpcs.get_template_version.retry_policy
2014
+
2015
+ options.apply_defaults timeout: @config.timeout,
2016
+ metadata: @config.metadata,
2017
+ retry_policy: @config.retry_policy
2018
+
2019
+ @parameter_manager_stub.call_rpc :get_template_version, request, options: options do |response, operation|
2020
+ yield response, operation if block_given?
2021
+ end
2022
+ rescue ::GRPC::BadStatus => e
2023
+ raise ::Google::Cloud::Error.from_error(e)
2024
+ end
2025
+
2026
+ ##
2027
+ # Creates a new TemplateVersion in a given project, location, and template.
2028
+ #
2029
+ # @overload create_template_version(request, options = nil)
2030
+ # Pass arguments to `create_template_version` via a request object, either of type
2031
+ # {::Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest} or an equivalent Hash.
2032
+ #
2033
+ # @param request [::Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest, ::Hash]
2034
+ # A request object representing the call parameters. Required. To specify no
2035
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2036
+ # @param options [::Gapic::CallOptions, ::Hash]
2037
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2038
+ #
2039
+ # @overload create_template_version(parent: nil, template_version_id: nil, template_version: nil, request_id: nil)
2040
+ # Pass arguments to `create_template_version` via keyword arguments. Note that at
2041
+ # least one keyword argument is required. To specify no parameters, or to keep all
2042
+ # the default parameter values, pass an empty Hash as a request object (see above).
2043
+ #
2044
+ # @param parent [::String]
2045
+ # Required. Value for parent in the format
2046
+ # `projects/*/locations/*/templates/*`.
2047
+ # @param template_version_id [::String]
2048
+ # Required. Id of the TemplateVersion resource
2049
+ # @param template_version [::Google::Cloud::ParameterManager::V1::TemplateVersion, ::Hash]
2050
+ # Required. The TemplateVersion resource being created
2051
+ # @param request_id [::String]
2052
+ # Optional. An optional request ID to identify requests. Specify a unique
2053
+ # request ID so that if you must retry your request, the server will know to
2054
+ # ignore the request if it has already been completed. The server will
2055
+ # guarantee that for at least 60 minutes since the first request.
2056
+ #
2057
+ # For example, consider a situation where you make an initial request and the
2058
+ # request times out. If you make the request again with the same request
2059
+ # ID, the server can check if original operation with the same request ID
2060
+ # was received, and if so, will ignore the second request. This prevents
2061
+ # clients from accidentally creating duplicate commitments.
2062
+ #
2063
+ # The request ID must be a valid UUID with the exception that zero UUID is
2064
+ # not supported (00000000-0000-0000-0000-000000000000).
2065
+ #
2066
+ # @yield [response, operation] Access the result along with the RPC operation
2067
+ # @yieldparam response [::Google::Cloud::ParameterManager::V1::TemplateVersion]
2068
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2069
+ #
2070
+ # @return [::Google::Cloud::ParameterManager::V1::TemplateVersion]
2071
+ #
2072
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2073
+ #
2074
+ # @example Basic example
2075
+ # require "google/cloud/parameter_manager/v1"
2076
+ #
2077
+ # # Create a client object. The client can be reused for multiple calls.
2078
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
2079
+ #
2080
+ # # Create a request. To set request fields, pass in keyword arguments.
2081
+ # request = Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest.new
2082
+ #
2083
+ # # Call the create_template_version method.
2084
+ # result = client.create_template_version request
2085
+ #
2086
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::TemplateVersion.
2087
+ # p result
2088
+ #
2089
+ def create_template_version request, options = nil
2090
+ raise ::ArgumentError, "request must be provided" if request.nil?
2091
+
2092
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::CreateTemplateVersionRequest
2093
+
2094
+ # Converts hash and nil to an options object
2095
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2096
+
2097
+ # Customize the options with defaults
2098
+ metadata = @config.rpcs.create_template_version.metadata.to_h
2099
+
2100
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2101
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2102
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2103
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
2104
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2105
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2106
+
2107
+ header_params = {}
2108
+ if request.parent
2109
+ header_params["parent"] = request.parent
2110
+ end
2111
+
2112
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2113
+ metadata[:"x-goog-request-params"] ||= request_params_header
2114
+
2115
+ options.apply_defaults timeout: @config.rpcs.create_template_version.timeout,
2116
+ metadata: metadata,
2117
+ retry_policy: @config.rpcs.create_template_version.retry_policy
2118
+
2119
+ options.apply_defaults timeout: @config.timeout,
2120
+ metadata: @config.metadata,
2121
+ retry_policy: @config.retry_policy
2122
+
2123
+ @parameter_manager_stub.call_rpc :create_template_version, request, options: options do |response, operation|
2124
+ yield response, operation if block_given?
2125
+ end
2126
+ rescue ::GRPC::BadStatus => e
2127
+ raise ::Google::Cloud::Error.from_error(e)
2128
+ end
2129
+
2130
+ ##
2131
+ # Updates a single TemplateVersion.
2132
+ #
2133
+ # @overload update_template_version(request, options = nil)
2134
+ # Pass arguments to `update_template_version` via a request object, either of type
2135
+ # {::Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest} or an equivalent Hash.
2136
+ #
2137
+ # @param request [::Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest, ::Hash]
2138
+ # A request object representing the call parameters. Required. To specify no
2139
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2140
+ # @param options [::Gapic::CallOptions, ::Hash]
2141
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2142
+ #
2143
+ # @overload update_template_version(update_mask: nil, template_version: nil, request_id: nil)
2144
+ # Pass arguments to `update_template_version` via keyword arguments. Note that at
2145
+ # least one keyword argument is required. To specify no parameters, or to keep all
2146
+ # the default parameter values, pass an empty Hash as a request object (see above).
2147
+ #
2148
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2149
+ # Optional. Field mask is used to specify the fields to be overwritten in the
2150
+ # TemplateVersion resource by the update.
2151
+ # The fields specified in the update_mask are relative to the resource, not
2152
+ # the full request. A mutable field will be overwritten if it is in the
2153
+ # mask. If the user does not provide a mask then all mutable fields present
2154
+ # in the request will be overwritten.
2155
+ # @param template_version [::Google::Cloud::ParameterManager::V1::TemplateVersion, ::Hash]
2156
+ # Required. The TemplateVersion resource being updated
2157
+ # @param request_id [::String]
2158
+ # Optional. An optional request ID to identify requests. Specify a unique
2159
+ # request ID so that if you must retry your request, the server will know to
2160
+ # ignore the request if it has already been completed. The server will
2161
+ # guarantee that for at least 60 minutes since the first request.
2162
+ #
2163
+ # For example, consider a situation where you make an initial request and the
2164
+ # request times out. If you make the request again with the same request
2165
+ # ID, the server can check if original operation with the same request ID
2166
+ # was received, and if so, will ignore the second request. This prevents
2167
+ # clients from accidentally creating duplicate commitments.
2168
+ #
2169
+ # The request ID must be a valid UUID with the exception that zero UUID is
2170
+ # not supported (00000000-0000-0000-0000-000000000000).
2171
+ #
2172
+ # @yield [response, operation] Access the result along with the RPC operation
2173
+ # @yieldparam response [::Google::Cloud::ParameterManager::V1::TemplateVersion]
2174
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2175
+ #
2176
+ # @return [::Google::Cloud::ParameterManager::V1::TemplateVersion]
2177
+ #
2178
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2179
+ #
2180
+ # @example Basic example
2181
+ # require "google/cloud/parameter_manager/v1"
2182
+ #
2183
+ # # Create a client object. The client can be reused for multiple calls.
2184
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
2185
+ #
2186
+ # # Create a request. To set request fields, pass in keyword arguments.
2187
+ # request = Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest.new
2188
+ #
2189
+ # # Call the update_template_version method.
2190
+ # result = client.update_template_version request
2191
+ #
2192
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::TemplateVersion.
2193
+ # p result
2194
+ #
2195
+ def update_template_version request, options = nil
2196
+ raise ::ArgumentError, "request must be provided" if request.nil?
2197
+
2198
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::UpdateTemplateVersionRequest
2199
+
2200
+ # Converts hash and nil to an options object
2201
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2202
+
2203
+ # Customize the options with defaults
2204
+ metadata = @config.rpcs.update_template_version.metadata.to_h
2205
+
2206
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2207
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2208
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2209
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
2210
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2211
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2212
+
2213
+ header_params = {}
2214
+ if request.template_version&.name
2215
+ header_params["template_version.name"] = request.template_version.name
2216
+ end
2217
+
2218
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2219
+ metadata[:"x-goog-request-params"] ||= request_params_header
2220
+
2221
+ options.apply_defaults timeout: @config.rpcs.update_template_version.timeout,
2222
+ metadata: metadata,
2223
+ retry_policy: @config.rpcs.update_template_version.retry_policy
2224
+
2225
+ options.apply_defaults timeout: @config.timeout,
2226
+ metadata: @config.metadata,
2227
+ retry_policy: @config.retry_policy
2228
+
2229
+ @parameter_manager_stub.call_rpc :update_template_version, request, options: options do |response, operation|
2230
+ yield response, operation if block_given?
2231
+ end
2232
+ rescue ::GRPC::BadStatus => e
2233
+ raise ::Google::Cloud::Error.from_error(e)
2234
+ end
2235
+
2236
+ ##
2237
+ # Deletes a single TemplateVersion.
2238
+ #
2239
+ # @overload delete_template_version(request, options = nil)
2240
+ # Pass arguments to `delete_template_version` via a request object, either of type
2241
+ # {::Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest} or an equivalent Hash.
2242
+ #
2243
+ # @param request [::Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest, ::Hash]
2244
+ # A request object representing the call parameters. Required. To specify no
2245
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2246
+ # @param options [::Gapic::CallOptions, ::Hash]
2247
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2248
+ #
2249
+ # @overload delete_template_version(name: nil, request_id: nil)
2250
+ # Pass arguments to `delete_template_version` via keyword arguments. Note that at
2251
+ # least one keyword argument is required. To specify no parameters, or to keep all
2252
+ # the default parameter values, pass an empty Hash as a request object (see above).
2253
+ #
2254
+ # @param name [::String]
2255
+ # Required. Name of the resource in the format
2256
+ # `projects/*/locations/*/templates/*/versions/*`.
2257
+ # @param request_id [::String]
2258
+ # Optional. An optional request ID to identify requests. Specify a unique
2259
+ # request ID so that if you must retry your request, the server will know to
2260
+ # ignore the request if it has already been completed. The server will
2261
+ # guarantee that for at least 60 minutes after the first request.
2262
+ #
2263
+ # For example, consider a situation where you make an initial request and the
2264
+ # request times out. If you make the request again with the same request
2265
+ # ID, the server can check if original operation with the same request ID
2266
+ # was received, and if so, will ignore the second request. This prevents
2267
+ # clients from accidentally creating duplicate commitments.
2268
+ #
2269
+ # The request ID must be a valid UUID with the exception that zero UUID is
2270
+ # not supported (00000000-0000-0000-0000-000000000000).
2271
+ #
2272
+ # @yield [response, operation] Access the result along with the RPC operation
2273
+ # @yieldparam response [::Google::Protobuf::Empty]
2274
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2275
+ #
2276
+ # @return [::Google::Protobuf::Empty]
2277
+ #
2278
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2279
+ #
2280
+ # @example Basic example
2281
+ # require "google/cloud/parameter_manager/v1"
2282
+ #
2283
+ # # Create a client object. The client can be reused for multiple calls.
2284
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
2285
+ #
2286
+ # # Create a request. To set request fields, pass in keyword arguments.
2287
+ # request = Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest.new
2288
+ #
2289
+ # # Call the delete_template_version method.
2290
+ # result = client.delete_template_version request
2291
+ #
2292
+ # # The returned object is of type Google::Protobuf::Empty.
2293
+ # p result
2294
+ #
2295
+ def delete_template_version request, options = nil
2296
+ raise ::ArgumentError, "request must be provided" if request.nil?
2297
+
2298
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::DeleteTemplateVersionRequest
2299
+
2300
+ # Converts hash and nil to an options object
2301
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2302
+
2303
+ # Customize the options with defaults
2304
+ metadata = @config.rpcs.delete_template_version.metadata.to_h
2305
+
2306
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2307
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2308
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2309
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
2310
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2311
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2312
+
2313
+ header_params = {}
2314
+ if request.name
2315
+ header_params["name"] = request.name
2316
+ end
2317
+
2318
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2319
+ metadata[:"x-goog-request-params"] ||= request_params_header
2320
+
2321
+ options.apply_defaults timeout: @config.rpcs.delete_template_version.timeout,
2322
+ metadata: metadata,
2323
+ retry_policy: @config.rpcs.delete_template_version.retry_policy
2324
+
2325
+ options.apply_defaults timeout: @config.timeout,
2326
+ metadata: @config.metadata,
2327
+ retry_policy: @config.retry_policy
2328
+
2329
+ @parameter_manager_stub.call_rpc :delete_template_version, request, options: options do |response, operation|
2330
+ yield response, operation if block_given?
2331
+ end
2332
+ rescue ::GRPC::BadStatus => e
2333
+ raise ::Google::Cloud::Error.from_error(e)
2334
+ end
2335
+
2336
+ ##
2337
+ # Gets rendered version of a TemplateVersion.
2338
+ #
2339
+ # @overload render_template_version(request, options = nil)
2340
+ # Pass arguments to `render_template_version` via a request object, either of type
2341
+ # {::Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest} or an equivalent Hash.
2342
+ #
2343
+ # @param request [::Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest, ::Hash]
2344
+ # A request object representing the call parameters. Required. To specify no
2345
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2346
+ # @param options [::Gapic::CallOptions, ::Hash]
2347
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2348
+ #
2349
+ # @overload render_template_version(name: nil, parameter_version: nil)
2350
+ # Pass arguments to `render_template_version` via keyword arguments. Note that at
2351
+ # least one keyword argument is required. To specify no parameters, or to keep all
2352
+ # the default parameter values, pass an empty Hash as a request object (see above).
2353
+ #
2354
+ # @param name [::String]
2355
+ # Required. Name of the resource
2356
+ # @param parameter_version [::String]
2357
+ # Required. Parameter version used to render the template version.
2358
+ #
2359
+ # @yield [response, operation] Access the result along with the RPC operation
2360
+ # @yieldparam response [::Google::Cloud::ParameterManager::V1::RenderTemplateVersionResponse]
2361
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2362
+ #
2363
+ # @return [::Google::Cloud::ParameterManager::V1::RenderTemplateVersionResponse]
2364
+ #
2365
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2366
+ #
2367
+ # @example Basic example
2368
+ # require "google/cloud/parameter_manager/v1"
2369
+ #
2370
+ # # Create a client object. The client can be reused for multiple calls.
2371
+ # client = Google::Cloud::ParameterManager::V1::ParameterManager::Client.new
2372
+ #
2373
+ # # Create a request. To set request fields, pass in keyword arguments.
2374
+ # request = Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest.new
2375
+ #
2376
+ # # Call the render_template_version method.
2377
+ # result = client.render_template_version request
2378
+ #
2379
+ # # The returned object is of type Google::Cloud::ParameterManager::V1::RenderTemplateVersionResponse.
2380
+ # p result
2381
+ #
2382
+ def render_template_version request, options = nil
2383
+ raise ::ArgumentError, "request must be provided" if request.nil?
2384
+
2385
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ParameterManager::V1::RenderTemplateVersionRequest
2386
+
2387
+ # Converts hash and nil to an options object
2388
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2389
+
2390
+ # Customize the options with defaults
2391
+ metadata = @config.rpcs.render_template_version.metadata.to_h
2392
+
2393
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2394
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2395
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2396
+ gapic_version: ::Google::Cloud::ParameterManager::V1::VERSION
2397
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2398
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2399
+
2400
+ header_params = {}
2401
+ if request.name
2402
+ header_params["name"] = request.name
2403
+ end
2404
+
2405
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2406
+ metadata[:"x-goog-request-params"] ||= request_params_header
2407
+
2408
+ options.apply_defaults timeout: @config.rpcs.render_template_version.timeout,
2409
+ metadata: metadata,
2410
+ retry_policy: @config.rpcs.render_template_version.retry_policy
2411
+
2412
+ options.apply_defaults timeout: @config.timeout,
2413
+ metadata: @config.metadata,
2414
+ retry_policy: @config.retry_policy
2415
+
2416
+ @parameter_manager_stub.call_rpc :render_template_version, request, options: options do |response, operation|
2417
+ yield response, operation if block_given?
2418
+ end
2419
+ rescue ::GRPC::BadStatus => e
2420
+ raise ::Google::Cloud::Error.from_error(e)
2421
+ end
2422
+
2423
+ ##
2424
+ # Configuration class for the ParameterManager API.
2425
+ #
2426
+ # This class represents the configuration for ParameterManager,
2427
+ # providing control over timeouts, retry behavior, logging, transport
2428
+ # parameters, and other low-level controls. Certain parameters can also be
2429
+ # applied individually to specific RPCs. See
2430
+ # {::Google::Cloud::ParameterManager::V1::ParameterManager::Client::Configuration::Rpcs}
2431
+ # for a list of RPCs that can be configured independently.
2432
+ #
2433
+ # Configuration can be applied globally to all clients, or to a single client
2434
+ # on construction.
2435
+ #
2436
+ # @example
2437
+ #
2438
+ # # Modify the global config, setting the timeout for
2439
+ # # list_parameters to 20 seconds,
2440
+ # # and all remaining timeouts to 10 seconds.
2441
+ # ::Google::Cloud::ParameterManager::V1::ParameterManager::Client.configure do |config|
2442
+ # config.timeout = 10.0
2443
+ # config.rpcs.list_parameters.timeout = 20.0
2444
+ # end
2445
+ #
2446
+ # # Apply the above configuration only to a new client.
2447
+ # client = ::Google::Cloud::ParameterManager::V1::ParameterManager::Client.new do |config|
2448
+ # config.timeout = 10.0
2449
+ # config.rpcs.list_parameters.timeout = 20.0
2450
+ # end
2451
+ #
2452
+ # @!attribute [rw] endpoint
2453
+ # A custom service endpoint, as a hostname or hostname:port. The default is
2454
+ # nil, indicating to use the default endpoint in the current universe domain.
2455
+ # @return [::String,nil]
2456
+ # @!attribute [rw] credentials
2457
+ # Credentials to send with calls. You may provide any of the following types:
2458
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
2459
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2460
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2461
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2462
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
2463
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2464
+ # * (`nil`) indicating no credentials
2465
+ #
2466
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
2467
+ # is deprecated. Providing an unvalidated credential configuration to
2468
+ # Google APIs can compromise the security of your systems and data.
2469
+ #
2470
+ # @example
2471
+ #
2472
+ # # The recommended way to provide credentials is to use the `make_creds` method
2473
+ # # on the appropriate credentials class for your environment.
2474
+ #
2475
+ # require "googleauth"
2476
+ #
2477
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
2478
+ # json_key_io: ::File.open("/path/to/keyfile.json")
2479
+ # )
2480
+ #
2481
+ # client = ::Google::Cloud::ParameterManager::V1::ParameterManager::Client.new do |config|
2482
+ # config.credentials = credentials
2483
+ # end
2484
+ #
2485
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
2486
+ # external source for authentication to Google Cloud, you must validate it before
2487
+ # providing it to a Google API client library. Providing an unvalidated credential
2488
+ # configuration to Google APIs can compromise the security of your systems and data.
2489
+ # For more information, refer to [Validate credential configurations from external
2490
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
2491
+ # @return [::Object]
2492
+ # @!attribute [rw] scope
2493
+ # The OAuth scopes
2494
+ # @return [::Array<::String>]
2495
+ # @!attribute [rw] lib_name
2496
+ # The library name as recorded in instrumentation and logging
2497
+ # @return [::String]
2498
+ # @!attribute [rw] lib_version
2499
+ # The library version as recorded in instrumentation and logging
2500
+ # @return [::String]
2501
+ # @!attribute [rw] channel_args
2502
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
2503
+ # `GRPC::Core::Channel` object is provided as the credential.
2504
+ # @return [::Hash]
2505
+ # @!attribute [rw] interceptors
2506
+ # An array of interceptors that are run before calls are executed.
2507
+ # @return [::Array<::GRPC::ClientInterceptor>]
2508
+ # @!attribute [rw] timeout
2509
+ # The call timeout in seconds.
2510
+ # @return [::Numeric]
2511
+ # @!attribute [rw] metadata
2512
+ # Additional gRPC headers to be sent with the call.
2513
+ # @return [::Hash{::Symbol=>::String}]
2514
+ # @!attribute [rw] retry_policy
2515
+ # The retry policy. The value is a hash with the following keys:
2516
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
2517
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
2518
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
2519
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
2520
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
2521
+ # trigger a retry.
2522
+ # @return [::Hash]
2523
+ # @!attribute [rw] quota_project
2524
+ # A separate project against which to charge quota.
2525
+ # @return [::String]
2526
+ # @!attribute [rw] universe_domain
2527
+ # The universe domain within which to make requests. This determines the
2528
+ # default endpoint URL. The default value of nil uses the environment
2529
+ # universe (usually the default "googleapis.com" universe).
2530
+ # @return [::String,nil]
2531
+ # @!attribute [rw] logger
2532
+ # A custom logger to use for request/response debug logging, or the value
2533
+ # `:default` (the default) to construct a default logger, or `nil` to
2534
+ # explicitly disable logging.
2535
+ # @return [::Logger,:default,nil]
2536
+ #
2537
+ class Configuration
2538
+ extend ::Gapic::Config
2539
+
2540
+ # @private
2541
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
2542
+ DEFAULT_ENDPOINT = "parametermanager.googleapis.com"
2543
+
2544
+ config_attr :endpoint, nil, ::String, nil
2545
+ config_attr :credentials, nil do |value|
2546
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
2547
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC::Core::Channel
2548
+ allowed.any? { |klass| klass === value }
2549
+ end
2550
+ config_attr :scope, nil, ::String, ::Array, nil
2551
+ config_attr :lib_name, nil, ::String, nil
2552
+ config_attr :lib_version, nil, ::String, nil
2553
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
2554
+ config_attr :interceptors, nil, ::Array, nil
2555
+ config_attr :timeout, nil, ::Numeric, nil
2556
+ config_attr :metadata, nil, ::Hash, nil
2557
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2558
+ config_attr :quota_project, nil, ::String, nil
2559
+ config_attr :universe_domain, nil, ::String, nil
2560
+ config_attr :logger, :default, ::Logger, nil, :default
2561
+
2562
+ # @private
2563
+ def initialize parent_config = nil
2564
+ @parent_config = parent_config unless parent_config.nil?
2565
+
2566
+ yield self if block_given?
2567
+ end
2568
+
2569
+ ##
2570
+ # Configurations for individual RPCs
2571
+ # @return [Rpcs]
2572
+ #
2573
+ def rpcs
2574
+ @rpcs ||= begin
2575
+ parent_rpcs = nil
2576
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
2577
+ Rpcs.new parent_rpcs
2578
+ end
2579
+ end
2580
+
2581
+ ##
2582
+ # Configuration for the channel pool
2583
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
2584
+ #
2585
+ def channel_pool
2586
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
2587
+ end
2588
+
2589
+ ##
2590
+ # Configuration RPC class for the ParameterManager API.
2591
+ #
2592
+ # Includes fields providing the configuration for each RPC in this service.
2593
+ # Each configuration object is of type `Gapic::Config::Method` and includes
2594
+ # the following configuration fields:
2595
+ #
1495
2596
  # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
1496
2597
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
1497
2598
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
@@ -1559,6 +2660,61 @@ module Google
1559
2660
  # @return [::Gapic::Config::Method]
1560
2661
  #
1561
2662
  attr_reader :delete_parameter_version
2663
+ ##
2664
+ # RPC-specific configuration for `list_templates`
2665
+ # @return [::Gapic::Config::Method]
2666
+ #
2667
+ attr_reader :list_templates
2668
+ ##
2669
+ # RPC-specific configuration for `get_template`
2670
+ # @return [::Gapic::Config::Method]
2671
+ #
2672
+ attr_reader :get_template
2673
+ ##
2674
+ # RPC-specific configuration for `create_template`
2675
+ # @return [::Gapic::Config::Method]
2676
+ #
2677
+ attr_reader :create_template
2678
+ ##
2679
+ # RPC-specific configuration for `update_template`
2680
+ # @return [::Gapic::Config::Method]
2681
+ #
2682
+ attr_reader :update_template
2683
+ ##
2684
+ # RPC-specific configuration for `delete_template`
2685
+ # @return [::Gapic::Config::Method]
2686
+ #
2687
+ attr_reader :delete_template
2688
+ ##
2689
+ # RPC-specific configuration for `list_template_versions`
2690
+ # @return [::Gapic::Config::Method]
2691
+ #
2692
+ attr_reader :list_template_versions
2693
+ ##
2694
+ # RPC-specific configuration for `get_template_version`
2695
+ # @return [::Gapic::Config::Method]
2696
+ #
2697
+ attr_reader :get_template_version
2698
+ ##
2699
+ # RPC-specific configuration for `create_template_version`
2700
+ # @return [::Gapic::Config::Method]
2701
+ #
2702
+ attr_reader :create_template_version
2703
+ ##
2704
+ # RPC-specific configuration for `update_template_version`
2705
+ # @return [::Gapic::Config::Method]
2706
+ #
2707
+ attr_reader :update_template_version
2708
+ ##
2709
+ # RPC-specific configuration for `delete_template_version`
2710
+ # @return [::Gapic::Config::Method]
2711
+ #
2712
+ attr_reader :delete_template_version
2713
+ ##
2714
+ # RPC-specific configuration for `render_template_version`
2715
+ # @return [::Gapic::Config::Method]
2716
+ #
2717
+ attr_reader :render_template_version
1562
2718
 
1563
2719
  # @private
1564
2720
  def initialize parent_rpcs = nil
@@ -1584,6 +2740,28 @@ module Google
1584
2740
  @update_parameter_version = ::Gapic::Config::Method.new update_parameter_version_config
1585
2741
  delete_parameter_version_config = parent_rpcs.delete_parameter_version if parent_rpcs.respond_to? :delete_parameter_version
1586
2742
  @delete_parameter_version = ::Gapic::Config::Method.new delete_parameter_version_config
2743
+ list_templates_config = parent_rpcs.list_templates if parent_rpcs.respond_to? :list_templates
2744
+ @list_templates = ::Gapic::Config::Method.new list_templates_config
2745
+ get_template_config = parent_rpcs.get_template if parent_rpcs.respond_to? :get_template
2746
+ @get_template = ::Gapic::Config::Method.new get_template_config
2747
+ create_template_config = parent_rpcs.create_template if parent_rpcs.respond_to? :create_template
2748
+ @create_template = ::Gapic::Config::Method.new create_template_config
2749
+ update_template_config = parent_rpcs.update_template if parent_rpcs.respond_to? :update_template
2750
+ @update_template = ::Gapic::Config::Method.new update_template_config
2751
+ delete_template_config = parent_rpcs.delete_template if parent_rpcs.respond_to? :delete_template
2752
+ @delete_template = ::Gapic::Config::Method.new delete_template_config
2753
+ list_template_versions_config = parent_rpcs.list_template_versions if parent_rpcs.respond_to? :list_template_versions
2754
+ @list_template_versions = ::Gapic::Config::Method.new list_template_versions_config
2755
+ get_template_version_config = parent_rpcs.get_template_version if parent_rpcs.respond_to? :get_template_version
2756
+ @get_template_version = ::Gapic::Config::Method.new get_template_version_config
2757
+ create_template_version_config = parent_rpcs.create_template_version if parent_rpcs.respond_to? :create_template_version
2758
+ @create_template_version = ::Gapic::Config::Method.new create_template_version_config
2759
+ update_template_version_config = parent_rpcs.update_template_version if parent_rpcs.respond_to? :update_template_version
2760
+ @update_template_version = ::Gapic::Config::Method.new update_template_version_config
2761
+ delete_template_version_config = parent_rpcs.delete_template_version if parent_rpcs.respond_to? :delete_template_version
2762
+ @delete_template_version = ::Gapic::Config::Method.new delete_template_version_config
2763
+ render_template_version_config = parent_rpcs.render_template_version if parent_rpcs.respond_to? :render_template_version
2764
+ @render_template_version = ::Gapic::Config::Method.new render_template_version_config
1587
2765
 
1588
2766
  yield self if block_given?
1589
2767
  end