google-cloud-dlp-v2 0.17.0 → 0.19.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -159,6 +159,25 @@ module Google
159
159
 
160
160
  default_config.rpcs.activate_job_trigger.timeout = 300.0
161
161
 
162
+ default_config.rpcs.create_discovery_config.timeout = 300.0
163
+
164
+ default_config.rpcs.update_discovery_config.timeout = 300.0
165
+
166
+ default_config.rpcs.get_discovery_config.timeout = 300.0
167
+ default_config.rpcs.get_discovery_config.retry_policy = {
168
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
169
+ }
170
+
171
+ default_config.rpcs.list_discovery_configs.timeout = 300.0
172
+ default_config.rpcs.list_discovery_configs.retry_policy = {
173
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
174
+ }
175
+
176
+ default_config.rpcs.delete_discovery_config.timeout = 300.0
177
+ default_config.rpcs.delete_discovery_config.retry_policy = {
178
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
179
+ }
180
+
162
181
  default_config.rpcs.create_dlp_job.timeout = 300.0
163
182
 
164
183
  default_config.rpcs.list_dlp_jobs.timeout = 300.0
@@ -281,7 +300,8 @@ module Google
281
300
  credentials: credentials,
282
301
  endpoint: @config.endpoint,
283
302
  channel_args: @config.channel_args,
284
- interceptors: @config.interceptors
303
+ interceptors: @config.interceptors,
304
+ channel_pool_config: @config.channel_pool
285
305
  )
286
306
  end
287
307
 
@@ -1032,8 +1052,8 @@ module Google
1032
1052
  # the default parameter values, pass an empty Hash as a request object (see above).
1033
1053
  #
1034
1054
  # @param name [::String]
1035
- # Required. Resource name of organization and inspectTemplate to be updated, for
1036
- # example `organizations/433245324/inspectTemplates/432452342` or
1055
+ # Required. Resource name of organization and inspectTemplate to be updated,
1056
+ # for example `organizations/433245324/inspectTemplates/432452342` or
1037
1057
  # projects/project-id/inspectTemplates/432452342.
1038
1058
  # @param inspect_template [::Google::Cloud::Dlp::V2::InspectTemplate, ::Hash]
1039
1059
  # New InspectTemplate value.
@@ -1124,8 +1144,8 @@ module Google
1124
1144
  # the default parameter values, pass an empty Hash as a request object (see above).
1125
1145
  #
1126
1146
  # @param name [::String]
1127
- # Required. Resource name of the organization and inspectTemplate to be read, for
1128
- # example `organizations/433245324/inspectTemplates/432452342` or
1147
+ # Required. Resource name of the organization and inspectTemplate to be read,
1148
+ # for example `organizations/433245324/inspectTemplates/432452342` or
1129
1149
  # projects/project-id/inspectTemplates/432452342.
1130
1150
  #
1131
1151
  # @yield [response, operation] Access the result along with the RPC operation
@@ -1233,15 +1253,15 @@ module Google
1233
1253
  #
1234
1254
  # parent=projects/example-project/locations/europe-west3
1235
1255
  # @param page_token [::String]
1236
- # Page token to continue retrieval. Comes from previous call
1256
+ # Page token to continue retrieval. Comes from the previous call
1237
1257
  # to `ListInspectTemplates`.
1238
1258
  # @param page_size [::Integer]
1239
- # Size of the page, can be limited by the server. If zero server returns
1240
- # a page of max size 100.
1259
+ # Size of the page. This value can be limited by the server. If zero server
1260
+ # returns a page of max size 100.
1241
1261
  # @param order_by [::String]
1242
1262
  # Comma separated list of fields to order by,
1243
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
1244
- # default sorting order is ascending, redundant space characters are
1263
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
1264
+ # default sorting order is ascending. Redundant space characters are
1245
1265
  # insignificant.
1246
1266
  #
1247
1267
  # Example: `name asc,update_time, create_time desc`
@@ -1344,9 +1364,9 @@ module Google
1344
1364
  # the default parameter values, pass an empty Hash as a request object (see above).
1345
1365
  #
1346
1366
  # @param name [::String]
1347
- # Required. Resource name of the organization and inspectTemplate to be deleted, for
1348
- # example `organizations/433245324/inspectTemplates/432452342` or
1349
- # projects/project-id/inspectTemplates/432452342.
1367
+ # Required. Resource name of the organization and inspectTemplate to be
1368
+ # deleted, for example `organizations/433245324/inspectTemplates/432452342`
1369
+ # or projects/project-id/inspectTemplates/432452342.
1350
1370
  #
1351
1371
  # @yield [response, operation] Access the result along with the RPC operation
1352
1372
  # @yieldparam response [::Google::Protobuf::Empty]
@@ -1549,8 +1569,9 @@ module Google
1549
1569
  # the default parameter values, pass an empty Hash as a request object (see above).
1550
1570
  #
