google-cloud-deploy-v1 0.20.0 → 1.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -135,6 +135,22 @@ module Google
135
135
 
136
136
  default_config.rpcs.abandon_release.timeout = 60.0
137
137
 
138
+ default_config.rpcs.create_deploy_policy.timeout = 60.0
139
+
140
+ default_config.rpcs.update_deploy_policy.timeout = 60.0
141
+
142
+ default_config.rpcs.delete_deploy_policy.timeout = 60.0
143
+
144
+ default_config.rpcs.list_deploy_policies.timeout = 60.0
145
+ default_config.rpcs.list_deploy_policies.retry_policy = {
146
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
147
+ }
148
+
149
+ default_config.rpcs.get_deploy_policy.timeout = 60.0
150
+ default_config.rpcs.get_deploy_policy.retry_policy = {
151
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
152
+ }
153
+
138
154
  default_config.rpcs.approve_rollout.timeout = 60.0
139
155
 
140
156
  default_config.rpcs.advance_rollout.timeout = 60.0
@@ -551,9 +567,8 @@ module Google
551
567
  # the default parameter values, pass an empty Hash as a request object (see above).
552
568
  #
553
569
  # @param parent [::String]
554
- # Required. The parent collection in which the `DeliveryPipeline` should be
555
- # created. Format should be
556
- # `projects/{project_id}/locations/{location_name}`.
570
+ # Required. The parent collection in which the `DeliveryPipeline` must be
571
+ # created. The format is `projects/{project_id}/locations/{location_name}`.
557
572
  # @param delivery_pipeline_id [::String]
558
573
  # Required. ID of the `DeliveryPipeline`.
559
574
  # @param delivery_pipeline [::Google::Cloud::Deploy::V1::DeliveryPipeline, ::Hash]
@@ -668,11 +683,11 @@ module Google
668
683
  # the default parameter values, pass an empty Hash as a request object (see above).
669
684
  #
670
685
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
671
- # Required. Field mask is used to specify the fields to be overwritten in the
672
- # `DeliveryPipeline` resource by the update.
673
- # The fields specified in the update_mask are relative to the resource, not
674
- # the full request. A field will be overwritten if it's in the mask. If the
675
- # user doesn't provide a mask then all fields are overwritten.
686
+ # Required. Field mask is used to specify the fields to be overwritten by the
687
+ # update in the `DeliveryPipeline` resource. The fields specified in the
688
+ # update_mask are relative to the resource, not the full request. A field
689
+ # will be overwritten if it's in the mask. If the user doesn't provide a mask
690
+ # then all fields are overwritten.
676
691
  # @param delivery_pipeline [::Google::Cloud::Deploy::V1::DeliveryPipeline, ::Hash]
677
692
  # Required. The `DeliveryPipeline` to update.
678
693
  # @param request_id [::String]
@@ -788,7 +803,7 @@ module Google
788
803
  # the default parameter values, pass an empty Hash as a request object (see above).
789
804
  #
790
805
  # @param name [::String]
791
- # Required. The name of the `DeliveryPipeline` to delete. Format should be
806
+ # Required. The name of the `DeliveryPipeline` to delete. The format is
792
807
  # `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.
793
808
  # @param request_id [::String]
794
809
  # Optional. A request ID to identify requests. Specify a unique request ID
@@ -1014,14 +1029,14 @@ module Google
1014
1029
  # @param options [::Gapic::CallOptions, ::Hash]
1015
1030
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1016
1031
  #
1017
- # @overload rollback_target(name: nil, target_id: nil, rollout_id: nil, release_id: nil, rollout_to_roll_back: nil, rollback_config: nil, validate_only: nil)
1032
+ # @overload rollback_target(name: nil, target_id: nil, rollout_id: nil, release_id: nil, rollout_to_roll_back: nil, rollback_config: nil, validate_only: nil, override_deploy_policy: nil)
1018
1033
  # Pass arguments to `rollback_target` via keyword arguments. Note that at
1019
1034
  # least one keyword argument is required. To specify no parameters, or to keep all
1020
1035
  # the default parameter values, pass an empty Hash as a request object (see above).
1021
1036
  #
1022
1037
  # @param name [::String]
1023
- # Required. The `DeliveryPipeline` for which the rollback `Rollout` should be
1024
- # created. Format should be
1038
+ # Required. The `DeliveryPipeline` for which the rollback `Rollout` must be
1039
+ # created. The format is
1025
1040
  # `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.
1026
1041
  # @param target_id [::String]
1027
1042
  # Required. ID of the `Target` that is being rolled back.
@@ -1039,6 +1054,9 @@ module Google
1039
1054
  # @param validate_only [::Boolean]
1040
1055
  # Optional. If set to true, the request is validated and the user is provided
1041
1056
  # with a `RollbackTargetResponse`.
1057
+ # @param override_deploy_policy [::Array<::String>]
1058
+ # Optional. Deploy policies to override. Format is
1059
+ # `projects/{project}/locations/{location}/deployPolicies/{deploy_policy}`.
1042
1060
  #
1043
1061
  # @yield [response, operation] Access the result along with the RPC operation
1044
1062
  # @yieldparam response [::Google::Cloud::Deploy::V1::RollbackTargetResponse]
@@ -1211,8 +1229,8 @@ module Google
1211
1229
  # the default parameter values, pass an empty Hash as a request object (see above).
1212
1230
  #
1213
1231
  # @param parent [::String]
1214
- # Required. The parent collection in which the `Target` should be created.
1215
- # Format should be
1232
+ # Required. The parent collection in which the `Target` must be created.
1233
+ # The format is
1216
1234
  # `projects/{project_id}/locations/{location_name}`.
1217
1235
  # @param target_id [::String]
1218
1236
  # Required. ID of the `Target`.
@@ -1328,11 +1346,11 @@ module Google
1328
1346
  # the default parameter values, pass an empty Hash as a request object (see above).
1329
1347
  #
