google-cloud-oracle_database-v1 0.13.0 → 0.15.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 +2298 -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 +76 -0
  6. data/lib/google/cloud/oracle_database/v1/oracle_database/rest/client.rb +2098 -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 +1533 -368
  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 +27 -0
  18. data/lib/google/cloud/oracledatabase/v1/goldengate_deployment_environment_pb.rb +28 -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 +28 -0
  21. data/lib/google/cloud/oracledatabase/v1/goldengate_deployment_version_pb.rb +30 -0
  22. data/lib/google/cloud/oracledatabase/v1/oracledatabase_pb.rb +8 -1
  23. data/lib/google/cloud/oracledatabase/v1/oracledatabase_services_pb.rb +39 -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 +176 -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 +135 -0
  35. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_deployment_type.rb +166 -0
  36. data/proto_docs/google/cloud/oracledatabase/v1/goldengate_deployment_version.rb +164 -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,1766 @@ 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
+ # Lists GoldengateDeploymentVersions in a given project and location.
6622
+ #
6623
+ # @overload list_goldengate_deployment_versions(request, options = nil)
6624
+ # Pass arguments to `list_goldengate_deployment_versions` via a request object, either of type
6625
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest} or an equivalent Hash.
6626
+ #
6627
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest, ::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 list_goldengate_deployment_versions(parent: nil, page_size: nil, page_token: nil, filter: nil)
6634
+ # Pass arguments to `list_goldengate_deployment_versions` 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 parent [::String]
6639
+ # Required. Parent value for ListGoldengateDeploymentVersionsRequest
6640
+ # Format: projects/\\{project}/locations/\\{location}
6641
+ # @param page_size [::Integer]
6642
+ # Optional. Requested page size. Server may return fewer items than
6643
+ # requested. If unspecified, server will pick an appropriate default. The
6644
+ # maximum value is 1000; values above 1000 will be coerced to 1000.
6645
+ # @param page_token [::String]
6646
+ # Optional. A token identifying a page of results the server should return.
6647
+ # @param filter [::String]
6648
+ # Optional. An expression for filtering the results of the request. Either
6649
+ # the deployment_id and deployment_type fields must be specified in the
6650
+ # format: `deployment_id="id"` or `deployment_type="DATABASE_ORACLE"`.
6651
+ # @yield [result, operation] Access the result along with the TransportOperation object
6652
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion>]
6653
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6654
+ #
6655
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion>]
6656
+ #
6657
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6658
+ #
6659
+ # @example Basic example
6660
+ # require "google/cloud/oracle_database/v1"
6661
+ #
6662
+ # # Create a client object. The client can be reused for multiple calls.
6663
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6664
+ #
6665
+ # # Create a request. To set request fields, pass in keyword arguments.
6666
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest.new
6667
+ #
6668
+ # # Call the list_goldengate_deployment_versions method.
6669
+ # result = client.list_goldengate_deployment_versions request
6670
+ #
6671
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
6672
+ # # over elements, and API calls will be issued to fetch pages as needed.
6673
+ # result.each do |item|
6674
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentVersion.
6675
+ # p item
6676
+ # end
6677
+ #
6678
+ def list_goldengate_deployment_versions request, options = nil
6679
+ raise ::ArgumentError, "request must be provided" if request.nil?
6680
+
6681
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentVersionsRequest
6682
+
6683
+ # Converts hash and nil to an options object
6684
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6685
+
6686
+ # Customize the options with defaults
6687
+ call_metadata = @config.rpcs.list_goldengate_deployment_versions.metadata.to_h
6688
+
6689
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6690
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6691
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6692
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6693
+ transports_version_send: [:rest]
6694
+
6695
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6696
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6697
+
6698
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_deployment_versions.timeout,
6699
+ metadata: call_metadata,
6700
+ retry_policy: @config.rpcs.list_goldengate_deployment_versions.retry_policy
6701
+
6702
+ options.apply_defaults timeout: @config.timeout,
6703
+ metadata: @config.metadata,
6704
+ retry_policy: @config.retry_policy
6705
+
6706
+ @oracle_database_stub.list_goldengate_deployment_versions request, options do |result, operation|
6707
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_deployment_versions, "goldengate_deployment_versions", request, result, options
6708
+ yield result, operation if block_given?
6709
+ throw :response, result
6710
+ end
6711
+ rescue ::Gapic::Rest::Error => e
6712
+ raise ::Google::Cloud::Error.from_error(e)
6713
+ end
6714
+
6715
+ ##
6716
+ # Lists GoldenGateDeploymentTypes in a given project and location.
6717
+ #
6718
+ # @overload list_goldengate_deployment_types(request, options = nil)
6719
+ # Pass arguments to `list_goldengate_deployment_types` via a request object, either of type
6720
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest} or an equivalent Hash.
6721
+ #
6722
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest, ::Hash]
6723
+ # A request object representing the call parameters. Required. To specify no
6724
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6725
+ # @param options [::Gapic::CallOptions, ::Hash]
6726
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6727
+ #
6728
+ # @overload list_goldengate_deployment_types(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
6729
+ # Pass arguments to `list_goldengate_deployment_types` via keyword arguments. Note that at
6730
+ # least one keyword argument is required. To specify no parameters, or to keep all
6731
+ # the default parameter values, pass an empty Hash as a request object (see above).
6732
+ #
6733
+ # @param parent [::String]
6734
+ # Required. The parent resource.
6735
+ # Format: projects/\\{project}/locations/\\{location}
6736
+ # @param page_size [::Integer]
6737
+ # Optional. Requested page size. Server may return fewer items than
6738
+ # requested. If unspecified, server will pick an appropriate default.
6739
+ # @param page_token [::String]
6740
+ # Optional. A token identifying a page of results the server should return.
6741
+ # @param filter [::String]
6742
+ # Optional. An expression for filtering the results of the request. Either
6743
+ # the deployment_type and ogg_version fields must be specified in the format:
6744
+ # `deployment_type="DATABASE_ORACLE"` or `ogg_version="version"`.
6745
+ # Allowed values for deployment_type are: `DATABASE_ORACLE`, `BIGDATA`,
6746
+ # `DATABASE_MICROSOFT_SQLSERVER`, `DATABASE_MYSQL`, `DATABASE_POSTGRESQL`,
6747
+ # `DATABASE_DB2ZOS`, `DATABASE_DB2I`, `GGSA`, `DATA_TRANSFORMS`.
6748
+ # @param order_by [::String]
6749
+ # Optional. Hint for how to order the results
6750
+ # @yield [result, operation] Access the result along with the TransportOperation object
6751
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType>]
6752
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6753
+ #
6754
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType>]
6755
+ #
6756
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6757
+ #
6758
+ # @example Basic example
6759
+ # require "google/cloud/oracle_database/v1"
6760
+ #
6761
+ # # Create a client object. The client can be reused for multiple calls.
6762
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6763
+ #
6764
+ # # Create a request. To set request fields, pass in keyword arguments.
6765
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest.new
6766
+ #
6767
+ # # Call the list_goldengate_deployment_types method.
6768
+ # result = client.list_goldengate_deployment_types request
6769
+ #
6770
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
6771
+ # # over elements, and API calls will be issued to fetch pages as needed.
6772
+ # result.each do |item|
6773
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentType.
6774
+ # p item
6775
+ # end
6776
+ #
6777
+ def list_goldengate_deployment_types request, options = nil
6778
+ raise ::ArgumentError, "request must be provided" if request.nil?
6779
+
6780
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentTypesRequest
6781
+
6782
+ # Converts hash and nil to an options object
6783
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6784
+
6785
+ # Customize the options with defaults
6786
+ call_metadata = @config.rpcs.list_goldengate_deployment_types.metadata.to_h
6787
+
6788
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6789
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6790
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6791
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6792
+ transports_version_send: [:rest]
6793
+
6794
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6795
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6796
+
6797
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_deployment_types.timeout,
6798
+ metadata: call_metadata,
6799
+ retry_policy: @config.rpcs.list_goldengate_deployment_types.retry_policy
6800
+
6801
+ options.apply_defaults timeout: @config.timeout,
6802
+ metadata: @config.metadata,
6803
+ retry_policy: @config.retry_policy
6804
+
6805
+ @oracle_database_stub.list_goldengate_deployment_types request, options do |result, operation|
6806
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_deployment_types, "goldengate_deployment_types", request, result, options
6807
+ yield result, operation if block_given?
6808
+ throw :response, result
6809
+ end
6810
+ rescue ::Gapic::Rest::Error => e
6811
+ raise ::Google::Cloud::Error.from_error(e)
6812
+ end
6813
+
6814
+ ##
6815
+ # Lists GoldengateDeploymentEnvironments in a given project and location.
6816
+ #
6817
+ # @overload list_goldengate_deployment_environments(request, options = nil)
6818
+ # Pass arguments to `list_goldengate_deployment_environments` via a request object, either of type
6819
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest} or an equivalent Hash.
6820
+ #
6821
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest, ::Hash]
6822
+ # A request object representing the call parameters. Required. To specify no
6823
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6824
+ # @param options [::Gapic::CallOptions, ::Hash]
6825
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6826
+ #
6827
+ # @overload list_goldengate_deployment_environments(parent: nil, page_size: nil, page_token: nil)
6828
+ # Pass arguments to `list_goldengate_deployment_environments` via keyword arguments. Note that at
6829
+ # least one keyword argument is required. To specify no parameters, or to keep all
6830
+ # the default parameter values, pass an empty Hash as a request object (see above).
6831
+ #
6832
+ # @param parent [::String]
6833
+ # Required. The parent, which owns this collection of
6834
+ # GoldengateDeploymentEnvironments. Format:
6835
+ # projects/\\{project}/locations/\\{location}
6836
+ # @param page_size [::Integer]
6837
+ # Optional. The maximum number of items to return.
6838
+ # If unspecified, at most 50 deployment environments will be returned.
6839
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
6840
+ # @param page_token [::String]
6841
+ # Optional. A token identifying a page of results the server should return.
6842
+ # @yield [result, operation] Access the result along with the TransportOperation object
6843
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment>]
6844
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6845
+ #
6846
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment>]
6847
+ #
6848
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6849
+ #
6850
+ # @example Basic example
6851
+ # require "google/cloud/oracle_database/v1"
6852
+ #
6853
+ # # Create a client object. The client can be reused for multiple calls.
6854
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6855
+ #
6856
+ # # Create a request. To set request fields, pass in keyword arguments.
6857
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest.new
6858
+ #
6859
+ # # Call the list_goldengate_deployment_environments method.
6860
+ # result = client.list_goldengate_deployment_environments request
6861
+ #
6862
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
6863
+ # # over elements, and API calls will be issued to fetch pages as needed.
6864
+ # result.each do |item|
6865
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateDeploymentEnvironment.
6866
+ # p item
6867
+ # end
6868
+ #
6869
+ def list_goldengate_deployment_environments request, options = nil
6870
+ raise ::ArgumentError, "request must be provided" if request.nil?
6871
+
6872
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateDeploymentEnvironmentsRequest
6873
+
6874
+ # Converts hash and nil to an options object
6875
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6876
+
6877
+ # Customize the options with defaults
6878
+ call_metadata = @config.rpcs.list_goldengate_deployment_environments.metadata.to_h
6879
+
6880
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6881
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6882
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6883
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6884
+ transports_version_send: [:rest]
6885
+
6886
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6887
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6888
+
6889
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_deployment_environments.timeout,
6890
+ metadata: call_metadata,
6891
+ retry_policy: @config.rpcs.list_goldengate_deployment_environments.retry_policy
6892
+
6893
+ options.apply_defaults timeout: @config.timeout,
6894
+ metadata: @config.metadata,
6895
+ retry_policy: @config.retry_policy
6896
+
6897
+ @oracle_database_stub.list_goldengate_deployment_environments request, options do |result, operation|
6898
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_deployment_environments, "goldengate_deployment_environments", request, result, options
6899
+ yield result, operation if block_given?
6900
+ throw :response, result
6901
+ end
6902
+ rescue ::Gapic::Rest::Error => e
6903
+ raise ::Google::Cloud::Error.from_error(e)
6904
+ end
6905
+
6906
+ ##
6907
+ # Lists GoldengateConnectionTypes in a given project and location.
6908
+ #
6909
+ # @overload list_goldengate_connection_types(request, options = nil)
6910
+ # Pass arguments to `list_goldengate_connection_types` via a request object, either of type
6911
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest} or an equivalent Hash.
6912
+ #
6913
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest, ::Hash]
6914
+ # A request object representing the call parameters. Required. To specify no
6915
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
6916
+ # @param options [::Gapic::CallOptions, ::Hash]
6917
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
6918
+ #
6919
+ # @overload list_goldengate_connection_types(parent: nil, page_size: nil, page_token: nil, filter: nil)
6920
+ # Pass arguments to `list_goldengate_connection_types` via keyword arguments. Note that at
6921
+ # least one keyword argument is required. To specify no parameters, or to keep all
6922
+ # the default parameter values, pass an empty Hash as a request object (see above).
6923
+ #
6924
+ # @param parent [::String]
6925
+ # Required. Parent value for ListGoldengateConnectionTypesRequest
6926
+ # Format: projects/\\{project}/locations/\\{location}
6927
+ # @param page_size [::Integer]
6928
+ # Optional. Requested page size. Server may return fewer items than
6929
+ # requested. If unspecified, server will pick an appropriate default.
6930
+ # @param page_token [::String]
6931
+ # Optional. A token identifying a page of results the server should return.
6932
+ # @param filter [::String]
6933
+ # Optional. An expression for filtering the results of the request. The
6934
+ # connection_type field must be specified in the format:
6935
+ # `connection_type="ORACLE"`.
6936
+ # @yield [result, operation] Access the result along with the TransportOperation object
6937
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType>]
6938
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
6939
+ #
6940
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType>]
6941
+ #
6942
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
6943
+ #
6944
+ # @example Basic example
6945
+ # require "google/cloud/oracle_database/v1"
6946
+ #
6947
+ # # Create a client object. The client can be reused for multiple calls.
6948
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
6949
+ #
6950
+ # # Create a request. To set request fields, pass in keyword arguments.
6951
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest.new
6952
+ #
6953
+ # # Call the list_goldengate_connection_types method.
6954
+ # result = client.list_goldengate_connection_types request
6955
+ #
6956
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
6957
+ # # over elements, and API calls will be issued to fetch pages as needed.
6958
+ # result.each do |item|
6959
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateConnectionType.
6960
+ # p item
6961
+ # end
6962
+ #
6963
+ def list_goldengate_connection_types request, options = nil
6964
+ raise ::ArgumentError, "request must be provided" if request.nil?
6965
+
6966
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionTypesRequest
6967
+
6968
+ # Converts hash and nil to an options object
6969
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
6970
+
6971
+ # Customize the options with defaults
6972
+ call_metadata = @config.rpcs.list_goldengate_connection_types.metadata.to_h
6973
+
6974
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
6975
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
6976
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
6977
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
6978
+ transports_version_send: [:rest]
6979
+
6980
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
6981
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
6982
+
6983
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_connection_types.timeout,
6984
+ metadata: call_metadata,
6985
+ retry_policy: @config.rpcs.list_goldengate_connection_types.retry_policy
6986
+
6987
+ options.apply_defaults timeout: @config.timeout,
6988
+ metadata: @config.metadata,
6989
+ retry_policy: @config.retry_policy
6990
+
6991
+ @oracle_database_stub.list_goldengate_connection_types request, options do |result, operation|
6992
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_connection_types, "goldengate_connection_types", request, result, options
6993
+ yield result, operation if block_given?
6994
+ throw :response, result
6995
+ end
6996
+ rescue ::Gapic::Rest::Error => e
6997
+ raise ::Google::Cloud::Error.from_error(e)
6998
+ end
6999
+
7000
+ ##
7001
+ # List DbVersions for the given project and location.
7002
+ #
7003
+ # @overload list_db_versions(request, options = nil)
7004
+ # Pass arguments to `list_db_versions` via a request object, either of type
7005
+ # {::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest} or an equivalent Hash.
7006
+ #
7007
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest, ::Hash]
7008
+ # A request object representing the call parameters. Required. To specify no
7009
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7010
+ # @param options [::Gapic::CallOptions, ::Hash]
7011
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7012
+ #
7013
+ # @overload list_db_versions(parent: nil, page_size: nil, page_token: nil, filter: nil)
7014
+ # Pass arguments to `list_db_versions` via keyword arguments. Note that at
7015
+ # least one keyword argument is required. To specify no parameters, or to keep all
7016
+ # the default parameter values, pass an empty Hash as a request object (see above).
7017
+ #
7018
+ # @param parent [::String]
7019
+ # Required. The parent value for the DbVersion resource with the
7020
+ # format: projects/\\{project}/locations/\\{location}
7021
+ # @param page_size [::Integer]
7022
+ # Optional. The maximum number of items to return.
7023
+ # If unspecified, a maximum of 50 DbVersions will be returned.
7024
+ # The maximum value is 1000; values above 1000 will be reset to 1000.
7025
+ # @param page_token [::String]
7026
+ # Optional. A token identifying the requested page of results to return. All
7027
+ # fields except the filter should remain the same as in the request that
7028
+ # provided this page token.
7029
+ # @param filter [::String]
7030
+ # Optional. Filter expression that matches a subset of the DbVersions to
7031
+ # show. The supported filter for dbSystem creation is `db_system_shape =
7032
+ # \\{db_system_shape} AND storage_management = \\{storage_management}`. If no
7033
+ # filter is provided, all DbVersions will be returned.
7034
+ # @yield [result, operation] Access the result along with the TransportOperation object
7035
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbVersion>]
7036
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7037
+ #
7038
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbVersion>]
7039
+ #
7040
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7041
+ #
7042
+ # @example Basic example
7043
+ # require "google/cloud/oracle_database/v1"
7044
+ #
7045
+ # # Create a client object. The client can be reused for multiple calls.
7046
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7047
+ #
7048
+ # # Create a request. To set request fields, pass in keyword arguments.
7049
+ # request = Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest.new
7050
+ #
7051
+ # # Call the list_db_versions method.
7052
+ # result = client.list_db_versions request
7053
+ #
7054
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7055
+ # # over elements, and API calls will be issued to fetch pages as needed.
7056
+ # result.each do |item|
7057
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DbVersion.
7058
+ # p item
7059
+ # end
7060
+ #
7061
+ def list_db_versions request, options = nil
7062
+ raise ::ArgumentError, "request must be provided" if request.nil?
7063
+
7064
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDbVersionsRequest
7065
+
7066
+ # Converts hash and nil to an options object
7067
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7068
+
7069
+ # Customize the options with defaults
7070
+ call_metadata = @config.rpcs.list_db_versions.metadata.to_h
7071
+
7072
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7073
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7074
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7075
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7076
+ transports_version_send: [:rest]
7077
+
7078
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7079
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7080
+
7081
+ options.apply_defaults timeout: @config.rpcs.list_db_versions.timeout,
7082
+ metadata: call_metadata,
7083
+ retry_policy: @config.rpcs.list_db_versions.retry_policy
7084
+
7085
+ options.apply_defaults timeout: @config.timeout,
7086
+ metadata: @config.metadata,
7087
+ retry_policy: @config.retry_policy
7088
+
7089
+ @oracle_database_stub.list_db_versions request, options do |result, operation|
7090
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_db_versions, "db_versions", request, result, options
7091
+ yield result, operation if block_given?
7092
+ throw :response, result
7093
+ end
7094
+ rescue ::Gapic::Rest::Error => e
7095
+ raise ::Google::Cloud::Error.from_error(e)
7096
+ end
7097
+
7098
+ ##
7099
+ # List DatabaseCharacterSets for the given project and location.
7100
+ #
7101
+ # @overload list_database_character_sets(request, options = nil)
7102
+ # Pass arguments to `list_database_character_sets` via a request object, either of type
7103
+ # {::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest} or an equivalent Hash.
7104
+ #
7105
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest, ::Hash]
7106
+ # A request object representing the call parameters. Required. To specify no
7107
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7108
+ # @param options [::Gapic::CallOptions, ::Hash]
7109
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7110
+ #
7111
+ # @overload list_database_character_sets(parent: nil, page_size: nil, page_token: nil, filter: nil)
7112
+ # Pass arguments to `list_database_character_sets` via keyword arguments. Note that at
7113
+ # least one keyword argument is required. To specify no parameters, or to keep all
7114
+ # the default parameter values, pass an empty Hash as a request object (see above).
7115
+ #
7116
+ # @param parent [::String]
7117
+ # Required. The parent value for DatabaseCharacterSets in the following
7118
+ # format: projects/\\{project}/locations/\\{location}.
7119
+ # @param page_size [::Integer]
7120
+ # Optional. The maximum number of DatabaseCharacterSets to return. The
7121
+ # service may return fewer than this value. If unspecified, at most 50
7122
+ # DatabaseCharacterSets will be returned. The maximum value is 1000; values
7123
+ # above 1000 will be coerced to 1000.
7124
+ # @param page_token [::String]
7125
+ # Optional. A page token, received from a previous
7126
+ # `ListDatabaseCharacterSets` call. Provide this to retrieve the subsequent
7127
+ # page.
7128
+ #
7129
+ # When paginating, all other parameters provided to
7130
+ # `ListDatabaseCharacterSets` must match the call that provided the page
7131
+ # token.
7132
+ # @param filter [::String]
7133
+ # Optional. An expression for filtering the results of the request. Only the
7134
+ # **character_set_type** field is supported in the following format:
7135
+ # `character_set_type="{characterSetType}"`. Accepted values include
7136
+ # `DATABASE` and `NATIONAL`.
7137
+ # @yield [result, operation] Access the result along with the TransportOperation object
7138
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet>]
7139
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7140
+ #
7141
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet>]
7142
+ #
7143
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7144
+ #
7145
+ # @example Basic example
7146
+ # require "google/cloud/oracle_database/v1"
7147
+ #
7148
+ # # Create a client object. The client can be reused for multiple calls.
7149
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7150
+ #
7151
+ # # Create a request. To set request fields, pass in keyword arguments.
7152
+ # request = Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest.new
7153
+ #
7154
+ # # Call the list_database_character_sets method.
7155
+ # result = client.list_database_character_sets request
7156
+ #
7157
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7158
+ # # over elements, and API calls will be issued to fetch pages as needed.
7159
+ # result.each do |item|
7160
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DatabaseCharacterSet.
7161
+ # p item
7162
+ # end
7163
+ #
7164
+ def list_database_character_sets request, options = nil
7165
+ raise ::ArgumentError, "request must be provided" if request.nil?
7166
+
7167
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDatabaseCharacterSetsRequest
7168
+
7169
+ # Converts hash and nil to an options object
7170
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7171
+
7172
+ # Customize the options with defaults
7173
+ call_metadata = @config.rpcs.list_database_character_sets.metadata.to_h
7174
+
7175
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7176
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7177
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7178
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7179
+ transports_version_send: [:rest]
7180
+
7181
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7182
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7183
+
7184
+ options.apply_defaults timeout: @config.rpcs.list_database_character_sets.timeout,
7185
+ metadata: call_metadata,
7186
+ retry_policy: @config.rpcs.list_database_character_sets.retry_policy
7187
+
7188
+ options.apply_defaults timeout: @config.timeout,
7189
+ metadata: @config.metadata,
7190
+ retry_policy: @config.retry_policy
7191
+
7192
+ @oracle_database_stub.list_database_character_sets request, options do |result, operation|
7193
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_database_character_sets, "database_character_sets", request, result, options
7194
+ yield result, operation if block_given?
7195
+ throw :response, result
7196
+ end
7197
+ rescue ::Gapic::Rest::Error => e
7198
+ raise ::Google::Cloud::Error.from_error(e)
7199
+ end
7200
+
7201
+ ##
7202
+ # Lists GoldengateConnectionAssignments in a given project and location.
7203
+ #
7204
+ # @overload list_goldengate_connection_assignments(request, options = nil)
7205
+ # Pass arguments to `list_goldengate_connection_assignments` via a request object, either of type
7206
+ # {::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest} or an equivalent Hash.
7207
+ #
7208
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest, ::Hash]
7209
+ # A request object representing the call parameters. Required. To specify no
7210
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7211
+ # @param options [::Gapic::CallOptions, ::Hash]
7212
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7213
+ #
7214
+ # @overload list_goldengate_connection_assignments(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
7215
+ # Pass arguments to `list_goldengate_connection_assignments` via keyword arguments. Note that at
7216
+ # least one keyword argument is required. To specify no parameters, or to keep all
7217
+ # the default parameter values, pass an empty Hash as a request object (see above).
7218
+ #
7219
+ # @param parent [::String]
7220
+ # Required. The parent value for the GoldengateConnectionAssignments.
7221
+ # Format: projects/\\{project}/locations/\\{location}
7222
+ # @param page_size [::Integer]
7223
+ # Optional. The maximum number of GoldengateConnectionAssignments to return.
7224
+ # The service may return fewer than this value. If unspecified, at most 50
7225
+ # GoldengateConnectionAssignments will be returned. The maximum value is
7226
+ # 1000; values above 1000 will be coerced to 1000.
7227
+ # @param page_token [::String]
7228
+ # Optional. A page token, received from a previous
7229
+ # `ListGoldengateConnectionAssignments` call. Provide this to retrieve the
7230
+ # subsequent page.
7231
+ #
7232
+ # When paginating, all other parameters provided to
7233
+ # `ListGoldengateConnectionAssignments` must match the call that provided
7234
+ # the page token.
7235
+ # @param filter [::String]
7236
+ # Optional. A filter expression that filters GoldengateConnectionAssignments
7237
+ # listed in the response.
7238
+ # @param order_by [::String]
7239
+ # Optional. A comma-separated list of fields to order by, sorted in ascending
7240
+ # order. Use "DESC" after a field name for descending.
7241
+ # @yield [result, operation] Access the result along with the TransportOperation object
7242
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment>]
7243
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7244
+ #
7245
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment>]
7246
+ #
7247
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7248
+ #
7249
+ # @example Basic example
7250
+ # require "google/cloud/oracle_database/v1"
7251
+ #
7252
+ # # Create a client object. The client can be reused for multiple calls.
7253
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7254
+ #
7255
+ # # Create a request. To set request fields, pass in keyword arguments.
7256
+ # request = Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest.new
7257
+ #
7258
+ # # Call the list_goldengate_connection_assignments method.
7259
+ # result = client.list_goldengate_connection_assignments request
7260
+ #
7261
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
7262
+ # # over elements, and API calls will be issued to fetch pages as needed.
7263
+ # result.each do |item|
7264
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment.
7265
+ # p item
7266
+ # end
7267
+ #
7268
+ def list_goldengate_connection_assignments request, options = nil
7269
+ raise ::ArgumentError, "request must be provided" if request.nil?
7270
+
7271
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGoldengateConnectionAssignmentsRequest
7272
+
7273
+ # Converts hash and nil to an options object
7274
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7275
+
7276
+ # Customize the options with defaults
7277
+ call_metadata = @config.rpcs.list_goldengate_connection_assignments.metadata.to_h
7278
+
7279
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7280
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7281
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7282
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7283
+ transports_version_send: [:rest]
7284
+
7285
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7286
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7287
+
7288
+ options.apply_defaults timeout: @config.rpcs.list_goldengate_connection_assignments.timeout,
7289
+ metadata: call_metadata,
7290
+ retry_policy: @config.rpcs.list_goldengate_connection_assignments.retry_policy
7291
+
7292
+ options.apply_defaults timeout: @config.timeout,
7293
+ metadata: @config.metadata,
7294
+ retry_policy: @config.retry_policy
7295
+
7296
+ @oracle_database_stub.list_goldengate_connection_assignments request, options do |result, operation|
7297
+ result = ::Gapic::Rest::PagedEnumerable.new @oracle_database_stub, :list_goldengate_connection_assignments, "goldengate_connection_assignments", request, result, options
7298
+ yield result, operation if block_given?
7299
+ throw :response, result
7300
+ end
7301
+ rescue ::Gapic::Rest::Error => e
7302
+ raise ::Google::Cloud::Error.from_error(e)
7303
+ end
7304
+
7305
+ ##
7306
+ # Gets details of a single GoldengateConnectionAssignment.
7307
+ #
7308
+ # @overload get_goldengate_connection_assignment(request, options = nil)
7309
+ # Pass arguments to `get_goldengate_connection_assignment` via a request object, either of type
7310
+ # {::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7311
+ #
7312
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest, ::Hash]
7313
+ # A request object representing the call parameters. Required. To specify no
7314
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7315
+ # @param options [::Gapic::CallOptions, ::Hash]
7316
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7317
+ #
7318
+ # @overload get_goldengate_connection_assignment(name: nil)
7319
+ # Pass arguments to `get_goldengate_connection_assignment` via keyword arguments. Note that at
7320
+ # least one keyword argument is required. To specify no parameters, or to keep all
7321
+ # the default parameter values, pass an empty Hash as a request object (see above).
7322
+ #
7323
+ # @param name [::String]
7324
+ # Required. The name of the GoldengateConnectionAssignment to retrieve.
7325
+ # Format:
7326
+ # projects/\\{project}/locations/\\{location}/goldengateConnectionAssignments/\\{goldengate_connection_assignment}
7327
+ # @yield [result, operation] Access the result along with the TransportOperation object
7328
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment]
7329
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7330
+ #
7331
+ # @return [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment]
7332
+ #
7333
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7334
+ #
7335
+ # @example Basic example
7336
+ # require "google/cloud/oracle_database/v1"
7337
+ #
7338
+ # # Create a client object. The client can be reused for multiple calls.
7339
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7340
+ #
7341
+ # # Create a request. To set request fields, pass in keyword arguments.
7342
+ # request = Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest.new
7343
+ #
7344
+ # # Call the get_goldengate_connection_assignment method.
7345
+ # result = client.get_goldengate_connection_assignment request
7346
+ #
7347
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment.
7348
+ # p result
7349
+ #
7350
+ def get_goldengate_connection_assignment request, options = nil
7351
+ raise ::ArgumentError, "request must be provided" if request.nil?
7352
+
7353
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetGoldengateConnectionAssignmentRequest
7354
+
7355
+ # Converts hash and nil to an options object
7356
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7357
+
7358
+ # Customize the options with defaults
7359
+ call_metadata = @config.rpcs.get_goldengate_connection_assignment.metadata.to_h
7360
+
7361
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7362
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7363
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7364
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7365
+ transports_version_send: [:rest]
7366
+
7367
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7368
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7369
+
7370
+ options.apply_defaults timeout: @config.rpcs.get_goldengate_connection_assignment.timeout,
7371
+ metadata: call_metadata,
7372
+ retry_policy: @config.rpcs.get_goldengate_connection_assignment.retry_policy
7373
+
7374
+ options.apply_defaults timeout: @config.timeout,
7375
+ metadata: @config.metadata,
7376
+ retry_policy: @config.retry_policy
7377
+
7378
+ @oracle_database_stub.get_goldengate_connection_assignment request, options do |result, operation|
7379
+ yield result, operation if block_given?
7380
+ end
7381
+ rescue ::Gapic::Rest::Error => e
7382
+ raise ::Google::Cloud::Error.from_error(e)
7383
+ end
7384
+
7385
+ ##
7386
+ # Creates a new GoldengateConnectionAssignment in a given project and
7387
+ # location.
7388
+ #
7389
+ # @overload create_goldengate_connection_assignment(request, options = nil)
7390
+ # Pass arguments to `create_goldengate_connection_assignment` via a request object, either of type
7391
+ # {::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7392
+ #
7393
+ # @param request [::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest, ::Hash]
7394
+ # A request object representing the call parameters. Required. To specify no
7395
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7396
+ # @param options [::Gapic::CallOptions, ::Hash]
7397
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7398
+ #
7399
+ # @overload create_goldengate_connection_assignment(parent: nil, goldengate_connection_assignment_id: nil, goldengate_connection_assignment: nil, request_id: nil)
7400
+ # Pass arguments to `create_goldengate_connection_assignment` via keyword arguments. Note that at
7401
+ # least one keyword argument is required. To specify no parameters, or to keep all
7402
+ # the default parameter values, pass an empty Hash as a request object (see above).
7403
+ #
7404
+ # @param parent [::String]
7405
+ # Required. The parent resource where this GoldengateConnectionAssignment
7406
+ # will be created. Format: projects/\\{project}/locations/\\{location}
7407
+ # @param goldengate_connection_assignment_id [::String]
7408
+ # Required. The ID of the GoldengateConnectionAssignment to create.
7409
+ # @param goldengate_connection_assignment [::Google::Cloud::OracleDatabase::V1::GoldengateConnectionAssignment, ::Hash]
7410
+ # Required. The GoldengateConnectionAssignment to create.
7411
+ # @param request_id [::String]
7412
+ # Optional. An optional request ID to identify requests. Specify a unique
7413
+ # request ID so that if you must retry your request, the server will know to
7414
+ # ignore the request if it has already been completed. The server will
7415
+ # guarantee that for at least 60 minutes since the first request.
7416
+ #
7417
+ # For example, consider a situation where you make an initial request and the
7418
+ # request times out. If you make the request again with the same request
7419
+ # ID, the server can check if original operation with the same request ID
7420
+ # was received, and if so, will ignore the second request. This prevents
7421
+ # clients from accidentally creating duplicate commitments.
7422
+ #
7423
+ # The request ID must be a valid UUID with the exception that zero UUID is
7424
+ # not supported (00000000-0000-0000-0000-000000000000).
7425
+ # @yield [result, operation] Access the result along with the TransportOperation object
7426
+ # @yieldparam result [::Gapic::Operation]
7427
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7428
+ #
7429
+ # @return [::Gapic::Operation]
7430
+ #
7431
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7432
+ #
7433
+ # @example Basic example
7434
+ # require "google/cloud/oracle_database/v1"
7435
+ #
7436
+ # # Create a client object. The client can be reused for multiple calls.
7437
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7438
+ #
7439
+ # # Create a request. To set request fields, pass in keyword arguments.
7440
+ # request = Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest.new
7441
+ #
7442
+ # # Call the create_goldengate_connection_assignment method.
7443
+ # result = client.create_goldengate_connection_assignment request
7444
+ #
7445
+ # # The returned object is of type Gapic::Operation. You can use it to
7446
+ # # check the status of an operation, cancel it, or wait for results.
7447
+ # # Here is how to wait for a response.
7448
+ # result.wait_until_done! timeout: 60
7449
+ # if result.response?
7450
+ # p result.response
7451
+ # else
7452
+ # puts "No response received."
7453
+ # end
7454
+ #
7455
+ def create_goldengate_connection_assignment request, options = nil
7456
+ raise ::ArgumentError, "request must be provided" if request.nil?
7457
+
7458
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::CreateGoldengateConnectionAssignmentRequest
7459
+
7460
+ # Converts hash and nil to an options object
7461
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7462
+
7463
+ # Customize the options with defaults
7464
+ call_metadata = @config.rpcs.create_goldengate_connection_assignment.metadata.to_h
7465
+
7466
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7467
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7468
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7469
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7470
+ transports_version_send: [:rest]
7471
+
7472
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7473
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7474
+
7475
+ options.apply_defaults timeout: @config.rpcs.create_goldengate_connection_assignment.timeout,
7476
+ metadata: call_metadata,
7477
+ retry_policy: @config.rpcs.create_goldengate_connection_assignment.retry_policy
7478
+
7479
+ options.apply_defaults timeout: @config.timeout,
7480
+ metadata: @config.metadata,
7481
+ retry_policy: @config.retry_policy
7482
+
7483
+ @oracle_database_stub.create_goldengate_connection_assignment request, options do |result, operation|
7484
+ result = ::Gapic::Operation.new result, @operations_client, options: options
7485
+ yield result, operation if block_given?
7486
+ throw :response, result
7487
+ end
7488
+ rescue ::Gapic::Rest::Error => e
7489
+ raise ::Google::Cloud::Error.from_error(e)
7490
+ end
7491
+
7492
+ ##
7493
+ # Deletes a single GoldengateConnectionAssignment.
7494
+ #
7495
+ # @overload delete_goldengate_connection_assignment(request, options = nil)
7496
+ # Pass arguments to `delete_goldengate_connection_assignment` via a request object, either of type
7497
+ # {::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7498
+ #
7499
+ # @param request [::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest, ::Hash]
7500
+ # A request object representing the call parameters. Required. To specify no
7501
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7502
+ # @param options [::Gapic::CallOptions, ::Hash]
7503
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7504
+ #
7505
+ # @overload delete_goldengate_connection_assignment(name: nil, request_id: nil)
7506
+ # Pass arguments to `delete_goldengate_connection_assignment` via keyword arguments. Note that at
7507
+ # least one keyword argument is required. To specify no parameters, or to keep all
7508
+ # the default parameter values, pass an empty Hash as a request object (see above).
7509
+ #
7510
+ # @param name [::String]
7511
+ # Required. The name of the GoldengateConnectionAssignment to delete.
7512
+ # Format:
7513
+ # projects/\\{project}/locations/\\{location}/goldengateConnectionAssignments/\\{goldengate_connection_assignment}
7514
+ # @param request_id [::String]
7515
+ # Optional. An optional request ID to identify requests. Specify a unique
7516
+ # request ID so that if you must retry your request, the server will know to
7517
+ # ignore the request if it has already been completed. The server will
7518
+ # guarantee that for at least 60 minutes after the first request.
7519
+ #
7520
+ # For example, consider a situation where you make an initial request and the
7521
+ # request times out. If you make the request again with the same request
7522
+ # ID, the server can check if original operation with the same request ID
7523
+ # was received, and if so, will ignore the second request. This prevents
7524
+ # clients from accidentally creating duplicate commitments.
7525
+ #
7526
+ # The request ID must be a valid UUID with the exception that zero UUID is
7527
+ # not supported (00000000-0000-0000-0000-000000000000).
7528
+ # @yield [result, operation] Access the result along with the TransportOperation object
7529
+ # @yieldparam result [::Gapic::Operation]
7530
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7531
+ #
7532
+ # @return [::Gapic::Operation]
7533
+ #
7534
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7535
+ #
7536
+ # @example Basic example
7537
+ # require "google/cloud/oracle_database/v1"
7538
+ #
7539
+ # # Create a client object. The client can be reused for multiple calls.
7540
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7541
+ #
7542
+ # # Create a request. To set request fields, pass in keyword arguments.
7543
+ # request = Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest.new
7544
+ #
7545
+ # # Call the delete_goldengate_connection_assignment method.
7546
+ # result = client.delete_goldengate_connection_assignment request
7547
+ #
7548
+ # # The returned object is of type Gapic::Operation. You can use it to
7549
+ # # check the status of an operation, cancel it, or wait for results.
7550
+ # # Here is how to wait for a response.
7551
+ # result.wait_until_done! timeout: 60
7552
+ # if result.response?
7553
+ # p result.response
7554
+ # else
7555
+ # puts "No response received."
7556
+ # end
7557
+ #
7558
+ def delete_goldengate_connection_assignment request, options = nil
7559
+ raise ::ArgumentError, "request must be provided" if request.nil?
7560
+
7561
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::DeleteGoldengateConnectionAssignmentRequest
7562
+
7563
+ # Converts hash and nil to an options object
7564
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7565
+
7566
+ # Customize the options with defaults
7567
+ call_metadata = @config.rpcs.delete_goldengate_connection_assignment.metadata.to_h
7568
+
7569
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7570
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7571
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7572
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7573
+ transports_version_send: [:rest]
7574
+
7575
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7576
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7577
+
7578
+ options.apply_defaults timeout: @config.rpcs.delete_goldengate_connection_assignment.timeout,
7579
+ metadata: call_metadata,
7580
+ retry_policy: @config.rpcs.delete_goldengate_connection_assignment.retry_policy
7581
+
7582
+ options.apply_defaults timeout: @config.timeout,
7583
+ metadata: @config.metadata,
7584
+ retry_policy: @config.retry_policy
7585
+
7586
+ @oracle_database_stub.delete_goldengate_connection_assignment request, options do |result, operation|
7587
+ result = ::Gapic::Operation.new result, @operations_client, options: options
7588
+ yield result, operation if block_given?
7589
+ throw :response, result
7590
+ end
7591
+ rescue ::Gapic::Rest::Error => e
7592
+ raise ::Google::Cloud::Error.from_error(e)
7593
+ end
7594
+
7595
+ ##
7596
+ # Tests a single GoldengateConnectionAssignment.
7597
+ #
7598
+ # @overload test_goldengate_connection_assignment(request, options = nil)
7599
+ # Pass arguments to `test_goldengate_connection_assignment` via a request object, either of type
7600
+ # {::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest} or an equivalent Hash.
7601
+ #
7602
+ # @param request [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest, ::Hash]
7603
+ # A request object representing the call parameters. Required. To specify no
7604
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
7605
+ # @param options [::Gapic::CallOptions, ::Hash]
7606
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
7607
+ #
7608
+ # @overload test_goldengate_connection_assignment(name: nil, type: nil)
7609
+ # Pass arguments to `test_goldengate_connection_assignment` via keyword arguments. Note that at
7610
+ # least one keyword argument is required. To specify no parameters, or to keep all
7611
+ # the default parameter values, pass an empty Hash as a request object (see above).
7612
+ #
7613
+ # @param name [::String]
7614
+ # Required. Name of the connection assignment for which to test connection.
7615
+ # projects/\\{project}/locations/\\{region}/goldengateConnectionAssignments/\\{goldengate_connection_assignment}
7616
+ # @param type [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest::TestType]
7617
+ # Optional. The type of the test of the assigned connection.
7618
+ # The only type actually supported is DEFAULT.
7619
+ # @yield [result, operation] Access the result along with the TransportOperation object
7620
+ # @yieldparam result [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentResponse]
7621
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
7622
+ #
7623
+ # @return [::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentResponse]
7624
+ #
7625
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
7626
+ #
7627
+ # @example Basic example
7628
+ # require "google/cloud/oracle_database/v1"
7629
+ #
7630
+ # # Create a client object. The client can be reused for multiple calls.
7631
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new
7632
+ #
7633
+ # # Create a request. To set request fields, pass in keyword arguments.
7634
+ # request = Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest.new
7635
+ #
7636
+ # # Call the test_goldengate_connection_assignment method.
7637
+ # result = client.test_goldengate_connection_assignment request
7638
+ #
7639
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentResponse.
7640
+ # p result
7641
+ #
7642
+ def test_goldengate_connection_assignment request, options = nil
7643
+ raise ::ArgumentError, "request must be provided" if request.nil?
7644
+
7645
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::TestGoldengateConnectionAssignmentRequest
7646
+
7647
+ # Converts hash and nil to an options object
7648
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
7649
+
7650
+ # Customize the options with defaults
7651
+ call_metadata = @config.rpcs.test_goldengate_connection_assignment.metadata.to_h
7652
+
7653
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
7654
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
7655
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
7656
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION,
7657
+ transports_version_send: [:rest]
7658
+
7659
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
7660
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
7661
+
7662
+ options.apply_defaults timeout: @config.rpcs.test_goldengate_connection_assignment.timeout,
7663
+ metadata: call_metadata,
7664
+ retry_policy: @config.rpcs.test_goldengate_connection_assignment.retry_policy
7665
+
7666
+ options.apply_defaults timeout: @config.timeout,
7667
+ metadata: @config.metadata,
7668
+ retry_policy: @config.retry_policy
7669
+
7670
+ @oracle_database_stub.test_goldengate_connection_assignment request, options do |result, operation|
7671
+ yield result, operation if block_given?
7672
+ end
7673
+ rescue ::Gapic::Rest::Error => e
7674
+ raise ::Google::Cloud::Error.from_error(e)
7675
+ end
7676
+
7677
+ ##
7678
+ # Configuration class for the OracleDatabase REST API.
7679
+ #
7680
+ # This class represents the configuration for OracleDatabase REST,
7681
+ # providing control over timeouts, retry behavior, logging, transport
7682
+ # parameters, and other low-level controls. Certain parameters can also be
7683
+ # applied individually to specific RPCs. See
7684
+ # {::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client::Configuration::Rpcs}
7685
+ # for a list of RPCs that can be configured independently.
7686
+ #
7687
+ # Configuration can be applied globally to all clients, or to a single client
7688
+ # on construction.
7689
+ #
7690
+ # @example
7691
+ #
7692
+ # # Modify the global config, setting the timeout for
7693
+ # # list_cloud_exadata_infrastructures to 20 seconds,
7694
+ # # and all remaining timeouts to 10 seconds.
7695
+ # ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.configure do |config|
7696
+ # config.timeout = 10.0
7697
+ # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
7698
+ # end
7699
+ #
7700
+ # # Apply the above configuration only to a new client.
7701
+ # client = ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Rest::Client.new do |config|
7702
+ # config.timeout = 10.0
7703
+ # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
7704
+ # end
7705
+ #
7706
+ # @!attribute [rw] endpoint
7707
+ # A custom service endpoint, as a hostname or hostname:port. The default is
7708
+ # nil, indicating to use the default endpoint in the current universe domain.
7709
+ # @return [::String,nil]
7710
+ # @!attribute [rw] credentials
7711
+ # Credentials to send with calls. You may provide any of the following types:
7712
+ # * (`String`) The path to a service account key file in JSON format
7713
+ # * (`Hash`) A service account key as a Hash
7714
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
7715
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
7716
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
7717
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
7718
+ # * (`nil`) indicating no credentials
7719
+ #
7720
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
7721
+ # external source for authentication to Google Cloud, you must validate it before
7722
+ # providing it to a Google API client library. Providing an unvalidated credential
7723
+ # configuration to Google APIs can compromise the security of your systems and data.
7724
+ # For more information, refer to [Validate credential configurations from external
7725
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
7726
+ # @return [::Object]
5881
7727
  # @!attribute [rw] scope