1551
1571
  # @param name [::String]
1552
- # Required. Resource name of organization and deidentify template to be updated, for
1553
- # example `organizations/433245324/deidentifyTemplates/432452342` or
1572
+ # Required. Resource name of organization and deidentify template to be
1573
+ # updated, for example
1574
+ # `organizations/433245324/deidentifyTemplates/432452342` or
1554
1575
  # projects/project-id/deidentifyTemplates/432452342.
1555
1576
  # @param deidentify_template [::Google::Cloud::Dlp::V2::DeidentifyTemplate, ::Hash]
1556
1577
  # New DeidentifyTemplate value.
@@ -1642,9 +1663,9 @@ module Google
1642
1663
  # the default parameter values, pass an empty Hash as a request object (see above).
1643
1664
  #
1644
1665
  # @param name [::String]
1645
- # Required. Resource name of the organization and deidentify template to be read, for
1646
- # example `organizations/433245324/deidentifyTemplates/432452342` or
1647
- # projects/project-id/deidentifyTemplates/432452342.
1666
+ # Required. Resource name of the organization and deidentify template to be
1667
+ # read, for example `organizations/433245324/deidentifyTemplates/432452342`
1668
+ # or projects/project-id/deidentifyTemplates/432452342.
1648
1669
  #
1649
1670
  # @yield [response, operation] Access the result along with the RPC operation
1650
1671
  # @yieldparam response [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
@@ -1752,15 +1773,15 @@ module Google
1752
1773
  #
1753
1774
  # parent=projects/example-project/locations/europe-west3
1754
1775
  # @param page_token [::String]
1755
- # Page token to continue retrieval. Comes from previous call
1776
+ # Page token to continue retrieval. Comes from the previous call
1756
1777
  # to `ListDeidentifyTemplates`.
1757
1778
  # @param page_size [::Integer]
1758
- # Size of the page, can be limited by the server. If zero server returns
1759
- # a page of max size 100.
1779
+ # Size of the page. This value can be limited by the server. If zero server
1780
+ # returns a page of max size 100.
1760
1781
  # @param order_by [::String]
1761
1782
  # Comma separated list of fields to order by,
1762
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
1763
- # default sorting order is ascending, redundant space characters are
1783
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
1784
+ # default sorting order is ascending. Redundant space characters are
1764
1785
  # insignificant.
1765
1786
  #
1766
1787
  # Example: `name asc,update_time, create_time desc`
@@ -1864,8 +1885,9 @@ module Google
1864
1885
  # the default parameter values, pass an empty Hash as a request object (see above).
1865
1886
  #
1866
1887
  # @param name [::String]
1867
- # Required. Resource name of the organization and deidentify template to be deleted,
1868
- # for example `organizations/433245324/deidentifyTemplates/432452342` or
1888
+ # Required. Resource name of the organization and deidentify template to be
1889
+ # deleted, for example
1890
+ # `organizations/433245324/deidentifyTemplates/432452342` or
1869
1891
  # projects/project-id/deidentifyTemplates/432452342.
1870
1892
  #
1871
1893
  # @yield [response, operation] Access the result along with the RPC operation
@@ -2155,8 +2177,8 @@ module Google
2155
2177
  # the default parameter values, pass an empty Hash as a request object (see above).
2156
2178
  #
2157
2179
  # @param name [::String]
2158
- # Required. Resource name of the trigger to execute a hybrid inspect on, for example
2159
- # `projects/dlp-test-project/jobTriggers/53234423`.
2180
+ # Required. Resource name of the trigger to execute a hybrid inspect on, for
2181
+ # example `projects/dlp-test-project/jobTriggers/53234423`.
2160
2182
  # @param hybrid_item [::Google::Cloud::Dlp::V2::HybridContentItem, ::Hash]
2161
2183
  # The item to inspect.
2162
2184
  #
@@ -2348,15 +2370,15 @@ module Google
2348
2370
  #
2349
2371
  # parent=projects/example-project/locations/europe-west3
2350
2372
  # @param page_token [::String]
2351
- # Page token to continue retrieval. Comes from previous call
2373
+ # Page token to continue retrieval. Comes from the previous call
2352
2374
  # to ListJobTriggers. `order_by` field must not
2353
2375
  # change for subsequent calls.
2354
2376
  # @param page_size [::Integer]
2355
- # Size of the page, can be limited by a server.
2377
+ # Size of the page. This value can be limited by a server.
2356
2378
  # @param order_by [::String]
2357
2379
  # Comma separated list of triggeredJob fields to order by,
2358
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
2359
- # default sorting order is ascending, redundant space characters are
2380
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
2381
+ # default sorting order is ascending. Redundant space characters are
2360
2382
  # insignificant.
2361
2383
  #
2362
2384
  # Example: `name asc,update_time, create_time desc`
@@ -2642,6 +2664,487 @@ module Google
2642
2664
  raise ::Google::Cloud::Error.from_error(e)