1330
1348
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1331
- # Required. Field mask is used to specify the fields to be overwritten in the
1332
- # Target resource by the update.
1333
- # The fields specified in the update_mask are relative to the resource, not
1334
- # the full request. A field will be overwritten if it's in the mask. If the
1335
- # user doesn't provide a mask then all fields are overwritten.
1349
+ # Required. Field mask is used to specify the fields to be overwritten by the
1350
+ # update in the `Target` resource. The fields specified in the update_mask
1351
+ # are relative to the resource, not the full request. A field will be
1352
+ # overwritten if it's in the mask. If the user doesn't provide a mask then
1353
+ # all fields are overwritten.
1336
1354
  # @param target [::Google::Cloud::Deploy::V1::Target, ::Hash]
1337
1355
  # Required. The `Target` to update.
1338
1356
  # @param request_id [::String]
@@ -1448,7 +1466,7 @@ module Google
1448
1466
  # the default parameter values, pass an empty Hash as a request object (see above).
1449
1467
  #
1450
1468
  # @param name [::String]
1451
- # Required. The name of the `Target` to delete. Format should be
1469
+ # Required. The name of the `Target` to delete. The format is
1452
1470
  # `projects/{project_id}/locations/{location_name}/targets/{target_name}`.
1453
1471
  # @param request_id [::String]
1454
1472
  # Optional. A request ID to identify requests. Specify a unique request ID
@@ -1763,9 +1781,8 @@ module Google
1763
1781
  # the default parameter values, pass an empty Hash as a request object (see above).
1764
1782
  #
1765
1783
  # @param parent [::String]
1766
- # Required. The parent collection in which the `CustomTargetType` should be
1767
- # created. Format should be
1768
- # `projects/{project_id}/locations/{location_name}`.
1784
+ # Required. The parent collection in which the `CustomTargetType` must be
1785
+ # created. The format is `projects/{project_id}/locations/{location_name}`.
1769
1786
  # @param custom_target_type_id [::String]
1770
1787
  # Required. ID of the `CustomTargetType`.
1771
1788
  # @param custom_target_type [::Google::Cloud::Deploy::V1::CustomTargetType, ::Hash]
@@ -1880,11 +1897,11 @@ module Google
1880
1897
  # the default parameter values, pass an empty Hash as a request object (see above).
1881
1898
  #
1882
1899
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1883
- # Required. Field mask is used to specify the fields to be overwritten in the
1884
- # `CustomTargetType` resource by the update.
1885
- # The fields specified in the update_mask are relative to the resource, not
1886
- # the full request. A field will be overwritten if it's in the mask. If the
1887
- # user doesn't provide a mask then all fields are overwritten.
1900
+ # Required. Field mask is used to specify the fields to be overwritten by the
1901
+ # update in the `CustomTargetType` resource. The fields specified in the
1902
+ # update_mask are relative to the resource, not the full request. A field
1903
+ # will be overwritten if it's in the mask. If the user doesn't provide a mask
1904
+ # then all fields are overwritten.
1888
1905
  # @param custom_target_type [::Google::Cloud::Deploy::V1::CustomTargetType, ::Hash]
1889
1906
  # Required. The `CustomTargetType` to update.
1890
1907
  # @param request_id [::String]
@@ -2309,14 +2326,14 @@ module Google
2309
2326
  # @param options [::Gapic::CallOptions, ::Hash]
2310
2327
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2311
2328
  #
2312
- # @overload create_release(parent: nil, release_id: nil, release: nil, request_id: nil, validate_only: nil)
2329
+ # @overload create_release(parent: nil, release_id: nil, release: nil, request_id: nil, validate_only: nil, override_deploy_policy: nil)
2313
2330
  # Pass arguments to `create_release` via keyword arguments. Note that at
2314
2331
  # least one keyword argument is required. To specify no parameters, or to keep all
2315
2332
  # the default parameter values, pass an empty Hash as a request object (see above).
2316
2333
  #
2317
2334
  # @param parent [::String]
2318
- # Required. The parent collection in which the `Release` should be created.
2319
- # Format should be
2335
+ # Required. The parent collection in which the `Release` is created.
2336
+ # The format is
2320
2337
  # `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.
2321
2338
  # @param release_id [::String]
2322
2339
  # Required. ID of the `Release`.
@@ -2339,6 +2356,9 @@ module Google
2339
2356
  # @param validate_only [::Boolean]
2340
2357
  # Optional. If set to true, the request is validated and the user is provided
2341
2358
  # with an expected result, but no actual change is made.
2359
+ # @param override_deploy_policy [::Array<::String>]
2360
+ # Optional. Deploy policies to override. Format is
2361
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
2342
2362
  #
2343
2363
  # @yield [response, operation] Access the result along with the RPC operation
2344
2364
  # @yieldparam response [::Gapic::Operation]
@@ -2500,6 +2520,556 @@ module Google
2500
2520
  raise ::Google::Cloud::Error.from_error(e)
2501
2521
  end
2502
2522
 
