google-cloud-dataplex-v1 2.9.0 → 2.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/dataplex/v1/analyze_pb.rb +2 -25
  4. data/lib/google/cloud/dataplex/v1/approval_workflow_pb.rb +33 -0
  5. data/lib/google/cloud/dataplex/v1/bindings_override.rb +24 -24
  6. data/lib/google/cloud/dataplex/v1/business_glossary_pb.rb +3 -26
  7. data/lib/google/cloud/dataplex/v1/business_glossary_service/client.rb +2 -0
  8. data/lib/google/cloud/dataplex/v1/business_glossary_service/credentials.rb +4 -1
  9. data/lib/google/cloud/dataplex/v1/business_glossary_service/operations.rb +2 -0
  10. data/lib/google/cloud/dataplex/v1/business_glossary_service/rest/client.rb +2 -0
  11. data/lib/google/cloud/dataplex/v1/business_glossary_service/rest/operations.rb +2 -0
  12. data/lib/google/cloud/dataplex/v1/catalog_pb.rb +20 -27
  13. data/lib/google/cloud/dataplex/v1/catalog_service/client.rb +1074 -73
  14. data/lib/google/cloud/dataplex/v1/catalog_service/credentials.rb +4 -1
  15. data/lib/google/cloud/dataplex/v1/catalog_service/operations.rb +2 -0
  16. data/lib/google/cloud/dataplex/v1/catalog_service/paths.rb +19 -0
  17. data/lib/google/cloud/dataplex/v1/catalog_service/rest/client.rb +1020 -82
  18. data/lib/google/cloud/dataplex/v1/catalog_service/rest/operations.rb +2 -0
  19. data/lib/google/cloud/dataplex/v1/catalog_service/rest/service_stub.rb +554 -0
  20. data/lib/google/cloud/dataplex/v1/catalog_services_pb.rb +18 -15
  21. data/lib/google/cloud/dataplex/v1/cmek_pb.rb +3 -26
  22. data/lib/google/cloud/dataplex/v1/cmek_service/client.rb +2 -0
  23. data/lib/google/cloud/dataplex/v1/cmek_service/credentials.rb +2 -1
  24. data/lib/google/cloud/dataplex/v1/cmek_service/operations.rb +2 -0
  25. data/lib/google/cloud/dataplex/v1/cmek_service/rest/client.rb +2 -0
  26. data/lib/google/cloud/dataplex/v1/cmek_service/rest/operations.rb +2 -0
  27. data/lib/google/cloud/dataplex/v1/content_pb.rb +3 -38
  28. data/lib/google/cloud/dataplex/v1/content_services_pb.rb +0 -49
  29. data/lib/google/cloud/dataplex/v1/data_discovery_pb.rb +4 -24
  30. data/lib/google/cloud/dataplex/v1/data_documentation_pb.rb +10 -24
  31. data/lib/google/cloud/dataplex/v1/data_product_service/client.rb +1644 -0
  32. data/lib/google/cloud/dataplex/v1/{content_service → data_product_service}/credentials.rb +7 -4
  33. data/lib/google/cloud/dataplex/v1/data_product_service/operations.rb +843 -0
  34. data/lib/google/cloud/dataplex/v1/data_product_service/paths.rb +231 -0
  35. data/lib/google/cloud/dataplex/v1/data_product_service/rest/client.rb +1533 -0
  36. data/lib/google/cloud/dataplex/v1/data_product_service/rest/operations.rb +956 -0
  37. data/lib/google/cloud/dataplex/v1/{content_service → data_product_service}/rest/service_stub.rb +284 -160
  38. data/lib/google/cloud/dataplex/v1/{content_service → data_product_service}/rest.rb +11 -10
  39. data/lib/google/cloud/dataplex/v1/{content_service.rb → data_product_service.rb} +15 -14
  40. data/lib/google/cloud/dataplex/v1/data_products_pb.rb +52 -0
  41. data/lib/google/cloud/dataplex/v1/data_products_services_pb.rb +69 -0
  42. data/lib/google/cloud/dataplex/v1/data_profile_pb.rb +4 -26
  43. data/lib/google/cloud/dataplex/v1/data_quality_pb.rb +13 -26
  44. data/lib/google/cloud/dataplex/v1/data_quality_rule_template_pb.rb +25 -0
  45. data/lib/google/cloud/dataplex/v1/data_scan_service/client.rb +99 -1
  46. data/lib/google/cloud/dataplex/v1/data_scan_service/credentials.rb +4 -1
  47. data/lib/google/cloud/dataplex/v1/data_scan_service/operations.rb +2 -0
  48. data/lib/google/cloud/dataplex/v1/data_scan_service/paths.rb +21 -0
  49. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/client.rb +92 -1
  50. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/operations.rb +2 -0
  51. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/service_stub.rb +62 -0
  52. data/lib/google/cloud/dataplex/v1/data_taxonomy_pb.rb +3 -27
  53. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/client.rb +2 -0
  54. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/credentials.rb +2 -1
  55. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/operations.rb +2 -0
  56. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/client.rb +2 -0
  57. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/operations.rb +2 -0
  58. data/lib/google/cloud/dataplex/v1/dataplex_service/client.rb +2 -664
  59. data/lib/google/cloud/dataplex/v1/dataplex_service/credentials.rb +4 -1
  60. data/lib/google/cloud/dataplex/v1/dataplex_service/operations.rb +2 -0
  61. data/lib/google/cloud/dataplex/v1/dataplex_service/paths.rb +0 -21
  62. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/client.rb +2 -622
  63. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/operations.rb +2 -0
  64. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/service_stub.rb +0 -368
  65. data/lib/google/cloud/dataplex/v1/datascans_common_pb.rb +3 -24
  66. data/lib/google/cloud/dataplex/v1/datascans_pb.rb +9 -31
  67. data/lib/google/cloud/dataplex/v1/datascans_services_pb.rb +2 -0
  68. data/lib/google/cloud/dataplex/v1/logs_pb.rb +3 -27
  69. data/lib/google/cloud/dataplex/v1/metadata_pb.rb +3 -25
  70. data/lib/google/cloud/dataplex/v1/metadata_service/client.rb +2 -0
  71. data/lib/google/cloud/dataplex/v1/metadata_service/credentials.rb +2 -1
  72. data/lib/google/cloud/dataplex/v1/metadata_service/rest/client.rb +2 -0
  73. data/lib/google/cloud/dataplex/v1/processing_pb.rb +5 -24
  74. data/lib/google/cloud/dataplex/v1/resources_pb.rb +2 -25
  75. data/lib/google/cloud/dataplex/v1/rest.rb +1 -1
  76. data/lib/google/cloud/dataplex/v1/security_pb.rb +2 -23
  77. data/lib/google/cloud/dataplex/v1/service_pb.rb +3 -38
  78. data/lib/google/cloud/dataplex/v1/service_services_pb.rb +0 -13
  79. data/lib/google/cloud/dataplex/v1/tasks_pb.rb +2 -25
  80. data/lib/google/cloud/dataplex/v1/version.rb +1 -1
  81. data/lib/google/cloud/dataplex/v1.rb +1 -0
  82. data/proto_docs/google/api/client.rb +149 -29
  83. data/proto_docs/google/cloud/dataplex/v1/approval_workflow.rb +263 -0
  84. data/proto_docs/google/cloud/dataplex/v1/catalog.rb +427 -3
  85. data/proto_docs/google/cloud/dataplex/v1/data_discovery.rb +13 -0
  86. data/proto_docs/google/cloud/dataplex/v1/data_documentation.rb +118 -2
  87. data/proto_docs/google/cloud/dataplex/v1/data_products.rb +567 -0
  88. data/proto_docs/google/cloud/dataplex/v1/data_profile.rb +21 -0
  89. data/proto_docs/google/cloud/dataplex/v1/data_quality.rb +240 -10
  90. data/proto_docs/google/cloud/dataplex/v1/data_quality_rule_template.rb +88 -0
  91. data/proto_docs/google/cloud/dataplex/v1/datascans.rb +82 -5
  92. data/proto_docs/google/cloud/dataplex/v1/datascans_common.rb +7 -3
  93. data/proto_docs/google/cloud/dataplex/v1/logs.rb +7 -0
  94. data/proto_docs/google/cloud/dataplex/v1/processing.rb +27 -3
  95. data/proto_docs/google/cloud/dataplex/v1/service.rb +0 -148
  96. metadata +20 -12
  97. data/lib/google/cloud/dataplex/v1/content_service/client.rb +0 -1261
  98. data/lib/google/cloud/dataplex/v1/content_service/paths.rb +0 -73
  99. data/lib/google/cloud/dataplex/v1/content_service/rest/client.rb +0 -1171
  100. data/proto_docs/google/cloud/dataplex/v1/content.rb +0 -142