2643
2665
  end
2644
2666
 
2667
+ ##
2668
+ # Creates a config for discovery to scan and profile storage.
2669
+ #
2670
+ # @overload create_discovery_config(request, options = nil)
2671
+ # Pass arguments to `create_discovery_config` via a request object, either of type
2672
+ # {::Google::Cloud::Dlp::V2::CreateDiscoveryConfigRequest} or an equivalent Hash.
2673
+ #
2674
+ # @param request [::Google::Cloud::Dlp::V2::CreateDiscoveryConfigRequest, ::Hash]
2675
+ # A request object representing the call parameters. Required. To specify no
2676
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2677
+ # @param options [::Gapic::CallOptions, ::Hash]
2678
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2679
+ #
2680
+ # @overload create_discovery_config(parent: nil, discovery_config: nil, config_id: nil)
2681
+ # Pass arguments to `create_discovery_config` via keyword arguments. Note that at
2682
+ # least one keyword argument is required. To specify no parameters, or to keep all
2683
+ # the default parameter values, pass an empty Hash as a request object (see above).
2684
+ #
2685
+ # @param parent [::String]
2686
+ # Required. Parent resource name.
2687
+ #
2688
+ # The format of this value is as follows:
2689
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
2690
+ #
2691
+ # The following example `parent` string specifies a parent project with the
2692
+ # identifier `example-project`, and specifies the `europe-west3` location
2693
+ # for processing data:
2694
+ #
2695
+ # parent=projects/example-project/locations/europe-west3
2696
+ # @param discovery_config [::Google::Cloud::Dlp::V2::DiscoveryConfig, ::Hash]
2697
+ # Required. The DiscoveryConfig to create.
2698
+ # @param config_id [::String]
2699
+ # The config ID can contain uppercase and lowercase letters,
2700
+ # numbers, and hyphens; that is, it must match the regular
2701
+ # expression: `[a-zA-Z\d-_]+`. The maximum length is 100
2702
+ # characters. Can be empty to allow the system to generate one.
2703
+ #
2704
+ # @yield [response, operation] Access the result along with the RPC operation
2705
+ # @yieldparam response [::Google::Cloud::Dlp::V2::DiscoveryConfig]
2706
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2707
+ #
2708
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryConfig]
2709
+ #
2710
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2711
+ #
2712
+ # @example Basic example
2713
+ # require "google/cloud/dlp/v2"
2714
+ #
2715
+ # # Create a client object. The client can be reused for multiple calls.
2716
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
2717
+ #
2718
+ # # Create a request. To set request fields, pass in keyword arguments.
2719
+ # request = Google::Cloud::Dlp::V2::CreateDiscoveryConfigRequest.new
2720
+ #
2721
+ # # Call the create_discovery_config method.
2722
+ # result = client.create_discovery_config request
2723
+ #
2724
+ # # The returned object is of type Google::Cloud::Dlp::V2::DiscoveryConfig.
2725
+ # p result
2726
+ #
2727
+ def create_discovery_config request, options = nil
2728
+ raise ::ArgumentError, "request must be provided" if request.nil?
2729
+
2730
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dlp::V2::CreateDiscoveryConfigRequest
2731
+
2732
+ # Converts hash and nil to an options object
2733
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2734
+
2735
+ # Customize the options with defaults
2736
+ metadata = @config.rpcs.create_discovery_config.metadata.to_h
2737
+
2738
+ # Set x-goog-api-client and x-goog-user-project headers
2739
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2740
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2741
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2742
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2743
+
2744
+ header_params = {}
2745
+ if request.parent
2746
+ header_params["parent"] = request.parent
2747
+ end
2748
+
2749
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2750
+ metadata[:"x-goog-request-params"] ||= request_params_header
2751
+
2752
+ options.apply_defaults timeout: @config.rpcs.create_discovery_config.timeout,
2753
+ metadata: metadata,
2754
+ retry_policy: @config.rpcs.create_discovery_config.retry_policy
2755
+
2756
+ options.apply_defaults timeout: @config.timeout,
2757
+ metadata: @config.metadata,
2758
+ retry_policy: @config.retry_policy
2759
+
2760
+ @dlp_service_stub.call_rpc :create_discovery_config, request, options: options do |response, operation|
2761
+ yield response, operation if block_given?
2762
+ return response
2763
+ end
2764
+ rescue ::GRPC::BadStatus => e
2765
+ raise ::Google::Cloud::Error.from_error(e)
2766
+ end
2767
+
2768
+ ##
2769
+ # Updates a discovery configuration.
2770
+ #
2771
+ # @overload update_discovery_config(request, options = nil)
2772
+ # Pass arguments to `update_discovery_config` via a request object, either of type
2773
+ # {::Google::Cloud::Dlp::V2::UpdateDiscoveryConfigRequest} or an equivalent Hash.
2774
+ #
2775
+ # @param request [::Google::Cloud::Dlp::V2::UpdateDiscoveryConfigRequest, ::Hash]
2776
+ # A request object representing the call parameters. Required. To specify no
2777
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2778
+ # @param options [::Gapic::CallOptions, ::Hash]
2779
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2780
+ #
2781
+ # @overload update_discovery_config(name: nil, discovery_config: nil, update_mask: nil)
2782
+ # Pass arguments to `update_discovery_config` via keyword arguments. Note that at
2783
+ # least one keyword argument is required. To specify no parameters, or to keep all
2784
+ # the default parameter values, pass an empty Hash as a request object (see above).
2785
+ #
2786
+ # @param name [::String]
2787
+ # Required. Resource name of the project and the configuration, for example
2788
+ # `projects/dlp-test-project/discoveryConfigs/53234423`.
2789
+ # @param discovery_config [::Google::Cloud::Dlp::V2::DiscoveryConfig, ::Hash]
2790
+ # Required. New DiscoveryConfig value.
2791
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2792
+ # Mask to control which fields get updated.
2793
+ #
2794
+ # @yield [response, operation] Access the result along with the RPC operation
2795
+ # @yieldparam response [::Google::Cloud::Dlp::V2::DiscoveryConfig]
2796
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2797
+ #
2798
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryConfig]
2799
+ #
2800
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2801
+ #
2802
+ # @example Basic example
2803
+ # require "google/cloud/dlp/v2"
2804
+ #
2805
+ # # Create a client object. The client can be reused for multiple calls.
2806
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
2807
+ #
2808
+ # # Create a request. To set request fields, pass in keyword arguments.
2809
+ # request = Google::Cloud::Dlp::V2::UpdateDiscoveryConfigRequest.new
2810
+ #
2811
+ # # Call the update_discovery_config method.
2812
+ # result = client.update_discovery_config request
2813
+ #
2814
+ # # The returned object is of type Google::Cloud::Dlp::V2::DiscoveryConfig.
2815
+ # p result
2816
+ #
2817
+ def update_discovery_config request, options = nil
2818
+ raise ::ArgumentError, "request must be provided" if request.nil?
2819
+
2820
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dlp::V2::UpdateDiscoveryConfigRequest
2821
+
2822
+ # Converts hash and nil to an options object
2823
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2824
+
2825
+ # Customize the options with defaults
2826
+ metadata = @config.rpcs.update_discovery_config.metadata.to_h
2827
+
2828
+ # Set x-goog-api-client and x-goog-user-project headers
2829
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2830
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2831
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2832
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2833
+
2834
+ header_params = {}
2835
+ if request.name
2836
+ header_params["name"] = request.name
2837
+ end
2838
+
2839
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2840
+ metadata[:"x-goog-request-params"] ||= request_params_header
2841
+
2842
+ options.apply_defaults timeout: @config.rpcs.update_discovery_config.timeout,
2843
+ metadata: metadata,
2844
+ retry_policy: @config.rpcs.update_discovery_config.retry_policy
2845
+
2846
+ options.apply_defaults timeout: @config.timeout,
2847
+ metadata: @config.metadata,
2848
+ retry_policy: @config.retry_policy
2849
+
2850
+ @dlp_service_stub.call_rpc :update_discovery_config, request, options: options do |response, operation|
2851
+ yield response, operation if block_given?
2852
+ return response
2853
+ end
2854
+ rescue ::GRPC::BadStatus => e
2855
+ raise ::Google::Cloud::Error.from_error(e)
2856
+ end
2857
+
2858
+ ##
2859
+ # Gets a discovery configuration.
2860
+ #
2861
+ # @overload get_discovery_config(request, options = nil)
2862
+ # Pass arguments to `get_discovery_config` via a request object, either of type
2863
+ # {::Google::Cloud::Dlp::V2::GetDiscoveryConfigRequest} or an equivalent Hash.
2864
+ #
2865
+ # @param request [::Google::Cloud::Dlp::V2::GetDiscoveryConfigRequest, ::Hash]
2866
+ # A request object representing the call parameters. Required. To specify no
2867
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2868
+ # @param options [::Gapic::CallOptions, ::Hash]
2869
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2870
+ #
2871
+ # @overload get_discovery_config(name: nil)
2872
+ # Pass arguments to `get_discovery_config` via keyword arguments. Note that at
2873
+ # least one keyword argument is required. To specify no parameters, or to keep all
2874
+ # the default parameter values, pass an empty Hash as a request object (see above).
2875
+ #
2876
+ # @param name [::String]
2877
+ # Required. Resource name of the project and the configuration, for example
2878
+ # `projects/dlp-test-project/discoveryConfigs/53234423`.
2879
+ #
2880
+ # @yield [response, operation] Access the result along with the RPC operation
2881
+ # @yieldparam response [::Google::Cloud::Dlp::V2::DiscoveryConfig]
2882
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2883
+ #
2884
+ # @return [::Google::Cloud::Dlp::V2::DiscoveryConfig]
2885
+ #
2886
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2887
+ #
2888
+ # @example Basic example
2889
+ # require "google/cloud/dlp/v2"
2890
+ #
2891
+ # # Create a client object. The client can be reused for multiple calls.
2892
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
2893
+ #
2894
+ # # Create a request. To set request fields, pass in keyword arguments.
2895
+ # request = Google::Cloud::Dlp::V2::GetDiscoveryConfigRequest.new
2896
+ #
2897
+ # # Call the get_discovery_config method.
2898
+ # result = client.get_discovery_config request
2899
+ #
2900
+ # # The returned object is of type Google::Cloud::Dlp::V2::DiscoveryConfig.
2901
+ # p result
2902
+ #
2903
+ def get_discovery_config request, options = nil
2904
+ raise ::ArgumentError, "request must be provided" if request.nil?
2905
+
2906
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dlp::V2::GetDiscoveryConfigRequest
2907
+
2908
+ # Converts hash and nil to an options object
2909
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2910
+
2911
+ # Customize the options with defaults
2912
+ metadata = @config.rpcs.get_discovery_config.metadata.to_h
2913
+
2914
+ # Set x-goog-api-client and x-goog-user-project headers
2915
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2916
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2917
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
2918
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2919
+
2920
+ header_params = {}
2921
+ if request.name
2922
+ header_params["name"] = request.name
2923
+ end
2924
+
2925
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2926
+ metadata[:"x-goog-request-params"] ||= request_params_header
2927
+
2928
+ options.apply_defaults timeout: @config.rpcs.get_discovery_config.timeout,
2929
+ metadata: metadata,
2930
+ retry_policy: @config.rpcs.get_discovery_config.retry_policy
2931
+
2932
+ options.apply_defaults timeout: @config.timeout,
2933
+ metadata: @config.metadata,
2934
+ retry_policy: @config.retry_policy
2935
+
2936
+ @dlp_service_stub.call_rpc :get_discovery_config, request, options: options do |response, operation|
2937
+ yield response, operation if block_given?
2938
+ return response
2939
+ end
2940
+ rescue ::GRPC::BadStatus => e
2941
+ raise ::Google::Cloud::Error.from_error(e)
2942
+ end
2943
+
2944
+ ##
2945
+ # Lists discovery configurations.
2946
+ #
2947
+ # @overload list_discovery_configs(request, options = nil)
2948
+ # Pass arguments to `list_discovery_configs` via a request object, either of type
2949
+ # {::Google::Cloud::Dlp::V2::ListDiscoveryConfigsRequest} or an equivalent Hash.
2950
+ #
2951
+ # @param request [::Google::Cloud::Dlp::V2::ListDiscoveryConfigsRequest, ::Hash]
2952
+ # A request object representing the call parameters. Required. To specify no
2953
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2954
+ # @param options [::Gapic::CallOptions, ::Hash]
2955
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2956
+ #
2957
+ # @overload list_discovery_configs(parent: nil, page_token: nil, page_size: nil, order_by: nil)
2958
+ # Pass arguments to `list_discovery_configs` via keyword arguments. Note that at
2959
+ # least one keyword argument is required. To specify no parameters, or to keep all
2960
+ # the default parameter values, pass an empty Hash as a request object (see above).
2961
+ #
2962
+ # @param parent [::String]
2963
+ # Required. Parent resource name.
2964
+ #
2965
+ # The format of this value is as follows:
2966
+ # `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
2967
+ #
2968
+ # The following example `parent` string specifies a parent project with the
2969
+ # identifier `example-project`, and specifies the `europe-west3` location
2970
+ # for processing data:
2971
+ #
2972
+ # parent=projects/example-project/locations/europe-west3
2973
+ # @param page_token [::String]
2974
+ # Page token to continue retrieval. Comes from the previous call
2975
+ # to ListDiscoveryConfigs. `order_by` field must not
2976
+ # change for subsequent calls.
2977
+ # @param page_size [::Integer]
2978
+ # Size of the page. This value can be limited by a server.
2979
+ # @param order_by [::String]
2980
+ # Comma separated list of config fields to order by,
2981
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
2982
+ # default sorting order is ascending. Redundant space characters are
2983
+ # insignificant.
2984
+ #
2985
+ # Example: `name asc,update_time, create_time desc`
2986
+ #
2987
+ # Supported fields are:
2988
+ #
2989
+ # - `last_run_time`: corresponds to the last time the DiscoveryConfig ran.
2990
+ # - `name`: corresponds to the DiscoveryConfig's name.
2991
+ # - `status`: corresponds to DiscoveryConfig's status.
2992
+ #
2993
+ # @yield [response, operation] Access the result along with the RPC operation
2994
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Dlp::V2::DiscoveryConfig>]
2995
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2996
+ #
2997
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Dlp::V2::DiscoveryConfig>]
2998
+ #
2999
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3000
+ #
3001
+ # @example Basic example
3002
+ # require "google/cloud/dlp/v2"
3003
+ #
3004
+ # # Create a client object. The client can be reused for multiple calls.
3005
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
3006
+ #
3007
+ # # Create a request. To set request fields, pass in keyword arguments.
3008
+ # request = Google::Cloud::Dlp::V2::ListDiscoveryConfigsRequest.new
3009
+ #
3010
+ # # Call the list_discovery_configs method.
3011
+ # result = client.list_discovery_configs request
3012
+ #
3013
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3014
+ # # over elements, and API calls will be issued to fetch pages as needed.
3015
+ # result.each do |item|
3016
+ # # Each element is of type ::Google::Cloud::Dlp::V2::DiscoveryConfig.
3017
+ # p item
3018
+ # end
3019
+ #
3020
+ def list_discovery_configs request, options = nil
3021
+ raise ::ArgumentError, "request must be provided" if request.nil?
3022
+
3023
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dlp::V2::ListDiscoveryConfigsRequest
3024
+
3025
+ # Converts hash and nil to an options object
3026
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3027
+
3028
+ # Customize the options with defaults
3029
+ metadata = @config.rpcs.list_discovery_configs.metadata.to_h
3030
+
3031
+ # Set x-goog-api-client and x-goog-user-project headers
3032
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3033
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3034
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
3035
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3036
+
3037
+ header_params = {}
3038
+ if request.parent
3039
+ header_params["parent"] = request.parent
3040
+ end
3041
+
3042
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3043
+ metadata[:"x-goog-request-params"] ||= request_params_header
3044
+
3045
+ options.apply_defaults timeout: @config.rpcs.list_discovery_configs.timeout,
3046
+ metadata: metadata,
3047
+ retry_policy: @config.rpcs.list_discovery_configs.retry_policy
3048
+
3049
+ options.apply_defaults timeout: @config.timeout,
3050
+ metadata: @config.metadata,
3051
+ retry_policy: @config.retry_policy
3052
+
3053
+ @dlp_service_stub.call_rpc :list_discovery_configs, request, options: options do |response, operation|
3054
+ response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_discovery_configs, request, response, operation, options
3055
+ yield response, operation if block_given?
3056
+ return response
3057
+ end
3058
+ rescue ::GRPC::BadStatus => e
3059
+ raise ::Google::Cloud::Error.from_error(e)
3060
+ end
3061
+
3062
+ ##
3063
+ # Deletes a discovery configuration.
3064
+ #
3065
+ # @overload delete_discovery_config(request, options = nil)
3066
+ # Pass arguments to `delete_discovery_config` via a request object, either of type
3067
+ # {::Google::Cloud::Dlp::V2::DeleteDiscoveryConfigRequest} or an equivalent Hash.
3068
+ #
3069
+ # @param request [::Google::Cloud::Dlp::V2::DeleteDiscoveryConfigRequest, ::Hash]
3070
+ # A request object representing the call parameters. Required. To specify no
3071
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3072
+ # @param options [::Gapic::CallOptions, ::Hash]
3073
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3074
+ #
3075
+ # @overload delete_discovery_config(name: nil)
3076
+ # Pass arguments to `delete_discovery_config` via keyword arguments. Note that at
3077
+ # least one keyword argument is required. To specify no parameters, or to keep all
3078
+ # the default parameter values, pass an empty Hash as a request object (see above).
3079
+ #
3080
+ # @param name [::String]
3081
+ # Required. Resource name of the project and the config, for example
3082
+ # `projects/dlp-test-project/discoveryConfigs/53234423`.
3083
+ #
3084
+ # @yield [response, operation] Access the result along with the RPC operation
3085
+ # @yieldparam response [::Google::Protobuf::Empty]
3086
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3087
+ #
3088
+ # @return [::Google::Protobuf::Empty]
3089
+ #
3090
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3091
+ #
3092
+ # @example Basic example
3093
+ # require "google/cloud/dlp/v2"
3094
+ #
3095
+ # # Create a client object. The client can be reused for multiple calls.
3096
+ # client = Google::Cloud::Dlp::V2::DlpService::Client.new
3097
+ #
3098
+ # # Create a request. To set request fields, pass in keyword arguments.
3099
+ # request = Google::Cloud::Dlp::V2::DeleteDiscoveryConfigRequest.new
3100
+ #
3101
+ # # Call the delete_discovery_config method.
3102
+ # result = client.delete_discovery_config request
3103
+ #
3104
+ # # The returned object is of type Google::Protobuf::Empty.
3105
+ # p result
3106
+ #
3107
+ def delete_discovery_config request, options = nil
3108
+ raise ::ArgumentError, "request must be provided" if request.nil?
3109
+
3110
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dlp::V2::DeleteDiscoveryConfigRequest
3111
+
3112
+ # Converts hash and nil to an options object
3113
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3114
+
3115
+ # Customize the options with defaults
3116
+ metadata = @config.rpcs.delete_discovery_config.metadata.to_h
3117
+
3118
+ # Set x-goog-api-client and x-goog-user-project headers
3119
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3120
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3121
+ gapic_version: ::Google::Cloud::Dlp::V2::VERSION
3122
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3123
+
3124
+ header_params = {}
3125
+ if request.name
3126
+ header_params["name"] = request.name
3127
+ end
3128
+
3129
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3130
+ metadata[:"x-goog-request-params"] ||= request_params_header
3131
+
3132
+ options.apply_defaults timeout: @config.rpcs.delete_discovery_config.timeout,
3133
+ metadata: metadata,
3134
+ retry_policy: @config.rpcs.delete_discovery_config.retry_policy
3135
+
3136
+ options.apply_defaults timeout: @config.timeout,
3137
+ metadata: @config.metadata,
3138
+ retry_policy: @config.retry_policy
3139
+
3140
+ @dlp_service_stub.call_rpc :delete_discovery_config, request, options: options do |response, operation|
3141
+ yield response, operation if block_given?
3142
+ return response
3143
+ end
3144
+ rescue ::GRPC::BadStatus => e
3145
+ raise ::Google::Cloud::Error.from_error(e)
3146
+ end
3147
+
2645
3148
  ##