5882
7728
  # The OAuth scopes
5883
7729
  # @return [::Array<::String>]
@@ -5898,6 +7744,7 @@ module Google
5898
7744
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
5899
7745
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
5900
7746
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
7747
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
5901
7748
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
5902
7749
  # trigger a retry.
5903
7750
  # @return [::Hash]
@@ -5977,6 +7824,7 @@ module Google
5977
7824
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
5978
7825
  # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
5979
7826
  # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
7827
+ # * `:jitter` (*type:* `Numeric`) - The jitter in seconds. Default: 1.0.
5980
7828
  # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
5981
7829
  # trigger a retry.
5982
7830
  #
@@ -6262,6 +8110,76 @@ module Google
6262
8110
  #
6263
8111
  attr_reader :delete_db_system
6264
8112
  ##
8113
+ # RPC-specific configuration for `list_goldengate_deployments`
8114
+ # @return [::Gapic::Config::Method]
8115
+ #
8116
+ attr_reader :list_goldengate_deployments
8117
+ ##
8118
+ # RPC-specific configuration for `get_goldengate_deployment`
8119
+ # @return [::Gapic::Config::Method]
8120
+ #
8121
+ attr_reader :get_goldengate_deployment
8122
+ ##
8123
+ # RPC-specific configuration for `create_goldengate_deployment`
8124
+ # @return [::Gapic::Config::Method]
8125
+ #
8126
+ attr_reader :create_goldengate_deployment
8127
+ ##
8128
+ # RPC-specific configuration for `delete_goldengate_deployment`
8129
+ # @return [::Gapic::Config::Method]
8130
+ #
8131
+ attr_reader :delete_goldengate_deployment
8132
+ ##
8133
+ # RPC-specific configuration for `stop_goldengate_deployment`
8134
+ # @return [::Gapic::Config::Method]
8135
+ #
8136
+ attr_reader :stop_goldengate_deployment
8137
+ ##
8138
+ # RPC-specific configuration for `start_goldengate_deployment`
8139
+ # @return [::Gapic::Config::Method]
8140
+ #
8141
+ attr_reader :start_goldengate_deployment
8142
+ ##
8143
+ # RPC-specific configuration for `list_goldengate_connections`
8144
+ # @return [::Gapic::Config::Method]
8145
+ #
8146
+ attr_reader :list_goldengate_connections
8147
+ ##
8148
+ # RPC-specific configuration for `get_goldengate_connection`
8149
+ # @return [::Gapic::Config::Method]
8150
+ #
8151
+ attr_reader :get_goldengate_connection
8152
+ ##
8153
+ # RPC-specific configuration for `create_goldengate_connection`
8154
+ # @return [::Gapic::Config::Method]
8155
+ #
8156
+ attr_reader :create_goldengate_connection
8157
+ ##
8158
+ # RPC-specific configuration for `delete_goldengate_connection`
8159
+ # @return [::Gapic::Config::Method]
8160
+ #
8161
+ attr_reader :delete_goldengate_connection
8162
+ ##
8163
+ # RPC-specific configuration for `list_goldengate_deployment_versions`
8164
+ # @return [::Gapic::Config::Method]
8165
+ #
8166
+ attr_reader :list_goldengate_deployment_versions
8167
+ ##
8168
+ # RPC-specific configuration for `list_goldengate_deployment_types`
8169
+ # @return [::Gapic::Config::Method]
8170
+ #
8171
+ attr_reader :list_goldengate_deployment_types
8172
+ ##
8173
+ # RPC-specific configuration for `list_goldengate_deployment_environments`
8174
+ # @return [::Gapic::Config::Method]
8175
+ #
8176
+ attr_reader :list_goldengate_deployment_environments
8177
+ ##
8178
+ # RPC-specific configuration for `list_goldengate_connection_types`
8179
+ # @return [::Gapic::Config::Method]
8180
+ #
8181
+ attr_reader :list_goldengate_connection_types
8182
+ ##
6265
8183
  # RPC-specific configuration for `list_db_versions`