@@ -167,22 +167,6 @@ module Google
167
167
 
168
168
  default_config.rpcs.cancel_job.timeout = 60.0
169
169
 
170
- default_config.rpcs.create_environment.timeout = 60.0
171
-
172
- default_config.rpcs.update_environment.timeout = 60.0
173
-
174
- default_config.rpcs.delete_environment.timeout = 60.0
175
-
176
- default_config.rpcs.list_environments.timeout = 60.0
177
- default_config.rpcs.list_environments.retry_policy = {
178
- initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
179
- }
180
-
181
- default_config.rpcs.get_environment.timeout = 60.0
182
- default_config.rpcs.get_environment.retry_policy = {
183
- initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
184
- }
185
-
186
170
  default_config
187
171
  end
188
172
  yield @configure if block_given?
@@ -2994,612 +2978,6 @@ module Google
2994
2978
  raise ::Google::Cloud::Error.from_error(e)
2995
2979
  end
2996
2980
 
2997
- ##
2998
- # Create an environment resource.
2999
- #
3000
- # @overload create_environment(request, options = nil)
3001
- # Pass arguments to `create_environment` via a request object, either of type
3002
- # {::Google::Cloud::Dataplex::V1::CreateEnvironmentRequest} or an equivalent Hash.
3003
- #
3004
- # @param request [::Google::Cloud::Dataplex::V1::CreateEnvironmentRequest, ::Hash]
3005
- # A request object representing the call parameters. Required. To specify no
3006
- # parameters, or to keep all the default parameter values, pass an empty Hash.
3007
- # @param options [::Gapic::CallOptions, ::Hash]
3008
- # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3009
- #
3010
- # @overload create_environment(parent: nil, environment_id: nil, environment: nil, validate_only: nil)
3011
- # Pass arguments to `create_environment` via keyword arguments. Note that at
3012
- # least one keyword argument is required. To specify no parameters, or to keep all
3013
- # the default parameter values, pass an empty Hash as a request object (see above).
3014
- #
3015
- # @param parent [::String]
3016
- # Required. The resource name of the parent lake:
3017
- # `projects/{project_id}/locations/{location_id}/lakes/{lake_id}`.
3018
- # @param environment_id [::String]
3019
- # Required. Environment identifier.
3020
- # * Must contain only lowercase letters, numbers and hyphens.
3021
- # * Must start with a letter.
3022
- # * Must be between 1-63 characters.
3023
- # * Must end with a number or a letter.
3024
- # * Must be unique within the lake.
3025
- # @param environment [::Google::Cloud::Dataplex::V1::Environment, ::Hash]
3026
- # Required. Environment resource.
3027
- # @param validate_only [::Boolean]
3028
- # Optional. Only validate the request, but do not perform mutations.
3029
- # The default is false.
3030
- #
3031
- # @yield [response, operation] Access the result along with the RPC operation
3032
- # @yieldparam response [::Gapic::Operation]
3033
- # @yieldparam operation [::GRPC::ActiveCall::Operation]
3034
- #
3035
- # @return [::Gapic::Operation]
3036
- #
3037
- # @raise [::Google::Cloud::Error] if the RPC is aborted.
3038
- #
3039
- # @example Basic example
3040
- # require "google/cloud/dataplex/v1"
3041
- #
3042
- # # Create a client object. The client can be reused for multiple calls.
3043
- # client = Google::Cloud::Dataplex::V1::DataplexService::Client.new
3044
- #
3045
- # # Create a request. To set request fields, pass in keyword arguments.
3046
- # request = Google::Cloud::Dataplex::V1::CreateEnvironmentRequest.new
3047
- #
3048
- # # Call the create_environment method.
3049
- # result = client.create_environment request
3050
- #
3051
- # # The returned object is of type Gapic::Operation. You can use it to
3052
- # # check the status of an operation, cancel it, or wait for results.
3053
- # # Here is how to wait for a response.
3054
- # result.wait_until_done! timeout: 60
3055
- # if result.response?
3056
- # p result.response
3057
- # else
3058
- # puts "No response received."
3059
- # end
3060
- #
3061
- def create_environment request, options = nil
3062
- raise ::ArgumentError, "request must be provided" if request.nil?
3063
-
3064
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::CreateEnvironmentRequest
3065
-
3066
- # Converts hash and nil to an options object
3067
- options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3068
-
3069
- # Customize the options with defaults
3070
- metadata = @config.rpcs.create_environment.metadata.to_h
3071
-
3072
- # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3073
- metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3074
- lib_name: @config.lib_name, lib_version: @config.lib_version,
3075
- gapic_version: ::Google::Cloud::Dataplex::V1::VERSION
3076
- metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3077
- metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3078
-
3079
- header_params = {}
3080
- if request.parent
3081
- header_params["parent"] = request.parent
3082
- end
3083
-
3084
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3085
- metadata[:"x-goog-request-params"] ||= request_params_header
3086
-
3087
- options.apply_defaults timeout: @config.rpcs.create_environment.timeout,
3088
- metadata: metadata,
3089
- retry_policy: @config.rpcs.create_environment.retry_policy
3090
-
3091
- options.apply_defaults timeout: @config.timeout,
3092
- metadata: @config.metadata,
3093
- retry_policy: @config.retry_policy
3094
-
3095
- @dataplex_service_stub.call_rpc :create_environment, request, options: options do |response, operation|
3096
- response = ::Gapic::Operation.new response, @operations_client, options: options
3097
- yield response, operation if block_given?
3098
- throw :response, response
3099
- end
3100
- rescue ::GRPC::BadStatus => e
3101
- raise ::Google::Cloud::Error.from_error(e)
3102
- end
3103
-
3104
- ##
3105
- # Update the environment resource.
3106
- #
3107
- # @overload update_environment(request, options = nil)
3108
- # Pass arguments to `update_environment` via a request object, either of type
3109
- # {::Google::Cloud::Dataplex::V1::UpdateEnvironmentRequest} or an equivalent Hash.
3110
- #
3111
- # @param request [::Google::Cloud::Dataplex::V1::UpdateEnvironmentRequest, ::Hash]
3112
- # A request object representing the call parameters. Required. To specify no
3113
- # parameters, or to keep all the default parameter values, pass an empty Hash.
3114
- # @param options [::Gapic::CallOptions, ::Hash]
3115
- # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3116
- #
3117
- # @overload update_environment(update_mask: nil, environment: nil, validate_only: nil)
3118
- # Pass arguments to `update_environment` via keyword arguments. Note that at
3119
- # least one keyword argument is required. To specify no parameters, or to keep all
3120
- # the default parameter values, pass an empty Hash as a request object (see above).
3121
- #
3122
- # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3123
- # Required. Mask of fields to update.
3124
- # @param environment [::Google::Cloud::Dataplex::V1::Environment, ::Hash]
3125
- # Required. Update description.
3126
- # Only fields specified in `update_mask` are updated.
3127
- # @param validate_only [::Boolean]
3128
- # Optional. Only validate the request, but do not perform mutations.
3129
- # The default is false.
3130
- #
3131
- # @yield [response, operation] Access the result along with the RPC operation
3132
- # @yieldparam response [::Gapic::Operation]
3133
- # @yieldparam operation [::GRPC::ActiveCall::Operation]
3134
- #
3135
- # @return [::Gapic::Operation]
3136
- #
3137
- # @raise [::Google::Cloud::Error] if the RPC is aborted.
3138
- #
3139
- # @example Basic example
3140
- # require "google/cloud/dataplex/v1"
3141
- #
3142
- # # Create a client object. The client can be reused for multiple calls.
3143
- # client = Google::Cloud::Dataplex::V1::DataplexService::Client.new
3144
- #
3145
- # # Create a request. To set request fields, pass in keyword arguments.
3146
- # request = Google::Cloud::Dataplex::V1::UpdateEnvironmentRequest.new
3147
- #
3148
- # # Call the update_environment method.
3149
- # result = client.update_environment request
3150
- #
3151
- # # The returned object is of type Gapic::Operation. You can use it to
3152
- # # check the status of an operation, cancel it, or wait for results.
3153
- # # Here is how to wait for a response.
3154
- # result.wait_until_done! timeout: 60
3155
- # if result.response?
3156
- # p result.response
3157
- # else
3158
- # puts "No response received."
3159
- # end
3160
- #
3161
- def update_environment request, options = nil
3162
- raise ::ArgumentError, "request must be provided" if request.nil?
3163
-
3164
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::UpdateEnvironmentRequest
3165
-
3166
- # Converts hash and nil to an options object
3167
- options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3168
-
3169
- # Customize the options with defaults
3170
- metadata = @config.rpcs.update_environment.metadata.to_h
3171
-
3172
- # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3173
- metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3174
- lib_name: @config.lib_name, lib_version: @config.lib_version,
3175
- gapic_version: ::Google::Cloud::Dataplex::V1::VERSION
3176
- metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3177
- metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3178
-
3179
- header_params = {}
3180
- if request.environment&.name
3181
- header_params["environment.name"] = request.environment.name
3182
- end
3183
-
3184
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3185
- metadata[:"x-goog-request-params"] ||= request_params_header
3186
-
3187
- options.apply_defaults timeout: @config.rpcs.update_environment.timeout,
3188
- metadata: metadata,
3189
- retry_policy: @config.rpcs.update_environment.retry_policy
3190
-
3191
- options.apply_defaults timeout: @config.timeout,
3192
- metadata: @config.metadata,
3193
- retry_policy: @config.retry_policy
3194
-
3195
- @dataplex_service_stub.call_rpc :update_environment, request, options: options do |response, operation|
3196
- response = ::Gapic::Operation.new response, @operations_client, options: options
3197
- yield response, operation if block_given?
3198
- throw :response, response
3199
- end
3200
- rescue ::GRPC::BadStatus => e
3201
- raise ::Google::Cloud::Error.from_error(e)
3202
- end
3203
-
3204
- ##
3205
- # Delete the environment resource. All the child resources must have been
3206
- # deleted before environment deletion can be initiated.
3207
- #
3208
- # @overload delete_environment(request, options = nil)
3209
- # Pass arguments to `delete_environment` via a request object, either of type
3210
- # {::Google::Cloud::Dataplex::V1::DeleteEnvironmentRequest} or an equivalent Hash.
3211
- #
3212
- # @param request [::Google::Cloud::Dataplex::V1::DeleteEnvironmentRequest, ::Hash]
3213
- # A request object representing the call parameters. Required. To specify no
3214
- # parameters, or to keep all the default parameter values, pass an empty Hash.
3215
- # @param options [::Gapic::CallOptions, ::Hash]
3216
- # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3217
- #
3218
- # @overload delete_environment(name: nil)
3219
- # Pass arguments to `delete_environment` via keyword arguments. Note that at
3220
- # least one keyword argument is required. To specify no parameters, or to keep all
3221
- # the default parameter values, pass an empty Hash as a request object (see above).
3222
- #
3223
- # @param name [::String]
3224
- # Required. The resource name of the environment:
3225
- # `projects/{project_id}/locations/{location_id}/lakes/{lake_id}/environments/{environment_id}`.
3226
- #
3227
- # @yield [response, operation] Access the result along with the RPC operation
3228
- # @yieldparam response [::Gapic::Operation]
3229
- # @yieldparam operation [::GRPC::ActiveCall::Operation]
3230
- #
3231
- # @return [::Gapic::Operation]
3232
- #
3233
- # @raise [::Google::Cloud::Error] if the RPC is aborted.
3234
- #
3235
- # @example Basic example
3236
- # require "google/cloud/dataplex/v1"
3237
- #
3238
- # # Create a client object. The client can be reused for multiple calls.
3239
- # client = Google::Cloud::Dataplex::V1::DataplexService::Client.new
3240
- #
3241
- # # Create a request. To set request fields, pass in keyword arguments.
3242
- # request = Google::Cloud::Dataplex::V1::DeleteEnvironmentRequest.new
3243
- #
3244
- # # Call the delete_environment method.
3245
- # result = client.delete_environment request
3246
- #
3247
- # # The returned object is of type Gapic::Operation. You can use it to
3248
- # # check the status of an operation, cancel it, or wait for results.
3249
- # # Here is how to wait for a response.
3250
- # result.wait_until_done! timeout: 60
3251
- # if result.response?
3252
- # p result.response
3253
- # else
3254
- # puts "No response received."
3255
- # end
3256
- #
3257
- def delete_environment request, options = nil
3258
- raise ::ArgumentError, "request must be provided" if request.nil?
3259
-
3260
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::DeleteEnvironmentRequest
3261
-
3262
- # Converts hash and nil to an options object
3263
- options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3264
-
3265
- # Customize the options with defaults
3266
- metadata = @config.rpcs.delete_environment.metadata.to_h
3267
-
3268
- # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3269
- metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3270
- lib_name: @config.lib_name, lib_version: @config.lib_version,
3271
- gapic_version: ::Google::Cloud::Dataplex::V1::VERSION
3272
- metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3273
- metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3274
-
3275
- header_params = {}
3276
- if request.name
3277
- header_params["name"] = request.name
3278
- end
3279
-
3280
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3281
- metadata[:"x-goog-request-params"] ||= request_params_header
3282
-
3283
- options.apply_defaults timeout: @config.rpcs.delete_environment.timeout,
3284
- metadata: metadata,
3285
- retry_policy: @config.rpcs.delete_environment.retry_policy
3286
-
3287
- options.apply_defaults timeout: @config.timeout,
3288
- metadata: @config.metadata,
3289
- retry_policy: @config.retry_policy
3290
-
3291
- @dataplex_service_stub.call_rpc :delete_environment, request, options: options do |response, operation|
3292
- response = ::Gapic::Operation.new response, @operations_client, options: options
3293
- yield response, operation if block_given?
3294
- throw :response, response
3295
- end
3296
- rescue ::GRPC::BadStatus => e
3297
- raise ::Google::Cloud::Error.from_error(e)
3298
- end
3299
-
3300
- ##
3301
- # Lists environments under the given lake.
3302
- #
3303
- # @overload list_environments(request, options = nil)
3304
- # Pass arguments to `list_environments` via a request object, either of type
3305
- # {::Google::Cloud::Dataplex::V1::ListEnvironmentsRequest} or an equivalent Hash.
3306
- #
3307
- # @param request [::Google::Cloud::Dataplex::V1::ListEnvironmentsRequest, ::Hash]
3308
- # A request object representing the call parameters. Required. To specify no
3309
- # parameters, or to keep all the default parameter values, pass an empty Hash.
3310
- # @param options [::Gapic::CallOptions, ::Hash]
3311
- # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3312
- #
3313
- # @overload list_environments(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
3314
- # Pass arguments to `list_environments` via keyword arguments. Note that at
3315
- # least one keyword argument is required. To specify no parameters, or to keep all
3316
- # the default parameter values, pass an empty Hash as a request object (see above).
3317
- #
3318
- # @param parent [::String]
3319
- # Required. The resource name of the parent lake:
3320
- # `projects/{project_id}/locations/{location_id}/lakes/{lake_id}`.
3321
- # @param page_size [::Integer]
3322
- # Optional. Maximum number of environments to return. The service may return
3323
- # fewer than this value. If unspecified, at most 10 environments will be
3324
- # returned. The maximum value is 1000; values above 1000 will be coerced to
3325
- # 1000.
3326
- # @param page_token [::String]
3327
- # Optional. Page token received from a previous `ListEnvironments` call.
3328
- # Provide this to retrieve the subsequent page. When paginating, all other
3329
- # parameters provided to `ListEnvironments` must match the call that provided
3330
- # the page token.
3331
- # @param filter [::String]
3332
- # Optional. Filter request.
3333
- # @param order_by [::String]
3334
- # Optional. Order by fields for the result.
3335
- #
3336
- # @yield [response, operation] Access the result along with the RPC operation
3337
- # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Dataplex::V1::Environment>]
3338
- # @yieldparam operation [::GRPC::ActiveCall::Operation]
3339
- #
3340
- # @return [::Gapic::PagedEnumerable<::Google::Cloud::Dataplex::V1::Environment>]
3341
- #
3342
- # @raise [::Google::Cloud::Error] if the RPC is aborted.
3343
- #
3344
- # @example Basic example
3345
- # require "google/cloud/dataplex/v1"
3346
- #
3347
- # # Create a client object. The client can be reused for multiple calls.
3348
- # client = Google::Cloud::Dataplex::V1::DataplexService::Client.new
3349
- #
3350
- # # Create a request. To set request fields, pass in keyword arguments.
3351
- # request = Google::Cloud::Dataplex::V1::ListEnvironmentsRequest.new
3352
- #
3353
- # # Call the list_environments method.
3354
- # result = client.list_environments request
3355
- #
3356
- # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3357
- # # over elements, and API calls will be issued to fetch pages as needed.
3358
- # result.each do |item|
3359
- # # Each element is of type ::Google::Cloud::Dataplex::V1::Environment.
3360
- # p item
3361
- # end
3362
- #
3363
- def list_environments request, options = nil
3364
- raise ::ArgumentError, "request must be provided" if request.nil?
3365
-
3366
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::ListEnvironmentsRequest
3367
-
3368
- # Converts hash and nil to an options object
3369
- options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3370
-
3371
- # Customize the options with defaults
3372
- metadata = @config.rpcs.list_environments.metadata.to_h
3373
-
3374
- # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3375
- metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3376
- lib_name: @config.lib_name, lib_version: @config.lib_version,
3377
- gapic_version: ::Google::Cloud::Dataplex::V1::VERSION
3378
- metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3379
- metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3380
-
3381
- header_params = {}
3382
- if request.parent
3383
- header_params["parent"] = request.parent
3384
- end
3385
-
3386
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3387
- metadata[:"x-goog-request-params"] ||= request_params_header
3388
-
3389
- options.apply_defaults timeout: @config.rpcs.list_environments.timeout,
3390
- metadata: metadata,
3391
- retry_policy: @config.rpcs.list_environments.retry_policy
3392
-
3393
- options.apply_defaults timeout: @config.timeout,
3394
- metadata: @config.metadata,
3395
- retry_policy: @config.retry_policy
3396
-
3397
- @dataplex_service_stub.call_rpc :list_environments, request, options: options do |response, operation|
3398
- response = ::Gapic::PagedEnumerable.new @dataplex_service_stub, :list_environments, request, response, operation, options
3399
- yield response, operation if block_given?
3400
- throw :response, response
3401
- end
3402
- rescue ::GRPC::BadStatus => e
3403
- raise ::Google::Cloud::Error.from_error(e)
3404
- end
3405
-
3406
- ##
3407
- # Get environment resource.
3408
- #
3409
- # @overload get_environment(request, options = nil)
3410
- # Pass arguments to `get_environment` via a request object, either of type
3411
- # {::Google::Cloud::Dataplex::V1::GetEnvironmentRequest} or an equivalent Hash.
3412
- #
3413
- # @param request [::Google::Cloud::Dataplex::V1::GetEnvironmentRequest, ::Hash]
3414
- # A request object representing the call parameters. Required. To specify no
3415
- # parameters, or to keep all the default parameter values, pass an empty Hash.
3416
- # @param options [::Gapic::CallOptions, ::Hash]
3417
- # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3418
- #
3419
- # @overload get_environment(name: nil)
3420
- # Pass arguments to `get_environment` via keyword arguments. Note that at
3421
- # least one keyword argument is required. To specify no parameters, or to keep all
3422
- # the default parameter values, pass an empty Hash as a request object (see above).
3423
- #
3424
- # @param name [::String]
3425
- # Required. The resource name of the environment:
3426
- # `projects/{project_id}/locations/{location_id}/lakes/{lake_id}/environments/{environment_id}`.
3427
- #
3428
- # @yield [response, operation] Access the result along with the RPC operation
3429
- # @yieldparam response [::Google::Cloud::Dataplex::V1::Environment]
3430
- # @yieldparam operation [::GRPC::ActiveCall::Operation]
3431
- #
3432
- # @return [::Google::Cloud::Dataplex::V1::Environment]
3433
- #
3434
- # @raise [::Google::Cloud::Error] if the RPC is aborted.
3435
- #
3436
- # @example Basic example
3437
- # require "google/cloud/dataplex/v1"
3438
- #
3439
- # # Create a client object. The client can be reused for multiple calls.
3440
- # client = Google::Cloud::Dataplex::V1::DataplexService::Client.new
3441
- #
3442
- # # Create a request. To set request fields, pass in keyword arguments.
3443
- # request = Google::Cloud::Dataplex::V1::GetEnvironmentRequest.new
3444
- #
3445
- # # Call the get_environment method.
3446
- # result = client.get_environment request
3447
- #
3448
- # # The returned object is of type Google::Cloud::Dataplex::V1::Environment.
3449
- # p result
3450
- #
3451
- def get_environment request, options = nil
3452
- raise ::ArgumentError, "request must be provided" if request.nil?
3453
-
3454
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::GetEnvironmentRequest
3455
-
3456
- # Converts hash and nil to an options object
3457
- options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3458
-
3459
- # Customize the options with defaults
3460
- metadata = @config.rpcs.get_environment.metadata.to_h
3461
-
3462
- # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3463
- metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3464
- lib_name: @config.lib_name, lib_version: @config.lib_version,
3465
- gapic_version: ::Google::Cloud::Dataplex::V1::VERSION
3466
- metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3467
- metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3468
-
3469
- header_params = {}
3470
- if request.name
3471
- header_params["name"] = request.name
3472
- end
3473
-
3474
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3475
- metadata[:"x-goog-request-params"] ||= request_params_header
3476
-
3477
- options.apply_defaults timeout: @config.rpcs.get_environment.timeout,
3478
- metadata: metadata,
3479
- retry_policy: @config.rpcs.get_environment.retry_policy
3480
-
3481
- options.apply_defaults timeout: @config.timeout,
3482
- metadata: @config.metadata,
3483
- retry_policy: @config.retry_policy
3484
-
3485
- @dataplex_service_stub.call_rpc :get_environment, request, options: options do |response, operation|
3486
- yield response, operation if block_given?
3487
- end
3488
- rescue ::GRPC::BadStatus => e
3489
- raise ::Google::Cloud::Error.from_error(e)
3490
- end
3491
-
3492
- ##
3493
- # Lists session resources in an environment.
3494
- #
3495
- # @overload list_sessions(request, options = nil)
3496
- # Pass arguments to `list_sessions` via a request object, either of type
3497
- # {::Google::Cloud::Dataplex::V1::ListSessionsRequest} or an equivalent Hash.
3498
- #
3499
- # @param request [::Google::Cloud::Dataplex::V1::ListSessionsRequest, ::Hash]
3500
- # A request object representing the call parameters. Required. To specify no
3501
- # parameters, or to keep all the default parameter values, pass an empty Hash.
3502
- # @param options [::Gapic::CallOptions, ::Hash]
3503
- # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
3504
- #
3505
- # @overload list_sessions(parent: nil, page_size: nil, page_token: nil, filter: nil)
3506
- # Pass arguments to `list_sessions` via keyword arguments. Note that at
3507
- # least one keyword argument is required. To specify no parameters, or to keep all
3508
- # the default parameter values, pass an empty Hash as a request object (see above).
3509
- #
3510
- # @param parent [::String]
3511
- # Required. The resource name of the parent environment:
3512
- # `projects/{project_number}/locations/{location_id}/lakes/{lake_id}/environment/{environment_id}`.
3513
- # @param page_size [::Integer]
3514
- # Optional. Maximum number of sessions to return. The service may return
3515
- # fewer than this value. If unspecified, at most 10 sessions will be
3516
- # returned. The maximum value is 1000; values above 1000 will be coerced to
3517
- # 1000.
3518
- # @param page_token [::String]
3519
- # Optional. Page token received from a previous `ListSessions` call. Provide
3520
- # this to retrieve the subsequent page. When paginating, all other parameters
3521
- # provided to `ListSessions` must match the call that provided the page
3522
- # token.
3523
- # @param filter [::String]
3524
- # Optional. Filter request. The following `mode` filter is supported to
3525
- # return only the sessions belonging to the requester when the mode is USER
3526
- # and return sessions of all the users when the mode is ADMIN. When no filter
3527
- # is sent default to USER mode. NOTE: When the mode is ADMIN, the requester
3528
- # should have `dataplex.environments.listAllSessions` permission to list all
3529
- # sessions, in absence of the permission, the request fails.
3530
- #
3531
- # mode = ADMIN | USER
3532
- #
3533
- # @yield [response, operation] Access the result along with the RPC operation
3534
- # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Dataplex::V1::Session>]
3535
- # @yieldparam operation [::GRPC::ActiveCall::Operation]
3536
- #
3537
- # @return [::Gapic::PagedEnumerable<::Google::Cloud::Dataplex::V1::Session>]
3538
- #
3539
- # @raise [::Google::Cloud::Error] if the RPC is aborted.
3540
- #
3541
- # @example Basic example
3542
- # require "google/cloud/dataplex/v1"
3543
- #
3544
- # # Create a client object. The client can be reused for multiple calls.
3545
- # client = Google::Cloud::Dataplex::V1::DataplexService::Client.new
3546
- #
3547
- # # Create a request. To set request fields, pass in keyword arguments.
3548
- # request = Google::Cloud::Dataplex::V1::ListSessionsRequest.new
3549
- #
3550
- # # Call the list_sessions method.
3551
- # result = client.list_sessions request
3552
- #
3553
- # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3554
- # # over elements, and API calls will be issued to fetch pages as needed.
3555
- # result.each do |item|
3556
- # # Each element is of type ::Google::Cloud::Dataplex::V1::Session.
3557
- # p item
3558
- # end
3559
- #
3560
- def list_sessions request, options = nil
3561
- raise ::ArgumentError, "request must be provided" if request.nil?
3562
-
3563
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dataplex::V1::ListSessionsRequest
3564
-
3565
- # Converts hash and nil to an options object
3566
- options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3567
-
3568
- # Customize the options with defaults
3569
- metadata = @config.rpcs.list_sessions.metadata.to_h
3570
-
3571
- # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3572
- metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3573
- lib_name: @config.lib_name, lib_version: @config.lib_version,
3574
- gapic_version: ::Google::Cloud::Dataplex::V1::VERSION
3575
- metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3576
- metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3577
-
3578
- header_params = {}
3579
- if request.parent
3580
- header_params["parent"] = request.parent
3581
- end
3582
-
3583
- request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3584
- metadata[:"x-goog-request-params"] ||= request_params_header
3585
-
3586
- options.apply_defaults timeout: @config.rpcs.list_sessions.timeout,
3587
- metadata: metadata,
3588
- retry_policy: @config.rpcs.list_sessions.retry_policy
3589
-
3590
- options.apply_defaults timeout: @config.timeout,
3591
- metadata: @config.metadata,
3592
- retry_policy: @config.retry_policy
3593
-
3594
- @dataplex_service_stub.call_rpc :list_sessions, request, options: options do |response, operation|
3595
- response = ::Gapic::PagedEnumerable.new @dataplex_service_stub, :list_sessions, request, response, operation, options
3596
- yield response, operation if block_given?
3597
- throw :response, response
3598
- end
3599
- rescue ::GRPC::BadStatus => e
3600
- raise ::Google::Cloud::Error.from_error(e)
3601
- end
3602
-
3603
2981
  ##