2646
3149
  # Creates a new job to inspect storage or calculate risk metrics.
2647
3150
  # See https://cloud.google.com/dlp/docs/inspecting-storage and
@@ -2834,8 +3337,8 @@ module Google
2834
3337
  # The type of job. Defaults to `DlpJobType.INSPECT`
2835
3338
  # @param order_by [::String]
2836
3339
  # Comma separated list of fields to order by,
2837
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
2838
- # default sorting order is ascending, redundant space characters are
3340
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
3341
+ # default sorting order is ascending. Redundant space characters are
2839
3342
  # insignificant.
2840
3343
  #
2841
3344
  # Example: `name asc, end_time asc, create_time desc`
@@ -3320,8 +3823,8 @@ module Google
3320
3823
  # the default parameter values, pass an empty Hash as a request object (see above).
3321
3824
  #
3322
3825
  # @param name [::String]
3323
- # Required. Resource name of organization and storedInfoType to be updated, for
3324
- # example `organizations/433245324/storedInfoTypes/432452342` or
3826
+ # Required. Resource name of organization and storedInfoType to be updated,
3827
+ # for example `organizations/433245324/storedInfoTypes/432452342` or
3325
3828
  # projects/project-id/storedInfoTypes/432452342.
3326
3829
  # @param config [::Google::Cloud::Dlp::V2::StoredInfoTypeConfig, ::Hash]