2523
+ ##
2524
+ # Creates a new DeployPolicy in a given project and location.
2525
+ #
2526
+ # @overload create_deploy_policy(request, options = nil)
2527
+ # Pass arguments to `create_deploy_policy` via a request object, either of type
2528
+ # {::Google::Cloud::Deploy::V1::CreateDeployPolicyRequest} or an equivalent Hash.
2529
+ #
2530
+ # @param request [::Google::Cloud::Deploy::V1::CreateDeployPolicyRequest, ::Hash]
2531
+ # A request object representing the call parameters. Required. To specify no
2532
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2533
+ # @param options [::Gapic::CallOptions, ::Hash]
2534
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2535
+ #
2536
+ # @overload create_deploy_policy(parent: nil, deploy_policy_id: nil, deploy_policy: nil, request_id: nil, validate_only: nil)
2537
+ # Pass arguments to `create_deploy_policy` via keyword arguments. Note that at
2538
+ # least one keyword argument is required. To specify no parameters, or to keep all
2539
+ # the default parameter values, pass an empty Hash as a request object (see above).
2540
+ #
2541
+ # @param parent [::String]
2542
+ # Required. The parent collection in which the `DeployPolicy` must be
2543
+ # created. The format is `projects/{project_id}/locations/{location_name}`.
2544
+ # @param deploy_policy_id [::String]
2545
+ # Required. ID of the `DeployPolicy`.
2546
+ # @param deploy_policy [::Google::Cloud::Deploy::V1::DeployPolicy, ::Hash]
2547
+ # Required. The `DeployPolicy` to create.
2548
+ # @param request_id [::String]
2549
+ # Optional. A request ID to identify requests. Specify a unique request ID
2550
+ # so that if you must retry your request, the server knows to ignore the
2551
+ # request if it has already been completed. The server guarantees that for
2552
+ # at least 60 minutes after the first request.
2553
+ #
2554
+ # For example, consider a situation where you make an initial request and the
2555
+ # request times out. If you make the request again with the same request ID,
2556
+ # the server can check if original operation with the same request ID was
2557
+ # received, and if so, will ignore the second request. This prevents clients
2558
+ # from accidentally creating duplicate commitments.
2559
+ #
2560
+ # The request ID must be a valid UUID with the exception that zero UUID is
2561
+ # not supported (00000000-0000-0000-0000-000000000000).
2562
+ # @param validate_only [::Boolean]
2563
+ # Optional. If set to true, the request is validated and the user is provided
2564
+ # with an expected result, but no actual change is made.
2565
+ #
2566
+ # @yield [response, operation] Access the result along with the RPC operation
2567
+ # @yieldparam response [::Gapic::Operation]
2568
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2569
+ #
2570
+ # @return [::Gapic::Operation]
2571
+ #
2572
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2573
+ #
2574
+ # @example Basic example
2575
+ # require "google/cloud/deploy/v1"
2576
+ #
2577
+ # # Create a client object. The client can be reused for multiple calls.
2578
+ # client = Google::Cloud::Deploy::V1::CloudDeploy::Client.new
2579
+ #
2580
+ # # Create a request. To set request fields, pass in keyword arguments.
2581
+ # request = Google::Cloud::Deploy::V1::CreateDeployPolicyRequest.new
2582
+ #
2583
+ # # Call the create_deploy_policy method.
2584
+ # result = client.create_deploy_policy request
2585
+ #
2586
+ # # The returned object is of type Gapic::Operation. You can use it to
2587
+ # # check the status of an operation, cancel it, or wait for results.
2588
+ # # Here is how to wait for a response.
2589
+ # result.wait_until_done! timeout: 60
2590
+ # if result.response?
2591
+ # p result.response
2592
+ # else
2593
+ # puts "No response received."
2594
+ # end
2595
+ #
2596
+ def create_deploy_policy request, options = nil
2597
+ raise ::ArgumentError, "request must be provided" if request.nil?
2598
+
2599
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Deploy::V1::CreateDeployPolicyRequest
2600
+
2601
+ # Converts hash and nil to an options object
2602
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2603
+
2604
+ # Customize the options with defaults
2605
+ metadata = @config.rpcs.create_deploy_policy.metadata.to_h
2606
+
2607
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2608
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2609
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2610
+ gapic_version: ::Google::Cloud::Deploy::V1::VERSION
2611
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2612
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2613
+
2614
+ header_params = {}
2615
+ if request.parent
2616
+ header_params["parent"] = request.parent
2617
+ end
2618
+
2619
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2620
+ metadata[:"x-goog-request-params"] ||= request_params_header
2621
+
2622
+ options.apply_defaults timeout: @config.rpcs.create_deploy_policy.timeout,
2623
+ metadata: metadata,
2624
+ retry_policy: @config.rpcs.create_deploy_policy.retry_policy
2625
+
2626
+ options.apply_defaults timeout: @config.timeout,
2627
+ metadata: @config.metadata,
2628
+ retry_policy: @config.retry_policy
2629
+
2630
+ @cloud_deploy_stub.call_rpc :create_deploy_policy, request, options: options do |response, operation|
2631
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2632
+ yield response, operation if block_given?
2633
+ return response
2634
+ end
2635
+ rescue ::GRPC::BadStatus => e
2636
+ raise ::Google::Cloud::Error.from_error(e)
2637
+ end
2638
+
2639
+ ##
2640
+ # Updates the parameters of a single DeployPolicy.
2641
+ #
2642
+ # @overload update_deploy_policy(request, options = nil)
2643
+ # Pass arguments to `update_deploy_policy` via a request object, either of type
2644
+ # {::Google::Cloud::Deploy::V1::UpdateDeployPolicyRequest} or an equivalent Hash.
2645
+ #
2646
+ # @param request [::Google::Cloud::Deploy::V1::UpdateDeployPolicyRequest, ::Hash]
2647
+ # A request object representing the call parameters. Required. To specify no
2648
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2649
+ # @param options [::Gapic::CallOptions, ::Hash]
2650
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2651
+ #
2652
+ # @overload update_deploy_policy(update_mask: nil, deploy_policy: nil, request_id: nil, allow_missing: nil, validate_only: nil)
2653
+ # Pass arguments to `update_deploy_policy` via keyword arguments. Note that at
2654
+ # least one keyword argument is required. To specify no parameters, or to keep all
2655
+ # the default parameter values, pass an empty Hash as a request object (see above).
2656
+ #
2657
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2658
+ # Required. Field mask is used to specify the fields to be overwritten by the
2659
+ # update in the `DeployPolicy` resource. The fields specified in the
2660
+ # update_mask are relative to the resource, not the full request. A field
2661
+ # will be overwritten if it's in the mask. If the user doesn't provide a mask
2662
+ # then all fields are overwritten.
2663
+ # @param deploy_policy [::Google::Cloud::Deploy::V1::DeployPolicy, ::Hash]
2664
+ # Required. The `DeployPolicy` to update.
2665
+ # @param request_id [::String]
2666
+ # Optional. A request ID to identify requests. Specify a unique request ID
2667
+ # so that if you must retry your request, the server knows to ignore the
2668
+ # request if it has already been completed. The server guarantees that for
2669
+ # at least 60 minutes after the first request.
2670
+ #
2671
+ # For example, consider a situation where you make an initial request and the
2672
+ # request times out. If you make the request again with the same request ID,
2673
+ # the server can check if original operation with the same request ID was
2674
+ # received, and if so, will ignore the second request. This prevents clients
2675
+ # from accidentally creating duplicate commitments.
2676
+ #
2677
+ # The request ID must be a valid UUID with the exception that zero UUID is
2678
+ # not supported (00000000-0000-0000-0000-000000000000).
2679
+ # @param allow_missing [::Boolean]
2680
+ # Optional. If set to true, updating a `DeployPolicy` that does not exist
2681
+ # will result in the creation of a new `DeployPolicy`.
2682
+ # @param validate_only [::Boolean]
2683
+ # Optional. If set to true, the request is validated and the user is provided
2684
+ # with an expected result, but no actual change is made.
2685
+ #
2686
+ # @yield [response, operation] Access the result along with the RPC operation
2687
+ # @yieldparam response [::Gapic::Operation]
2688
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2689
+ #
2690
+ # @return [::Gapic::Operation]
2691
+ #
2692
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2693
+ #
2694
+ # @example Basic example
2695
+ # require "google/cloud/deploy/v1"
2696
+ #
2697
+ # # Create a client object. The client can be reused for multiple calls.
2698
+ # client = Google::Cloud::Deploy::V1::CloudDeploy::Client.new
2699
+ #
2700
+ # # Create a request. To set request fields, pass in keyword arguments.
2701
+ # request = Google::Cloud::Deploy::V1::UpdateDeployPolicyRequest.new
2702
+ #
2703
+ # # Call the update_deploy_policy method.
2704
+ # result = client.update_deploy_policy request
2705
+ #
2706
+ # # The returned object is of type Gapic::Operation. You can use it to
2707
+ # # check the status of an operation, cancel it, or wait for results.
2708
+ # # Here is how to wait for a response.
2709
+ # result.wait_until_done! timeout: 60
2710
+ # if result.response?
2711
+ # p result.response
2712
+ # else
2713
+ # puts "No response received."
2714
+ # end
2715
+ #
2716
+ def update_deploy_policy request, options = nil
2717
+ raise ::ArgumentError, "request must be provided" if request.nil?
2718
+
2719
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Deploy::V1::UpdateDeployPolicyRequest
2720
+
2721
+ # Converts hash and nil to an options object
2722
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2723
+
2724
+ # Customize the options with defaults
2725
+ metadata = @config.rpcs.update_deploy_policy.metadata.to_h
2726
+
2727
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2728
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2729
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2730
+ gapic_version: ::Google::Cloud::Deploy::V1::VERSION
2731
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2732
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2733
+
2734
+ header_params = {}
2735
+ if request.deploy_policy&.name
2736
+ header_params["deploy_policy.name"] = request.deploy_policy.name
2737
+ end
2738
+
2739
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2740
+ metadata[:"x-goog-request-params"] ||= request_params_header
2741
+
2742
+ options.apply_defaults timeout: @config.rpcs.update_deploy_policy.timeout,
2743
+ metadata: metadata,
2744
+ retry_policy: @config.rpcs.update_deploy_policy.retry_policy
2745
+
2746
+ options.apply_defaults timeout: @config.timeout,
2747
+ metadata: @config.metadata,
2748
+ retry_policy: @config.retry_policy
2749
+
2750
+ @cloud_deploy_stub.call_rpc :update_deploy_policy, request, options: options do |response, operation|
2751
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2752
+ yield response, operation if block_given?
2753
+ return response
2754
+ end
2755
+ rescue ::GRPC::BadStatus => e
2756
+ raise ::Google::Cloud::Error.from_error(e)
2757
+ end
2758
+
2759
+ ##
2760
+ # Deletes a single DeployPolicy.
2761
+ #
2762
+ # @overload delete_deploy_policy(request, options = nil)
2763
+ # Pass arguments to `delete_deploy_policy` via a request object, either of type
2764
+ # {::Google::Cloud::Deploy::V1::DeleteDeployPolicyRequest} or an equivalent Hash.
2765
+ #
2766
+ # @param request [::Google::Cloud::Deploy::V1::DeleteDeployPolicyRequest, ::Hash]
2767
+ # A request object representing the call parameters. Required. To specify no
2768
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2769
+ # @param options [::Gapic::CallOptions, ::Hash]
2770
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2771
+ #
2772
+ # @overload delete_deploy_policy(name: nil, request_id: nil, allow_missing: nil, validate_only: nil, etag: nil)
2773
+ # Pass arguments to `delete_deploy_policy` via keyword arguments. Note that at
2774
+ # least one keyword argument is required. To specify no parameters, or to keep all
2775
+ # the default parameter values, pass an empty Hash as a request object (see above).
2776
+ #
2777
+ # @param name [::String]
2778
+ # Required. The name of the `DeployPolicy` to delete. The format is
2779
+ # `projects/{project_id}/locations/{location_name}/deployPolicies/{deploy_policy_name}`.
2780
+ # @param request_id [::String]
2781
+ # Optional. A request ID to identify requests. Specify a unique request ID
2782
+ # so that if you must retry your request, the server knows to ignore the
2783
+ # request if it has already been completed. The server guarantees that for
2784
+ # at least 60 minutes after the first request.
2785
+ #
2786
+ # For example, consider a situation where you make an initial request and the
2787
+ # request times out. If you make the request again with the same request ID,
2788
+ # the server can check if original operation with the same request ID was
2789
+ # received, and if so, will ignore the second request. This prevents clients
2790
+ # from accidentally creating duplicate commitments.
2791
+ #
2792
+ # The request ID must be a valid UUID with the exception that zero UUID is
2793
+ # not supported (00000000-0000-0000-0000-000000000000).
2794
+ # @param allow_missing [::Boolean]
2795
+ # Optional. If set to true, then deleting an already deleted or non-existing
2796
+ # `DeployPolicy` will succeed.
2797
+ # @param validate_only [::Boolean]
2798
+ # Optional. If set, validate the request and preview the review, but do not
2799
+ # actually post it.
2800
+ # @param etag [::String]
2801
+ # Optional. This checksum is computed by the server based on the value of
2802
+ # other fields, and may be sent on update and delete requests to ensure the
2803
+ # client has an up-to-date value before proceeding.
2804
+ #
2805
+ # @yield [response, operation] Access the result along with the RPC operation
2806
+ # @yieldparam response [::Gapic::Operation]
2807
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2808
+ #
2809
+ # @return [::Gapic::Operation]
2810
+ #
2811
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2812
+ #
2813
+ # @example Basic example
2814
+ # require "google/cloud/deploy/v1"
2815
+ #
2816
+ # # Create a client object. The client can be reused for multiple calls.
2817
+ # client = Google::Cloud::Deploy::V1::CloudDeploy::Client.new
2818
+ #
2819
+ # # Create a request. To set request fields, pass in keyword arguments.
2820
+ # request = Google::Cloud::Deploy::V1::DeleteDeployPolicyRequest.new
2821
+ #
2822
+ # # Call the delete_deploy_policy method.
2823
+ # result = client.delete_deploy_policy request
2824
+ #
2825
+ # # The returned object is of type Gapic::Operation. You can use it to
2826
+ # # check the status of an operation, cancel it, or wait for results.
2827
+ # # Here is how to wait for a response.
2828
+ # result.wait_until_done! timeout: 60
2829
+ # if result.response?
2830
+ # p result.response
2831
+ # else
2832
+ # puts "No response received."
2833
+ # end
2834
+ #
2835
+ def delete_deploy_policy request, options = nil
2836
+ raise ::ArgumentError, "request must be provided" if request.nil?
2837
+
2838
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Deploy::V1::DeleteDeployPolicyRequest
2839
+
2840
+ # Converts hash and nil to an options object
2841
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2842
+
2843
+ # Customize the options with defaults
2844
+ metadata = @config.rpcs.delete_deploy_policy.metadata.to_h
2845
+
2846
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2847
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2848
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2849
+ gapic_version: ::Google::Cloud::Deploy::V1::VERSION
2850
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2851
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2852
+
2853
+ header_params = {}
2854
+ if request.name
2855
+ header_params["name"] = request.name
2856
+ end
2857
+
2858
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2859
+ metadata[:"x-goog-request-params"] ||= request_params_header
2860
+
2861
+ options.apply_defaults timeout: @config.rpcs.delete_deploy_policy.timeout,
2862
+ metadata: metadata,
2863
+ retry_policy: @config.rpcs.delete_deploy_policy.retry_policy
2864
+
2865
+ options.apply_defaults timeout: @config.timeout,
2866
+ metadata: @config.metadata,
2867
+ retry_policy: @config.retry_policy
2868
+
2869
+ @cloud_deploy_stub.call_rpc :delete_deploy_policy, request, options: options do |response, operation|
2870
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2871
+ yield response, operation if block_given?
2872
+ return response
2873
+ end
2874
+ rescue ::GRPC::BadStatus => e
2875
+ raise ::Google::Cloud::Error.from_error(e)
2876
+ end
2877
+
2878
+ ##
2879
+ # Lists DeployPolicies in a given project and location.
2880
+ #
2881
+ # @overload list_deploy_policies(request, options = nil)
2882
+ # Pass arguments to `list_deploy_policies` via a request object, either of type
2883
+ # {::Google::Cloud::Deploy::V1::ListDeployPoliciesRequest} or an equivalent Hash.
2884
+ #
2885
+ # @param request [::Google::Cloud::Deploy::V1::ListDeployPoliciesRequest, ::Hash]
2886
+ # A request object representing the call parameters. Required. To specify no
2887
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2888
+ # @param options [::Gapic::CallOptions, ::Hash]
2889
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2890
+ #
2891
+ # @overload list_deploy_policies(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
2892
+ # Pass arguments to `list_deploy_policies` via keyword arguments. Note that at
2893
+ # least one keyword argument is required. To specify no parameters, or to keep all
2894
+ # the default parameter values, pass an empty Hash as a request object (see above).
2895
+ #
2896
+ # @param parent [::String]
2897
+ # Required. The parent, which owns this collection of deploy policies. Format
2898
+ # must be `projects/{project_id}/locations/{location_name}`.
2899
+ # @param page_size [::Integer]
2900
+ # The maximum number of deploy policies to return. The service may return
2901
+ # fewer than this value. If unspecified, at most 50 deploy policies will
2902
+ # be returned. The maximum value is 1000; values above 1000 will be set
2903
+ # to 1000.
2904
+ # @param page_token [::String]
2905
+ # A page token, received from a previous `ListDeployPolicies` call.
2906
+ # Provide this to retrieve the subsequent page.
2907
+ #
2908
+ # When paginating, all other provided parameters match
2909
+ # the call that provided the page token.
2910
+ # @param filter [::String]
2911
+ # Filter deploy policies to be returned. See https://google.aip.dev/160 for
2912
+ # more details. All fields can be used in the filter.
2913
+ # @param order_by [::String]
2914
+ # Field to sort by. See https://google.aip.dev/132#ordering for more details.
2915
+ #
2916
+ # @yield [response, operation] Access the result along with the RPC operation
2917
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Deploy::V1::DeployPolicy>]
2918
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2919
+ #
2920
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Deploy::V1::DeployPolicy>]
2921
+ #
2922
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2923
+ #
2924
+ # @example Basic example
2925
+ # require "google/cloud/deploy/v1"
2926
+ #
2927
+ # # Create a client object. The client can be reused for multiple calls.
2928
+ # client = Google::Cloud::Deploy::V1::CloudDeploy::Client.new
2929
+ #
2930
+ # # Create a request. To set request fields, pass in keyword arguments.
2931
+ # request = Google::Cloud::Deploy::V1::ListDeployPoliciesRequest.new
2932
+ #
2933
+ # # Call the list_deploy_policies method.
2934
+ # result = client.list_deploy_policies request
2935
+ #
2936
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2937
+ # # over elements, and API calls will be issued to fetch pages as needed.
2938
+ # result.each do |item|
2939
+ # # Each element is of type ::Google::Cloud::Deploy::V1::DeployPolicy.
2940
+ # p item
2941
+ # end
2942
+ #
2943
+ def list_deploy_policies request, options = nil
2944
+ raise ::ArgumentError, "request must be provided" if request.nil?
2945
+
2946
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Deploy::V1::ListDeployPoliciesRequest
2947
+
2948
+ # Converts hash and nil to an options object
2949
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2950
+
2951
+ # Customize the options with defaults
2952
+ metadata = @config.rpcs.list_deploy_policies.metadata.to_h
2953
+
2954
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2955
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2956
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2957
+ gapic_version: ::Google::Cloud::Deploy::V1::VERSION
2958
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2959
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2960
+
2961
+ header_params = {}
2962
+ if request.parent
2963
+ header_params["parent"] = request.parent
2964
+ end
2965
+
2966
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2967
+ metadata[:"x-goog-request-params"] ||= request_params_header
2968
+
2969
+ options.apply_defaults timeout: @config.rpcs.list_deploy_policies.timeout,
2970
+ metadata: metadata,
2971
+ retry_policy: @config.rpcs.list_deploy_policies.retry_policy
2972
+
2973
+ options.apply_defaults timeout: @config.timeout,
2974
+ metadata: @config.metadata,
2975
+ retry_policy: @config.retry_policy
2976
+
2977
+ @cloud_deploy_stub.call_rpc :list_deploy_policies, request, options: options do |response, operation|
2978
+ response = ::Gapic::PagedEnumerable.new @cloud_deploy_stub, :list_deploy_policies, request, response, operation, options
2979
+ yield response, operation if block_given?
2980
+ return response
2981
+ end
2982
+ rescue ::GRPC::BadStatus => e
2983
+ raise ::Google::Cloud::Error.from_error(e)
2984
+ end
2985
+
2986
+ ##
2987
+ # Gets details of a single DeployPolicy.
2988
+ #
2989
+ # @overload get_deploy_policy(request, options = nil)
2990
+ # Pass arguments to `get_deploy_policy` via a request object, either of type
2991
+ # {::Google::Cloud::Deploy::V1::GetDeployPolicyRequest} or an equivalent Hash.
2992
+ #
2993
+ # @param request [::Google::Cloud::Deploy::V1::GetDeployPolicyRequest, ::Hash]
2994
+ # A request object representing the call parameters. Required. To specify no
2995
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2996
+ # @param options [::Gapic::CallOptions, ::Hash]
2997
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2998
+ #
2999
+ # @overload get_deploy_policy(name: nil)
3000
+ # Pass arguments to `get_deploy_policy` via keyword arguments. Note that at
3001
+ # least one keyword argument is required. To specify no parameters, or to keep all
3002
+ # the default parameter values, pass an empty Hash as a request object (see above).
3003
+ #
3004
+ # @param name [::String]
3005
+ # Required. Name of the `DeployPolicy`. Format must be
3006
+ # `projects/{project_id}/locations/{location_name}/deployPolicies/{deploy_policy_name}`.
3007
+ #
3008
+ # @yield [response, operation] Access the result along with the RPC operation
3009
+ # @yieldparam response [::Google::Cloud::Deploy::V1::DeployPolicy]
3010
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3011
+ #
3012
+ # @return [::Google::Cloud::Deploy::V1::DeployPolicy]
3013
+ #
3014
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3015
+ #
3016
+ # @example Basic example
3017
+ # require "google/cloud/deploy/v1"
3018
+ #
3019
+ # # Create a client object. The client can be reused for multiple calls.
3020
+ # client = Google::Cloud::Deploy::V1::CloudDeploy::Client.new
3021
+ #
3022
+ # # Create a request. To set request fields, pass in keyword arguments.
3023
+ # request = Google::Cloud::Deploy::V1::GetDeployPolicyRequest.new
3024
+ #
3025
+ # # Call the get_deploy_policy method.
3026
+ # result = client.get_deploy_policy request
3027
+ #
3028
+ # # The returned object is of type Google::Cloud::Deploy::V1::DeployPolicy.
3029
+ # p result
3030
+ #
3031
+ def get_deploy_policy request, options = nil
3032
+ raise ::ArgumentError, "request must be provided" if request.nil?
3033
+
3034
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Deploy::V1::GetDeployPolicyRequest
3035
+
3036
+ # Converts hash and nil to an options object
3037
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3038
+
3039
+ # Customize the options with defaults
3040
+ metadata = @config.rpcs.get_deploy_policy.metadata.to_h
3041
+
3042
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3043
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3044
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3045
+ gapic_version: ::Google::Cloud::Deploy::V1::VERSION
3046
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3047
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3048
+
3049
+ header_params = {}
3050
+ if request.name
3051
+ header_params["name"] = request.name
3052
+ end
3053
+
3054
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3055
+ metadata[:"x-goog-request-params"] ||= request_params_header
3056
+
3057
+ options.apply_defaults timeout: @config.rpcs.get_deploy_policy.timeout,
3058
+ metadata: metadata,
3059
+ retry_policy: @config.rpcs.get_deploy_policy.retry_policy
3060
+
3061
+ options.apply_defaults timeout: @config.timeout,
3062
+ metadata: @config.metadata,
3063
+ retry_policy: @config.retry_policy
3064
+
3065
+ @cloud_deploy_stub.call_rpc :get_deploy_policy, request, options: options do |response, operation|
3066
+ yield response, operation if block_given?
3067
+ return response
3068
+ end
3069
+ rescue ::GRPC::BadStatus => e
3070
+ raise ::Google::Cloud::Error.from_error(e)
3071
+ end
3072
+
2503
3073
  ##