3604
2982
  # Configuration class for the DataplexService API.
3605
2983
  #
@@ -3696,6 +3074,7 @@ module Google
3696
3074
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3697
3075
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3698
3076
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3077
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
3699
3078
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
3700
3079
  # trigger a retry.
3701
3080
  # @return [::Hash]
@@ -3779,6 +3158,7 @@ module Google
3779
3158
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3780
3159
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3781
3160
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3161
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
3782
3162
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
3783
3163
  # trigger a retry.
3784
3164
  #
@@ -3918,36 +3298,6 @@ module Google
3918
3298
  # @return [::Gapic::Config::Method]
3919
3299
  #
3920
3300
  attr_reader :cancel_job
3921
- ##
3922
- # RPC-specific configuration for `create_environment`
3923
- # @return [::Gapic::Config::Method]
3924
- #
3925
- attr_reader :create_environment
3926
- ##
3927
- # RPC-specific configuration for `update_environment`
3928
- # @return [::Gapic::Config::Method]
3929
- #
3930
- attr_reader :update_environment
3931
- ##
3932
- # RPC-specific configuration for `delete_environment`
3933
- # @return [::Gapic::Config::Method]
3934
- #
3935
- attr_reader :delete_environment
3936
- ##
3937
- # RPC-specific configuration for `list_environments`
3938
- # @return [::Gapic::Config::Method]
3939
- #
3940
- attr_reader :list_environments
3941
- ##
3942
- # RPC-specific configuration for `get_environment`
3943
- # @return [::Gapic::Config::Method]
3944
- #
3945
- attr_reader :get_environment
3946
- ##
3947
- # RPC-specific configuration for `list_sessions`
3948
- # @return [::Gapic::Config::Method]
3949
- #
3950
- attr_reader :list_sessions
3951
3301
 
