google-cloud-dataproc-v1 0.2.3 → 0.5.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.
- checksums.yaml +4 -4
- data/LICENSE.md +188 -190
- data/README.md +66 -2
- data/lib/google/cloud/dataproc/v1.rb +3 -0
- data/lib/google/cloud/dataproc/v1/autoscaling_policies_services_pb.rb +5 -5
- data/lib/google/cloud/dataproc/v1/autoscaling_policy_service/client.rb +26 -20
- data/lib/google/cloud/dataproc/v1/autoscaling_policy_service/paths.rb +1 -1
- data/lib/google/cloud/dataproc/v1/cluster_controller/client.rb +46 -40
- data/lib/google/cloud/dataproc/v1/cluster_controller/operations.rb +96 -11
- data/lib/google/cloud/dataproc/v1/clusters_pb.rb +14 -0
- data/lib/google/cloud/dataproc/v1/clusters_services_pb.rb +6 -6
- data/lib/google/cloud/dataproc/v1/job_controller/client.rb +51 -45
- data/lib/google/cloud/dataproc/v1/job_controller/operations.rb +96 -11
- data/lib/google/cloud/dataproc/v1/jobs_services_pb.rb +7 -7
- data/lib/google/cloud/dataproc/v1/version.rb +1 -1
- data/lib/google/cloud/dataproc/v1/workflow_template_service/client.rb +40 -34
- data/lib/google/cloud/dataproc/v1/workflow_template_service/operations.rb +96 -11
- data/lib/google/cloud/dataproc/v1/workflow_template_service/paths.rb +1 -1
- data/lib/google/cloud/dataproc/v1/workflow_templates_services_pb.rb +7 -7
- data/proto_docs/google/api/field_behavior.rb +6 -0
- data/proto_docs/google/api/resource.rb +50 -14
- data/proto_docs/google/cloud/dataproc/v1/autoscaling_policies.rb +8 -2
- data/proto_docs/google/cloud/dataproc/v1/clusters.rb +69 -2
- data/proto_docs/google/cloud/dataproc/v1/jobs.rb +14 -13
- data/proto_docs/google/cloud/dataproc/v1/shared.rb +1 -1
- data/proto_docs/google/cloud/dataproc/v1/workflow_templates.rb +9 -3
- data/proto_docs/google/longrunning/operations.rb +17 -3
- data/proto_docs/google/protobuf/any.rb +5 -2
- data/proto_docs/google/protobuf/timestamp.rb +10 -1
- metadata +12 -9
@@ -25,6 +25,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
25
25
|
end
|
26
26
|
add_message "google.cloud.dataproc.v1.ClusterConfig" do
|
27
27
|
optional :config_bucket, :string, 1
|
28
|
+
optional :temp_bucket, :string, 2
|
28
29
|
optional :gce_cluster_config, :message, 8, "google.cloud.dataproc.v1.GceClusterConfig"
|
29
30
|
optional :master_config, :message, 9, "google.cloud.dataproc.v1.InstanceGroupConfig"
|
30
31
|
optional :worker_config, :message, 10, "google.cloud.dataproc.v1.InstanceGroupConfig"
|
@@ -35,6 +36,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
35
36
|
optional :autoscaling_config, :message, 18, "google.cloud.dataproc.v1.AutoscalingConfig"
|
36
37
|
optional :security_config, :message, 16, "google.cloud.dataproc.v1.SecurityConfig"
|
37
38
|
optional :lifecycle_config, :message, 17, "google.cloud.dataproc.v1.LifecycleConfig"
|
39
|
+
optional :endpoint_config, :message, 19, "google.cloud.dataproc.v1.EndpointConfig"
|
40
|
+
end
|
41
|
+
add_message "google.cloud.dataproc.v1.EndpointConfig" do
|
42
|
+
map :http_ports, :string, :string, 1
|
43
|
+
optional :enable_http_port_access, :bool, 2
|
38
44
|
end
|
39
45
|
add_message "google.cloud.dataproc.v1.AutoscalingConfig" do
|
40
46
|
optional :policy_uri, :string, 1
|
@@ -60,10 +66,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
60
66
|
optional :machine_type_uri, :string, 4
|
61
67
|
optional :disk_config, :message, 5, "google.cloud.dataproc.v1.DiskConfig"
|
62
68
|
optional :is_preemptible, :bool, 6
|
69
|
+
optional :preemptibility, :enum, 10, "google.cloud.dataproc.v1.InstanceGroupConfig.Preemptibility"
|
63
70
|
optional :managed_group_config, :message, 7, "google.cloud.dataproc.v1.ManagedGroupConfig"
|
64
71
|
repeated :accelerators, :message, 8, "google.cloud.dataproc.v1.AcceleratorConfig"
|
65
72
|
optional :min_cpu_platform, :string, 9
|
66
73
|
end
|
74
|
+
add_enum "google.cloud.dataproc.v1.InstanceGroupConfig.Preemptibility" do
|
75
|
+
value :PREEMPTIBILITY_UNSPECIFIED, 0
|
76
|
+
value :NON_PREEMPTIBLE, 1
|
77
|
+
value :PREEMPTIBLE, 2
|
78
|
+
end
|
67
79
|
add_message "google.cloud.dataproc.v1.ManagedGroupConfig" do
|
68
80
|
optional :instance_template_name, :string, 1
|
69
81
|
optional :instance_group_manager_name, :string, 2
|
@@ -203,10 +215,12 @@ module Google
|
|
203
215
|
module V1
|
204
216
|
Cluster = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.Cluster").msgclass
|
205
217
|
ClusterConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.ClusterConfig").msgclass
|
218
|
+
EndpointConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.EndpointConfig").msgclass
|
206
219
|
AutoscalingConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.AutoscalingConfig").msgclass
|
207
220
|
EncryptionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.EncryptionConfig").msgclass
|
208
221
|
GceClusterConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.GceClusterConfig").msgclass
|
209
222
|
InstanceGroupConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.InstanceGroupConfig").msgclass
|
223
|
+
InstanceGroupConfig::Preemptibility = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.InstanceGroupConfig.Preemptibility").enummodule
|
210
224
|
ManagedGroupConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.ManagedGroupConfig").msgclass
|
211
225
|
AcceleratorConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.AcceleratorConfig").msgclass
|
212
226
|
DiskConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dataproc.v1.DiskConfig").msgclass
|
@@ -37,19 +37,19 @@ module Google
|
|
37
37
|
# Creates a cluster in a project. The returned
|
38
38
|
# [Operation.metadata][google.longrunning.Operation.metadata] will be
|
39
39
|
# [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
|
40
|
-
rpc :CreateCluster, CreateClusterRequest, Google::Longrunning::Operation
|
40
|
+
rpc :CreateCluster, ::Google::Cloud::Dataproc::V1::CreateClusterRequest, ::Google::Longrunning::Operation
|
41
41
|
# Updates a cluster in a project. The returned
|
42
42
|
# [Operation.metadata][google.longrunning.Operation.metadata] will be
|
43
43
|
# [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
|
44
|
-
rpc :UpdateCluster, UpdateClusterRequest, Google::Longrunning::Operation
|
44
|
+
rpc :UpdateCluster, ::Google::Cloud::Dataproc::V1::UpdateClusterRequest, ::Google::Longrunning::Operation
|
45
45
|
# Deletes a cluster in a project. The returned
|
46
46
|
# [Operation.metadata][google.longrunning.Operation.metadata] will be
|
47
47
|
# [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
|
48
|
-
rpc :DeleteCluster, DeleteClusterRequest, Google::Longrunning::Operation
|
48
|
+
rpc :DeleteCluster, ::Google::Cloud::Dataproc::V1::DeleteClusterRequest, ::Google::Longrunning::Operation
|
49
49
|
# Gets the resource representation for a cluster in a project.
|
50
|
-
rpc :GetCluster, GetClusterRequest, Cluster
|
50
|
+
rpc :GetCluster, ::Google::Cloud::Dataproc::V1::GetClusterRequest, ::Google::Cloud::Dataproc::V1::Cluster
|
51
51
|
# Lists all regions/{region}/clusters in a project alphabetically.
|
52
|
-
rpc :ListClusters, ListClustersRequest, ListClustersResponse
|
52
|
+
rpc :ListClusters, ::Google::Cloud::Dataproc::V1::ListClustersRequest, ::Google::Cloud::Dataproc::V1::ListClustersResponse
|
53
53
|
# Gets cluster diagnostic information. The returned
|
54
54
|
# [Operation.metadata][google.longrunning.Operation.metadata] will be
|
55
55
|
# [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata).
|
@@ -57,7 +57,7 @@ module Google
|
|
57
57
|
# [Operation.response][google.longrunning.Operation.response]
|
58
58
|
# contains
|
59
59
|
# [DiagnoseClusterResults](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#diagnoseclusterresults).
|
60
|
-
rpc :DiagnoseCluster, DiagnoseClusterRequest, Google::Longrunning::Operation
|
60
|
+
rpc :DiagnoseCluster, ::Google::Cloud::Dataproc::V1::DiagnoseClusterRequest, ::Google::Longrunning::Operation
|
61
61
|
end
|
62
62
|
|
63
63
|
Stub = Service.rpc_stub_class
|
@@ -58,7 +58,7 @@ module Google
|
|
58
58
|
parent_config = while namespace.any?
|
59
59
|
parent_name = namespace.join "::"
|
60
60
|
parent_const = const_get parent_name
|
61
|
-
break parent_const.configure if parent_const
|
61
|
+
break parent_const.configure if parent_const.respond_to? :configure
|
62
62
|
namespace.pop
|
63
63
|
end
|
64
64
|
default_config = Client::Configuration.new parent_config
|
@@ -66,57 +66,57 @@ module Google
|
|
66
66
|
default_config.rpcs.submit_job.timeout = 900.0
|
67
67
|
default_config.rpcs.submit_job.retry_policy = {
|
68
68
|
initial_delay: 0.1,
|
69
|
-
|
70
|
-
|
71
|
-
|
69
|
+
max_delay: 60.0,
|
70
|
+
multiplier: 1.3,
|
71
|
+
retry_codes: [14]
|
72
72
|
}
|
73
73
|
|
74
74
|
default_config.rpcs.submit_job_as_operation.timeout = 900.0
|
75
75
|
default_config.rpcs.submit_job_as_operation.retry_policy = {
|
76
76
|
initial_delay: 0.1,
|
77
|
-
|
78
|
-
|
79
|
-
|
77
|
+
max_delay: 60.0,
|
78
|
+
multiplier: 1.3,
|
79
|
+
retry_codes: [14]
|
80
80
|
}
|
81
81
|
|
82
82
|
default_config.rpcs.get_job.timeout = 900.0
|
83
83
|
default_config.rpcs.get_job.retry_policy = {
|
84
84
|
initial_delay: 0.1,
|
85
|
-
|
86
|
-
|
87
|
-
|
85
|
+
max_delay: 60.0,
|
86
|
+
multiplier: 1.3,
|
87
|
+
retry_codes: [4, 13, 14]
|
88
88
|
}
|
89
89
|
|
90
90
|
default_config.rpcs.list_jobs.timeout = 900.0
|
91
91
|
default_config.rpcs.list_jobs.retry_policy = {
|
92
92
|
initial_delay: 0.1,
|
93
|
-
|
94
|
-
|
95
|
-
|
93
|
+
max_delay: 60.0,
|
94
|
+
multiplier: 1.3,
|
95
|
+
retry_codes: [4, 13, 14]
|
96
96
|
}
|
97
97
|
|
98
98
|
default_config.rpcs.update_job.timeout = 900.0
|
99
99
|
default_config.rpcs.update_job.retry_policy = {
|
100
100
|
initial_delay: 0.1,
|
101
|
-
|
102
|
-
|
103
|
-
|
101
|
+
max_delay: 60.0,
|
102
|
+
multiplier: 1.3,
|
103
|
+
retry_codes: [14]
|
104
104
|
}
|
105
105
|
|
106
106
|
default_config.rpcs.cancel_job.timeout = 900.0
|
107
107
|
default_config.rpcs.cancel_job.retry_policy = {
|
108
108
|
initial_delay: 0.1,
|
109
|
-
|
110
|
-
|
111
|
-
|
109
|
+
max_delay: 60.0,
|
110
|
+
multiplier: 1.3,
|
111
|
+
retry_codes: [4, 13, 14]
|
112
112
|
}
|
113
113
|
|
114
114
|
default_config.rpcs.delete_job.timeout = 900.0
|
115
115
|
default_config.rpcs.delete_job.retry_policy = {
|
116
116
|
initial_delay: 0.1,
|
117
|
-
|
118
|
-
|
119
|
-
|
117
|
+
max_delay: 60.0,
|
118
|
+
multiplier: 1.3,
|
119
|
+
retry_codes: [14]
|
120
120
|
}
|
121
121
|
|
122
122
|
default_config
|
@@ -180,7 +180,13 @@ module Google
|
|
180
180
|
|
181
181
|
# Create credentials
|
182
182
|
credentials = @config.credentials
|
183
|
-
|
183
|
+
# Use self-signed JWT if the scope and endpoint are unchanged from default,
|
184
|
+
# but only if the default endpoint does not have a region prefix.
|
185
|
+
enable_self_signed_jwt = @config.scope == Client.configure.scope &&
|
186
|
+
@config.endpoint == Client.configure.endpoint &&
|
187
|
+
!@config.endpoint.split(".").first.include?("-")
|
188
|
+
credentials ||= Credentials.default scope: @config.scope,
|
189
|
+
enable_self_signed_jwt: enable_self_signed_jwt
|
184
190
|
if credentials.is_a?(String) || credentials.is_a?(Hash)
|
185
191
|
credentials = Credentials.new credentials, scope: @config.scope
|
186
192
|
end
|
@@ -275,7 +281,7 @@ module Google
|
|
275
281
|
|
276
282
|
header_params = {
|
277
283
|
"project_id" => request.project_id,
|
278
|
-
"region"
|
284
|
+
"region" => request.region
|
279
285
|
}
|
280
286
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
281
287
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
@@ -359,7 +365,7 @@ module Google
|
|
359
365
|
|
360
366
|
header_params = {
|
361
367
|
"project_id" => request.project_id,
|
362
|
-
"region"
|
368
|
+
"region" => request.region
|
363
369
|
}
|
364
370
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
365
371
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
@@ -432,8 +438,8 @@ module Google
|
|
432
438
|
|
433
439
|
header_params = {
|
434
440
|
"project_id" => request.project_id,
|
435
|
-
"region"
|
436
|
-
"job_id"
|
441
|
+
"region" => request.region,
|
442
|
+
"job_id" => request.job_id
|
437
443
|
}
|
438
444
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
439
445
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
@@ -531,7 +537,7 @@ module Google
|
|
531
537
|
|
532
538
|
header_params = {
|
533
539
|
"project_id" => request.project_id,
|
534
|
-
"region"
|
540
|
+
"region" => request.region
|
535
541
|
}
|
536
542
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
537
543
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
@@ -613,8 +619,8 @@ module Google
|
|
613
619
|
|
614
620
|
header_params = {
|
615
621
|
"project_id" => request.project_id,
|
616
|
-
"region"
|
617
|
-
"job_id"
|
622
|
+
"region" => request.region,
|
623
|
+
"job_id" => request.job_id
|
618
624
|
}
|
619
625
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
620
626
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
@@ -690,8 +696,8 @@ module Google
|
|
690
696
|
|
691
697
|
header_params = {
|
692
698
|
"project_id" => request.project_id,
|
693
|
-
"region"
|
694
|
-
"job_id"
|
699
|
+
"region" => request.region,
|
700
|
+
"job_id" => request.job_id
|
695
701
|
}
|
696
702
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
697
703
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
@@ -764,8 +770,8 @@ module Google
|
|
764
770
|
|
765
771
|
header_params = {
|
766
772
|
"project_id" => request.project_id,
|
767
|
-
"region"
|
768
|
-
"job_id"
|
773
|
+
"region" => request.region,
|
774
|
+
"job_id" => request.job_id
|
769
775
|
}
|
770
776
|
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
771
777
|
metadata[:"x-goog-request-params"] ||= request_params_header
|
@@ -869,14 +875,14 @@ module Google
|
|
869
875
|
|
870
876
|
config_attr :endpoint, "dataproc.googleapis.com", ::String
|
871
877
|
config_attr :credentials, nil do |value|
|
872
|
-
allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
878
|
+
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
873
879
|
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
874
880
|
allowed.any? { |klass| klass === value }
|
875
881
|
end
|
876
882
|
config_attr :scope, nil, ::String, ::Array, nil
|
877
883
|
config_attr :lib_name, nil, ::String, nil
|
878
884
|
config_attr :lib_version, nil, ::String, nil
|
879
|
-
config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
|
885
|
+
config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
|
880
886
|
config_attr :interceptors, nil, ::Array, nil
|
881
887
|
config_attr :timeout, nil, ::Numeric, nil
|
882
888
|
config_attr :metadata, nil, ::Hash, nil
|
@@ -897,7 +903,7 @@ module Google
|
|
897
903
|
def rpcs
|
898
904
|
@rpcs ||= begin
|
899
905
|
parent_rpcs = nil
|
900
|
-
parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config
|
906
|
+
parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
|
901
907
|
Rpcs.new parent_rpcs
|
902
908
|
end
|
903
909
|
end
|
@@ -909,7 +915,7 @@ module Google
|
|
909
915
|
# Each configuration object is of type `Gapic::Config::Method` and includes
|
910
916
|
# the following configuration fields:
|
911
917
|
#
|
912
|
-
# * `timeout` (*type:* `Numeric`) - The call timeout in
|
918
|
+
# * `timeout` (*type:* `Numeric`) - The call timeout in seconds
|
913
919
|
# * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
|
914
920
|
# * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
|
915
921
|
# include the following keys:
|
@@ -958,19 +964,19 @@ module Google
|
|
958
964
|
|
959
965
|
# @private
|
960
966
|
def initialize parent_rpcs = nil
|
961
|
-
submit_job_config = parent_rpcs
|
967
|
+
submit_job_config = parent_rpcs.submit_job if parent_rpcs.respond_to? :submit_job
|
962
968
|
@submit_job = ::Gapic::Config::Method.new submit_job_config
|
963
|
-
submit_job_as_operation_config = parent_rpcs
|
969
|
+
submit_job_as_operation_config = parent_rpcs.submit_job_as_operation if parent_rpcs.respond_to? :submit_job_as_operation
|
964
970
|
@submit_job_as_operation = ::Gapic::Config::Method.new submit_job_as_operation_config
|
965
|
-
get_job_config = parent_rpcs
|
971
|
+
get_job_config = parent_rpcs.get_job if parent_rpcs.respond_to? :get_job
|
966
972
|
@get_job = ::Gapic::Config::Method.new get_job_config
|
967
|
-
list_jobs_config = parent_rpcs
|
973
|
+
list_jobs_config = parent_rpcs.list_jobs if parent_rpcs.respond_to? :list_jobs
|
968
974
|
@list_jobs = ::Gapic::Config::Method.new list_jobs_config
|
969
|
-
update_job_config = parent_rpcs
|
975
|
+
update_job_config = parent_rpcs.update_job if parent_rpcs.respond_to? :update_job
|
970
976
|
@update_job = ::Gapic::Config::Method.new update_job_config
|
971
|
-
cancel_job_config = parent_rpcs
|
977
|
+
cancel_job_config = parent_rpcs.cancel_job if parent_rpcs.respond_to? :cancel_job
|
972
978
|
@cancel_job = ::Gapic::Config::Method.new cancel_job_config
|
973
|
-
delete_job_config = parent_rpcs
|
979
|
+
delete_job_config = parent_rpcs.delete_job if parent_rpcs.respond_to? :delete_job
|
974
980
|
@delete_job = ::Gapic::Config::Method.new delete_job_config
|
975
981
|
|
976
982
|
yield self if block_given?
|
@@ -103,8 +103,13 @@ module Google
|
|
103
103
|
# Lists operations that match the specified filter in the request. If the
|
104
104
|
# server doesn't support this method, it returns `UNIMPLEMENTED`.
|
105
105
|
#
|
106
|
-
# NOTE: the `name` binding
|
107
|
-
# to use different resource name schemes, such as `users/*/operations`.
|
106
|
+
# NOTE: the `name` binding allows API services to override the binding
|
107
|
+
# to use different resource name schemes, such as `users/*/operations`. To
|
108
|
+
# override the binding, API services can add a binding such as
|
109
|
+
# `"/v1/{name=users/*}/operations"` to their service configuration.
|
110
|
+
# For backwards compatibility, the default name includes the operations
|
111
|
+
# collection id, however overriding users must ensure the name binding
|
112
|
+
# is the parent resource, without the operations collection id.
|
108
113
|
#
|
109
114
|
# @overload list_operations(request, options = nil)
|
110
115
|
# Pass arguments to `list_operations` via a request object, either of type
|
@@ -122,7 +127,7 @@ module Google
|
|
122
127
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
123
128
|
#
|
124
129
|
# @param name [::String]
|
125
|
-
# The name of the operation
|
130
|
+
# The name of the operation's parent resource.
|
126
131
|
# @param filter [::String]
|
127
132
|
# The standard list filter.
|
128
133
|
# @param page_size [::Integer]
|
@@ -390,6 +395,79 @@ module Google
|
|
390
395
|
raise ::Google::Cloud::Error.from_error(e)
|
391
396
|
end
|
392
397
|
|
398
|
+
##
|
399
|
+
# Waits for the specified long-running operation until it is done or reaches
|
400
|
+
# at most a specified timeout, returning the latest state. If the operation
|
401
|
+
# is already done, the latest state is immediately returned. If the timeout
|
402
|
+
# specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
|
403
|
+
# timeout is used. If the server does not support this method, it returns
|
404
|
+
# `google.rpc.Code.UNIMPLEMENTED`.
|
405
|
+
# Note that this method is on a best-effort basis. It may return the latest
|
406
|
+
# state before the specified timeout (including immediately), meaning even an
|
407
|
+
# immediate response is no guarantee that the operation is done.
|
408
|
+
#
|
409
|
+
# @overload wait_operation(request, options = nil)
|
410
|
+
# Pass arguments to `wait_operation` via a request object, either of type
|
411
|
+
# {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
|
412
|
+
#
|
413
|
+
# @param request [::Google::Longrunning::WaitOperationRequest, ::Hash]
|
414
|
+
# A request object representing the call parameters. Required. To specify no
|
415
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
416
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
417
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
418
|
+
#
|
419
|
+
# @overload wait_operation(name: nil, timeout: nil)
|
420
|
+
# Pass arguments to `wait_operation` via keyword arguments. Note that at
|
421
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
422
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
423
|
+
#
|
424
|
+
# @param name [::String]
|
425
|
+
# The name of the operation resource to wait on.
|
426
|
+
# @param timeout [::Google::Protobuf::Duration, ::Hash]
|
427
|
+
# The maximum duration to wait before timing out. If left blank, the wait
|
428
|
+
# will be at most the time permitted by the underlying HTTP/RPC protocol.
|
429
|
+
# If RPC context deadline is also specified, the shorter one will be used.
|
430
|
+
#
|
431
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
432
|
+
# @yieldparam response [::Gapic::Operation]
|
433
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
434
|
+
#
|
435
|
+
# @return [::Gapic::Operation]
|
436
|
+
#
|
437
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
438
|
+
#
|
439
|
+
def wait_operation request, options = nil
|
440
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
441
|
+
|
442
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
|
443
|
+
|
444
|
+
# Converts hash and nil to an options object
|
445
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
446
|
+
|
447
|
+
# Customize the options with defaults
|
448
|
+
metadata = @config.rpcs.wait_operation.metadata.to_h
|
449
|
+
|
450
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
451
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
452
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
453
|
+
gapic_version: ::Google::Cloud::Dataproc::V1::VERSION
|
454
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
455
|
+
|
456
|
+
options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
|
457
|
+
metadata: metadata,
|
458
|
+
retry_policy: @config.rpcs.wait_operation.retry_policy
|
459
|
+
options.apply_defaults metadata: @config.metadata,
|
460
|
+
retry_policy: @config.retry_policy
|
461
|
+
|
462
|
+
@operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
|
463
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
464
|
+
yield response, operation if block_given?
|
465
|
+
return response
|
466
|
+
end
|
467
|
+
rescue ::GRPC::BadStatus => e
|
468
|
+
raise ::Google::Cloud::Error.from_error(e)
|
469
|
+
end
|
470
|
+
|
393
471
|
##
|
394
472
|
# Configuration class for the Operations API.
|
395
473
|
#
|
@@ -475,14 +553,14 @@ module Google
|
|
475
553
|
|
476
554
|
config_attr :endpoint, "dataproc.googleapis.com", ::String
|
477
555
|
config_attr :credentials, nil do |value|
|
478
|
-
allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
556
|
+
allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
|
479
557
|
allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
|
480
558
|
allowed.any? { |klass| klass === value }
|
481
559
|
end
|
482
560
|
config_attr :scope, nil, ::String, ::Array, nil
|
483
561
|
config_attr :lib_name, nil, ::String, nil
|
484
562
|
config_attr :lib_version, nil, ::String, nil
|
485
|
-
config_attr(:channel_args, { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
|
563
|
+
config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
|
486
564
|
config_attr :interceptors, nil, ::Array, nil
|
487
565
|
config_attr :timeout, nil, ::Numeric, nil
|
488
566
|
config_attr :metadata, nil, ::Hash, nil
|
@@ -503,7 +581,7 @@ module Google
|
|
503
581
|
def rpcs
|
504
582
|
@rpcs ||= begin
|
505
583
|
parent_rpcs = nil
|
506
|
-
parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config
|
584
|
+
parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
|
507
585
|
Rpcs.new parent_rpcs
|
508
586
|
end
|
509
587
|
end
|
@@ -515,7 +593,7 @@ module Google
|
|
515
593
|
# Each configuration object is of type `Gapic::Config::Method` and includes
|
516
594
|
# the following configuration fields:
|
517
595
|
#
|
518
|
-
# * `timeout` (*type:* `Numeric`) - The call timeout in
|
596
|
+
# * `timeout` (*type:* `Numeric`) - The call timeout in seconds
|
519
597
|
# * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
|
520
598
|
# * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
|
521
599
|
# include the following keys:
|
@@ -546,17 +624,24 @@ module Google
|
|
546
624
|
# @return [::Gapic::Config::Method]
|
547
625
|
#
|
548
626
|
attr_reader :cancel_operation
|
627
|
+
##
|
628
|
+
# RPC-specific configuration for `wait_operation`
|
629
|
+
# @return [::Gapic::Config::Method]
|
630
|
+
#
|
631
|
+
attr_reader :wait_operation
|
549
632
|
|
550
633
|
# @private
|
551
634
|
def initialize parent_rpcs = nil
|
552
|
-
list_operations_config = parent_rpcs
|
635
|
+
list_operations_config = parent_rpcs.list_operations if parent_rpcs.respond_to? :list_operations
|
553
636
|
@list_operations = ::Gapic::Config::Method.new list_operations_config
|
554
|
-
get_operation_config = parent_rpcs
|
637
|
+
get_operation_config = parent_rpcs.get_operation if parent_rpcs.respond_to? :get_operation
|
555
638
|
@get_operation = ::Gapic::Config::Method.new get_operation_config
|
556
|
-
delete_operation_config = parent_rpcs
|
639
|
+
delete_operation_config = parent_rpcs.delete_operation if parent_rpcs.respond_to? :delete_operation
|
557
640
|
@delete_operation = ::Gapic::Config::Method.new delete_operation_config
|
558
|
-
cancel_operation_config = parent_rpcs
|
641
|
+
cancel_operation_config = parent_rpcs.cancel_operation if parent_rpcs.respond_to? :cancel_operation
|
559
642
|
@cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
|
643
|
+
wait_operation_config = parent_rpcs.wait_operation if parent_rpcs.respond_to? :wait_operation
|
644
|
+
@wait_operation = ::Gapic::Config::Method.new wait_operation_config
|
560
645
|
|
561
646
|
yield self if block_given?
|
562
647
|
end
|