google-cloud-oracle_database-v1 0.13.0 → 0.14.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 (39) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/oracle_database/v1/oracle_database/client.rb +2672 -184
  4. data/lib/google/cloud/oracle_database/v1/oracle_database/operations.rb +2 -0
  5. data/lib/google/cloud/oracle_database/v1/oracle_database/paths.rb +152 -0
  6. data/lib/google/cloud/oracle_database/v1/oracle_database/rest/client.rb +2444 -117
  7. data/lib/google/cloud/oracle_database/v1/oracle_database/rest/operations.rb +2 -0
  8. data/lib/google/cloud/oracle_database/v1/oracle_database/rest/service_stub.rb +1782 -373
  9. data/lib/google/cloud/oracle_database/v1/version.rb +1 -1
  10. data/lib/google/cloud/oracledatabase/v1/autonomous_database_pb.rb +1 -1
  11. data/lib/google/cloud/oracledatabase/v1/database_pb.rb +1 -1
  12. data/lib/google/cloud/oracledatabase/v1/db_system_pb.rb +1 -1
  13. data/lib/google/cloud/oracledatabase/v1/exadata_infra_pb.rb +2 -1
  14. data/lib/google/cloud/oracledatabase/v1/exascale_db_storage_vault_pb.rb +1 -1
  15. data/lib/google/cloud/oracledatabase/v1/goldengate_connection_assignment_pb.rb +38 -0
  16. data/lib/google/cloud/oracledatabase/v1/goldengate_connection_pb.rb +98 -0
  17. data/lib/google/cloud/oracledatabase/v1/goldengate_connection_type_pb.rb +28 -0
  18. data/lib/google/cloud/oracledatabase/v1/goldengate_deployment_environment_pb.rb +29 -0
  19. data/lib/google/cloud/oracledatabase/v1/goldengate_deployment_pb.rb +54 -0
  20. data/lib/google/cloud/oracledatabase/v1/goldengate_deployment_type_pb.rb +29 -0
  21. data/lib/google/cloud/oracledatabase/v1/goldengate_deployment_version_pb.rb +31 -0
  22. data/lib/google/cloud/oracledatabase/v1/oracledatabase_pb.rb +8 -1
  23. data/lib/google/cloud/oracledatabase/v1/oracledatabase_services_pb.rb +47 -0
  24. data/lib/google/cloud/oracledatabase/v1/vm_cluster_pb.rb +1 -1
  25. data/proto_docs/google/api/client.rb +4 -0
  26. data/proto_docs/google/cloud/oracledatabase/v1/autonomous_database.rb +84 -48
  27. data/proto_docs/google/cloud/oracledatabase/v1/database.rb +27 -1
  28. data/proto_docs/google/cloud/oracledatabase/v1/db_system.rb +6 -1
  29. data/proto_docs/google/cloud/oracledatabase/v1/exascale_db_storage_vault.rb +4 -0
  30. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_connection.rb +2238 -0
  31. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_connection_assignment.rb +300 -0
  32. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_connection_type.rb +186 -0
  33. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_deployment.rb +712 -0
  34. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_deployment_environment.rb +145 -0
  35. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_deployment_type.rb +177 -0
  36. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_deployment_version.rb +175 -0
  37. data/proto_docs/google/cloud/oracledatabase/v1/oracledatabase.rb +20 -2
  38. data/proto_docs/google/cloud/oracledatabase/v1/vm_cluster.rb +4 -4
  39. metadata +17 -3
@@ -225,6 +225,46 @@ module Google
225
225
  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
226
226
  }
227
227
 
228
+ default_config.rpcs.list_goldengate_deployments.timeout = 60.0
229
+ default_config.rpcs.list_goldengate_deployments.retry_policy = {
230
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
231
+ }
232
+
233
+ default_config.rpcs.get_goldengate_deployment.timeout = 60.0
234
+ default_config.rpcs.get_goldengate_deployment.retry_policy = {
235
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
236
+ }
237
+
238
+ default_config.rpcs.list_goldengate_connections.timeout = 60.0
239
+ default_config.rpcs.list_goldengate_connections.retry_policy = {
240
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
241
+ }
242
+
243
+ default_config.rpcs.get_goldengate_connection.timeout = 60.0
244
+ default_config.rpcs.get_goldengate_connection.retry_policy = {
245
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
246
+ }
247
+
248
+ default_config.rpcs.list_goldengate_deployment_versions.timeout = 60.0
249
+ default_config.rpcs.list_goldengate_deployment_versions.retry_policy = {
250
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
251
+ }
252
+
253
+ default_config.rpcs.list_goldengate_deployment_types.timeout = 60.0
254
+ default_config.rpcs.list_goldengate_deployment_types.retry_policy = {
255
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
256
+ }
257
+
258
+ default_config.rpcs.list_goldengate_deployment_environments.timeout = 60.0
259
+ default_config.rpcs.list_goldengate_deployment_environments.retry_policy = {
260
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
261
+ }
262
+
263
+ default_config.rpcs.list_goldengate_connection_types.timeout = 60.0
264
+ default_config.rpcs.list_goldengate_connection_types.retry_policy = {
265
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
266
+ }
267
+
228
268
  default_config.rpcs.list_db_versions.timeout = 60.0
229
269
  default_config.rpcs.list_db_versions.retry_policy = {
230
270
  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
@@ -235,6 +275,16 @@ module Google
235
275
  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
236
276
  }
237
277
 
278
+ default_config.rpcs.list_goldengate_connection_assignments.timeout = 60.0
279
+ default_config.rpcs.list_goldengate_connection_assignments.retry_policy = {
280
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
281
+ }
282
+
283
+ default_config.rpcs.get_goldengate_connection_assignment.timeout = 60.0
284
+ default_config.rpcs.get_goldengate_connection_assignment.retry_policy = {
285
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14, 4]
286
+ }
287
+
238
288
  default_config
239
289
  end
240
290
  yield @configure if block_given?
@@ -2921,7 +2971,8 @@ module Google
2921
2971
  # Required. The name of the Autonomous Database in the following format:
2922
2972
  # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
2923
2973
  # @param peer_autonomous_database [::String]
2924
- # Required. The peer database name to switch over to.
2974
+ # Optional. The peer database name to switch over to. Required for
2975
+ # cross-region standby, and must be omitted for in-region Data Guard.
2925
2976
  # @yield [result, operation] Access the result along with the TransportOperation object
2926
2977
  # @yieldparam result [::Gapic::Operation]
2927
2978
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -3012,7 +3063,8 @@ module Google
3012
3063
  # Required. The name of the Autonomous Database in the following format:
3013
3064
  # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
3014
3065
  # @param peer_autonomous_database [::String]
3015
- # Required. The peer database name to fail over to.
3066
+ # Optional. The peer database name to fail over to. Required for cross-region
3067
+ # standby, and must be omitted for in-region Data Guard.
3016
3068
  # @yield [result, operation] Access the result along with the TransportOperation object
3017
3069
  # @yieldparam result [::Gapic::Operation]
3018
3070
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -5628,44 +5680,42 @@ module Google
5628
5680
  end
5629
5681
 
5630
5682
  ##
5631
- # List DbVersions for the given project and location.
5683
+ # Lists all the GoldengateDeployments for the given project and location.
5632
5684
  #
5633
- # @overload list_db_versions(request, options = nil)
5634
- # Pass arguments to `list_db_versions` via a request object, either of type
5635
- # {::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest} or an equivalent Hash.
5685
+ # @overload list_goldengate_deployments(request, options = nil)
5686
+ # Pass arguments to `list_goldengate_deployments` via a request object, either of type
5687
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentsRequest} or an equivalent Hash.
5636
5688
  #
5637
- # @param request [::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest, ::Hash]
5689
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentsRequest, ::Hash]
5638
5690
  # A request object representing the call parameters. Required. To specify no
5639
5691
  # parameters, or to keep all the default parameter values, pass an empty Hash.
5640
5692
  # @param options [::Gapic::CallOptions, ::Hash]
5641
5693
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5642
5694
  #
5643
- # @overload list_db_versions(parent: nil, page_size: nil, page_token: nil, filter: nil)
5644
- # Pass arguments to `list_db_versions` via keyword arguments. Note that at
5695
+ # @overload list_goldengate_deployments(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
5696
+ # Pass arguments to `list_goldengate_deployments` via keyword arguments. Note that at
5645
5697
  # least one keyword argument is required. To specify no parameters, or to keep all
5646
5698
  # the default parameter values, pass an empty Hash as a request object (see above).
5647
5699
  #
5648
5700
  # @param parent [::String]
5649
- # Required. The parent value for the DbVersion resource with the
5650
- # format: projects/\\{project}/locations/\\{location}
5701
+ # Required. The parent value for GoldengateDeployments in the following
5702
+ # format: projects/\\{project}/locations/\\{location}.
5651
5703
  # @param page_size [::Integer]
5652
5704
  # Optional. The maximum number of items to return.
5653
- # If unspecified, a maximum of 50 DbVersions will be returned.
5654
- # The maximum value is 1000; values above 1000 will be reset to 1000.
5705
+ # If unspecified, at most 50 GoldengateDeployments will be returned.
5706
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
5655
5707
  # @param page_token [::String]
5656
- # Optional. A token identifying the requested page of results to return. All
5657
- # fields except the filter should remain the same as in the request that
5658
- # provided this page token.
5708
+ # Optional. A page token, received from a previous ListGoldengateDeployments
5709
+ # call. Provide this to retrieve the subsequent page.
5659
5710
  # @param filter [::String]
5660
- # Optional. Filter expression that matches a subset of the DbVersions to
5661
- # show. The supported filter for dbSystem creation is `db_system_shape =
5662
- # \\{db_system_shape} AND storage_management = \\{storage_management}`. If no
5663
- # filter is provided, all DbVersions will be returned.
5711
+ # Optional. An expression for filtering the results of the request.
5712
+ # @param order_by [::String]
5713
+ # Optional. An expression for ordering the results of the request.
5664
5714
  # @yield [result, operation] Access the result along with the TransportOperation object
5665
- # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbVersion>]
5715
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeployment>]
5666
5716
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
5667
5717
  #
5668
- # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbVersion>]
5718
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeployment>]
5669
5719
  #
5670
5720
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
5671
5721
  #
@@ -5676,28 +5726,28 @@ module Google
5676
5726
  # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
5677
5727
  #
5678
5728
  # # Create a request. To set request fields, pass in keyword arguments.
5679
- # request = Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest.new
5729
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentsRequest.new
5680
5730
  #
5681
- # # Call the list_db_versions method.
5682
- # result = client.list_db_versions request
5731
+ # # Call the list_goldengate_deployments method.
5732
+ # result = client.list_goldengate_deployments request
5683
5733
  #
5684
5734
  # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5685
5735
  # # over elements, and API calls will be issued to fetch pages as needed.
5686
5736
  # result.each do |item|
5687
- # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DbVersion.
5737
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateDeployment.
5688
5738
  # p item
5689
5739
  # end
5690
5740
  #
5691
- def list_db_versions request, options = nil
5741
+ def list_goldengate_deployments request, options = nil
5692
5742
  raise ::ArgumentError, "request must be provided" if request.nil?
5693
5743
 
5694
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest
5744
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentsRequest
5695
5745
 
5696
5746
  # Converts hash and nil to an options object
5697
5747
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5698
5748
 
5699
5749
  # Customize the options with defaults
5700
- call_metadata = @config.rpcs.list_db_versions.metadata.to_h
5750
+ call_metadata = @config.rpcs.list_goldengate_deployments.metadata.to_h
5701
5751
 
5702
5752
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5703
5753
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -5708,16 +5758,16 @@ module Google
5708
5758
  call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5709
5759
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5710
5760
 
5711
- options.apply_defaults timeout: @config.rpcs.list_db_versions.timeout,
5761
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_deployments.timeout,
5712
5762
  metadata: call_metadata,
5713
- retry_policy: @config.rpcs.list_db_versions.retry_policy
5763
+ retry_policy: @config.rpcs.list_goldengate_deployments.retry_policy
5714
5764
 
5715
5765
  options.apply_defaults timeout: @config.timeout,
5716
5766
  metadata: @config.metadata,
5717
5767
  retry_policy: @config.retry_policy
5718
5768
 
5719
- @oracle_database_stub.list_db_versions request, options do |result, operation|
5720
- result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_db_versions, "db_versions", request, result, options
5769
+ @oracle_database_stub.list_goldengate_deployments request, options do |result, operation|
5770
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_deployments, "goldengate_deployments", request, result, options
5721
5771
  yield result, operation if block_given?
5722
5772
  throw :response, result
5723
5773
  end
@@ -5726,49 +5776,131 @@ module Google
5726
5776
  end
5727
5777
 
5728
5778
  ##
5729
- # List DatabaseCharacterSets for the given project and location.
5779
+ # Gets details of a single GoldengateDeployment.
5730
5780
  #
5731
- # @overload list_database_character_sets(request, options = nil)
5732
- # Pass arguments to `list_database_character_sets` via a request object, either of type
5733
- # {::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest} or an equivalent Hash.
5781
+ # @overload get_goldengate_deployment(request, options = nil)
5782
+ # Pass arguments to `get_goldengate_deployment` via a request object, either of type
5783
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentRequest} or an equivalent Hash.
5734
5784
  #
5735
- # @param request [::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest, ::Hash]
5785
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentRequest, ::Hash]
5736
5786
  # A request object representing the call parameters. Required. To specify no
5737
5787
  # parameters, or to keep all the default parameter values, pass an empty Hash.
5738
5788
  # @param options [::Gapic::CallOptions, ::Hash]
5739
5789
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5740
5790
  #