3327
3830
  # Updated configuration for the storedInfoType. If not provided, a new
@@ -3415,8 +3918,8 @@ module Google
3415
3918
  # the default parameter values, pass an empty Hash as a request object (see above).
3416
3919
  #
3417
3920
  # @param name [::String]
3418
- # Required. Resource name of the organization and storedInfoType to be read, for
3419
- # example `organizations/433245324/storedInfoTypes/432452342` or
3921
+ # Required. Resource name of the organization and storedInfoType to be read,
3922
+ # for example `organizations/433245324/storedInfoTypes/432452342` or
3420
3923
  # projects/project-id/storedInfoTypes/432452342.
3421
3924
  #
3422
3925
  # @yield [response, operation] Access the result along with the RPC operation
@@ -3521,15 +4024,15 @@ module Google
3521
4024
  #
3522
4025
  # parent=projects/example-project/locations/europe-west3
3523
4026
  # @param page_token [::String]
3524
- # Page token to continue retrieval. Comes from previous call
4027
+ # Page token to continue retrieval. Comes from the previous call
3525
4028
  # to `ListStoredInfoTypes`.
3526
4029
  # @param page_size [::Integer]
3527
- # Size of the page, can be limited by the server. If zero server returns
3528
- # a page of max size 100.
4030
+ # Size of the page. This value can be limited by the server. If zero server
4031
+ # returns a page of max size 100.
3529
4032
  # @param order_by [::String]