2504
3074
  # Approves a Rollout.
2505
3075
  #
@@ -2513,7 +3083,7 @@ module Google
2513
3083
  # @param options [::Gapic::CallOptions, ::Hash]
2514
3084
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2515
3085
  #
2516
- # @overload approve_rollout(name: nil, approved: nil)
3086
+ # @overload approve_rollout(name: nil, approved: nil, override_deploy_policy: nil)
2517
3087
  # Pass arguments to `approve_rollout` via keyword arguments. Note that at
2518
3088
  # least one keyword argument is required. To specify no parameters, or to keep all
2519
3089
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -2523,6 +3093,9 @@ module Google
2523
3093
  # `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.
2524
3094
  # @param approved [::Boolean]
2525
3095
  # Required. True = approve; false = reject
3096
+ # @param override_deploy_policy [::Array<::String>]
3097
+ # Optional. Deploy policies to override. Format is
3098
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
2526
3099
  #
2527
3100
  # @yield [response, operation] Access the result along with the RPC operation
2528
3101
  # @yieldparam response [::Google::Cloud::Deploy::V1::ApproveRolloutResponse]
@@ -2602,7 +3175,7 @@ module Google
2602
3175
  # @param options [::Gapic::CallOptions, ::Hash]
2603
3176
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2604
3177
  #