5741
- # @overload list_database_character_sets(parent: nil, page_size: nil, page_token: nil, filter: nil)
5742
- # Pass arguments to `list_database_character_sets` via keyword arguments. Note that at
5791
+ # @overload get_goldengate_deployment(name: nil)
5792
+ # Pass arguments to `get_goldengate_deployment` via keyword arguments. Note that at
5793
+ # least one keyword argument is required. To specify no parameters, or to keep all
5794
+ # the default parameter values, pass an empty Hash as a request object (see above).
5795
+ #
5796
+ # @param name [::String]
5797
+ # Required. The name of the GoldengateDeployment in the following format:
5798
+ # projects/\\{project}/locations/\\{location}/goldengateDeployments/\\{goldengate_deployment}.
5799
+ # @yield [result, operation] Access the result along with the TransportOperation object
5800
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateDeployment]
5801
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5802
+ #
5803
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateDeployment]
5804
+ #
5805
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
5806
+ #
5807
+ # @example Basic example
5808
+ # require "google/cloud/oracle_database/v1"
5809
+ #
5810
+ # # Create a client object. The client can be reused for multiple calls.
5811
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
5812
+ #
5813
+ # # Create a request. To set request fields, pass in keyword arguments.
5814
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentRequest.new
5815
+ #
5816
+ # # Call the get_goldengate_deployment method.
5817
+ # result = client.get_goldengate_deployment request
5818
+ #
5819
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateDeployment.
5820
+ # p result
5821
+ #
5822
+ def get_goldengate_deployment request, options = nil
5823
+ raise ::ArgumentError, "request must be provided" if request.nil?
5824
+
5825
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentRequest
5826
+
5827
+ # Converts hash and nil to an options object
5828
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5829
+
5830
+ # Customize the options with defaults
5831
+ call_metadata = @config.rpcs.get_goldengate_deployment.metadata.to_h
5832
+
5833
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5834
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
5835
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
5836
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
5837
+ transports_version_send: [:rest]
5838
+
5839
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5840
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5841
+
5842
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_deployment.timeout,
5843
+ metadata: call_metadata,
5844
+ retry_policy: @config.rpcs.get_goldengate_deployment.retry_policy
5845
+
5846
+ options.apply_defaults timeout: @config.timeout,
5847
+ metadata: @config.metadata,
5848
+ retry_policy: @config.retry_policy
5849
+
5850
+ @oracle_database_stub.get_goldengate_deployment request, options do |result, operation|
5851
+ yield result, operation if block_given?
5852
+ end
5853
+ rescue ::Gapic::Rest::Error => e
5854
+ raise ::Google::Cloud::Error.from_error(e)
5855
+ end
5856
+
5857
+ ##
5858
+ # Creates a new GoldengateDeployment in a given project and location.
5859
+ #
5860
+ # @overload create_goldengate_deployment(request, options = nil)
5861
+ # Pass arguments to `create_goldengate_deployment` via a request object, either of type
5862
+ # {::Google::Cloud::OracleDatabase::V1::CreateGoldengateDeploymentRequest} or an equivalent Hash.
5863
+ #
5864
+ # @param request [::Google::Cloud::OracleDatabase::V1::CreateGoldengateDeploymentRequest, ::Hash]
5865
+ # A request object representing the call parameters. Required. To specify no
5866
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5867
+ # @param options [::Gapic::CallOptions, ::Hash]
5868
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5869
+ #
5870
+ # @overload create_goldengate_deployment(parent: nil, goldengate_deployment_id: nil, goldengate_deployment: nil, request_id: nil)
5871
+ # Pass arguments to `create_goldengate_deployment` via keyword arguments. Note that at
5743
5872
  # least one keyword argument is required. To specify no parameters, or to keep all
5744
5873
  # the default parameter values, pass an empty Hash as a request object (see above).
5745
5874
  #
5746
5875
  # @param parent [::String]
5747
- # Required. The parent value for DatabaseCharacterSets in the following
5876
+ # Required. The value for parent of the GoldengateDeployment in the following
5748
5877
  # format: projects/\\{project}/locations/\\{location}.
5749
- # @param page_size [::Integer]
5750
- # Optional. The maximum number of DatabaseCharacterSets to return. The
5751
- # service may return fewer than this value. If unspecified, at most 50
5752
- # DatabaseCharacterSets will be returned. The maximum value is 1000; values
5753
- # above 1000 will be coerced to 1000.
5754
- # @param page_token [::String]
5755
- # Optional. A page token, received from a previous
5756
- # `ListDatabaseCharacterSets` call. Provide this to retrieve the subsequent
5757
- # page.
5878
+ # @param goldengate_deployment_id [::String]
5879
+ # Required. The ID of the GoldengateDeployment to create. This value is
5880
+ # restricted to (^[a-z]([a-z0-9-]\\{0,61}[a-z0-9])?$) and must be a maximum of
5881
+ # 63 characters in length. The value must start with a letter and end with a
5882
+ # letter or a number.
5883
+ # @param goldengate_deployment [::Google::Cloud::OracleDatabase::V1::GoldengateDeployment, ::Hash]
5884
+ # Required. The resource being created.
5885
+ # @param request_id [::String]
5886
+ # Optional. An optional request ID to identify requests. Specify a unique
5887
+ # request ID so that if you must retry your request, the server will know to
5888
+ # ignore the request if it has already been completed. The server will
5889
+ # guarantee that for at least 60 minutes since the first request.
5758
5890
  #
5759
- # When paginating, all other parameters provided to
5760
- # `ListDatabaseCharacterSets` must match the call that provided the page
5761
- # token.
5762
- # @param filter [::String]
5763
- # Optional. An expression for filtering the results of the request. Only the
5764
- # **character_set_type** field is supported in the following format:
5765
- # `character_set_type="{characterSetType}"`. Accepted values include
5766
- # `DATABASE` and `NATIONAL`.
5891
+ # For example, consider a situation where you make an initial request and the
5892
+ # request times out. If you make the request again with the same request
5893
+ # ID, the server can check if original operation with the same request ID
5894
+ # was received, and if so, will ignore the second request. This prevents
5895
+ # clients from accidentally creating duplicate commitments.
5896
+ #
5897
+ # The request ID must be a valid UUID with the exception that zero UUID is
5898
+ # not supported (00000000-0000-0000-0000-000000000000).
5767
5899
  # @yield [result, operation] Access the result along with the TransportOperation object
5768
- # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet>]
5900
+ # @yieldparam result [::Gapic::Operation]
5769
5901
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
5770
5902
  #
5771
- # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet>]
5903
+ # @return [::Gapic::Operation]
5772
5904
  #
5773
5905
  # @raise [::Google::Cloud::Error] if the REST call is aborted.
5774
5906
  #
@@ -5779,28 +5911,31 @@ module Google
5779
5911
  # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
5780
5912
  #
5781
5913
  # # Create a request. To set request fields, pass in keyword arguments.
5782
- # request = Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest.new
5914
+ # request = Google::Cloud::OracleDatabase::V1::CreateGoldengateDeploymentRequest.new
5783
5915
  #
5784
- # # Call the list_database_character_sets method.
5785
- # result = client.list_database_character_sets request
5916
+ # # Call the create_goldengate_deployment method.
5917
+ # result = client.create_goldengate_deployment request
5786
5918
  #
5787
- # # The returned object is of type Gapic::PagedEnumerable. You can iterate
5788
- # # over elements, and API calls will be issued to fetch pages as needed.
5789
- # result.each do |item|
5790
- # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet.
5791
- # p item
5919
+ # # The returned object is of type Gapic::Operation. You can use it to
5920
+ # # check the status of an operation, cancel it, or wait for results.
5921
+ # # Here is how to wait for a response.
5922
+ # result.wait_until_done! timeout: 60
5923
+ # if result.response?
5924
+ # p result.response
5925
+ # else
5926
+ # puts "No response received."
5792
5927
  # end
5793
5928
  #
5794
- def list_database_character_sets request, options = nil
5929
+ def create_goldengate_deployment request, options = nil
5795
5930
  raise ::ArgumentError, "request must be provided" if request.nil?
5796
5931
 
5797
- request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest
5932
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::CreateGoldengateDeploymentRequest
5798
5933
 
5799
5934
  # Converts hash and nil to an options object
5800
5935
  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
5801
5936
 
5802
5937
  # Customize the options with defaults
5803
- call_metadata = @config.rpcs.list_database_character_sets.metadata.to_h
5938
+ call_metadata = @config.rpcs.create_goldengate_deployment.metadata.to_h
5804
5939
 
5805
5940
  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
5806
5941
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
@@ -5811,16 +5946,16 @@ module Google
5811
5946
  call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
5812
5947
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
5813
5948
 
5814
- options.apply_defaults timeout: @config.rpcs.list_database_character_sets.timeout,
5949
+ options.apply_defaults timeout: @config.rpcs.create_goldengate_deployment.timeout,
5815
5950
  metadata: call_metadata,
5816
- retry_policy: @config.rpcs.list_database_character_sets.retry_policy
5951
+ retry_policy: @config.rpcs.create_goldengate_deployment.retry_policy
5817
5952
 
5818
5953
  options.apply_defaults timeout: @config.timeout,
5819
5954
  metadata: @config.metadata,
5820
5955
  retry_policy: @config.retry_policy
5821
5956
 
5822
- @oracle_database_stub.list_database_character_sets request, options do |result, operation|
5823
- result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_database_character_sets, "database_character_sets", request, result, options
5957
+ @oracle_database_stub.create_goldengate_deployment request, options do |result, operation|
5958
+ result = ::Gapic::Operation.new result, @operations_client, options: options
5824
5959
  yield result, operation if block_given?
5825
5960
  throw :response, result
5826
5961
  end
@@ -5829,55 +5964,2084 @@ module Google
5829
5964
  end
5830
5965
 
5831
5966
  ##
5832
- # Configuration class for the OracleDatabase REST API.
5967
+ # Deletes a single GoldengateDeployment.
5833
5968
  #
5834
- # This class represents the configuration for OracleDatabase REST,
5835
- # providing control over timeouts, retry behavior, logging, transport
5836
- # parameters, and other low-level controls. Certain parameters can also be
5837
- # applied individually to specific RPCs. See
5838
- # {::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client::Configuration::Rpcs}
5839
- # for a list of RPCs that can be configured independently.
5969
+ # @overload delete_goldengate_deployment(request, options = nil)
5970
+ # Pass arguments to `delete_goldengate_deployment` via a request object, either of type
5971
+ # {::Google::Cloud::OracleDatabase::V1::DeleteGoldengateDeploymentRequest} or an equivalent Hash.
5840
5972
  #
5841
- # Configuration can be applied globally to all clients, or to a single client
5842
- # on construction.
5973
+ # @param request [::Google::Cloud::OracleDatabase::V1::DeleteGoldengateDeploymentRequest, ::Hash]
5974
+ # A request object representing the call parameters. Required. To specify no
5975
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
5976
+ # @param options [::Gapic::CallOptions, ::Hash]
5977
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
5843
5978
  #
5844
- # @example
5979
+ # @overload delete_goldengate_deployment(name: nil, request_id: nil)
5980
+ # Pass arguments to `delete_goldengate_deployment` via keyword arguments. Note that at
5981
+ # least one keyword argument is required. To specify no parameters, or to keep all
5982
+ # the default parameter values, pass an empty Hash as a request object (see above).
5845
5983
  #
5846
- # # Modify the global config, setting the timeout for
5847
- # # list_cloud_exadata_infrastructures to 20 seconds,
5848
- # # and all remaining timeouts to 10 seconds.
5849
- # ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.configure do |config|
5850
- # config.timeout = 10.0
5851
- # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
5852
- # end
5984
+ # @param name [::String]
5985
+ # Required. The name of the GoldengateDeployment in the following format:
5986
+ # projects/\\{project}/locations/\\{location}/goldengateDeployments/\\{goldengate_deployment}.
5987
+ # @param request_id [::String]
5988
+ # Optional. An optional ID to identify the request. This value is used to
5989
+ # identify duplicate requests. If you make a request with the same request ID
5990
+ # and the original request is still in progress or completed, the server
5991
+ # ignores the second request. This prevents clients from
5992
+ # accidentally creating duplicate commitments.
5853
5993
  #
5854
- # # Apply the above configuration only to a new client.
5855
- # client = ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new do |config|
5856
- # config.timeout = 10.0
5857
- # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
5858
- # end
5994
+ # The request ID must be a valid UUID with the exception that zero UUID is
5995
+ # not supported (00000000-0000-0000-0000-000000000000).
5996
+ # @yield [result, operation] Access the result along with the TransportOperation object
5997
+ # @yieldparam result [::Gapic::Operation]
5998
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
5859
5999
  #
5860
- # @!attribute [rw] endpoint
5861
- # A custom service endpoint, as a hostname or hostname:port. The default is
5862
- # nil, indicating to use the default endpoint in the current universe domain.
5863
- # @return [::String,nil]
5864
- # @!attribute [rw] credentials
5865
- # Credentials to send with calls. You may provide any of the following types:
5866
- # * (`String`) The path to a service account key file in JSON format
5867
- # * (`Hash`) A service account key as a Hash
5868
- # * (`Google::Auth::Credentials`) A googleauth credentials object
5869
- # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
5870
- # * (`Signet::OAuth2::Client`) A signet oauth2 client object
5871
- # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
5872
- # * (`nil`) indicating no credentials
6000
+ # @return [::Gapic::Operation]
5873
6001
  #