3952
3302
  # @private
3953
3303
  def initialize parent_rpcs = nil
@@ -4005,18 +3355,6 @@ module Google
4005
3355
  @get_job = ::Gapic::Config::Method.new get_job_config
4006
3356
  cancel_job_config = parent_rpcs.cancel_job if parent_rpcs.respond_to? :cancel_job
4007
3357
  @cancel_job = ::Gapic::Config::Method.new cancel_job_config
4008
- create_environment_config = parent_rpcs.create_environment if parent_rpcs.respond_to? :create_environment
4009
- @create_environment = ::Gapic::Config::Method.new create_environment_config
4010
- update_environment_config = parent_rpcs.update_environment if parent_rpcs.respond_to? :update_environment
4011
- @update_environment = ::Gapic::Config::Method.new update_environment_config
4012
- delete_environment_config = parent_rpcs.delete_environment if parent_rpcs.respond_to? :delete_environment
4013
- @delete_environment = ::Gapic::Config::Method.new delete_environment_config
4014
- list_environments_config = parent_rpcs.list_environments if parent_rpcs.respond_to? :list_environments
4015
- @list_environments = ::Gapic::Config::Method.new list_environments_config
4016
- get_environment_config = parent_rpcs.get_environment if parent_rpcs.respond_to? :get_environment
4017
- @get_environment = ::Gapic::Config::Method.new get_environment_config
4018
- list_sessions_config = parent_rpcs.list_sessions if parent_rpcs.respond_to? :list_sessions
4019
- @list_sessions = ::Gapic::Config::Method.new list_sessions_config
4020
3358
 
4021
3359
  yield self if block_given?
4022
3360
  end