2605
- # @overload advance_rollout(name: nil, phase_id: nil)
3178
+ # @overload advance_rollout(name: nil, phase_id: nil, override_deploy_policy: nil)
2606
3179
  # Pass arguments to `advance_rollout` via keyword arguments. Note that at
2607
3180
  # least one keyword argument is required. To specify no parameters, or to keep all
2608
3181
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -2612,6 +3185,9 @@ module Google
2612
3185
  # `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.
2613
3186
  # @param phase_id [::String]
2614
3187
  # Required. The phase ID to advance the `Rollout` to.
3188
+ # @param override_deploy_policy [::Array<::String>]
3189
+ # Optional. Deploy policies to override. Format is
3190
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
2615
3191
  #
2616
3192
  # @yield [response, operation] Access the result along with the RPC operation
2617
3193
  # @yieldparam response [::Google::Cloud::Deploy::V1::AdvanceRolloutResponse]
@@ -2691,7 +3267,7 @@ module Google
2691
3267
  # @param options [::Gapic::CallOptions, ::Hash]
2692
3268
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2693
3269
  #
2694
- # @overload cancel_rollout(name: nil)
3270
+ # @overload cancel_rollout(name: nil, override_deploy_policy: nil)
2695
3271
  # Pass arguments to `cancel_rollout` via keyword arguments. Note that at