5874
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
5875
- # external source for authentication to Google Cloud, you must validate it before
5876
- # providing it to a Google API client library. Providing an unvalidated credential
5877
- # configuration to Google APIs can compromise the security of your systems and data.
5878
- # For more information, refer to [Validate credential configurations from external
5879
- # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
5880
- # @return [::Object]
6002
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6003
+ #
6004
+ # @example Basic example
6005
+ # require "google/cloud/oracle_database/v1"
6006
+ #
6007
+ # # Create a client object. The client can be reused for multiple calls.
6008
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6009
+ #
6010
+ # # Create a request. To set request fields, pass in keyword arguments.
6011
+ # request = Google::Cloud::OracleDatabase::V1::DeleteGoldengateDeploymentRequest.new
6012
+ #
6013
+ # # Call the delete_goldengate_deployment method.
6014
+ # result = client.delete_goldengate_deployment request
6015
+ #
6016
+ # # The returned object is of type Gapic::Operation. You can use it to
6017
+ # # check the status of an operation, cancel it, or wait for results.
6018
+ # # Here is how to wait for a response.
6019
+ # result.wait_until_done! timeout: 60
6020
+ # if result.response?
6021
+ # p result.response
6022
+ # else
6023
+ # puts "No response received."
6024
+ # end
6025
+ #
6026
+ def delete_goldengate_deployment request, options = nil
6027
+ raise ::ArgumentError, "request must be provided" if request.nil?
6028
+
6029
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::DeleteGoldengateDeploymentRequest
6030
+
6031
+ # Converts hash and nil to an options object
6032
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6033
+
6034
+ # Customize the options with defaults
6035
+ call_metadata = @config.rpcs.delete_goldengate_deployment.metadata.to_h
6036
+
6037
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6038
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6039
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6040
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6041
+ transports_version_send: [:rest]
6042
+
6043
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6044
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6045
+
6046
+ options.apply_defaults timeout: @config.rpcs.delete_goldengate_deployment.timeout,
6047
+ metadata: call_metadata,
6048
+ retry_policy: @config.rpcs.delete_goldengate_deployment.retry_policy
6049
+
6050
+ options.apply_defaults timeout: @config.timeout,
6051
+ metadata: @config.metadata,
6052
+ retry_policy: @config.retry_policy
6053
+
6054
+ @oracle_database_stub.delete_goldengate_deployment request, options do |result, operation|
6055
+ result = ::Gapic::Operation.new result, @operations_client, options: options
6056
+ yield result, operation if block_given?
6057
+ throw :response, result
6058
+ end
6059
+ rescue ::Gapic::Rest::Error => e
6060
+ raise ::Google::Cloud::Error.from_error(e)
6061
+ end
6062
+
6063
+ ##
6064
+ # Stops a single GoldengateDeployment.
6065
+ #
6066
+ # @overload stop_goldengate_deployment(request, options = nil)
6067
+ # Pass arguments to `stop_goldengate_deployment` via a request object, either of type
6068
+ # {::Google::Cloud::OracleDatabase::V1::StopGoldengateDeploymentRequest} or an equivalent Hash.
6069
+ #
6070
+ # @param request [::Google::Cloud::OracleDatabase::V1::StopGoldengateDeploymentRequest, ::Hash]
6071
+ # A request object representing the call parameters. Required. To specify no
6072
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6073
+ # @param options [::Gapic::CallOptions, ::Hash]
6074
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6075
+ #
6076
+ # @overload stop_goldengate_deployment(name: nil)
6077
+ # Pass arguments to `stop_goldengate_deployment` via keyword arguments. Note that at
6078
+ # least one keyword argument is required. To specify no parameters, or to keep all
6079
+ # the default parameter values, pass an empty Hash as a request object (see above).
6080
+ #
6081
+ # @param name [::String]
6082
+ # Required. The name of the Goldengate Deployment in the following format:
6083
+ # projects/\\{project}/locations/\\{location}/goldengateDeployments/\\{goldengate_deployment}.
6084
+ # @yield [result, operation] Access the result along with the TransportOperation object
6085
+ # @yieldparam result [::Gapic::Operation]
6086
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6087
+ #
6088
+ # @return [::Gapic::Operation]
6089
+ #
6090
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6091
+ #
6092
+ # @example Basic example
6093
+ # require "google/cloud/oracle_database/v1"
6094
+ #
6095
+ # # Create a client object. The client can be reused for multiple calls.
6096
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6097
+ #
6098
+ # # Create a request. To set request fields, pass in keyword arguments.
6099
+ # request = Google::Cloud::OracleDatabase::V1::StopGoldengateDeploymentRequest.new
6100
+ #
6101
+ # # Call the stop_goldengate_deployment method.
6102
+ # result = client.stop_goldengate_deployment request
6103
+ #
6104
+ # # The returned object is of type Gapic::Operation. You can use it to
6105
+ # # check the status of an operation, cancel it, or wait for results.
6106
+ # # Here is how to wait for a response.
6107
+ # result.wait_until_done! timeout: 60
6108
+ # if result.response?
6109
+ # p result.response
6110
+ # else
6111
+ # puts "No response received."
6112
+ # end
6113
+ #
6114
+ def stop_goldengate_deployment request, options = nil
6115
+ raise ::ArgumentError, "request must be provided" if request.nil?
6116
+
6117
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::StopGoldengateDeploymentRequest
6118
+
6119
+ # Converts hash and nil to an options object
6120
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6121
+
6122
+ # Customize the options with defaults
6123
+ call_metadata = @config.rpcs.stop_goldengate_deployment.metadata.to_h
6124
+
6125
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6126
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6127
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6128
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6129
+ transports_version_send: [:rest]
6130
+
6131
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6132
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6133
+
6134
+ options.apply_defaults timeout: @config.rpcs.stop_goldengate_deployment.timeout,
6135
+ metadata: call_metadata,
6136
+ retry_policy: @config.rpcs.stop_goldengate_deployment.retry_policy
6137
+
6138
+ options.apply_defaults timeout: @config.timeout,
6139
+ metadata: @config.metadata,
6140
+ retry_policy: @config.retry_policy
6141
+
6142
+ @oracle_database_stub.stop_goldengate_deployment request, options do |result, operation|
6143
+ result = ::Gapic::Operation.new result, @operations_client, options: options
6144
+ yield result, operation if block_given?
6145
+ throw :response, result
6146
+ end
6147
+ rescue ::Gapic::Rest::Error => e
6148
+ raise ::Google::Cloud::Error.from_error(e)
6149
+ end
6150
+
6151
+ ##
6152
+ # Starts a single GoldengateDeployment.
6153
+ #
6154
+ # @overload start_goldengate_deployment(request, options = nil)
6155
+ # Pass arguments to `start_goldengate_deployment` via a request object, either of type
6156
+ # {::Google::Cloud::OracleDatabase::V1::StartGoldengateDeploymentRequest} or an equivalent Hash.
6157
+ #
6158
+ # @param request [::Google::Cloud::OracleDatabase::V1::StartGoldengateDeploymentRequest, ::Hash]
6159
+ # A request object representing the call parameters. Required. To specify no
6160
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6161
+ # @param options [::Gapic::CallOptions, ::Hash]
6162
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6163
+ #
6164
+ # @overload start_goldengate_deployment(name: nil)
6165
+ # Pass arguments to `start_goldengate_deployment` via keyword arguments. Note that at
6166
+ # least one keyword argument is required. To specify no parameters, or to keep all
6167
+ # the default parameter values, pass an empty Hash as a request object (see above).
6168
+ #
6169
+ # @param name [::String]
6170
+ # Required. The name of the Goldengate Deployment in the following format:
6171
+ # projects/\\{project}/locations/\\{location}/goldengateDeployments/\\{goldengate_deployment}.
6172
+ # @yield [result, operation] Access the result along with the TransportOperation object
6173
+ # @yieldparam result [::Gapic::Operation]
6174
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6175
+ #
6176
+ # @return [::Gapic::Operation]
6177
+ #
6178
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6179
+ #
6180
+ # @example Basic example
6181
+ # require "google/cloud/oracle_database/v1"
6182
+ #
6183
+ # # Create a client object. The client can be reused for multiple calls.
6184
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6185
+ #
6186
+ # # Create a request. To set request fields, pass in keyword arguments.
6187
+ # request = Google::Cloud::OracleDatabase::V1::StartGoldengateDeploymentRequest.new
6188
+ #
6189
+ # # Call the start_goldengate_deployment method.
6190
+ # result = client.start_goldengate_deployment request
6191
+ #
6192
+ # # The returned object is of type Gapic::Operation. You can use it to
6193
+ # # check the status of an operation, cancel it, or wait for results.
6194
+ # # Here is how to wait for a response.
6195
+ # result.wait_until_done! timeout: 60
6196
+ # if result.response?
6197
+ # p result.response
6198
+ # else
6199
+ # puts "No response received."
6200
+ # end
6201
+ #
6202
+ def start_goldengate_deployment request, options = nil
6203
+ raise ::ArgumentError, "request must be provided" if request.nil?
6204
+
6205
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::StartGoldengateDeploymentRequest
6206
+
6207
+ # Converts hash and nil to an options object
6208
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6209
+
6210
+ # Customize the options with defaults
6211
+ call_metadata = @config.rpcs.start_goldengate_deployment.metadata.to_h
6212
+
6213
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6214
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6215
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6216
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6217
+ transports_version_send: [:rest]
6218
+
6219
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6220
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6221
+
6222
+ options.apply_defaults timeout: @config.rpcs.start_goldengate_deployment.timeout,
6223
+ metadata: call_metadata,
6224
+ retry_policy: @config.rpcs.start_goldengate_deployment.retry_policy
6225
+
6226
+ options.apply_defaults timeout: @config.timeout,
6227
+ metadata: @config.metadata,
6228
+ retry_policy: @config.retry_policy
6229
+
6230
+ @oracle_database_stub.start_goldengate_deployment request, options do |result, operation|
6231
+ result = ::Gapic::Operation.new result, @operations_client, options: options
6232
+ yield result, operation if block_given?
6233
+ throw :response, result
6234
+ end
6235
+ rescue ::Gapic::Rest::Error => e
6236
+ raise ::Google::Cloud::Error.from_error(e)
6237
+ end
6238
+
6239
+ ##
6240
+ # Lists all the GoldengateConnections for the given project and location.
6241
+ #
6242
+ # @overload list_goldengate_connections(request, options = nil)
6243
+ # Pass arguments to `list_goldengate_connections` via a request object, either of type
6244
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionsRequest} or an equivalent Hash.
6245
+ #
6246
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionsRequest, ::Hash]
6247
+ # A request object representing the call parameters. Required. To specify no
6248
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6249
+ # @param options [::Gapic::CallOptions, ::Hash]
6250
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6251
+ #
6252
+ # @overload list_goldengate_connections(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
6253
+ # Pass arguments to `list_goldengate_connections` via keyword arguments. Note that at
6254
+ # least one keyword argument is required. To specify no parameters, or to keep all
6255
+ # the default parameter values, pass an empty Hash as a request object (see above).
6256
+ #
6257
+ # @param parent [::String]
6258
+ # Required. The parent value for GoldengateConnections in the following
6259
+ # format: projects/\\{project}/locations/\\{location}.
6260
+ # @param page_size [::Integer]
6261
+ # Optional. The maximum number of items to return.
6262
+ # If unspecified, at most 50 GoldengateConnections will be returned.
6263
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
6264
+ # @param page_token [::String]
6265
+ # Optional. A page token, received from a previous ListGoldengateConnections
6266
+ # call. Provide this to retrieve the subsequent page.
6267
+ # @param filter [::String]
6268
+ # Optional. An expression for filtering the results of the request.
6269
+ # @param order_by [::String]
6270
+ # Optional. An expression for ordering the results of the request.
6271
+ # @yield [result, operation] Access the result along with the TransportOperation object
6272
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnection>]
6273
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6274
+ #
6275
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnection>]
6276
+ #
6277
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6278
+ #
6279
+ # @example Basic example
6280
+ # require "google/cloud/oracle_database/v1"
6281
+ #
6282
+ # # Create a client object. The client can be reused for multiple calls.
6283
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6284
+ #
6285
+ # # Create a request. To set request fields, pass in keyword arguments.
6286
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionsRequest.new
6287
+ #
6288
+ # # Call the list_goldengate_connections method.
6289
+ # result = client.list_goldengate_connections request
6290
+ #
6291
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
6292
+ # # over elements, and API calls will be issued to fetch pages as needed.
6293
+ # result.each do |item|
6294
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateConnection.
6295
+ # p item
6296
+ # end
6297
+ #
6298
+ def list_goldengate_connections request, options = nil
6299
+ raise ::ArgumentError, "request must be provided" if request.nil?
6300
+
6301
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionsRequest
6302
+
6303
+ # Converts hash and nil to an options object
6304
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6305
+
6306
+ # Customize the options with defaults
6307
+ call_metadata = @config.rpcs.list_goldengate_connections.metadata.to_h
6308
+
6309
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6310
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6311
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6312
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6313
+ transports_version_send: [:rest]
6314
+
6315
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6316
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6317
+
6318
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_connections.timeout,
6319
+ metadata: call_metadata,
6320
+ retry_policy: @config.rpcs.list_goldengate_connections.retry_policy
6321
+
6322
+ options.apply_defaults timeout: @config.timeout,
6323
+ metadata: @config.metadata,
6324
+ retry_policy: @config.retry_policy
6325
+
6326
+ @oracle_database_stub.list_goldengate_connections request, options do |result, operation|
6327
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_connections, "goldengate_connections", request, result, options
6328
+ yield result, operation if block_given?
6329
+ throw :response, result
6330
+ end
6331
+ rescue ::Gapic::Rest::Error => e
6332
+ raise ::Google::Cloud::Error.from_error(e)
6333
+ end
6334
+
6335
+ ##
6336
+ # Gets details of a single GoldengateConnection.
6337
+ #
6338
+ # @overload get_goldengate_connection(request, options = nil)
6339
+ # Pass arguments to `get_goldengate_connection` via a request object, either of type
6340
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionRequest} or an equivalent Hash.
6341
+ #
6342
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionRequest, ::Hash]
6343
+ # A request object representing the call parameters. Required. To specify no
6344
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6345
+ # @param options [::Gapic::CallOptions, ::Hash]
6346
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6347
+ #
6348
+ # @overload get_goldengate_connection(name: nil)
6349
+ # Pass arguments to `get_goldengate_connection` via keyword arguments. Note that at
6350
+ # least one keyword argument is required. To specify no parameters, or to keep all
6351
+ # the default parameter values, pass an empty Hash as a request object (see above).
6352
+ #
6353
+ # @param name [::String]
6354
+ # Required. The name of the GoldengateConnection in the following format:
6355
+ # projects/\\{project}/locations/\\{location}/goldengateConnections/\\{goldengate_connection}.
6356
+ # @yield [result, operation] Access the result along with the TransportOperation object
6357
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateConnection]
6358
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6359
+ #
6360
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateConnection]
6361
+ #
6362
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6363
+ #
6364
+ # @example Basic example
6365
+ # require "google/cloud/oracle_database/v1"
6366
+ #
6367
+ # # Create a client object. The client can be reused for multiple calls.
6368
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6369
+ #
6370
+ # # Create a request. To set request fields, pass in keyword arguments.
6371
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionRequest.new
6372
+ #
6373
+ # # Call the get_goldengate_connection method.
6374
+ # result = client.get_goldengate_connection request
6375
+ #
6376
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateConnection.
6377
+ # p result
6378
+ #
6379
+ def get_goldengate_connection request, options = nil
6380
+ raise ::ArgumentError, "request must be provided" if request.nil?
6381
+
6382
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionRequest
6383
+
6384
+ # Converts hash and nil to an options object
6385
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6386
+
6387
+ # Customize the options with defaults
6388
+ call_metadata = @config.rpcs.get_goldengate_connection.metadata.to_h
6389
+
6390
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6391
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6392
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6393
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6394
+ transports_version_send: [:rest]
6395
+
6396
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6397
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6398
+
6399
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_connection.timeout,
6400
+ metadata: call_metadata,
6401
+ retry_policy: @config.rpcs.get_goldengate_connection.retry_policy
6402
+
6403
+ options.apply_defaults timeout: @config.timeout,
6404
+ metadata: @config.metadata,
6405
+ retry_policy: @config.retry_policy
6406
+
6407
+ @oracle_database_stub.get_goldengate_connection request, options do |result, operation|
6408
+ yield result, operation if block_given?
6409
+ end
6410
+ rescue ::Gapic::Rest::Error => e
6411
+ raise ::Google::Cloud::Error.from_error(e)
6412
+ end
6413
+
6414
+ ##
6415
+ # Creates a new GoldengateConnection in a given project and location.
6416
+ #
6417
+ # @overload create_goldengate_connection(request, options = nil)
6418
+ # Pass arguments to `create_goldengate_connection` via a request object, either of type
6419
+ # {::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionRequest} or an equivalent Hash.
6420
+ #
6421
+ # @param request [::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionRequest, ::Hash]
6422
+ # A request object representing the call parameters. Required. To specify no
6423
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6424
+ # @param options [::Gapic::CallOptions, ::Hash]
6425
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6426
+ #
6427
+ # @overload create_goldengate_connection(parent: nil, goldengate_connection_id: nil, goldengate_connection: nil, request_id: nil)
6428
+ # Pass arguments to `create_goldengate_connection` via keyword arguments. Note that at
6429
+ # least one keyword argument is required. To specify no parameters, or to keep all
6430
+ # the default parameter values, pass an empty Hash as a request object (see above).
6431
+ #
6432
+ # @param parent [::String]
6433
+ # Required. The value for parent of the GoldengateConnection in the following
6434
+ # format: projects/\\{project}/locations/\\{location}.
6435
+ # @param goldengate_connection_id [::String]
6436
+ # Required. The ID of the GoldengateConnection to create. This value is
6437
+ # restricted to (^[a-z]([a-z0-9-]\\{0,61}[a-z0-9])?$) and must be a maximum of
6438
+ # 63 characters in length. The value must start with a letter and end with a
6439
+ # letter or a number.
6440
+ # @param goldengate_connection [::Google::Cloud::OracleDatabase::V1::GoldengateConnection, ::Hash]
6441
+ # Required. The resource being created.
6442
+ # @param request_id [::String]
6443
+ # Optional. An optional request ID to identify requests. Specify a unique
6444
+ # request ID so that if you must retry your request, the server will know to
6445
+ # ignore the request if it has already been completed. The server will
6446
+ # guarantee that for at least 60 minutes since the first request.
6447
+ #
6448
+ # For example, consider a situation where you make an initial request and the
6449
+ # request times out. If you make the request again with the same request
6450
+ # ID, the server can check if original operation with the same request ID
6451
+ # was received, and if so, will ignore the second request. This prevents
6452
+ # clients from accidentally creating duplicate commitments.
6453
+ #
6454
+ # The request ID must be a valid UUID with the exception that zero UUID is
6455
+ # not supported (00000000-0000-0000-0000-000000000000).
6456
+ # @yield [result, operation] Access the result along with the TransportOperation object
6457
+ # @yieldparam result [::Gapic::Operation]
6458
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6459
+ #
6460
+ # @return [::Gapic::Operation]
6461
+ #
6462
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6463
+ #
6464
+ # @example Basic example
6465
+ # require "google/cloud/oracle_database/v1"
6466
+ #
6467
+ # # Create a client object. The client can be reused for multiple calls.
6468
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6469
+ #
6470
+ # # Create a request. To set request fields, pass in keyword arguments.
6471
+ # request = Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionRequest.new
6472
+ #
6473
+ # # Call the create_goldengate_connection method.
6474
+ # result = client.create_goldengate_connection request
6475
+ #
6476
+ # # The returned object is of type Gapic::Operation. You can use it to
6477
+ # # check the status of an operation, cancel it, or wait for results.
6478
+ # # Here is how to wait for a response.
6479
+ # result.wait_until_done! timeout: 60
6480
+ # if result.response?
6481
+ # p result.response
6482
+ # else
6483
+ # puts "No response received."
6484
+ # end
6485
+ #
6486
+ def create_goldengate_connection request, options = nil
6487
+ raise ::ArgumentError, "request must be provided" if request.nil?
6488
+
6489
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionRequest
6490
+
6491
+ # Converts hash and nil to an options object
6492
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6493
+
6494
+ # Customize the options with defaults
6495
+ call_metadata = @config.rpcs.create_goldengate_connection.metadata.to_h
6496
+
6497
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6498
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6499
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6500
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6501
+ transports_version_send: [:rest]
6502
+
6503
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6504
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6505
+
6506
+ options.apply_defaults timeout: @config.rpcs.create_goldengate_connection.timeout,
6507
+ metadata: call_metadata,
6508
+ retry_policy: @config.rpcs.create_goldengate_connection.retry_policy
6509
+
6510
+ options.apply_defaults timeout: @config.timeout,
6511
+ metadata: @config.metadata,
6512
+ retry_policy: @config.retry_policy
6513
+
6514
+ @oracle_database_stub.create_goldengate_connection request, options do |result, operation|
6515
+ result = ::Gapic::Operation.new result, @operations_client, options: options
6516
+ yield result, operation if block_given?
6517
+ throw :response, result
6518
+ end
6519
+ rescue ::Gapic::Rest::Error => e
6520
+ raise ::Google::Cloud::Error.from_error(e)
6521
+ end
6522
+
6523
+ ##
6524
+ # Deletes a single GoldengateConnection.
6525
+ #
6526
+ # @overload delete_goldengate_connection(request, options = nil)
6527
+ # Pass arguments to `delete_goldengate_connection` via a request object, either of type
6528
+ # {::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionRequest} or an equivalent Hash.
6529
+ #
6530
+ # @param request [::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionRequest, ::Hash]
6531
+ # A request object representing the call parameters. Required. To specify no
6532
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6533
+ # @param options [::Gapic::CallOptions, ::Hash]
6534
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6535
+ #
6536
+ # @overload delete_goldengate_connection(name: nil, request_id: nil)
6537
+ # Pass arguments to `delete_goldengate_connection` via keyword arguments. Note that at
6538
+ # least one keyword argument is required. To specify no parameters, or to keep all
6539
+ # the default parameter values, pass an empty Hash as a request object (see above).
6540
+ #
6541
+ # @param name [::String]
6542
+ # Required. The name of the GoldengateConnection in the following format:
6543
+ # projects/\\{project}/locations/\\{location}/goldengateConnections/\\{goldengate_connection}.
6544
+ # @param request_id [::String]
6545
+ # Optional. An optional ID to identify the request. This value is used to
6546
+ # identify duplicate requests. If you make a request with the same request ID
6547
+ # and the original request is still in progress or completed, the server
6548
+ # ignores the second request. This prevents clients from
6549
+ # accidentally creating duplicate commitments.
6550
+ #
6551
+ # The request ID must be a valid UUID with the exception that zero UUID is
6552
+ # not supported (00000000-0000-0000-0000-000000000000).
6553
+ # @yield [result, operation] Access the result along with the TransportOperation object
6554
+ # @yieldparam result [::Gapic::Operation]
6555
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6556
+ #
6557
+ # @return [::Gapic::Operation]
6558
+ #
6559
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6560
+ #
6561
+ # @example Basic example
6562
+ # require "google/cloud/oracle_database/v1"
6563
+ #
6564
+ # # Create a client object. The client can be reused for multiple calls.
6565
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6566
+ #
6567
+ # # Create a request. To set request fields, pass in keyword arguments.
6568
+ # request = Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionRequest.new
6569
+ #
6570
+ # # Call the delete_goldengate_connection method.
6571
+ # result = client.delete_goldengate_connection request
6572
+ #
6573
+ # # The returned object is of type Gapic::Operation. You can use it to
6574
+ # # check the status of an operation, cancel it, or wait for results.
6575
+ # # Here is how to wait for a response.
6576
+ # result.wait_until_done! timeout: 60
6577
+ # if result.response?
6578
+ # p result.response
6579
+ # else
6580
+ # puts "No response received."
6581
+ # end
6582
+ #
6583
+ def delete_goldengate_connection request, options = nil
6584
+ raise ::ArgumentError, "request must be provided" if request.nil?
6585
+
6586
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionRequest
6587
+
6588
+ # Converts hash and nil to an options object
6589
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6590
+
6591
+ # Customize the options with defaults
6592
+ call_metadata = @config.rpcs.delete_goldengate_connection.metadata.to_h
6593
+
6594
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6595
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6596
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6597
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6598
+ transports_version_send: [:rest]
6599
+
6600
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6601
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6602
+
6603
+ options.apply_defaults timeout: @config.rpcs.delete_goldengate_connection.timeout,
6604
+ metadata: call_metadata,
6605
+ retry_policy: @config.rpcs.delete_goldengate_connection.retry_policy
6606
+
6607
+ options.apply_defaults timeout: @config.timeout,
6608
+ metadata: @config.metadata,
6609
+ retry_policy: @config.retry_policy
6610
+
6611
+ @oracle_database_stub.delete_goldengate_connection request, options do |result, operation|
6612
+ result = ::Gapic::Operation.new result, @operations_client, options: options
6613
+ yield result, operation if block_given?
6614
+ throw :response, result
6615
+ end
6616
+ rescue ::Gapic::Rest::Error => e
6617
+ raise ::Google::Cloud::Error.from_error(e)
6618
+ end
6619
+
6620
+ ##
6621
+ # Gets details of a single GoldengateDeploymentVersion.
6622
+ #
6623
+ # @overload get_goldengate_deployment_version(request, options = nil)
6624
+ # Pass arguments to `get_goldengate_deployment_version` via a request object, either of type
6625
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentVersionRequest} or an equivalent Hash.
6626
+ #
6627
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentVersionRequest, ::Hash]
6628
+ # A request object representing the call parameters. Required. To specify no
6629
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6630
+ # @param options [::Gapic::CallOptions, ::Hash]
6631
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6632
+ #
6633
+ # @overload get_goldengate_deployment_version(name: nil)
6634
+ # Pass arguments to `get_goldengate_deployment_version` via keyword arguments. Note that at
6635
+ # least one keyword argument is required. To specify no parameters, or to keep all
6636
+ # the default parameter values, pass an empty Hash as a request object (see above).
6637
+ #
6638
+ # @param name [::String]
6639
+ # Required. The name of the GoldengateDeploymentVersion to retrieve.
6640
+ # Format:
6641
+ # projects/\\{project}/locations/\\{location}/goldengateDeploymentVersions/\\{goldengate_deployment_version}
6642
+ # @yield [result, operation] Access the result along with the TransportOperation object
6643
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion]
6644
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6645
+ #
6646
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion]
6647
+ #
6648
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6649
+ #
6650
+ # @example Basic example
6651
+ # require "google/cloud/oracle_database/v1"
6652
+ #
6653
+ # # Create a client object. The client can be reused for multiple calls.
6654
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6655
+ #
6656
+ # # Create a request. To set request fields, pass in keyword arguments.
6657
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentVersionRequest.new
6658
+ #
6659
+ # # Call the get_goldengate_deployment_version method.
6660
+ # result = client.get_goldengate_deployment_version request
6661
+ #
6662
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion.
6663
+ # p result
6664
+ #
6665
+ def get_goldengate_deployment_version request, options = nil
6666
+ raise ::ArgumentError, "request must be provided" if request.nil?
6667
+
6668
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentVersionRequest
6669
+
6670
+ # Converts hash and nil to an options object
6671
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6672
+
6673
+ # Customize the options with defaults
6674
+ call_metadata = @config.rpcs.get_goldengate_deployment_version.metadata.to_h
6675
+
6676
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6677
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6678
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6679
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6680
+ transports_version_send: [:rest]
6681
+
6682
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6683
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6684
+
6685
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_deployment_version.timeout,
6686
+ metadata: call_metadata,
6687
+ retry_policy: @config.rpcs.get_goldengate_deployment_version.retry_policy
6688
+
6689
+ options.apply_defaults timeout: @config.timeout,
6690
+ metadata: @config.metadata,
6691
+ retry_policy: @config.retry_policy
6692
+
6693
+ @oracle_database_stub.get_goldengate_deployment_version request, options do |result, operation|
6694
+ yield result, operation if block_given?
6695
+ end
6696
+ rescue ::Gapic::Rest::Error => e
6697
+ raise ::Google::Cloud::Error.from_error(e)
6698
+ end
6699
+
6700
+ ##
6701
+ # Lists GoldengateDeploymentVersions in a given project and location.
6702
+ #
6703
+ # @overload list_goldengate_deployment_versions(request, options = nil)
6704
+ # Pass arguments to `list_goldengate_deployment_versions` via a request object, either of type
6705
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest} or an equivalent Hash.
6706
+ #
6707
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest, ::Hash]
6708
+ # A request object representing the call parameters. Required. To specify no
6709
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6710
+ # @param options [::Gapic::CallOptions, ::Hash]
6711
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6712
+ #
6713
+ # @overload list_goldengate_deployment_versions(parent: nil, page_size: nil, page_token: nil, filter: nil)
6714
+ # Pass arguments to `list_goldengate_deployment_versions` via keyword arguments. Note that at
6715
+ # least one keyword argument is required. To specify no parameters, or to keep all
6716
+ # the default parameter values, pass an empty Hash as a request object (see above).
6717
+ #
6718
+ # @param parent [::String]
6719
+ # Required. Parent value for ListGoldengateDeploymentVersionsRequest
6720
+ # Format: projects/\\{project}/locations/\\{location}
6721
+ # @param page_size [::Integer]
6722
+ # Optional. Requested page size. Server may return fewer items than
6723
+ # requested. If unspecified, server will pick an appropriate default. The
6724
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
6725
+ # @param page_token [::String]
6726
+ # Optional. A token identifying a page of results the server should return.
6727
+ # @param filter [::String]
6728
+ # Optional. An expression for filtering the results of the request. Either
6729
+ # the deployment_id and deployment_type fields must be specified in the
6730
+ # format: `deployment_id="id"` or `deployment_type="DATABASE_ORACLE"`.
6731
+ # @yield [result, operation] Access the result along with the TransportOperation object
6732
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion>]
6733
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6734
+ #
6735
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion>]
6736
+ #
6737
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6738
+ #
6739
+ # @example Basic example
6740
+ # require "google/cloud/oracle_database/v1"
6741
+ #
6742
+ # # Create a client object. The client can be reused for multiple calls.
6743
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6744
+ #
6745
+ # # Create a request. To set request fields, pass in keyword arguments.
6746
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest.new
6747
+ #
6748
+ # # Call the list_goldengate_deployment_versions method.
6749
+ # result = client.list_goldengate_deployment_versions request
6750
+ #
6751
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
6752
+ # # over elements, and API calls will be issued to fetch pages as needed.
6753
+ # result.each do |item|
6754
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion.
6755
+ # p item
6756
+ # end
6757
+ #
6758
+ def list_goldengate_deployment_versions request, options = nil
6759
+ raise ::ArgumentError, "request must be provided" if request.nil?
6760
+
6761
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest
6762
+
6763
+ # Converts hash and nil to an options object
6764
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6765
+
6766
+ # Customize the options with defaults
6767
+ call_metadata = @config.rpcs.list_goldengate_deployment_versions.metadata.to_h
6768
+
6769
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6770
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6771
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6772
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6773
+ transports_version_send: [:rest]
6774
+
6775
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6776
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6777
+
6778
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_deployment_versions.timeout,
6779
+ metadata: call_metadata,
6780
+ retry_policy: @config.rpcs.list_goldengate_deployment_versions.retry_policy
6781
+
6782
+ options.apply_defaults timeout: @config.timeout,
6783
+ metadata: @config.metadata,
6784
+ retry_policy: @config.retry_policy
6785
+
6786
+ @oracle_database_stub.list_goldengate_deployment_versions request, options do |result, operation|
6787
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_deployment_versions, "goldengate_deployment_versions", request, result, options
6788
+ yield result, operation if block_given?
6789
+ throw :response, result
6790
+ end
6791
+ rescue ::Gapic::Rest::Error => e
6792
+ raise ::Google::Cloud::Error.from_error(e)
6793
+ end
6794
+
6795
+ ##
6796
+ # Gets details of a single GoldenGateDeploymentType.
6797
+ #
6798
+ # @overload get_goldengate_deployment_type(request, options = nil)
6799
+ # Pass arguments to `get_goldengate_deployment_type` via a request object, either of type
6800
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentTypeRequest} or an equivalent Hash.
6801
+ #
6802
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentTypeRequest, ::Hash]
6803
+ # A request object representing the call parameters. Required. To specify no
6804
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6805
+ # @param options [::Gapic::CallOptions, ::Hash]
6806
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6807
+ #
6808
+ # @overload get_goldengate_deployment_type(name: nil)
6809
+ # Pass arguments to `get_goldengate_deployment_type` via keyword arguments. Note that at
6810
+ # least one keyword argument is required. To specify no parameters, or to keep all
6811
+ # the default parameter values, pass an empty Hash as a request object (see above).
6812
+ #
6813
+ # @param name [::String]
6814
+ # Required. The name of the GoldengateDeploymentType to retrieve.
6815
+ # Format:
6816
+ # projects/\\{project}/locations/\\{location}/goldengateDeploymentTypes/\\{goldengate_deployment_type}
6817
+ # @yield [result, operation] Access the result along with the TransportOperation object
6818
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType]
6819
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6820
+ #
6821
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType]
6822
+ #
6823
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6824
+ #
6825
+ # @example Basic example
6826
+ # require "google/cloud/oracle_database/v1"
6827
+ #
6828
+ # # Create a client object. The client can be reused for multiple calls.
6829
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6830
+ #
6831
+ # # Create a request. To set request fields, pass in keyword arguments.
6832
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentTypeRequest.new
6833
+ #
6834
+ # # Call the get_goldengate_deployment_type method.
6835
+ # result = client.get_goldengate_deployment_type request
6836
+ #
6837
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType.
6838
+ # p result
6839
+ #
6840
+ def get_goldengate_deployment_type request, options = nil
6841
+ raise ::ArgumentError, "request must be provided" if request.nil?
6842
+
6843
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentTypeRequest
6844
+
6845
+ # Converts hash and nil to an options object
6846
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6847
+
6848
+ # Customize the options with defaults
6849
+ call_metadata = @config.rpcs.get_goldengate_deployment_type.metadata.to_h
6850
+
6851
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6852
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6853
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6854
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6855
+ transports_version_send: [:rest]
6856
+
6857
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6858
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6859
+
6860
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_deployment_type.timeout,
6861
+ metadata: call_metadata,
6862
+ retry_policy: @config.rpcs.get_goldengate_deployment_type.retry_policy
6863
+
6864
+ options.apply_defaults timeout: @config.timeout,
6865
+ metadata: @config.metadata,
6866
+ retry_policy: @config.retry_policy
6867
+
6868
+ @oracle_database_stub.get_goldengate_deployment_type request, options do |result, operation|
6869
+ yield result, operation if block_given?
6870
+ end
6871
+ rescue ::Gapic::Rest::Error => e
6872
+ raise ::Google::Cloud::Error.from_error(e)
6873
+ end
6874
+
6875
+ ##
6876
+ # Lists GoldenGateDeploymentTypes in a given project and location.
6877
+ #
6878
+ # @overload list_goldengate_deployment_types(request, options = nil)
6879
+ # Pass arguments to `list_goldengate_deployment_types` via a request object, either of type
6880
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest} or an equivalent Hash.
6881
+ #
6882
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest, ::Hash]
6883
+ # A request object representing the call parameters. Required. To specify no
6884
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6885
+ # @param options [::Gapic::CallOptions, ::Hash]
6886
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6887
+ #
6888
+ # @overload list_goldengate_deployment_types(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
6889
+ # Pass arguments to `list_goldengate_deployment_types` via keyword arguments. Note that at
6890
+ # least one keyword argument is required. To specify no parameters, or to keep all
6891
+ # the default parameter values, pass an empty Hash as a request object (see above).
6892
+ #
6893
+ # @param parent [::String]
6894
+ # Required. The parent resource.
6895
+ # Format: projects/\\{project}/locations/\\{location}
6896
+ # @param page_size [::Integer]
6897
+ # Optional. Requested page size. Server may return fewer items than
6898
+ # requested. If unspecified, server will pick an appropriate default.
6899
+ # @param page_token [::String]
6900
+ # Optional. A token identifying a page of results the server should return.
6901
+ # @param filter [::String]
6902
+ # Optional. An expression for filtering the results of the request. Either
6903
+ # the deployment_type and ogg_version fields must be specified in the format:
6904
+ # `deployment_type="DATABASE_ORACLE"` or `ogg_version="version"`.
6905
+ # Allowed values for deployment_type are: `DATABASE_ORACLE`, `BIGDATA`,
6906
+ # `DATABASE_MICROSOFT_SQLSERVER`, `DATABASE_MYSQL`, `DATABASE_POSTGRESQL`,
6907
+ # `DATABASE_DB2ZOS`, `DATABASE_DB2I`, `GGSA`, `DATA_TRANSFORMS`.
6908
+ # @param order_by [::String]
6909
+ # Optional. Hint for how to order the results
6910
+ # @yield [result, operation] Access the result along with the TransportOperation object
6911
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType>]
6912
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6913
+ #
6914
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType>]
6915
+ #
6916
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6917
+ #
6918
+ # @example Basic example
6919
+ # require "google/cloud/oracle_database/v1"
6920
+ #
6921
+ # # Create a client object. The client can be reused for multiple calls.
6922
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6923
+ #
6924
+ # # Create a request. To set request fields, pass in keyword arguments.
6925
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest.new
6926
+ #
6927
+ # # Call the list_goldengate_deployment_types method.
6928
+ # result = client.list_goldengate_deployment_types request
6929
+ #
6930
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
6931
+ # # over elements, and API calls will be issued to fetch pages as needed.
6932
+ # result.each do |item|
6933
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType.
6934
+ # p item
6935
+ # end
6936
+ #
6937
+ def list_goldengate_deployment_types request, options = nil
6938
+ raise ::ArgumentError, "request must be provided" if request.nil?
6939
+
6940
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest
6941
+
6942
+ # Converts hash and nil to an options object
6943
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6944
+
6945
+ # Customize the options with defaults
6946
+ call_metadata = @config.rpcs.list_goldengate_deployment_types.metadata.to_h
6947
+
6948
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6949
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6950
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6951
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6952
+ transports_version_send: [:rest]
6953
+
6954
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6955
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6956
+
6957
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_deployment_types.timeout,
6958
+ metadata: call_metadata,
6959
+ retry_policy: @config.rpcs.list_goldengate_deployment_types.retry_policy
6960
+
6961
+ options.apply_defaults timeout: @config.timeout,
6962
+ metadata: @config.metadata,
6963
+ retry_policy: @config.retry_policy
6964
+
6965
+ @oracle_database_stub.list_goldengate_deployment_types request, options do |result, operation|
6966
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_deployment_types, "goldengate_deployment_types", request, result, options
6967
+ yield result, operation if block_given?
6968
+ throw :response, result
6969
+ end
6970
+ rescue ::Gapic::Rest::Error => e
6971
+ raise ::Google::Cloud::Error.from_error(e)
6972
+ end
6973
+
6974
+ ##
6975
+ # Gets details of a single GoldengateDeploymentEnvironment.
6976
+ #
6977
+ # @overload get_goldengate_deployment_environment(request, options = nil)
6978
+ # Pass arguments to `get_goldengate_deployment_environment` via a request object, either of type
6979
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentEnvironmentRequest} or an equivalent Hash.
6980
+ #
6981
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentEnvironmentRequest, ::Hash]
6982
+ # A request object representing the call parameters. Required. To specify no
6983
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6984
+ # @param options [::Gapic::CallOptions, ::Hash]
6985
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6986
+ #
6987
+ # @overload get_goldengate_deployment_environment(name: nil)
6988
+ # Pass arguments to `get_goldengate_deployment_environment` via keyword arguments. Note that at
6989
+ # least one keyword argument is required. To specify no parameters, or to keep all
6990
+ # the default parameter values, pass an empty Hash as a request object (see above).
6991
+ #
6992
+ # @param name [::String]
6993
+ # Required. Name of the resource with the format:
6994
+ # projects/\\{project}/locations/\\{location}/goldengateDeploymentEnvironments/\\{goldengate_deployment_environment}
6995
+ # @yield [result, operation] Access the result along with the TransportOperation object
6996
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment]
6997
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6998
+ #
6999
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment]
7000
+ #
7001
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7002
+ #
7003
+ # @example Basic example
7004
+ # require "google/cloud/oracle_database/v1"
7005
+ #
7006
+ # # Create a client object. The client can be reused for multiple calls.
7007
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7008
+ #
7009
+ # # Create a request. To set request fields, pass in keyword arguments.
7010
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentEnvironmentRequest.new
7011
+ #
7012
+ # # Call the get_goldengate_deployment_environment method.
7013
+ # result = client.get_goldengate_deployment_environment request
7014
+ #
7015
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment.
7016
+ # p result
7017
+ #
7018
+ def get_goldengate_deployment_environment request, options = nil
7019
+ raise ::ArgumentError, "request must be provided" if request.nil?
7020
+
7021
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateDeploymentEnvironmentRequest
7022
+
7023
+ # Converts hash and nil to an options object
7024
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7025
+
7026
+ # Customize the options with defaults
7027
+ call_metadata = @config.rpcs.get_goldengate_deployment_environment.metadata.to_h
7028
+
7029
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7030
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7031
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7032
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7033
+ transports_version_send: [:rest]
7034
+
7035
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7036
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7037
+
7038
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_deployment_environment.timeout,
7039
+ metadata: call_metadata,
7040
+ retry_policy: @config.rpcs.get_goldengate_deployment_environment.retry_policy
7041
+
7042
+ options.apply_defaults timeout: @config.timeout,
7043
+ metadata: @config.metadata,
7044
+ retry_policy: @config.retry_policy
7045
+
7046
+ @oracle_database_stub.get_goldengate_deployment_environment request, options do |result, operation|
7047
+ yield result, operation if block_given?
7048
+ end
7049
+ rescue ::Gapic::Rest::Error => e
7050
+ raise ::Google::Cloud::Error.from_error(e)
7051
+ end
7052
+
7053
+ ##
7054
+ # Lists GoldengateDeploymentEnvironments in a given project and location.
7055
+ #
7056
+ # @overload list_goldengate_deployment_environments(request, options = nil)
7057
+ # Pass arguments to `list_goldengate_deployment_environments` via a request object, either of type
7058
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest} or an equivalent Hash.
7059
+ #
7060
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest, ::Hash]
7061
+ # A request object representing the call parameters. Required. To specify no
7062
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7063
+ # @param options [::Gapic::CallOptions, ::Hash]
7064
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7065
+ #
7066
+ # @overload list_goldengate_deployment_environments(parent: nil, page_size: nil, page_token: nil)
7067
+ # Pass arguments to `list_goldengate_deployment_environments` via keyword arguments. Note that at
7068
+ # least one keyword argument is required. To specify no parameters, or to keep all
7069
+ # the default parameter values, pass an empty Hash as a request object (see above).
7070
+ #
7071
+ # @param parent [::String]
7072
+ # Required. The parent, which owns this collection of
7073
+ # GoldengateDeploymentEnvironments. Format:
7074
+ # projects/\\{project}/locations/\\{location}
7075
+ # @param page_size [::Integer]
7076
+ # Optional. The maximum number of items to return.
7077
+ # If unspecified, at most 50 deployment environments will be returned.
7078
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
7079
+ # @param page_token [::String]
7080
+ # Optional. A token identifying a page of results the server should return.
7081
+ # @yield [result, operation] Access the result along with the TransportOperation object
7082
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment>]
7083
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7084
+ #
7085
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment>]
7086
+ #
7087
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7088
+ #
7089
+ # @example Basic example
7090
+ # require "google/cloud/oracle_database/v1"
7091
+ #
7092
+ # # Create a client object. The client can be reused for multiple calls.
7093
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7094
+ #
7095
+ # # Create a request. To set request fields, pass in keyword arguments.
7096
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest.new
7097
+ #
7098
+ # # Call the list_goldengate_deployment_environments method.
7099
+ # result = client.list_goldengate_deployment_environments request
7100
+ #
7101
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7102
+ # # over elements, and API calls will be issued to fetch pages as needed.
7103
+ # result.each do |item|
7104
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment.
7105
+ # p item
7106
+ # end
7107
+ #
7108
+ def list_goldengate_deployment_environments request, options = nil
7109
+ raise ::ArgumentError, "request must be provided" if request.nil?
7110
+
7111
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest
7112
+
7113
+ # Converts hash and nil to an options object
7114
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7115
+
7116
+ # Customize the options with defaults
7117
+ call_metadata = @config.rpcs.list_goldengate_deployment_environments.metadata.to_h
7118
+
7119
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7120
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7121
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7122
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7123
+ transports_version_send: [:rest]
7124
+
7125
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7126
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7127
+
7128
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_deployment_environments.timeout,
7129
+ metadata: call_metadata,
7130
+ retry_policy: @config.rpcs.list_goldengate_deployment_environments.retry_policy
7131
+
7132
+ options.apply_defaults timeout: @config.timeout,
7133
+ metadata: @config.metadata,
7134
+ retry_policy: @config.retry_policy
7135
+
7136
+ @oracle_database_stub.list_goldengate_deployment_environments request, options do |result, operation|
7137
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_deployment_environments, "goldengate_deployment_environments", request, result, options
7138
+ yield result, operation if block_given?
7139
+ throw :response, result
7140
+ end
7141
+ rescue ::Gapic::Rest::Error => e
7142
+ raise ::Google::Cloud::Error.from_error(e)
7143
+ end
7144
+
7145
+ ##
7146
+ # Gets details of a single GoldengateConnectionType.
7147
+ #
7148
+ # @overload get_goldengate_connection_type(request, options = nil)
7149
+ # Pass arguments to `get_goldengate_connection_type` via a request object, either of type
7150
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionTypeRequest} or an equivalent Hash.
7151
+ #
7152
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionTypeRequest, ::Hash]
7153
+ # A request object representing the call parameters. Required. To specify no
7154
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7155
+ # @param options [::Gapic::CallOptions, ::Hash]
7156
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7157
+ #
7158
+ # @overload get_goldengate_connection_type(name: nil)
7159
+ # Pass arguments to `get_goldengate_connection_type` via keyword arguments. Note that at
7160
+ # least one keyword argument is required. To specify no parameters, or to keep all
7161
+ # the default parameter values, pass an empty Hash as a request object (see above).
7162
+ #
7163
+ # @param name [::String]
7164
+ # Required. Name of the resource in the format:
7165
+ # projects/\\{project}/locations/\\{location}/goldengateConnectionTypes/\\{goldengate_connection_type}
7166
+ # @yield [result, operation] Access the result along with the TransportOperation object
7167
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType]
7168
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7169
+ #
7170
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType]
7171
+ #
7172
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7173
+ #
7174
+ # @example Basic example
7175
+ # require "google/cloud/oracle_database/v1"
7176
+ #
7177
+ # # Create a client object. The client can be reused for multiple calls.
7178
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7179
+ #
7180
+ # # Create a request. To set request fields, pass in keyword arguments.
7181
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionTypeRequest.new
7182
+ #
7183
+ # # Call the get_goldengate_connection_type method.
7184
+ # result = client.get_goldengate_connection_type request
7185
+ #
7186
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateConnectionType.
7187
+ # p result
7188
+ #
7189
+ def get_goldengate_connection_type request, options = nil
7190
+ raise ::ArgumentError, "request must be provided" if request.nil?
7191
+
7192
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionTypeRequest
7193
+
7194
+ # Converts hash and nil to an options object
7195
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7196
+
7197
+ # Customize the options with defaults
7198
+ call_metadata = @config.rpcs.get_goldengate_connection_type.metadata.to_h
7199
+
7200
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7201
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7202
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7203
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7204
+ transports_version_send: [:rest]
7205
+
7206
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7207
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7208
+
7209
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_connection_type.timeout,
7210
+ metadata: call_metadata,
7211
+ retry_policy: @config.rpcs.get_goldengate_connection_type.retry_policy
7212
+
7213
+ options.apply_defaults timeout: @config.timeout,
7214
+ metadata: @config.metadata,
7215
+ retry_policy: @config.retry_policy
7216
+
7217
+ @oracle_database_stub.get_goldengate_connection_type request, options do |result, operation|
7218
+ yield result, operation if block_given?
7219
+ end
7220
+ rescue ::Gapic::Rest::Error => e
7221
+ raise ::Google::Cloud::Error.from_error(e)
7222
+ end
7223
+
7224
+ ##
7225
+ # Lists GoldengateConnectionTypes in a given project and location.
7226
+ #
7227
+ # @overload list_goldengate_connection_types(request, options = nil)
7228
+ # Pass arguments to `list_goldengate_connection_types` via a request object, either of type
7229
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest} or an equivalent Hash.
7230
+ #
7231
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest, ::Hash]
7232
+ # A request object representing the call parameters. Required. To specify no
7233
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7234
+ # @param options [::Gapic::CallOptions, ::Hash]
7235
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7236
+ #
7237
+ # @overload list_goldengate_connection_types(parent: nil, page_size: nil, page_token: nil, filter: nil)
7238
+ # Pass arguments to `list_goldengate_connection_types` via keyword arguments. Note that at
7239
+ # least one keyword argument is required. To specify no parameters, or to keep all
7240
+ # the default parameter values, pass an empty Hash as a request object (see above).
7241
+ #
7242
+ # @param parent [::String]
7243
+ # Required. Parent value for ListGoldengateConnectionTypesRequest
7244
+ # Format: projects/\\{project}/locations/\\{location}
7245
+ # @param page_size [::Integer]
7246
+ # Optional. Requested page size. Server may return fewer items than
7247
+ # requested. If unspecified, server will pick an appropriate default.
7248
+ # @param page_token [::String]
7249
+ # Optional. A token identifying a page of results the server should return.
7250
+ # @param filter [::String]
7251
+ # Optional. An expression for filtering the results of the request. The
7252
+ # connection_type field must be specified in the format:
7253
+ # `connection_type="ORACLE"`.
7254
+ # @yield [result, operation] Access the result along with the TransportOperation object
7255
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType>]
7256
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7257
+ #
7258
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType>]
7259
+ #
7260
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7261
+ #
7262
+ # @example Basic example
7263
+ # require "google/cloud/oracle_database/v1"
7264
+ #
7265
+ # # Create a client object. The client can be reused for multiple calls.
7266
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7267
+ #
7268
+ # # Create a request. To set request fields, pass in keyword arguments.
7269
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest.new
7270
+ #
7271
+ # # Call the list_goldengate_connection_types method.
7272
+ # result = client.list_goldengate_connection_types request
7273
+ #
7274
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7275
+ # # over elements, and API calls will be issued to fetch pages as needed.
7276
+ # result.each do |item|
7277
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType.
7278
+ # p item
7279
+ # end
7280
+ #
7281
+ def list_goldengate_connection_types request, options = nil
7282
+ raise ::ArgumentError, "request must be provided" if request.nil?
7283
+
7284
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest
7285
+
7286
+ # Converts hash and nil to an options object
7287
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7288
+
7289
+ # Customize the options with defaults
7290
+ call_metadata = @config.rpcs.list_goldengate_connection_types.metadata.to_h
7291
+
7292
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7293
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7294
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7295
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7296
+ transports_version_send: [:rest]
7297
+
7298
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7299
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7300
+
7301
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_connection_types.timeout,
7302
+ metadata: call_metadata,
7303
+ retry_policy: @config.rpcs.list_goldengate_connection_types.retry_policy
7304
+
7305
+ options.apply_defaults timeout: @config.timeout,
7306
+ metadata: @config.metadata,
7307
+ retry_policy: @config.retry_policy
7308
+
7309
+ @oracle_database_stub.list_goldengate_connection_types request, options do |result, operation|
7310
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_connection_types, "goldengate_connection_types", request, result, options
7311
+ yield result, operation if block_given?
7312
+ throw :response, result
7313
+ end
7314
+ rescue ::Gapic::Rest::Error => e
7315
+ raise ::Google::Cloud::Error.from_error(e)
7316
+ end
7317
+
7318
+ ##
7319
+ # List DbVersions for the given project and location.
7320
+ #
7321
+ # @overload list_db_versions(request, options = nil)
7322
+ # Pass arguments to `list_db_versions` via a request object, either of type
7323
+ # {::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest} or an equivalent Hash.
7324
+ #
7325
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest, ::Hash]
7326
+ # A request object representing the call parameters. Required. To specify no
7327
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7328
+ # @param options [::Gapic::CallOptions, ::Hash]
7329
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7330
+ #
7331
+ # @overload list_db_versions(parent: nil, page_size: nil, page_token: nil, filter: nil)
7332
+ # Pass arguments to `list_db_versions` via keyword arguments. Note that at
7333
+ # least one keyword argument is required. To specify no parameters, or to keep all
7334
+ # the default parameter values, pass an empty Hash as a request object (see above).
7335
+ #
7336
+ # @param parent [::String]
7337
+ # Required. The parent value for the DbVersion resource with the
7338
+ # format: projects/\\{project}/locations/\\{location}
7339
+ # @param page_size [::Integer]
7340
+ # Optional. The maximum number of items to return.
7341
+ # If unspecified, a maximum of 50 DbVersions will be returned.
7342
+ # The maximum value is 1000; values above 1000 will be reset to 1000.
7343
+ # @param page_token [::String]
7344
+ # Optional. A token identifying the requested page of results to return. All
7345
+ # fields except the filter should remain the same as in the request that
7346
+ # provided this page token.
7347
+ # @param filter [::String]
7348
+ # Optional. Filter expression that matches a subset of the DbVersions to
7349
+ # show. The supported filter for dbSystem creation is `db_system_shape =
7350
+ # \\{db_system_shape} AND storage_management = \\{storage_management}`. If no
7351
+ # filter is provided, all DbVersions will be returned.
7352
+ # @yield [result, operation] Access the result along with the TransportOperation object
7353
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbVersion>]
7354
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7355
+ #
7356
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbVersion>]
7357
+ #
7358
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7359
+ #
7360
+ # @example Basic example
7361
+ # require "google/cloud/oracle_database/v1"
7362
+ #
7363
+ # # Create a client object. The client can be reused for multiple calls.
7364
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7365
+ #
7366
+ # # Create a request. To set request fields, pass in keyword arguments.
7367
+ # request = Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest.new
7368
+ #
7369
+ # # Call the list_db_versions method.
7370
+ # result = client.list_db_versions request
7371
+ #
7372
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7373
+ # # over elements, and API calls will be issued to fetch pages as needed.
7374
+ # result.each do |item|
7375
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DbVersion.
7376
+ # p item
7377
+ # end
7378
+ #
7379
+ def list_db_versions request, options = nil
7380
+ raise ::ArgumentError, "request must be provided" if request.nil?
7381
+
7382
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest
7383
+
7384
+ # Converts hash and nil to an options object
7385
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7386
+
7387
+ # Customize the options with defaults
7388
+ call_metadata = @config.rpcs.list_db_versions.metadata.to_h
7389
+
7390
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7391
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7392
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7393
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7394
+ transports_version_send: [:rest]
7395
+
7396
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7397
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7398
+
7399
+ options.apply_defaults timeout: @config.rpcs.list_db_versions.timeout,
7400
+ metadata: call_metadata,
7401
+ retry_policy: @config.rpcs.list_db_versions.retry_policy
7402
+
7403
+ options.apply_defaults timeout: @config.timeout,
7404
+ metadata: @config.metadata,
7405
+ retry_policy: @config.retry_policy
7406
+
7407
+ @oracle_database_stub.list_db_versions request, options do |result, operation|
7408
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_db_versions, "db_versions", request, result, options
7409
+ yield result, operation if block_given?
7410
+ throw :response, result
7411
+ end
7412
+ rescue ::Gapic::Rest::Error => e
7413
+ raise ::Google::Cloud::Error.from_error(e)
7414
+ end
7415
+
7416
+ ##
7417
+ # List DatabaseCharacterSets for the given project and location.
7418
+ #
7419
+ # @overload list_database_character_sets(request, options = nil)
7420
+ # Pass arguments to `list_database_character_sets` via a request object, either of type
7421
+ # {::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest} or an equivalent Hash.
7422
+ #
7423
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest, ::Hash]
7424
+ # A request object representing the call parameters. Required. To specify no
7425
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7426
+ # @param options [::Gapic::CallOptions, ::Hash]
7427
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7428
+ #
7429
+ # @overload list_database_character_sets(parent: nil, page_size: nil, page_token: nil, filter: nil)
7430
+ # Pass arguments to `list_database_character_sets` via keyword arguments. Note that at
7431
+ # least one keyword argument is required. To specify no parameters, or to keep all
7432
+ # the default parameter values, pass an empty Hash as a request object (see above).
7433
+ #
7434
+ # @param parent [::String]
7435
+ # Required. The parent value for DatabaseCharacterSets in the following
7436
+ # format: projects/\\{project}/locations/\\{location}.
7437
+ # @param page_size [::Integer]
7438
+ # Optional. The maximum number of DatabaseCharacterSets to return. The
7439
+ # service may return fewer than this value. If unspecified, at most 50
7440
+ # DatabaseCharacterSets will be returned. The maximum value is 1000; values
7441
+ # above 1000 will be coerced to 1000.
7442
+ # @param page_token [::String]
7443
+ # Optional. A page token, received from a previous
7444
+ # `ListDatabaseCharacterSets` call. Provide this to retrieve the subsequent
7445
+ # page.
7446
+ #
7447
+ # When paginating, all other parameters provided to
7448
+ # `ListDatabaseCharacterSets` must match the call that provided the page
7449
+ # token.
7450
+ # @param filter [::String]
7451
+ # Optional. An expression for filtering the results of the request. Only the
7452
+ # **character_set_type** field is supported in the following format:
7453
+ # `character_set_type="{characterSetType}"`. Accepted values include
7454
+ # `DATABASE` and `NATIONAL`.
7455
+ # @yield [result, operation] Access the result along with the TransportOperation object
7456
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet>]
7457
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7458
+ #
7459
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet>]
7460
+ #
7461
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7462
+ #
7463
+ # @example Basic example
7464
+ # require "google/cloud/oracle_database/v1"
7465
+ #
7466
+ # # Create a client object. The client can be reused for multiple calls.
7467
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7468
+ #
7469
+ # # Create a request. To set request fields, pass in keyword arguments.
7470
+ # request = Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest.new
7471
+ #
7472
+ # # Call the list_database_character_sets method.
7473
+ # result = client.list_database_character_sets request
7474
+ #
7475
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7476
+ # # over elements, and API calls will be issued to fetch pages as needed.
7477
+ # result.each do |item|
7478
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet.
7479
+ # p item
7480
+ # end
7481
+ #
7482
+ def list_database_character_sets request, options = nil
7483
+ raise ::ArgumentError, "request must be provided" if request.nil?
7484
+
7485
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest
7486
+
7487
+ # Converts hash and nil to an options object
7488
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7489
+
7490
+ # Customize the options with defaults
7491
+ call_metadata = @config.rpcs.list_database_character_sets.metadata.to_h
7492
+
7493
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7494
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7495
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7496
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7497
+ transports_version_send: [:rest]
7498
+
7499
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7500
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7501
+
7502
+ options.apply_defaults timeout: @config.rpcs.list_database_character_sets.timeout,
7503
+ metadata: call_metadata,
7504
+ retry_policy: @config.rpcs.list_database_character_sets.retry_policy
7505
+
7506
+ options.apply_defaults timeout: @config.timeout,
7507
+ metadata: @config.metadata,
7508
+ retry_policy: @config.retry_policy
7509
+
7510
+ @oracle_database_stub.list_database_character_sets request, options do |result, operation|
7511
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_database_character_sets, "database_character_sets", request, result, options
7512
+ yield result, operation if block_given?
7513
+ throw :response, result
7514
+ end
7515
+ rescue ::Gapic::Rest::Error => e
7516
+ raise ::Google::Cloud::Error.from_error(e)
7517
+ end
7518
+
7519
+ ##
7520
+ # Lists GoldengateConnectionAssignments in a given project and location.
7521
+ #
7522
+ # @overload list_goldengate_connection_assignments(request, options = nil)
7523
+ # Pass arguments to `list_goldengate_connection_assignments` via a request object, either of type
7524
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest} or an equivalent Hash.
7525
+ #
7526
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest, ::Hash]
7527
+ # A request object representing the call parameters. Required. To specify no
7528
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7529
+ # @param options [::Gapic::CallOptions, ::Hash]
7530
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7531
+ #
7532
+ # @overload list_goldengate_connection_assignments(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
7533
+ # Pass arguments to `list_goldengate_connection_assignments` via keyword arguments. Note that at
7534
+ # least one keyword argument is required. To specify no parameters, or to keep all
7535
+ # the default parameter values, pass an empty Hash as a request object (see above).
7536
+ #
7537
+ # @param parent [::String]
7538
+ # Required. The parent value for the GoldengateConnectionAssignments.
7539
+ # Format: projects/\\{project}/locations/\\{location}
7540
+ # @param page_size [::Integer]
7541
+ # Optional. The maximum number of GoldengateConnectionAssignments to return.
7542
+ # The service may return fewer than this value. If unspecified, at most 50
7543
+ # GoldengateConnectionAssignments will be returned. The maximum value is
7544
+ # 1000; values above 1000 will be coerced to 1000.
7545
+ # @param page_token [::String]
7546
+ # Optional. A page token, received from a previous
7547
+ # `ListGoldengateConnectionAssignments` call. Provide this to retrieve the
7548
+ # subsequent page.
7549
+ #
7550
+ # When paginating, all other parameters provided to
7551
+ # `ListGoldengateConnectionAssignments` must match the call that provided
7552
+ # the page token.
7553
+ # @param filter [::String]
7554
+ # Optional. A filter expression that filters GoldengateConnectionAssignments
7555
+ # listed in the response.
7556
+ # @param order_by [::String]
7557
+ # Optional. A comma-separated list of fields to order by, sorted in ascending
7558
+ # order. Use "DESC" after a field name for descending.
7559
+ # @yield [result, operation] Access the result along with the TransportOperation object
7560
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment>]
7561
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7562
+ #
7563
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment>]
7564
+ #
7565
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7566
+ #
7567
+ # @example Basic example
7568
+ # require "google/cloud/oracle_database/v1"
7569
+ #
7570
+ # # Create a client object. The client can be reused for multiple calls.
7571
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7572
+ #
7573
+ # # Create a request. To set request fields, pass in keyword arguments.
7574
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest.new
7575
+ #
7576
+ # # Call the list_goldengate_connection_assignments method.
7577
+ # result = client.list_goldengate_connection_assignments request
7578
+ #
7579
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7580
+ # # over elements, and API calls will be issued to fetch pages as needed.
7581
+ # result.each do |item|
7582
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment.
7583
+ # p item
7584
+ # end
7585
+ #
7586
+ def list_goldengate_connection_assignments request, options = nil
7587
+ raise ::ArgumentError, "request must be provided" if request.nil?
7588
+
7589
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest
7590
+
7591
+ # Converts hash and nil to an options object
7592
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7593
+
7594
+ # Customize the options with defaults
7595
+ call_metadata = @config.rpcs.list_goldengate_connection_assignments.metadata.to_h
7596
+
7597
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7598
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7599
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7600
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7601
+ transports_version_send: [:rest]
7602
+
7603
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7604
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7605
+
7606
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_connection_assignments.timeout,
7607
+ metadata: call_metadata,
7608
+ retry_policy: @config.rpcs.list_goldengate_connection_assignments.retry_policy
7609
+
7610
+ options.apply_defaults timeout: @config.timeout,
7611
+ metadata: @config.metadata,
7612
+ retry_policy: @config.retry_policy
7613
+
7614
+ @oracle_database_stub.list_goldengate_connection_assignments request, options do |result, operation|
7615
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_connection_assignments, "goldengate_connection_assignments", request, result, options
7616
+ yield result, operation if block_given?
7617
+ throw :response, result
7618
+ end
7619
+ rescue ::Gapic::Rest::Error => e
7620
+ raise ::Google::Cloud::Error.from_error(e)
7621
+ end
7622
+
7623
+ ##
7624
+ # Gets details of a single GoldengateConnectionAssignment.
7625
+ #
7626
+ # @overload get_goldengate_connection_assignment(request, options = nil)
7627
+ # Pass arguments to `get_goldengate_connection_assignment` via a request object, either of type
7628
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7629
+ #
7630
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest, ::Hash]
7631
+ # A request object representing the call parameters. Required. To specify no
7632
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7633
+ # @param options [::Gapic::CallOptions, ::Hash]
7634
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7635
+ #
7636
+ # @overload get_goldengate_connection_assignment(name: nil)
7637
+ # Pass arguments to `get_goldengate_connection_assignment` via keyword arguments. Note that at
7638
+ # least one keyword argument is required. To specify no parameters, or to keep all
7639
+ # the default parameter values, pass an empty Hash as a request object (see above).
7640
+ #
7641
+ # @param name [::String]
7642
+ # Required. The name of the GoldengateConnectionAssignment to retrieve.
7643
+ # Format:
7644
+ # projects/\\{project}/locations/\\{location}/goldengateConnectionAssignments/\\{goldengate_connection_assignment}
7645
+ # @yield [result, operation] Access the result along with the TransportOperation object
7646
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment]
7647
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7648
+ #
7649
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment]
7650
+ #
7651
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7652
+ #
7653
+ # @example Basic example
7654
+ # require "google/cloud/oracle_database/v1"
7655
+ #
7656
+ # # Create a client object. The client can be reused for multiple calls.
7657
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7658
+ #
7659
+ # # Create a request. To set request fields, pass in keyword arguments.
7660
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest.new
7661
+ #
7662
+ # # Call the get_goldengate_connection_assignment method.
7663
+ # result = client.get_goldengate_connection_assignment request
7664
+ #
7665
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment.
7666
+ # p result
7667
+ #
7668
+ def get_goldengate_connection_assignment request, options = nil
7669
+ raise ::ArgumentError, "request must be provided" if request.nil?
7670
+
7671
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest
7672
+
7673
+ # Converts hash and nil to an options object
7674
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7675
+
7676
+ # Customize the options with defaults
7677
+ call_metadata = @config.rpcs.get_goldengate_connection_assignment.metadata.to_h
7678
+
7679
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7680
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7681
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7682
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7683
+ transports_version_send: [:rest]
7684
+
7685
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7686
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7687
+
7688
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_connection_assignment.timeout,
7689
+ metadata: call_metadata,
7690
+ retry_policy: @config.rpcs.get_goldengate_connection_assignment.retry_policy
7691
+
7692
+ options.apply_defaults timeout: @config.timeout,
7693
+ metadata: @config.metadata,
7694
+ retry_policy: @config.retry_policy
7695
+
7696
+ @oracle_database_stub.get_goldengate_connection_assignment request, options do |result, operation|
7697
+ yield result, operation if block_given?
7698
+ end
7699
+ rescue ::Gapic::Rest::Error => e
7700
+ raise ::Google::Cloud::Error.from_error(e)
7701
+ end
7702
+
7703
+ ##
7704
+ # Creates a new GoldengateConnectionAssignment in a given project and
7705
+ # location.
7706
+ #
7707
+ # @overload create_goldengate_connection_assignment(request, options = nil)
7708
+ # Pass arguments to `create_goldengate_connection_assignment` via a request object, either of type
7709
+ # {::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7710
+ #
7711
+ # @param request [::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest, ::Hash]
7712
+ # A request object representing the call parameters. Required. To specify no
7713
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7714
+ # @param options [::Gapic::CallOptions, ::Hash]
7715
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7716
+ #
7717
+ # @overload create_goldengate_connection_assignment(parent: nil, goldengate_connection_assignment_id: nil, goldengate_connection_assignment: nil, request_id: nil)
7718
+ # Pass arguments to `create_goldengate_connection_assignment` via keyword arguments. Note that at
7719
+ # least one keyword argument is required. To specify no parameters, or to keep all
7720
+ # the default parameter values, pass an empty Hash as a request object (see above).
7721
+ #
7722
+ # @param parent [::String]
7723
+ # Required. The parent resource where this GoldengateConnectionAssignment
7724
+ # will be created. Format: projects/\\{project}/locations/\\{location}
7725
+ # @param goldengate_connection_assignment_id [::String]
7726
+ # Required. The ID of the GoldengateConnectionAssignment to create.
7727
+ # @param goldengate_connection_assignment [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment, ::Hash]
7728
+ # Required. The GoldengateConnectionAssignment to create.
7729
+ # @param request_id [::String]
7730
+ # Optional. An optional request ID to identify requests. Specify a unique
7731
+ # request ID so that if you must retry your request, the server will know to
7732
+ # ignore the request if it has already been completed. The server will
7733
+ # guarantee that for at least 60 minutes since the first request.
7734
+ #
7735
+ # For example, consider a situation where you make an initial request and the
7736
+ # request times out. If you make the request again with the same request
7737
+ # ID, the server can check if original operation with the same request ID
7738
+ # was received, and if so, will ignore the second request. This prevents
7739
+ # clients from accidentally creating duplicate commitments.
7740
+ #
7741
+ # The request ID must be a valid UUID with the exception that zero UUID is
7742
+ # not supported (00000000-0000-0000-0000-000000000000).
7743
+ # @yield [result, operation] Access the result along with the TransportOperation object
7744
+ # @yieldparam result [::Gapic::Operation]
7745
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7746
+ #
7747
+ # @return [::Gapic::Operation]
7748
+ #
7749
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7750
+ #
7751
+ # @example Basic example
7752
+ # require "google/cloud/oracle_database/v1"
7753
+ #
7754
+ # # Create a client object. The client can be reused for multiple calls.
7755
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7756
+ #
7757
+ # # Create a request. To set request fields, pass in keyword arguments.
7758
+ # request = Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest.new
7759
+ #
7760
+ # # Call the create_goldengate_connection_assignment method.
7761
+ # result = client.create_goldengate_connection_assignment request
7762
+ #
7763
+ # # The returned object is of type Gapic::Operation. You can use it to
7764
+ # # check the status of an operation, cancel it, or wait for results.
7765
+ # # Here is how to wait for a response.
7766
+ # result.wait_until_done! timeout: 60
7767
+ # if result.response?
7768
+ # p result.response
7769
+ # else
7770
+ # puts "No response received."
7771
+ # end
7772
+ #
7773
+ def create_goldengate_connection_assignment request, options = nil
7774
+ raise ::ArgumentError, "request must be provided" if request.nil?
7775
+
7776
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest
7777
+
7778
+ # Converts hash and nil to an options object
7779
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7780
+
7781
+ # Customize the options with defaults
7782
+ call_metadata = @config.rpcs.create_goldengate_connection_assignment.metadata.to_h
7783
+
7784
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7785
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7786
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7787
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7788
+ transports_version_send: [:rest]
7789
+
7790
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7791
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7792
+
7793
+ options.apply_defaults timeout: @config.rpcs.create_goldengate_connection_assignment.timeout,
7794
+ metadata: call_metadata,
7795
+ retry_policy: @config.rpcs.create_goldengate_connection_assignment.retry_policy
7796
+
7797
+ options.apply_defaults timeout: @config.timeout,
7798
+ metadata: @config.metadata,
7799
+ retry_policy: @config.retry_policy
7800
+
7801
+ @oracle_database_stub.create_goldengate_connection_assignment request, options do |result, operation|
7802
+ result = ::Gapic::Operation.new result, @operations_client, options: options
7803
+ yield result, operation if block_given?
7804
+ throw :response, result
7805
+ end
7806
+ rescue ::Gapic::Rest::Error => e
7807
+ raise ::Google::Cloud::Error.from_error(e)
7808
+ end
7809
+
7810
+ ##
7811
+ # Deletes a single GoldengateConnectionAssignment.
7812
+ #
7813
+ # @overload delete_goldengate_connection_assignment(request, options = nil)
7814
+ # Pass arguments to `delete_goldengate_connection_assignment` via a request object, either of type
7815
+ # {::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7816
+ #
7817
+ # @param request [::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest, ::Hash]
7818
+ # A request object representing the call parameters. Required. To specify no
7819
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7820
+ # @param options [::Gapic::CallOptions, ::Hash]
7821
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7822
+ #
7823
+ # @overload delete_goldengate_connection_assignment(name: nil, request_id: nil)
7824
+ # Pass arguments to `delete_goldengate_connection_assignment` via keyword arguments. Note that at
7825
+ # least one keyword argument is required. To specify no parameters, or to keep all
7826
+ # the default parameter values, pass an empty Hash as a request object (see above).
7827
+ #
7828
+ # @param name [::String]
7829
+ # Required. The name of the GoldengateConnectionAssignment to delete.
7830
+ # Format:
7831
+ # projects/\\{project}/locations/\\{location}/goldengateConnectionAssignments/\\{goldengate_connection_assignment}
7832
+ # @param request_id [::String]
7833
+ # Optional. An optional request ID to identify requests. Specify a unique
7834
+ # request ID so that if you must retry your request, the server will know to
7835
+ # ignore the request if it has already been completed. The server will
7836
+ # guarantee that for at least 60 minutes after the first request.
7837
+ #
7838
+ # For example, consider a situation where you make an initial request and the
7839
+ # request times out. If you make the request again with the same request
7840
+ # ID, the server can check if original operation with the same request ID
7841
+ # was received, and if so, will ignore the second request. This prevents
7842
+ # clients from accidentally creating duplicate commitments.
7843
+ #
7844
+ # The request ID must be a valid UUID with the exception that zero UUID is
7845
+ # not supported (00000000-0000-0000-0000-000000000000).
7846
+ # @yield [result, operation] Access the result along with the TransportOperation object
7847
+ # @yieldparam result [::Gapic::Operation]
7848
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7849
+ #
7850
+ # @return [::Gapic::Operation]
7851
+ #
7852
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7853
+ #
7854
+ # @example Basic example
7855
+ # require "google/cloud/oracle_database/v1"
7856
+ #
7857
+ # # Create a client object. The client can be reused for multiple calls.
7858
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7859
+ #
7860
+ # # Create a request. To set request fields, pass in keyword arguments.
7861
+ # request = Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest.new
7862
+ #
7863
+ # # Call the delete_goldengate_connection_assignment method.
7864
+ # result = client.delete_goldengate_connection_assignment request
7865
+ #
7866
+ # # The returned object is of type Gapic::Operation. You can use it to
7867
+ # # check the status of an operation, cancel it, or wait for results.
7868
+ # # Here is how to wait for a response.
7869
+ # result.wait_until_done! timeout: 60
7870
+ # if result.response?
7871
+ # p result.response
7872
+ # else
7873
+ # puts "No response received."
7874
+ # end
7875
+ #
7876
+ def delete_goldengate_connection_assignment request, options = nil
7877
+ raise ::ArgumentError, "request must be provided" if request.nil?
7878
+
7879
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest
7880
+
7881
+ # Converts hash and nil to an options object
7882
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7883
+
7884
+ # Customize the options with defaults
7885
+ call_metadata = @config.rpcs.delete_goldengate_connection_assignment.metadata.to_h
7886
+
7887
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7888
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7889
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7890
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7891
+ transports_version_send: [:rest]
7892
+
7893
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7894
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7895
+
7896
+ options.apply_defaults timeout: @config.rpcs.delete_goldengate_connection_assignment.timeout,
7897
+ metadata: call_metadata,
7898
+ retry_policy: @config.rpcs.delete_goldengate_connection_assignment.retry_policy
7899
+
7900
+ options.apply_defaults timeout: @config.timeout,
7901
+ metadata: @config.metadata,
7902
+ retry_policy: @config.retry_policy
7903
+
7904
+ @oracle_database_stub.delete_goldengate_connection_assignment request, options do |result, operation|
7905
+ result = ::Gapic::Operation.new result, @operations_client, options: options
7906
+ yield result, operation if block_given?
7907
+ throw :response, result
7908
+ end
7909
+ rescue ::Gapic::Rest::Error => e
7910
+ raise ::Google::Cloud::Error.from_error(e)
7911
+ end
7912
+
7913
+ ##
7914
+ # Tests a single GoldengateConnectionAssignment.
7915
+ #
7916
+ # @overload test_goldengate_connection_assignment(request, options = nil)
7917
+ # Pass arguments to `test_goldengate_connection_assignment` via a request object, either of type
7918
+ # {::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7919
+ #
7920
+ # @param request [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest, ::Hash]
7921
+ # A request object representing the call parameters. Required. To specify no
7922
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7923
+ # @param options [::Gapic::CallOptions, ::Hash]
7924
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7925
+ #
7926
+ # @overload test_goldengate_connection_assignment(name: nil, type: nil)
7927
+ # Pass arguments to `test_goldengate_connection_assignment` via keyword arguments. Note that at
7928
+ # least one keyword argument is required. To specify no parameters, or to keep all
7929
+ # the default parameter values, pass an empty Hash as a request object (see above).
7930
+ #
7931
+ # @param name [::String]
7932
+ # Required. Name of the connection assignment for which to test connection.
7933
+ # projects/\\{project}/locations/\\{region}/goldengateConnectionAssignments/\\{goldengate_connection_assignment}
7934
+ # @param type [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest::TestType]
7935
+ # Optional. The type of the test of the assigned connection.
7936
+ # The only type actually supported is DEFAULT.
7937
+ # @yield [result, operation] Access the result along with the TransportOperation object
7938
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentResponse]
7939
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7940
+ #
7941
+ # @return [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentResponse]
7942
+ #
7943
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7944
+ #
7945
+ # @example Basic example
7946
+ # require "google/cloud/oracle_database/v1"
7947
+ #
7948
+ # # Create a client object. The client can be reused for multiple calls.
7949
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7950
+ #
7951
+ # # Create a request. To set request fields, pass in keyword arguments.
7952
+ # request = Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest.new
7953
+ #
7954
+ # # Call the test_goldengate_connection_assignment method.
7955
+ # result = client.test_goldengate_connection_assignment request
7956
+ #
7957
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentResponse.
7958
+ # p result
7959
+ #
7960
+ def test_goldengate_connection_assignment request, options = nil
7961
+ raise ::ArgumentError, "request must be provided" if request.nil?
7962
+
7963
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest
7964
+
7965
+ # Converts hash and nil to an options object
7966
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7967
+
7968
+ # Customize the options with defaults
7969
+ call_metadata = @config.rpcs.test_goldengate_connection_assignment.metadata.to_h
7970
+
7971
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7972
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7973
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7974
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7975
+ transports_version_send: [:rest]
7976
+
7977
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7978
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7979
+
7980
+ options.apply_defaults timeout: @config.rpcs.test_goldengate_connection_assignment.timeout,
7981
+ metadata: call_metadata,
7982
+ retry_policy: @config.rpcs.test_goldengate_connection_assignment.retry_policy
7983
+
7984
+ options.apply_defaults timeout: @config.timeout,
7985
+ metadata: @config.metadata,
7986
+ retry_policy: @config.retry_policy
7987
+
7988
+ @oracle_database_stub.test_goldengate_connection_assignment request, options do |result, operation|
7989
+ yield result, operation if block_given?
7990
+ end
7991
+ rescue ::Gapic::Rest::Error => e
7992
+ raise ::Google::Cloud::Error.from_error(e)
7993
+ end
7994
+
7995
+ ##
7996
+ # Configuration class for the OracleDatabase REST API.
7997
+ #
7998
+ # This class represents the configuration for OracleDatabase REST,
7999
+ # providing control over timeouts, retry behavior, logging, transport
8000
+ # parameters, and other low-level controls. Certain parameters can also be
8001
+ # applied individually to specific RPCs. See
8002
+ # {::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client::Configuration::Rpcs}
8003
+ # for a list of RPCs that can be configured independently.
8004
+ #
8005
+ # Configuration can be applied globally to all clients, or to a single client
8006
+ # on construction.
8007
+ #
8008
+ # @example
8009
+ #
8010
+ # # Modify the global config, setting the timeout for
8011
+ # # list_cloud_exadata_infrastructures to 20 seconds,
8012
+ # # and all remaining timeouts to 10 seconds.
8013
+ # ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.configure do |config|
8014
+ # config.timeout = 10.0
8015
+ # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
8016
+ # end
8017
+ #
8018
+ # # Apply the above configuration only to a new client.
8019
+ # client = ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new do |config|
8020
+ # config.timeout = 10.0
8021
+ # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
8022
+ # end
8023
+ #
8024
+ # @!attribute [rw] endpoint
8025
+ # A custom service endpoint, as a hostname or hostname:port. The default is
8026
+ # nil, indicating to use the default endpoint in the current universe domain.
8027
+ # @return [::String,nil]
8028
+ # @!attribute [rw] credentials
8029
+ # Credentials to send with calls. You may provide any of the following types:
8030
+ # * (`String`) The path to a service account key file in JSON format
8031
+ # * (`Hash`) A service account key as a Hash
8032
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
8033
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
8034
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
8035
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
8036
+ # * (`nil`) indicating no credentials
8037
+ #
8038
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
8039
+ # external source for authentication to Google Cloud, you must validate it before
8040
+ # providing it to a Google API client library. Providing an unvalidated credential
8041
+ # configuration to Google APIs can compromise the security of your systems and data.
8042
+ # For more information, refer to [Validate credential configurations from external
8043
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
8044
+ # @return [::Object]
5881
8045
  # @!attribute [rw] scope