6266
8184
  # @return [::Gapic::Config::Method]
6267
8185
  #
@@ -6271,6 +8189,31 @@ module Google
6271
8189
  # @return [::Gapic::Config::Method]
6272
8190
  #
6273
8191
  attr_reader :list_database_character_sets
8192
+ ##
8193
+ # RPC-specific configuration for `list_goldengate_connection_assignments`
8194
+ # @return [::Gapic::Config::Method]
8195
+ #
8196
+ attr_reader :list_goldengate_connection_assignments
8197
+ ##
8198
+ # RPC-specific configuration for `get_goldengate_connection_assignment`
8199
+ # @return [::Gapic::Config::Method]
8200
+ #
8201
+ attr_reader :get_goldengate_connection_assignment
8202
+ ##
8203
+ # RPC-specific configuration for `create_goldengate_connection_assignment`
8204
+ # @return [::Gapic::Config::Method]
8205
+ #
8206
+ attr_reader :create_goldengate_connection_assignment
8207
+ ##
8208
+ # RPC-specific configuration for `delete_goldengate_connection_assignment`
8209
+ # @return [::Gapic::Config::Method]
8210
+ #
8211
+ attr_reader :delete_goldengate_connection_assignment
8212
+ ##
8213
+ # RPC-specific configuration for `test_goldengate_connection_assignment`
8214
+ # @return [::Gapic::Config::Method]
8215
+ #
8216
+ attr_reader :test_goldengate_connection_assignment
6274
8217
 