3530
4033
  # Comma separated list of fields to order by,
3531
- # followed by `asc` or `desc` postfix. This list is case-insensitive,
3532
- # default sorting order is ascending, redundant space characters are
4034
+ # followed by `asc` or `desc` postfix. This list is case insensitive. The
4035
+ # default sorting order is ascending. Redundant space characters are
3533
4036
  # insignificant.
3534
4037
  #
3535
4038
  # Example: `name asc, display_name, create_time desc`
@@ -3634,8 +4137,8 @@ module Google
3634
4137
  # the default parameter values, pass an empty Hash as a request object (see above).
3635
4138
  #
3636
4139
  # @param name [::String]
3637
- # Required. Resource name of the organization and storedInfoType to be deleted, for
3638
- # example `organizations/433245324/storedInfoTypes/432452342` or
4140
+ # Required. Resource name of the organization and storedInfoType to be
4141
+ # deleted, for example `organizations/433245324/storedInfoTypes/432452342` or
3639
4142
  # projects/project-id/storedInfoTypes/432452342.
3640
4143
  #
3641
4144
  # @yield [response, operation] Access the result along with the RPC operation
@@ -3723,8 +4226,8 @@ module Google
3723
4226
  # the default parameter values, pass an empty Hash as a request object (see above).
3724
4227
  #