5882
8046
  # The OAuth scopes
5883
8047
  # @return [::Array<::String>]
@@ -5898,6 +8062,7 @@ module Google
5898
8062
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
5899
8063
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
5900
8064
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
8065
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
5901
8066
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
5902
8067
  # trigger a retry.
5903
8068
  # @return [::Hash]
@@ -5977,6 +8142,7 @@ module Google
5977
8142
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
5978
8143
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
5979
8144
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
8145
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
5980
8146
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
5981
8147
  # trigger a retry.
5982
8148
  #
@@ -6262,6 +8428,96 @@ module Google
6262
8428
  #
6263
8429
  attr_reader :delete_db_system
6264
8430
  ##
8431
+ # RPC-specific configuration for `list_goldengate_deployments`
8432
+ # @return [::Gapic::Config::Method]
8433
+ #
8434
+ attr_reader :list_goldengate_deployments
8435
+ ##
8436
+ # RPC-specific configuration for `get_goldengate_deployment`
8437
+ # @return [::Gapic::Config::Method]
8438
+ #
8439
+ attr_reader :get_goldengate_deployment
8440
+ ##
8441
+ # RPC-specific configuration for `create_goldengate_deployment`
8442
+ # @return [::Gapic::Config::Method]
8443
+ #
8444
+ attr_reader :create_goldengate_deployment
8445
+ ##
8446
+ # RPC-specific configuration for `delete_goldengate_deployment`
8447
+ # @return [::Gapic::Config::Method]
8448
+ #
8449
+ attr_reader :delete_goldengate_deployment
8450
+ ##
8451
+ # RPC-specific configuration for `stop_goldengate_deployment`
8452
+ # @return [::Gapic::Config::Method]
8453
+ #
8454
+ attr_reader :stop_goldengate_deployment
8455
+ ##
8456
+ # RPC-specific configuration for `start_goldengate_deployment`
8457
+ # @return [::Gapic::Config::Method]
8458
+ #
8459
+ attr_reader :start_goldengate_deployment
8460
+ ##
8461
+ # RPC-specific configuration for `list_goldengate_connections`
8462
+ # @return [::Gapic::Config::Method]
8463
+ #
8464
+ attr_reader :list_goldengate_connections
8465
+ ##
8466
+ # RPC-specific configuration for `get_goldengate_connection`
8467
+ # @return [::Gapic::Config::Method]
8468
+ #
8469
+ attr_reader :get_goldengate_connection
8470
+ ##
8471
+ # RPC-specific configuration for `create_goldengate_connection`
8472
+ # @return [::Gapic::Config::Method]
8473
+ #
8474
+ attr_reader :create_goldengate_connection
8475
+ ##
8476
+ # RPC-specific configuration for `delete_goldengate_connection`
8477
+ # @return [::Gapic::Config::Method]
8478
+ #
8479
+ attr_reader :delete_goldengate_connection
8480
+ ##
8481
+ # RPC-specific configuration for `get_goldengate_deployment_version`
8482
+ # @return [::Gapic::Config::Method]
8483
+ #
8484
+ attr_reader :get_goldengate_deployment_version
8485
+ ##
8486
+ # RPC-specific configuration for `list_goldengate_deployment_versions`
8487
+ # @return [::Gapic::Config::Method]
8488
+ #
8489
+ attr_reader :list_goldengate_deployment_versions
8490
+ ##
8491
+ # RPC-specific configuration for `get_goldengate_deployment_type`
8492
+ # @return [::Gapic::Config::Method]
8493
+ #
8494
+ attr_reader :get_goldengate_deployment_type
8495
+ ##
8496
+ # RPC-specific configuration for `list_goldengate_deployment_types`
8497
+ # @return [::Gapic::Config::Method]
8498
+ #
8499
+ attr_reader :list_goldengate_deployment_types
8500
+ ##
8501
+ # RPC-specific configuration for `get_goldengate_deployment_environment`
8502
+ # @return [::Gapic::Config::Method]
8503
+ #
8504
+ attr_reader :get_goldengate_deployment_environment
8505
+ ##
8506
+ # RPC-specific configuration for `list_goldengate_deployment_environments`
8507
+ # @return [::Gapic::Config::Method]
8508
+ #
8509
+ attr_reader :list_goldengate_deployment_environments
8510
+ ##
8511
+ # RPC-specific configuration for `get_goldengate_connection_type`
8512
+ # @return [::Gapic::Config::Method]
8513
+ #
8514
+ attr_reader :get_goldengate_connection_type
8515
+ ##
8516
+ # RPC-specific configuration for `list_goldengate_connection_types`
8517
+ # @return [::Gapic::Config::Method]
8518
+ #
8519
+ attr_reader :list_goldengate_connection_types
8520
+ ##
6265
8521
  # RPC-specific configuration for `list_db_versions`