6275
8218
  # @private
6276
8219
  def initialize parent_rpcs = nil
@@ -6386,10 +8329,48 @@ module Google
6386
8329
  @create_db_system = ::Gapic::Config::Method.new create_db_system_config
6387
8330
  delete_db_system_config = parent_rpcs.delete_db_system if parent_rpcs.respond_to? :delete_db_system
6388
8331
  @delete_db_system = ::Gapic::Config::Method.new delete_db_system_config
8332
+ list_goldengate_deployments_config = parent_rpcs.list_goldengate_deployments if parent_rpcs.respond_to? :list_goldengate_deployments
8333
+ @list_goldengate_deployments = ::Gapic::Config::Method.new list_goldengate_deployments_config
8334
+ get_goldengate_deployment_config = parent_rpcs.get_goldengate_deployment if parent_rpcs.respond_to? :get_goldengate_deployment
8335
+ @get_goldengate_deployment = ::Gapic::Config::Method.new get_goldengate_deployment_config
8336
+ create_goldengate_deployment_config = parent_rpcs.create_goldengate_deployment if parent_rpcs.respond_to? :create_goldengate_deployment
8337
+ @create_goldengate_deployment = ::Gapic::Config::Method.new create_goldengate_deployment_config
8338
+ delete_goldengate_deployment_config = parent_rpcs.delete_goldengate_deployment if parent_rpcs.respond_to? :delete_goldengate_deployment
8339
+ @delete_goldengate_deployment = ::Gapic::Config::Method.new delete_goldengate_deployment_config
8340
+ stop_goldengate_deployment_config = parent_rpcs.stop_goldengate_deployment if parent_rpcs.respond_to? :stop_goldengate_deployment
8341
+ @stop_goldengate_deployment = ::Gapic::Config::Method.new stop_goldengate_deployment_config
8342
+ start_goldengate_deployment_config = parent_rpcs.start_goldengate_deployment if parent_rpcs.respond_to? :start_goldengate_deployment
8343
+ @start_goldengate_deployment = ::Gapic::Config::Method.new start_goldengate_deployment_config
8344
+ list_goldengate_connections_config = parent_rpcs.list_goldengate_connections if parent_rpcs.respond_to? :list_goldengate_connections
8345
+ @list_goldengate_connections = ::Gapic::Config::Method.new list_goldengate_connections_config
8346
+ get_goldengate_connection_config = parent_rpcs.get_goldengate_connection if parent_rpcs.respond_to? :get_goldengate_connection
8347
+ @get_goldengate_connection = ::Gapic::Config::Method.new get_goldengate_connection_config
8348
+ create_goldengate_connection_config = parent_rpcs.create_goldengate_connection if parent_rpcs.respond_to? :create_goldengate_connection
8349
+ @create_goldengate_connection = ::Gapic::Config::Method.new create_goldengate_connection_config
8350
+ delete_goldengate_connection_config = parent_rpcs.delete_goldengate_connection if parent_rpcs.respond_to? :delete_goldengate_connection
8351
+ @delete_goldengate_connection = ::Gapic::Config::Method.new delete_goldengate_connection_config
8352
+ list_goldengate_deployment_versions_config = parent_rpcs.list_goldengate_deployment_versions if parent_rpcs.respond_to? :list_goldengate_deployment_versions
8353
+ @list_goldengate_deployment_versions = ::Gapic::Config::Method.new list_goldengate_deployment_versions_config
8354
+ list_goldengate_deployment_types_config = parent_rpcs.list_goldengate_deployment_types if parent_rpcs.respond_to? :list_goldengate_deployment_types
8355
+ @list_goldengate_deployment_types = ::Gapic::Config::Method.new list_goldengate_deployment_types_config
8356
+ list_goldengate_deployment_environments_config = parent_rpcs.list_goldengate_deployment_environments if parent_rpcs.respond_to? :list_goldengate_deployment_environments
8357
+ @list_goldengate_deployment_environments = ::Gapic::Config::Method.new list_goldengate_deployment_environments_config
8358
+ list_goldengate_connection_types_config = parent_rpcs.list_goldengate_connection_types if parent_rpcs.respond_to? :list_goldengate_connection_types
8359
+ @list_goldengate_connection_types = ::Gapic::Config::Method.new list_goldengate_connection_types_config
6389
8360
  list_db_versions_config = parent_rpcs.list_db_versions if parent_rpcs.respond_to? :list_db_versions