2696
3272
  # least one keyword argument is required. To specify no parameters, or to keep all
2697
3273
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -2699,6 +3275,9 @@ module Google
2699
3275
  # @param name [::String]
2700
3276
  # Required. Name of the Rollout. Format is
2701
3277
  # `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}`.
3278
+ # @param override_deploy_policy [::Array<::String>]
3279
+ # Optional. Deploy policies to override. Format is
3280
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
2702
3281
  #
2703
3282
  # @yield [response, operation] Access the result along with the RPC operation
2704
3283
  # @yieldparam response [::Google::Cloud::Deploy::V1::CancelRolloutResponse]
@@ -2973,14 +3552,14 @@ module Google
2973
3552
  # @param options [::Gapic::CallOptions, ::Hash]
2974
3553
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2975
3554
  #
2976
- # @overload create_rollout(parent: nil, rollout_id: nil, rollout: nil, request_id: nil, validate_only: nil, starting_phase_id: nil)
3555
+ # @overload create_rollout(parent: nil, rollout_id: nil, rollout: nil, request_id: nil, validate_only: nil, override_deploy_policy: nil, starting_phase_id: nil)
2977
3556
  # Pass arguments to `create_rollout` via keyword arguments. Note that at
2978
3557
  # least one keyword argument is required. To specify no parameters, or to keep all