6266
8522
  # @return [::Gapic::Config::Method]
6267
8523
  #
@@ -6271,6 +8527,31 @@ module Google
6271
8527
  # @return [::Gapic::Config::Method]
6272
8528
  #
6273
8529
  attr_reader :list_database_character_sets
8530
+ ##
8531
+ # RPC-specific configuration for `list_goldengate_connection_assignments`
8532
+ # @return [::Gapic::Config::Method]
8533
+ #
8534
+ attr_reader :list_goldengate_connection_assignments
8535
+ ##
8536
+ # RPC-specific configuration for `get_goldengate_connection_assignment`
8537
+ # @return [::Gapic::Config::Method]
8538
+ #
8539
+ attr_reader :get_goldengate_connection_assignment
8540
+ ##
8541
+ # RPC-specific configuration for `create_goldengate_connection_assignment`
8542
+ # @return [::Gapic::Config::Method]
8543
+ #
8544
+ attr_reader :create_goldengate_connection_assignment
8545
+ ##
8546
+ # RPC-specific configuration for `delete_goldengate_connection_assignment`
8547
+ # @return [::Gapic::Config::Method]
8548
+ #
8549
+ attr_reader :delete_goldengate_connection_assignment
8550
+ ##
8551
+ # RPC-specific configuration for `test_goldengate_connection_assignment`
8552
+ # @return [::Gapic::Config::Method]
8553
+ #
8554
+ attr_reader :test_goldengate_connection_assignment
6274
8555
 