3725
4228
  # @param name [::String]
3726
- # Required. Resource name of the job to execute a hybrid inspect on, for example
3727
- # `projects/dlp-test-project/dlpJob/53234423`.
4229
+ # Required. Resource name of the job to execute a hybrid inspect on, for
4230
+ # example `projects/dlp-test-project/dlpJob/53234423`.
3728
4231
  # @param hybrid_item [::Google::Cloud::Dlp::V2::HybridContentItem, ::Hash]
3729
4232
  # The item to inspect.
3730
4233
  #
@@ -3997,6 +4500,14 @@ module Google
3997
4500
  end
3998
4501
  end
3999
4502
 
4503
+ ##
4504
+ # Configuration for the channel pool
4505
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
4506
+ #
4507
+ def channel_pool
4508
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
4509
+ end
4510
+
4000
4511
  ##
4001
4512
  # Configuration RPC class for the DlpService API.
4002
4513
  #
@@ -4126,6 +4637,31 @@ module Google
4126
4637
  #
4127
4638
  attr_reader :activate_job_trigger
4128
4639
  ##
4640
+ # RPC-specific configuration for `create_discovery_config`
4641
+ # @return [::Gapic::Config::Method]
4642
+ #
4643
+ attr_reader :create_discovery_config
4644
+ ##
4645
+ # RPC-specific configuration for `update_discovery_config`
4646
+ # @return [::Gapic::Config::Method]
4647
+ #
4648
+ attr_reader :update_discovery_config
4649
+ ##
4650
+ # RPC-specific configuration for `get_discovery_config`
4651
+ # @return [::Gapic::Config::Method]
4652
+ #
4653
+ attr_reader :get_discovery_config
4654
+ ##
4655
+ # RPC-specific configuration for `list_discovery_configs`
4656
+ # @return [::Gapic::Config::Method]
4657
+ #
4658
+ attr_reader :list_discovery_configs
4659
+ ##
4660
+ # RPC-specific configuration for `delete_discovery_config`
4661
+ # @return [::Gapic::Config::Method]
4662
+ #
4663
+ attr_reader :delete_discovery_config
4664
+ ##
4129
4665
  # RPC-specific configuration for `create_dlp_job`