2979
3558
  # the default parameter values, pass an empty Hash as a request object (see above).
2980
3559
  #
2981
3560
  # @param parent [::String]
2982
- # Required. The parent collection in which the `Rollout` should be created.
2983
- # Format should be
3561
+ # Required. The parent collection in which the `Rollout` must be created.
3562
+ # The format is
2984
3563
  # `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}`.
2985
3564
  # @param rollout_id [::String]
2986
3565
  # Required. ID of the `Rollout`.
@@ -3003,6 +3582,9 @@ module Google
3003
3582
  # @param validate_only [::Boolean]
3004
3583
  # Optional. If set to true, the request is validated and the user is provided
3005
3584
  # with an expected result, but no actual change is made.
3585
+ # @param override_deploy_policy [::Array<::String>]
3586
+ # Optional. Deploy policies to override. Format is
3587
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
3006
3588
  # @param starting_phase_id [::String]
3007
3589
  # Optional. The starting phase ID for the `Rollout`. If empty the `Rollout`
3008
3590
  # will start at the first phase.
@@ -3093,7 +3675,7 @@ module Google
3093
3675
  # @param options [::Gapic::CallOptions, ::Hash]
3094
3676
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3095
3677
  #
3096
- # @overload ignore_job(rollout: nil, phase_id: nil, job_id: nil)
3678
+ # @overload ignore_job(rollout: nil, phase_id: nil, job_id: nil, override_deploy_policy: nil)
3097
3679
  # Pass arguments to `ignore_job` via keyword arguments. Note that at
3098
3680
  # least one keyword argument is required. To specify no parameters, or to keep all
3099
3681
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -3105,6 +3687,9 @@ module Google
3105
3687
  # Required. The phase ID the Job to ignore belongs to.
3106
3688
  # @param job_id [::String]
3107
3689
  # Required. The job ID for the Job to ignore.
3690
+ # @param override_deploy_policy [::Array<::String>]
3691
+ # Optional. Deploy policies to override. Format is
3692
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
3108
3693
  #
3109
3694
  # @yield [response, operation] Access the result along with the RPC operation
3110
3695
  # @yieldparam response [::Google::Cloud::Deploy::V1::IgnoreJobResponse]
@@ -3184,7 +3769,7 @@ module Google
3184
3769
  # @param options [::Gapic::CallOptions, ::Hash]
3185
3770
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3186
3771
  #
3187
- # @overload retry_job(rollout: nil, phase_id: nil, job_id: nil)
3772
+ # @overload retry_job(rollout: nil, phase_id: nil, job_id: nil, override_deploy_policy: nil)
3188
3773
  # Pass arguments to `retry_job` via keyword arguments. Note that at
3189
3774
  # least one keyword argument is required. To specify no parameters, or to keep all
3190
3775
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -3196,6 +3781,9 @@ module Google
3196
3781
  # Required. The phase ID the Job to retry belongs to.
3197
3782
  # @param job_id [::String]
3198
3783
  # Required. The job ID for the Job to retry.
3784
+ # @param override_deploy_policy [::Array<::String>]
3785
+ # Optional. Deploy policies to override. Format is
3786
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
3199
3787
  #
3200
3788
  # @yield [response, operation] Access the result along with the RPC operation
3201
3789
  # @yieldparam response [::Google::Cloud::Deploy::V1::RetryJobResponse]
@@ -3470,7 +4058,7 @@ module Google
3470
4058
  # @param options [::Gapic::CallOptions, ::Hash]
3471
4059
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3472
4060
  #
3473
- # @overload terminate_job_run(name: nil)
4061
+ # @overload terminate_job_run(name: nil, override_deploy_policy: nil)
3474
4062
  # Pass arguments to `terminate_job_run` via keyword arguments. Note that at