6275
8556
  # @private
6276
8557
  def initialize parent_rpcs = nil
@@ -6386,10 +8667,56 @@ module Google
6386
8667
  @create_db_system = ::Gapic::Config::Method.new create_db_system_config
6387
8668
  delete_db_system_config = parent_rpcs.delete_db_system if parent_rpcs.respond_to? :delete_db_system
6388
8669
  @delete_db_system = ::Gapic::Config::Method.new delete_db_system_config
8670
+ list_goldengate_deployments_config = parent_rpcs.list_goldengate_deployments if parent_rpcs.respond_to? :list_goldengate_deployments
8671
+ @list_goldengate_deployments = ::Gapic::Config::Method.new list_goldengate_deployments_config
8672
+ get_goldengate_deployment_config = parent_rpcs.get_goldengate_deployment if parent_rpcs.respond_to? :get_goldengate_deployment
8673
+ @get_goldengate_deployment = ::Gapic::Config::Method.new get_goldengate_deployment_config
8674
+ create_goldengate_deployment_config = parent_rpcs.create_goldengate_deployment if parent_rpcs.respond_to? :create_goldengate_deployment
8675
+ @create_goldengate_deployment = ::Gapic::Config::Method.new create_goldengate_deployment_config
8676
+ delete_goldengate_deployment_config = parent_rpcs.delete_goldengate_deployment if parent_rpcs.respond_to? :delete_goldengate_deployment
8677
+ @delete_goldengate_deployment = ::Gapic::Config::Method.new delete_goldengate_deployment_config
8678
+ stop_goldengate_deployment_config = parent_rpcs.stop_goldengate_deployment if parent_rpcs.respond_to? :stop_goldengate_deployment
8679
+ @stop_goldengate_deployment = ::Gapic::Config::Method.new stop_goldengate_deployment_config
8680
+ start_goldengate_deployment_config = parent_rpcs.start_goldengate_deployment if parent_rpcs.respond_to? :start_goldengate_deployment
8681
+ @start_goldengate_deployment = ::Gapic::Config::Method.new start_goldengate_deployment_config
8682
+ list_goldengate_connections_config = parent_rpcs.list_goldengate_connections if parent_rpcs.respond_to? :list_goldengate_connections
8683
+ @list_goldengate_connections = ::Gapic::Config::Method.new list_goldengate_connections_config
8684
+ get_goldengate_connection_config = parent_rpcs.get_goldengate_connection if parent_rpcs.respond_to? :get_goldengate_connection
8685
+ @get_goldengate_connection = ::Gapic::Config::Method.new get_goldengate_connection_config
8686
+ create_goldengate_connection_config = parent_rpcs.create_goldengate_connection if parent_rpcs.respond_to? :create_goldengate_connection
8687
+ @create_goldengate_connection = ::Gapic::Config::Method.new create_goldengate_connection_config
8688
+ delete_goldengate_connection_config = parent_rpcs.delete_goldengate_connection if parent_rpcs.respond_to? :delete_goldengate_connection
8689
+ @delete_goldengate_connection = ::Gapic::Config::Method.new delete_goldengate_connection_config
8690
+ get_goldengate_deployment_version_config = parent_rpcs.get_goldengate_deployment_version if parent_rpcs.respond_to? :get_goldengate_deployment_version
8691
+ @get_goldengate_deployment_version = ::Gapic::Config::Method.new get_goldengate_deployment_version_config
8692
+ list_goldengate_deployment_versions_config = parent_rpcs.list_goldengate_deployment_versions if parent_rpcs.respond_to? :list_goldengate_deployment_versions
8693
+ @list_goldengate_deployment_versions = ::Gapic::Config::Method.new list_goldengate_deployment_versions_config
8694
+ get_goldengate_deployment_type_config = parent_rpcs.get_goldengate_deployment_type if parent_rpcs.respond_to? :get_goldengate_deployment_type
8695
+ @get_goldengate_deployment_type = ::Gapic::Config::Method.new get_goldengate_deployment_type_config
8696
+ list_goldengate_deployment_types_config = parent_rpcs.list_goldengate_deployment_types if parent_rpcs.respond_to? :list_goldengate_deployment_types
8697
+ @list_goldengate_deployment_types = ::Gapic::Config::Method.new list_goldengate_deployment_types_config
8698
+ get_goldengate_deployment_environment_config = parent_rpcs.get_goldengate_deployment_environment if parent_rpcs.respond_to? :get_goldengate_deployment_environment
8699
+ @get_goldengate_deployment_environment = ::Gapic::Config::Method.new get_goldengate_deployment_environment_config
8700
+ list_goldengate_deployment_environments_config = parent_rpcs.list_goldengate_deployment_environments if parent_rpcs.respond_to? :list_goldengate_deployment_environments
8701
+ @list_goldengate_deployment_environments = ::Gapic::Config::Method.new list_goldengate_deployment_environments_config
8702
+ get_goldengate_connection_type_config = parent_rpcs.get_goldengate_connection_type if parent_rpcs.respond_to? :get_goldengate_connection_type
8703
+ @get_goldengate_connection_type = ::Gapic::Config::Method.new get_goldengate_connection_type_config
8704
+ list_goldengate_connection_types_config = parent_rpcs.list_goldengate_connection_types if parent_rpcs.respond_to? :list_goldengate_connection_types
8705
+ @list_goldengate_connection_types = ::Gapic::Config::Method.new list_goldengate_connection_types_config
6389
8706
  list_db_versions_config = parent_rpcs.list_db_versions if parent_rpcs.respond_to? :list_db_versions