4130
4666
  # @return [::Gapic::Config::Method]
4131
4667
  #
@@ -4232,6 +4768,16 @@ module Google
4232
4768
  @delete_job_trigger = ::Gapic::Config::Method.new delete_job_trigger_config
4233
4769
  activate_job_trigger_config = parent_rpcs.activate_job_trigger if parent_rpcs.respond_to? :activate_job_trigger
4234
4770
  @activate_job_trigger = ::Gapic::Config::Method.new activate_job_trigger_config
4771
+ create_discovery_config_config = parent_rpcs.create_discovery_config if parent_rpcs.respond_to? :create_discovery_config
4772
+ @create_discovery_config = ::Gapic::Config::Method.new create_discovery_config_config
4773
+ update_discovery_config_config = parent_rpcs.update_discovery_config if parent_rpcs.respond_to? :update_discovery_config
4774
+ @update_discovery_config = ::Gapic::Config::Method.new update_discovery_config_config
4775
+ get_discovery_config_config = parent_rpcs.get_discovery_config if parent_rpcs.respond_to? :get_discovery_config
4776
+ @get_discovery_config = ::Gapic::Config::Method.new get_discovery_config_config
4777
+ list_discovery_configs_config = parent_rpcs.list_discovery_configs if parent_rpcs.respond_to? :list_discovery_configs
4778
+ @list_discovery_configs = ::Gapic::Config::Method.new list_discovery_configs_config
4779
+ delete_discovery_config_config = parent_rpcs.delete_discovery_config if parent_rpcs.respond_to? :delete_discovery_config
4780
+ @delete_discovery_config = ::Gapic::Config::Method.new delete_discovery_config_config
4235
4781
  create_dlp_job_config = parent_rpcs.create_dlp_job if parent_rpcs.respond_to? :create_dlp_job
4236
4782
  @create_dlp_job = ::Gapic::Config::Method.new create_dlp_job_config
4237
4783
  list_dlp_jobs_config = parent_rpcs.list_dlp_jobs if parent_rpcs.respond_to? :list_dlp_jobs