3475
4063
  # least one keyword argument is required. To specify no parameters, or to keep all
3476
4064
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -3478,6 +4066,9 @@ module Google
3478
4066
  # @param name [::String]
3479
4067
  # Required. Name of the `JobRun`. Format must be
3480
4068
  # `projects/{project}/locations/{location}/deliveryPipelines/{deliveryPipeline}/releases/{release}/rollouts/{rollout}/jobRuns/{jobRun}`.
4069
+ # @param override_deploy_policy [::Array<::String>]
4070
+ # Optional. Deploy policies to override. Format is
4071
+ # `projects/{project}/locations/{location}/deployPolicies/{deployPolicy}`.
3481
4072
  #
3482
4073
  # @yield [response, operation] Access the result along with the RPC operation
3483
4074
  # @yieldparam response [::Google::Cloud::Deploy::V1::TerminateJobRunResponse]
@@ -3649,8 +4240,8 @@ module Google
3649
4240
  # the default parameter values, pass an empty Hash as a request object (see above).
3650
4241
  #
3651
4242
  # @param parent [::String]
3652
- # Required. The parent collection in which the `Automation` should be
3653
- # created. Format should be
4243
+ # Required. The parent collection in which the `Automation` must be created.
4244
+ # The format is
3654
4245
  # `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}`.
3655
4246
  # @param automation_id [::String]
3656
4247
  # Required. ID of the `Automation`.
@@ -3766,11 +4357,11 @@ module Google
3766
4357
  # the default parameter values, pass an empty Hash as a request object (see above).
3767
4358
  #
3768
4359
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3769
- # Required. Field mask is used to specify the fields to be overwritten in the
3770
- # `Automation` resource by the update.
3771
- # The fields specified in the update_mask are relative to the resource, not
3772
- # the full request. A field will be overwritten if it's in the mask. If the
3773
- # user doesn't provide a mask then all fields are overwritten.
4360
+ # Required. Field mask is used to specify the fields to be overwritten by the
4361
+ # update in the `Automation` resource. The fields specified in the
4362
+ # update_mask are relative to the resource, not the full request. A field
4363
+ # will be overwritten if it's in the mask. If the user doesn't provide a mask
4364
+ # then all fields are overwritten.
3774
4365
  # @param automation [::Google::Cloud::Deploy::V1::Automation, ::Hash]
3775
4366
  # Required. The `Automation` to update.
3776
4367
  # @param request_id [::String]
@@ -3886,7 +4477,7 @@ module Google
3886
4477
  # the default parameter values, pass an empty Hash as a request object (see above).
3887
4478
  #
3888
4479
  # @param name [::String]
3889
- # Required. The name of the `Automation` to delete. Format should be
4480
+ # Required. The name of the `Automation` to delete. The format is
3890
4481
  # `projects/{project_id}/locations/{location_name}/deliveryPipelines/{pipeline_name}/automations/{automation_name}`.
3891
4482
  # @param request_id [::String]
3892
4483
  # Optional. A request ID to identify requests. Specify a unique request ID
@@ -4723,6 +5314,31 @@ module Google
4723
5314
  #
4724
5315
  attr_reader :abandon_release
4725
5316
  ##
5317
+ # RPC-specific configuration for `create_deploy_policy`
5318
+ # @return [::Gapic::Config::Method]
5319
+ #
5320
+ attr_reader :create_deploy_policy
5321
+ ##
5322
+ # RPC-specific configuration for `update_deploy_policy`
5323
+ # @return [::Gapic::Config::Method]
5324
+ #
5325
+ attr_reader :update_deploy_policy
5326
+ ##
5327
+ # RPC-specific configuration for `delete_deploy_policy`
5328
+ # @return [::Gapic::Config::Method]
5329
+ #
5330
+ attr_reader :delete_deploy_policy
5331
+ ##
5332
+ # RPC-specific configuration for `list_deploy_policies`
5333
+ # @return [::Gapic::Config::Method]
5334
+ #
5335
+ attr_reader :list_deploy_policies
5336
+ ##
5337
+ # RPC-specific configuration for `get_deploy_policy`
5338
+ # @return [::Gapic::Config::Method]
5339
+ #
5340
+ attr_reader :get_deploy_policy
5341
+ ##
4726
5342
  # RPC-specific configuration for `approve_rollout`
4727
5343
  # @return [::Gapic::Config::Method]
4728
5344
  #
@@ -4865,6 +5481,16 @@ module Google
4865
5481
  @create_release = ::Gapic::Config::Method.new create_release_config
4866
5482
  abandon_release_config = parent_rpcs.abandon_release if parent_rpcs.respond_to? :abandon_release
4867
5483
  @abandon_release = ::Gapic::Config::Method.new abandon_release_config
5484
+ create_deploy_policy_config = parent_rpcs.create_deploy_policy if parent_rpcs.respond_to? :create_deploy_policy
5485
+ @create_deploy_policy = ::Gapic::Config::Method.new create_deploy_policy_config
5486
+ update_deploy_policy_config = parent_rpcs.update_deploy_policy if parent_rpcs.respond_to? :update_deploy_policy
5487
+ @update_deploy_policy = ::Gapic::Config::Method.new update_deploy_policy_config
5488
+ delete_deploy_policy_config = parent_rpcs.delete_deploy_policy if parent_rpcs.respond_to? :delete_deploy_policy
5489
+ @delete_deploy_policy = ::Gapic::Config::Method.new delete_deploy_policy_config
5490
+ list_deploy_policies_config = parent_rpcs.list_deploy_policies if parent_rpcs.respond_to? :list_deploy_policies
5491
+ @list_deploy_policies = ::Gapic::Config::Method.new list_deploy_policies_config
5492
+ get_deploy_policy_config = parent_rpcs.get_deploy_policy if parent_rpcs.respond_to? :get_deploy_policy
5493
+ @get_deploy_policy = ::Gapic::Config::Method.new get_deploy_policy_config
4868
5494
  approve_rollout_config = parent_rpcs.approve_rollout if parent_rpcs.respond_to? :approve_rollout
4869
5495
  @approve_rollout = ::Gapic::Config::Method.new approve_rollout_config
4870
5496
  advance_rollout_config = parent_rpcs.advance_rollout if parent_rpcs.respond_to? :advance_rollout