6390
8707
  @list_db_versions = ::Gapic::Config::Method.new list_db_versions_config
6391
8708
  list_database_character_sets_config = parent_rpcs.list_database_character_sets if parent_rpcs.respond_to? :list_database_character_sets
6392
8709
  @list_database_character_sets = ::Gapic::Config::Method.new list_database_character_sets_config
8710
+ list_goldengate_connection_assignments_config = parent_rpcs.list_goldengate_connection_assignments if parent_rpcs.respond_to? :list_goldengate_connection_assignments
8711
+ @list_goldengate_connection_assignments = ::Gapic::Config::Method.new list_goldengate_connection_assignments_config
8712
+ get_goldengate_connection_assignment_config = parent_rpcs.get_goldengate_connection_assignment if parent_rpcs.respond_to? :get_goldengate_connection_assignment
8713
+ @get_goldengate_connection_assignment = ::Gapic::Config::Method.new get_goldengate_connection_assignment_config
8714
+ create_goldengate_connection_assignment_config = parent_rpcs.create_goldengate_connection_assignment if parent_rpcs.respond_to? :create_goldengate_connection_assignment
8715
+ @create_goldengate_connection_assignment = ::Gapic::Config::Method.new create_goldengate_connection_assignment_config
8716
+ delete_goldengate_connection_assignment_config = parent_rpcs.delete_goldengate_connection_assignment if parent_rpcs.respond_to? :delete_goldengate_connection_assignment
8717
+ @delete_goldengate_connection_assignment = ::Gapic::Config::Method.new delete_goldengate_connection_assignment_config
8718
+ test_goldengate_connection_assignment_config = parent_rpcs.test_goldengate_connection_assignment if parent_rpcs.respond_to? :test_goldengate_connection_assignment
8719
+ @test_goldengate_connection_assignment = ::Gapic::Config::Method.new test_goldengate_connection_assignment_config
6393
8720
 
6394
8721
  yield self if block_given?
6395
8722
  end