6390
8361
  @list_db_versions = ::Gapic::Config::Method.new list_db_versions_config
6391
8362
  list_database_character_sets_config = parent_rpcs.list_database_character_sets if parent_rpcs.respond_to? :list_database_character_sets
6392
8363
  @list_database_character_sets = ::Gapic::Config::Method.new list_database_character_sets_config
8364
+ list_goldengate_connection_assignments_config = parent_rpcs.list_goldengate_connection_assignments if parent_rpcs.respond_to? :list_goldengate_connection_assignments
8365
+ @list_goldengate_connection_assignments = ::Gapic::Config::Method.new list_goldengate_connection_assignments_config
8366
+ get_goldengate_connection_assignment_config = parent_rpcs.get_goldengate_connection_assignment if parent_rpcs.respond_to? :get_goldengate_connection_assignment
8367
+ @get_goldengate_connection_assignment = ::Gapic::Config::Method.new get_goldengate_connection_assignment_config
8368
+ create_goldengate_connection_assignment_config = parent_rpcs.create_goldengate_connection_assignment if parent_rpcs.respond_to? :create_goldengate_connection_assignment
8369
+ @create_goldengate_connection_assignment = ::Gapic::Config::Method.new create_goldengate_connection_assignment_config
8370
+ delete_goldengate_connection_assignment_config = parent_rpcs.delete_goldengate_connection_assignment if parent_rpcs.respond_to? :delete_goldengate_connection_assignment
8371
+ @delete_goldengate_connection_assignment = ::Gapic::Config::Method.new delete_goldengate_connection_assignment_config
8372
+ test_goldengate_connection_assignment_config = parent_rpcs.test_goldengate_connection_assignment if parent_rpcs.respond_to? :test_goldengate_connection_assignment
8373
+ @test_goldengate_connection_assignment = ::Gapic::Config::Method.new test_goldengate_connection_assignment_config
6393
8374
 
6394
8375
  yield self if block_given?
6395
8376
  end