google-api-client 0.12.0 → 0.13.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (315) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +7 -0
  3. data/api_names.yaml +945 -41609
  4. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +12 -12
  5. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +2 -2
  6. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +1437 -412
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +516 -71
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +1098 -422
  10. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +6 -6
  11. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +3 -3
  12. data/generated/google/apis/adexchangebuyer_v1_4/service.rb +3 -3
  13. data/generated/google/apis/adexchangeseller_v2_0/service.rb +10 -10
  14. data/generated/google/apis/admin_directory_v1/service.rb +26 -26
  15. data/generated/google/apis/adsense_v1_4.rb +1 -1
  16. data/generated/google/apis/adsense_v1_4/classes.rb +2 -2
  17. data/generated/google/apis/adsense_v1_4/representations.rb +3 -3
  18. data/generated/google/apis/adsense_v1_4/service.rb +44 -44
  19. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  20. data/generated/google/apis/adsensehost_v4_1/service.rb +22 -22
  21. data/generated/google/apis/analytics_v3/classes.rb +3 -3
  22. data/generated/google/apis/analytics_v3/representations.rb +3 -3
  23. data/generated/google/apis/analytics_v3/service.rb +82 -82
  24. data/generated/google/apis/analyticsreporting_v4/classes.rb +937 -937
  25. data/generated/google/apis/analyticsreporting_v4/representations.rb +128 -128
  26. data/generated/google/apis/analyticsreporting_v4/service.rb +1 -1
  27. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  28. data/generated/google/apis/androidenterprise_v1/classes.rb +10 -10
  29. data/generated/google/apis/androidenterprise_v1/representations.rb +20 -20
  30. data/generated/google/apis/androidenterprise_v1/service.rb +43 -43
  31. data/generated/google/apis/androidpublisher_v2/classes.rb +26 -26
  32. data/generated/google/apis/androidpublisher_v2/representations.rb +46 -46
  33. data/generated/google/apis/androidpublisher_v2/service.rb +95 -95
  34. data/generated/google/apis/appengine_v1.rb +4 -4
  35. data/generated/google/apis/appengine_v1/classes.rb +1570 -1512
  36. data/generated/google/apis/appengine_v1/representations.rb +362 -343
  37. data/generated/google/apis/appengine_v1/service.rb +220 -220
  38. data/generated/google/apis/appstate_v1.rb +1 -1
  39. data/generated/google/apis/bigquery_v2.rb +1 -1
  40. data/generated/google/apis/bigquery_v2/classes.rb +5 -5
  41. data/generated/google/apis/bigquery_v2/representations.rb +8 -8
  42. data/generated/google/apis/bigquery_v2/service.rb +13 -13
  43. data/generated/google/apis/blogger_v3/service.rb +3 -3
  44. data/generated/google/apis/books_v1/classes.rb +55 -55
  45. data/generated/google/apis/books_v1/representations.rb +67 -67
  46. data/generated/google/apis/books_v1/service.rb +82 -82
  47. data/generated/google/apis/calendar_v3.rb +1 -1
  48. data/generated/google/apis/calendar_v3/classes.rb +6 -6
  49. data/generated/google/apis/calendar_v3/representations.rb +3 -3
  50. data/generated/google/apis/calendar_v3/service.rb +2 -2
  51. data/generated/google/apis/civicinfo_v2/classes.rb +2 -2
  52. data/generated/google/apis/civicinfo_v2/representations.rb +4 -4
  53. data/generated/google/apis/civicinfo_v2/service.rb +12 -12
  54. data/generated/google/apis/classroom_v1.rb +7 -7
  55. data/generated/google/apis/classroom_v1/classes.rb +1013 -991
  56. data/generated/google/apis/classroom_v1/representations.rb +207 -204
  57. data/generated/google/apis/classroom_v1/service.rb +709 -709
  58. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  59. data/generated/google/apis/cloudbuild_v1/classes.rb +307 -307
  60. data/generated/google/apis/cloudbuild_v1/representations.rb +84 -84
  61. data/generated/google/apis/cloudbuild_v1/service.rb +125 -125
  62. data/generated/google/apis/clouddebugger_v2/classes.rb +673 -673
  63. data/generated/google/apis/clouddebugger_v2/representations.rb +152 -152
  64. data/generated/google/apis/clouddebugger_v2/service.rb +55 -55
  65. data/generated/google/apis/clouderrorreporting_v1beta1.rb +1 -1
  66. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +121 -121
  67. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +25 -25
  68. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +74 -74
  69. data/generated/google/apis/cloudkms_v1.rb +1 -1
  70. data/generated/google/apis/cloudkms_v1/classes.rb +668 -613
  71. data/generated/google/apis/cloudkms_v1/representations.rb +151 -133
  72. data/generated/google/apis/cloudkms_v1/service.rb +267 -267
  73. data/generated/google/apis/cloudresourcemanager_v1.rb +4 -4
  74. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1167 -1168
  75. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +193 -193
  76. data/generated/google/apis/cloudresourcemanager_v1/service.rb +470 -469
  77. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  78. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +508 -509
  79. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +94 -94
  80. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +157 -156
  81. data/generated/google/apis/cloudtrace_v1/service.rb +34 -34
  82. data/generated/google/apis/compute_beta.rb +1 -1
  83. data/generated/google/apis/compute_beta/classes.rb +163 -15
  84. data/generated/google/apis/compute_beta/representations.rb +54 -14
  85. data/generated/google/apis/compute_beta/service.rb +2258 -482
  86. data/generated/google/apis/compute_v1.rb +1 -1
  87. data/generated/google/apis/compute_v1/classes.rb +465 -13
  88. data/generated/google/apis/compute_v1/representations.rb +202 -16
  89. data/generated/google/apis/compute_v1/service.rb +573 -309
  90. data/generated/google/apis/container_v1.rb +1 -1
  91. data/generated/google/apis/container_v1/classes.rb +635 -589
  92. data/generated/google/apis/container_v1/representations.rb +139 -111
  93. data/generated/google/apis/container_v1/service.rb +272 -227
  94. data/generated/google/apis/content_v2.rb +1 -1
  95. data/generated/google/apis/content_v2/classes.rb +86 -74
  96. data/generated/google/apis/content_v2/representations.rb +107 -105
  97. data/generated/google/apis/content_v2/service.rb +131 -130
  98. data/generated/google/apis/customsearch_v1.rb +2 -2
  99. data/generated/google/apis/customsearch_v1/classes.rb +0 -6
  100. data/generated/google/apis/customsearch_v1/representations.rb +0 -1
  101. data/generated/google/apis/customsearch_v1/service.rb +2 -5
  102. data/generated/google/apis/dataflow_v1b3.rb +7 -4
  103. data/generated/google/apis/dataflow_v1b3/classes.rb +3405 -3405
  104. data/generated/google/apis/dataflow_v1b3/representations.rb +834 -834
  105. data/generated/google/apis/dataflow_v1b3/service.rb +244 -244
  106. data/generated/google/apis/dataproc_v1.rb +1 -1
  107. data/generated/google/apis/dataproc_v1/classes.rb +543 -691
  108. data/generated/google/apis/dataproc_v1/representations.rb +129 -185
  109. data/generated/google/apis/dataproc_v1/service.rb +347 -347
  110. data/generated/google/apis/datastore_v1.rb +4 -4
  111. data/generated/google/apis/datastore_v1/classes.rb +833 -833
  112. data/generated/google/apis/datastore_v1/representations.rb +182 -182
  113. data/generated/google/apis/datastore_v1/service.rb +45 -45
  114. data/generated/google/apis/deploymentmanager_v2/classes.rb +5 -5
  115. data/generated/google/apis/deploymentmanager_v2/representations.rb +10 -10
  116. data/generated/google/apis/deploymentmanager_v2/service.rb +20 -20
  117. data/generated/google/apis/discovery_v1/classes.rb +4 -4
  118. data/generated/google/apis/discovery_v1/representations.rb +2 -2
  119. data/generated/google/apis/discovery_v1/service.rb +1 -1
  120. data/generated/google/apis/dns_v1.rb +1 -1
  121. data/generated/google/apis/dns_v1/classes.rb +3 -3
  122. data/generated/google/apis/dns_v1/representations.rb +6 -6
  123. data/generated/google/apis/dns_v1/service.rb +12 -12
  124. data/generated/google/apis/dns_v2beta1.rb +1 -1
  125. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +8 -8
  126. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  127. data/generated/google/apis/drive_v2.rb +1 -1
  128. data/generated/google/apis/drive_v2/classes.rb +1 -1
  129. data/generated/google/apis/drive_v2/service.rb +1 -1
  130. data/generated/google/apis/drive_v3.rb +1 -1
  131. data/generated/google/apis/drive_v3/service.rb +1 -1
  132. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  133. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +160 -110
  134. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +60 -31
  135. data/generated/google/apis/firebasedynamiclinks_v1/service.rb +38 -3
  136. data/generated/google/apis/firebaserules_v1/classes.rb +354 -354
  137. data/generated/google/apis/firebaserules_v1/representations.rb +87 -87
  138. data/generated/google/apis/firebaserules_v1/service.rb +103 -103
  139. data/generated/google/apis/fusiontables_v2/service.rb +2 -2
  140. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  141. data/generated/google/apis/games_configuration_v1configuration/classes.rb +2 -2
  142. data/generated/google/apis/games_configuration_v1configuration/representations.rb +4 -4
  143. data/generated/google/apis/games_configuration_v1configuration/service.rb +8 -8
  144. data/generated/google/apis/games_management_v1management.rb +1 -1
  145. data/generated/google/apis/games_v1.rb +1 -1
  146. data/generated/google/apis/games_v1/classes.rb +23 -23
  147. data/generated/google/apis/games_v1/representations.rb +43 -43
  148. data/generated/google/apis/games_v1/service.rb +72 -72
  149. data/generated/google/apis/genomics_v1.rb +1 -1
  150. data/generated/google/apis/genomics_v1/classes.rb +2316 -2316
  151. data/generated/google/apis/genomics_v1/representations.rb +291 -291
  152. data/generated/google/apis/genomics_v1/service.rb +821 -821
  153. data/generated/google/apis/gmail_v1.rb +1 -1
  154. data/generated/google/apis/groupsmigration_v1.rb +1 -1
  155. data/generated/google/apis/groupssettings_v1.rb +1 -1
  156. data/generated/google/apis/groupssettings_v1/classes.rb +2 -2
  157. data/generated/google/apis/groupssettings_v1/service.rb +3 -0
  158. data/generated/google/apis/iam_v1/classes.rb +338 -338
  159. data/generated/google/apis/iam_v1/representations.rb +98 -98
  160. data/generated/google/apis/iam_v1/service.rb +35 -35
  161. data/generated/google/apis/identitytoolkit_v3/classes.rb +15 -15
  162. data/generated/google/apis/identitytoolkit_v3/representations.rb +30 -30
  163. data/generated/google/apis/identitytoolkit_v3/service.rb +64 -64
  164. data/generated/google/apis/kgsearch_v1/service.rb +13 -13
  165. data/generated/google/apis/language_v1.rb +1 -1
  166. data/generated/google/apis/language_v1/classes.rb +374 -374
  167. data/generated/google/apis/language_v1/representations.rb +97 -97
  168. data/generated/google/apis/language_v1/service.rb +16 -16
  169. data/generated/google/apis/language_v1beta1.rb +1 -1
  170. data/generated/google/apis/language_v1beta1/classes.rb +441 -441
  171. data/generated/google/apis/language_v1beta1/representations.rb +108 -108
  172. data/generated/google/apis/language_v1beta1/service.rb +30 -30
  173. data/generated/google/apis/licensing_v1/service.rb +2 -2
  174. data/generated/google/apis/logging_v2.rb +1 -1
  175. data/generated/google/apis/logging_v2/classes.rb +712 -712
  176. data/generated/google/apis/logging_v2/representations.rb +109 -109
  177. data/generated/google/apis/logging_v2/service.rb +543 -539
  178. data/generated/google/apis/logging_v2beta1.rb +1 -1
  179. data/generated/google/apis/logging_v2beta1/classes.rb +752 -752
  180. data/generated/google/apis/logging_v2beta1/representations.rb +94 -94
  181. data/generated/google/apis/logging_v2beta1/service.rb +257 -256
  182. data/generated/google/apis/manufacturers_v1/classes.rb +130 -130
  183. data/generated/google/apis/manufacturers_v1/representations.rb +28 -28
  184. data/generated/google/apis/mirror_v1/classes.rb +5 -5
  185. data/generated/google/apis/mirror_v1/representations.rb +10 -10
  186. data/generated/google/apis/mirror_v1/service.rb +20 -20
  187. data/generated/google/apis/ml_v1.rb +1 -1
  188. data/generated/google/apis/ml_v1/classes.rb +1830 -1210
  189. data/generated/google/apis/ml_v1/representations.rb +342 -120
  190. data/generated/google/apis/ml_v1/service.rb +365 -258
  191. data/generated/google/apis/monitoring_v3.rb +4 -4
  192. data/generated/google/apis/monitoring_v3/classes.rb +889 -889
  193. data/generated/google/apis/monitoring_v3/representations.rb +174 -174
  194. data/generated/google/apis/monitoring_v3/service.rb +119 -119
  195. data/generated/google/apis/mybusiness_v3/service.rb +5 -5
  196. data/generated/google/apis/oauth2_v2/service.rb +1 -1
  197. data/generated/google/apis/pagespeedonline_v2/classes.rb +11 -11
  198. data/generated/google/apis/pagespeedonline_v2/representations.rb +13 -13
  199. data/generated/google/apis/pagespeedonline_v2/service.rb +1 -1
  200. data/generated/google/apis/partners_v2.rb +1 -1
  201. data/generated/google/apis/partners_v2/classes.rb +550 -536
  202. data/generated/google/apis/partners_v2/representations.rb +118 -116
  203. data/generated/google/apis/partners_v2/service.rb +439 -439
  204. data/generated/google/apis/people_v1.rb +4 -4
  205. data/generated/google/apis/people_v1/classes.rb +414 -413
  206. data/generated/google/apis/people_v1/representations.rb +85 -85
  207. data/generated/google/apis/people_v1/service.rb +111 -18
  208. data/generated/google/apis/plus_domains_v1.rb +1 -1
  209. data/generated/google/apis/plus_domains_v1/service.rb +4 -4
  210. data/generated/google/apis/plus_v1.rb +1 -1
  211. data/generated/google/apis/plus_v1/service.rb +1 -1
  212. data/generated/google/apis/prediction_v1_6/service.rb +8 -8
  213. data/generated/google/apis/proximitybeacon_v1beta1.rb +1 -1
  214. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +443 -443
  215. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +92 -92
  216. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +152 -152
  217. data/generated/google/apis/pubsub_v1/classes.rb +249 -249
  218. data/generated/google/apis/pubsub_v1/representations.rb +80 -80
  219. data/generated/google/apis/pubsub_v1/service.rb +415 -415
  220. data/generated/google/apis/qpx_express_v1/classes.rb +2 -2
  221. data/generated/google/apis/qpx_express_v1/representations.rb +4 -4
  222. data/generated/google/apis/qpx_express_v1/service.rb +8 -8
  223. data/generated/google/apis/replicapool_v1beta2/classes.rb +5 -5
  224. data/generated/google/apis/replicapool_v1beta2/representations.rb +10 -10
  225. data/generated/google/apis/replicapool_v1beta2/service.rb +21 -21
  226. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +1 -1
  227. data/generated/google/apis/resourceviews_v1beta2/classes.rb +5 -5
  228. data/generated/google/apis/resourceviews_v1beta2/representations.rb +10 -10
  229. data/generated/google/apis/resourceviews_v1beta2/service.rb +20 -20
  230. data/generated/google/apis/runtimeconfig_v1.rb +4 -4
  231. data/generated/google/apis/runtimeconfig_v1/classes.rb +15 -15
  232. data/generated/google/apis/runtimeconfig_v1/representations.rb +2 -2
  233. data/generated/google/apis/runtimeconfig_v1/service.rb +4 -4
  234. data/generated/google/apis/script_v1.rb +17 -17
  235. data/generated/google/apis/script_v1/classes.rb +27 -27
  236. data/generated/google/apis/script_v1/representations.rb +5 -5
  237. data/generated/google/apis/script_v1/service.rb +4 -4
  238. data/generated/google/apis/searchconsole_v1.rb +1 -1
  239. data/generated/google/apis/searchconsole_v1/classes.rb +53 -53
  240. data/generated/google/apis/searchconsole_v1/representations.rb +23 -23
  241. data/generated/google/apis/searchconsole_v1/service.rb +4 -4
  242. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  243. data/generated/google/apis/servicecontrol_v1/classes.rb +1175 -1175
  244. data/generated/google/apis/servicecontrol_v1/representations.rb +206 -206
  245. data/generated/google/apis/servicecontrol_v1/service.rb +116 -116
  246. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  247. data/generated/google/apis/servicemanagement_v1/classes.rb +1186 -1125
  248. data/generated/google/apis/servicemanagement_v1/representations.rb +241 -223
  249. data/generated/google/apis/servicemanagement_v1/service.rb +201 -201
  250. data/generated/google/apis/serviceuser_v1.rb +1 -1
  251. data/generated/google/apis/serviceuser_v1/classes.rb +2645 -2641
  252. data/generated/google/apis/serviceuser_v1/representations.rb +234 -234
  253. data/generated/google/apis/serviceuser_v1/service.rb +37 -37
  254. data/generated/google/apis/sheets_v4.rb +1 -1
  255. data/generated/google/apis/sheets_v4/classes.rb +5042 -4111
  256. data/generated/google/apis/sheets_v4/representations.rb +994 -824
  257. data/generated/google/apis/sheets_v4/service.rb +80 -80
  258. data/generated/google/apis/site_verification_v1/classes.rb +6 -6
  259. data/generated/google/apis/site_verification_v1/representations.rb +8 -8
  260. data/generated/google/apis/site_verification_v1/service.rb +12 -12
  261. data/generated/google/apis/slides_v1.rb +1 -1
  262. data/generated/google/apis/slides_v1/classes.rb +2885 -2885
  263. data/generated/google/apis/slides_v1/representations.rb +310 -310
  264. data/generated/google/apis/slides_v1/service.rb +54 -54
  265. data/generated/google/apis/sourcerepo_v1/classes.rb +206 -206
  266. data/generated/google/apis/sourcerepo_v1/representations.rb +52 -52
  267. data/generated/google/apis/sourcerepo_v1/service.rb +5 -5
  268. data/generated/google/apis/spanner_v1.rb +1 -1
  269. data/generated/google/apis/spanner_v1/classes.rb +2142 -2141
  270. data/generated/google/apis/spanner_v1/representations.rb +174 -174
  271. data/generated/google/apis/spanner_v1/service.rb +497 -497
  272. data/generated/google/apis/speech_v1beta1.rb +1 -1
  273. data/generated/google/apis/speech_v1beta1/classes.rb +227 -227
  274. data/generated/google/apis/speech_v1beta1/representations.rb +50 -50
  275. data/generated/google/apis/speech_v1beta1/service.rb +33 -33
  276. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  277. data/generated/google/apis/sqladmin_v1beta4/classes.rb +21 -21
  278. data/generated/google/apis/sqladmin_v1beta4/representations.rb +29 -29
  279. data/generated/google/apis/sqladmin_v1beta4/service.rb +56 -56
  280. data/generated/google/apis/storage_v1.rb +1 -1
  281. data/generated/google/apis/storage_v1/classes.rb +40 -6
  282. data/generated/google/apis/storage_v1/representations.rb +20 -4
  283. data/generated/google/apis/storage_v1/service.rb +61 -46
  284. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  285. data/generated/google/apis/storagetransfer_v1/classes.rb +184 -184
  286. data/generated/google/apis/storagetransfer_v1/representations.rb +35 -35
  287. data/generated/google/apis/storagetransfer_v1/service.rb +70 -70
  288. data/generated/google/apis/tagmanager_v1/service.rb +33 -33
  289. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  290. data/generated/google/apis/translate_v2/classes.rb +12 -12
  291. data/generated/google/apis/translate_v2/representations.rb +10 -10
  292. data/generated/google/apis/translate_v2/service.rb +62 -62
  293. data/generated/google/apis/vision_v1.rb +1 -1
  294. data/generated/google/apis/vision_v1/classes.rb +1267 -1267
  295. data/generated/google/apis/vision_v1/representations.rb +200 -200
  296. data/generated/google/apis/vision_v1/service.rb +10 -10
  297. data/generated/google/apis/webmasters_v3.rb +1 -1
  298. data/generated/google/apis/webmasters_v3/classes.rb +4 -4
  299. data/generated/google/apis/webmasters_v3/representations.rb +8 -8
  300. data/generated/google/apis/webmasters_v3/service.rb +21 -21
  301. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  302. data/generated/google/apis/youtube_analytics_v1/classes.rb +2 -2
  303. data/generated/google/apis/youtube_analytics_v1/representations.rb +4 -4
  304. data/generated/google/apis/youtube_analytics_v1/service.rb +8 -8
  305. data/generated/google/apis/youtube_v3/classes.rb +20 -20
  306. data/generated/google/apis/youtube_v3/representations.rb +40 -40
  307. data/generated/google/apis/youtube_v3/service.rb +80 -80
  308. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  309. data/generated/google/apis/youtubereporting_v1/classes.rb +129 -129
  310. data/generated/google/apis/youtubereporting_v1/representations.rb +38 -38
  311. data/generated/google/apis/youtubereporting_v1/service.rb +97 -97
  312. data/lib/google/apis/generator/annotator.rb +2 -2
  313. data/lib/google/apis/generator/model.rb +2 -2
  314. data/lib/google/apis/version.rb +1 -1
  315. metadata +2 -2
@@ -47,61 +47,85 @@ module Google
47
47
  @batch_path = 'batch'
48
48
  end
49
49
 
50
- # Lists operations that match the specified filter in the request. If the server
51
- # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
52
- # allows API services to override the binding to use different resource name
53
- # schemes, such as users/*/operations. To override the binding, API services can
54
- # add a binding such as "/v1/`name=users/*`/operations" to their service
55
- # configuration. For backwards compatibility, the default name includes the
56
- # operations collection id, however overriding users must ensure the name
57
- # binding is the parent resource, without the operations collection id.
58
- # @param [String] name
59
- # The name of the operation's parent resource.
60
- # @param [Fixnum] page_size
61
- # The standard list page size.
62
- # @param [String] filter
63
- # The standard list filter.
64
- # @param [String] page_token
65
- # The standard list page token.
66
- # @param [String] fields
67
- # Selector specifying which fields to include in a partial response.
50
+ # Gets the resource representation for a cluster in a project.
51
+ # @param [String] project_id
52
+ # Required. The ID of the Google Cloud Platform project that the cluster belongs
53
+ # to.
54
+ # @param [String] region
55
+ # Required. The Cloud Dataproc region in which to handle the request.
56
+ # @param [String] cluster_name
57
+ # Required. The cluster name.
68
58
  # @param [String] quota_user
69
59
  # Available to use for quota purposes for server-side applications. Can be any
70
60
  # arbitrary string assigned to a user, but should not exceed 40 characters.
61
+ # @param [String] fields
62
+ # Selector specifying which fields to include in a partial response.
71
63
  # @param [Google::Apis::RequestOptions] options
72
64
  # Request-specific options
73
65
  #
74
66
  # @yield [result, err] Result & error if block supplied
75
- # @yieldparam result [Google::Apis::DataprocV1::ListOperationsResponse] parsed result object
67
+ # @yieldparam result [Google::Apis::DataprocV1::Cluster] parsed result object
76
68
  # @yieldparam err [StandardError] error object if request failed
77
69
  #
78
- # @return [Google::Apis::DataprocV1::ListOperationsResponse]
70
+ # @return [Google::Apis::DataprocV1::Cluster]
79
71
  #
80
72
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
81
73
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
82
74
  # @raise [Google::Apis::AuthorizationError] Authorization is required
83
- def list_project_region_operations(name, page_size: nil, filter: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
84
- command = make_simple_command(:get, 'v1/{+name}', options)
85
- command.response_representation = Google::Apis::DataprocV1::ListOperationsResponse::Representation
86
- command.response_class = Google::Apis::DataprocV1::ListOperationsResponse
87
- command.params['name'] = name unless name.nil?
88
- command.query['pageSize'] = page_size unless page_size.nil?
89
- command.query['filter'] = filter unless filter.nil?
90
- command.query['pageToken'] = page_token unless page_token.nil?
91
- command.query['fields'] = fields unless fields.nil?
75
+ def get_cluster(project_id, region, cluster_name, quota_user: nil, fields: nil, options: nil, &block)
76
+ command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}', options)
77
+ command.response_representation = Google::Apis::DataprocV1::Cluster::Representation
78
+ command.response_class = Google::Apis::DataprocV1::Cluster
79
+ command.params['projectId'] = project_id unless project_id.nil?
80
+ command.params['region'] = region unless region.nil?
81
+ command.params['clusterName'] = cluster_name unless cluster_name.nil?
92
82
  command.query['quotaUser'] = quota_user unless quota_user.nil?
83
+ command.query['fields'] = fields unless fields.nil?
93
84
  execute_or_queue_command(command, &block)
94
85
  end
95
86
 
96
- # Gets the latest state of a long-running operation. Clients can use this method
97
- # to poll the operation result at intervals as recommended by the API service.
98
- # @param [String] name
99
- # The name of the operation resource.
100
- # @param [String] fields
101
- # Selector specifying which fields to include in a partial response.
87
+ # Updates a cluster in a project.
88
+ # @param [String] project_id
89
+ # Required. The ID of the Google Cloud Platform project the cluster belongs to.
90
+ # @param [String] region
91
+ # Required. The Cloud Dataproc region in which to handle the request.
92
+ # @param [String] cluster_name
93
+ # Required. The cluster name.
94
+ # @param [Google::Apis::DataprocV1::Cluster] cluster_object
95
+ # @param [String] update_mask
96
+ # Required. Specifies the path, relative to Cluster, of the field to update. For
97
+ # example, to change the number of workers in a cluster to 5, the update_mask
98
+ # parameter would be specified as config.worker_config.num_instances, and the
99
+ # PATCH request body would specify the new value, as follows:
100
+ # `
101
+ # "config":`
102
+ # "workerConfig":`
103
+ # "numInstances":"5"
104
+ # `
105
+ # `
106
+ # `
107
+ # Similarly, to change the number of preemptible workers in a cluster to 5, the
108
+ # update_mask parameter would be config.secondary_worker_config.num_instances,
109
+ # and the PATCH request body would be set as follows:
110
+ # `
111
+ # "config":`
112
+ # "secondaryWorkerConfig":`
113
+ # "numInstances":"5"
114
+ # `
115
+ # `
116
+ # `
117
+ # <strong>Note:</strong> Currently, only the following fields can be updated:<
118
+ # table> <tbody> <tr> <td><strong>Mask</strong></td> <td><strong>Purpose</
119
+ # strong></td> </tr> <tr> <td><strong><em>labels</em></strong></td> <td>
120
+ # Update labels</td> </tr> <tr> <td><strong><em>config.worker_config.
121
+ # num_instances</em></strong></td> <td>Resize primary worker group</td> </tr>
122
+ # <tr> <td><strong><em>config.secondary_worker_config.num_instances</em></
123
+ # strong></td> <td>Resize secondary worker group</td> </tr> </tbody> </table>
102
124
  # @param [String] quota_user
103
125
  # Available to use for quota purposes for server-side applications. Can be any
104
126
  # arbitrary string assigned to a user, but should not exceed 40 characters.
127
+ # @param [String] fields
128
+ # Selector specifying which fields to include in a partial response.
105
129
  # @param [Google::Apis::RequestOptions] options
106
130
  # Request-specific options
107
131
  #
@@ -114,289 +138,333 @@ module Google
114
138
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
115
139
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
116
140
  # @raise [Google::Apis::AuthorizationError] Authorization is required
117
- def get_project_region_operation(name, fields: nil, quota_user: nil, options: nil, &block)
118
- command = make_simple_command(:get, 'v1/{+name}', options)
141
+ def patch_cluster(project_id, region, cluster_name, cluster_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
142
+ command = make_simple_command(:patch, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}', options)
143
+ command.request_representation = Google::Apis::DataprocV1::Cluster::Representation
144
+ command.request_object = cluster_object
119
145
  command.response_representation = Google::Apis::DataprocV1::Operation::Representation
120
146
  command.response_class = Google::Apis::DataprocV1::Operation
121
- command.params['name'] = name unless name.nil?
122
- command.query['fields'] = fields unless fields.nil?
147
+ command.params['projectId'] = project_id unless project_id.nil?
148
+ command.params['region'] = region unless region.nil?
149
+ command.params['clusterName'] = cluster_name unless cluster_name.nil?
150
+ command.query['updateMask'] = update_mask unless update_mask.nil?
123
151
  command.query['quotaUser'] = quota_user unless quota_user.nil?
152
+ command.query['fields'] = fields unless fields.nil?
124
153
  execute_or_queue_command(command, &block)
125
154
  end
126
155
 
127
- # Starts asynchronous cancellation on a long-running operation. The server makes
128
- # a best effort to cancel the operation, but success is not guaranteed. If the
129
- # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
130
- # Clients can use Operations.GetOperation or other methods to check whether the
131
- # cancellation succeeded or whether the operation completed despite cancellation.
132
- # On successful cancellation, the operation is not deleted; instead, it becomes
133
- # an operation with an Operation.error value with a google.rpc.Status.code of 1,
134
- # corresponding to Code.CANCELLED.
135
- # @param [String] name
136
- # The name of the operation resource to be cancelled.
137
- # @param [String] fields
138
- # Selector specifying which fields to include in a partial response.
156
+ # Gets cluster diagnostic information. After the operation completes, the
157
+ # Operation.response field contains DiagnoseClusterOutputLocation.
158
+ # @param [String] project_id
159
+ # Required. The ID of the Google Cloud Platform project that the cluster belongs
160
+ # to.
161
+ # @param [String] region
162
+ # Required. The Cloud Dataproc region in which to handle the request.
163
+ # @param [String] cluster_name
164
+ # Required. The cluster name.
165
+ # @param [Google::Apis::DataprocV1::DiagnoseClusterRequest] diagnose_cluster_request_object
139
166
  # @param [String] quota_user
140
167
  # Available to use for quota purposes for server-side applications. Can be any
141
168
  # arbitrary string assigned to a user, but should not exceed 40 characters.
169
+ # @param [String] fields
170
+ # Selector specifying which fields to include in a partial response.
142
171
  # @param [Google::Apis::RequestOptions] options
143
172
  # Request-specific options
144
173
  #
145
174
  # @yield [result, err] Result & error if block supplied
146
- # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
175
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
147
176
  # @yieldparam err [StandardError] error object if request failed
148
177
  #
149
- # @return [Google::Apis::DataprocV1::Empty]
178
+ # @return [Google::Apis::DataprocV1::Operation]
150
179
  #
151
180
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
152
181
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
153
182
  # @raise [Google::Apis::AuthorizationError] Authorization is required
154
- def cancel_project_region_operation(name, fields: nil, quota_user: nil, options: nil, &block)
155
- command = make_simple_command(:post, 'v1/{+name}:cancel', options)
156
- command.response_representation = Google::Apis::DataprocV1::Empty::Representation
157
- command.response_class = Google::Apis::DataprocV1::Empty
158
- command.params['name'] = name unless name.nil?
159
- command.query['fields'] = fields unless fields.nil?
183
+ def diagnose_cluster(project_id, region, cluster_name, diagnose_cluster_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
184
+ command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:diagnose', options)
185
+ command.request_representation = Google::Apis::DataprocV1::DiagnoseClusterRequest::Representation
186
+ command.request_object = diagnose_cluster_request_object
187
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
188
+ command.response_class = Google::Apis::DataprocV1::Operation
189
+ command.params['projectId'] = project_id unless project_id.nil?
190
+ command.params['region'] = region unless region.nil?
191
+ command.params['clusterName'] = cluster_name unless cluster_name.nil?
160
192
  command.query['quotaUser'] = quota_user unless quota_user.nil?
193
+ command.query['fields'] = fields unless fields.nil?
161
194
  execute_or_queue_command(command, &block)
162
195
  end
163
196
 
164
- # Deletes a long-running operation. This method indicates that the client is no
165
- # longer interested in the operation result. It does not cancel the operation.
166
- # If the server doesn't support this method, it returns google.rpc.Code.
167
- # UNIMPLEMENTED.
168
- # @param [String] name
169
- # The name of the operation resource to be deleted.
170
- # @param [String] fields
171
- # Selector specifying which fields to include in a partial response.
197
+ # Deletes a cluster in a project.
198
+ # @param [String] project_id
199
+ # Required. The ID of the Google Cloud Platform project that the cluster belongs
200
+ # to.
201
+ # @param [String] region
202
+ # Required. The Cloud Dataproc region in which to handle the request.
203
+ # @param [String] cluster_name
204
+ # Required. The cluster name.
172
205
  # @param [String] quota_user
173
206
  # Available to use for quota purposes for server-side applications. Can be any
174
207
  # arbitrary string assigned to a user, but should not exceed 40 characters.
208
+ # @param [String] fields
209
+ # Selector specifying which fields to include in a partial response.
175
210
  # @param [Google::Apis::RequestOptions] options
176
211
  # Request-specific options
177
212
  #
178
213
  # @yield [result, err] Result & error if block supplied
179
- # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
214
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
180
215
  # @yieldparam err [StandardError] error object if request failed
181
216
  #
182
- # @return [Google::Apis::DataprocV1::Empty]
217
+ # @return [Google::Apis::DataprocV1::Operation]
183
218
  #
184
219
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
185
220
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
186
221
  # @raise [Google::Apis::AuthorizationError] Authorization is required
187
- def delete_project_region_operation(name, fields: nil, quota_user: nil, options: nil, &block)
188
- command = make_simple_command(:delete, 'v1/{+name}', options)
189
- command.response_representation = Google::Apis::DataprocV1::Empty::Representation
190
- command.response_class = Google::Apis::DataprocV1::Empty
191
- command.params['name'] = name unless name.nil?
192
- command.query['fields'] = fields unless fields.nil?
222
+ def delete_cluster(project_id, region, cluster_name, quota_user: nil, fields: nil, options: nil, &block)
223
+ command = make_simple_command(:delete, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}', options)
224
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
225
+ command.response_class = Google::Apis::DataprocV1::Operation
226
+ command.params['projectId'] = project_id unless project_id.nil?
227
+ command.params['region'] = region unless region.nil?
228
+ command.params['clusterName'] = cluster_name unless cluster_name.nil?
193
229
  command.query['quotaUser'] = quota_user unless quota_user.nil?
230
+ command.query['fields'] = fields unless fields.nil?
194
231
  execute_or_queue_command(command, &block)
195
232
  end
196
233
 
197
- # Submits a job to a cluster.
234
+ # Lists all regions/`region`/clusters in a project.
198
235
  # @param [String] project_id
199
- # Required. The ID of the Google Cloud Platform project that the job belongs to.
236
+ # Required. The ID of the Google Cloud Platform project that the cluster belongs
237
+ # to.
200
238
  # @param [String] region
201
239
  # Required. The Cloud Dataproc region in which to handle the request.
202
- # @param [Google::Apis::DataprocV1::SubmitJobRequest] submit_job_request_object
203
- # @param [String] fields
204
- # Selector specifying which fields to include in a partial response.
240
+ # @param [Fixnum] page_size
241
+ # Optional. The standard List page size.
242
+ # @param [String] filter
243
+ # Optional. A filter constraining the clusters to list. Filters are case-
244
+ # sensitive and have the following syntax:field = value AND field = value ...
245
+ # where field is one of status.state, clusterName, or labels.[KEY], and [KEY] is
246
+ # a label key. value can be * to match all values. status.state can be one of
247
+ # the following: ACTIVE, INACTIVE, CREATING, RUNNING, ERROR, DELETING, or
248
+ # UPDATING. ACTIVE contains the CREATING, UPDATING, and RUNNING states. INACTIVE
249
+ # contains the DELETING and ERROR states. clusterName is the name of the cluster
250
+ # provided at creation time. Only the logical AND operator is supported; space-
251
+ # separated items are treated as having an implicit AND operator.Example filter:
252
+ # status.state = ACTIVE AND clusterName = mycluster AND labels.env = staging AND
253
+ # labels.starred = *
254
+ # @param [String] page_token
255
+ # Optional. The standard List page token.
205
256
  # @param [String] quota_user
206
257
  # Available to use for quota purposes for server-side applications. Can be any
207
258
  # arbitrary string assigned to a user, but should not exceed 40 characters.
259
+ # @param [String] fields
260
+ # Selector specifying which fields to include in a partial response.
208
261
  # @param [Google::Apis::RequestOptions] options
209
262
  # Request-specific options
210
263
  #
211
264
  # @yield [result, err] Result & error if block supplied
212
- # @yieldparam result [Google::Apis::DataprocV1::Job] parsed result object
265
+ # @yieldparam result [Google::Apis::DataprocV1::ListClustersResponse] parsed result object
213
266
  # @yieldparam err [StandardError] error object if request failed
214
267
  #
215
- # @return [Google::Apis::DataprocV1::Job]
268
+ # @return [Google::Apis::DataprocV1::ListClustersResponse]
216
269
  #
217
270
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
218
271
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
219
272
  # @raise [Google::Apis::AuthorizationError] Authorization is required
220
- def submit_job(project_id, region, submit_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
221
- command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/jobs:submit', options)
222
- command.request_representation = Google::Apis::DataprocV1::SubmitJobRequest::Representation
223
- command.request_object = submit_job_request_object
224
- command.response_representation = Google::Apis::DataprocV1::Job::Representation
225
- command.response_class = Google::Apis::DataprocV1::Job
273
+ def list_clusters(project_id, region, page_size: nil, filter: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
274
+ command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/clusters', options)
275
+ command.response_representation = Google::Apis::DataprocV1::ListClustersResponse::Representation
276
+ command.response_class = Google::Apis::DataprocV1::ListClustersResponse
226
277
  command.params['projectId'] = project_id unless project_id.nil?
227
278
  command.params['region'] = region unless region.nil?
228
- command.query['fields'] = fields unless fields.nil?
279
+ command.query['pageSize'] = page_size unless page_size.nil?
280
+ command.query['filter'] = filter unless filter.nil?
281
+ command.query['pageToken'] = page_token unless page_token.nil?
229
282
  command.query['quotaUser'] = quota_user unless quota_user.nil?
283
+ command.query['fields'] = fields unless fields.nil?
230
284
  execute_or_queue_command(command, &block)
231
285
  end
232
286
 
233
- # Deletes the job from the project. If the job is active, the delete fails, and
234
- # the response returns FAILED_PRECONDITION.
287
+ # Creates a cluster in a project.
235
288
  # @param [String] project_id
236
- # Required. The ID of the Google Cloud Platform project that the job belongs to.
289
+ # Required. The ID of the Google Cloud Platform project that the cluster belongs
290
+ # to.
237
291
  # @param [String] region
238
292
  # Required. The Cloud Dataproc region in which to handle the request.
239
- # @param [String] job_id
240
- # Required. The job ID.
241
- # @param [String] fields
242
- # Selector specifying which fields to include in a partial response.
293
+ # @param [Google::Apis::DataprocV1::Cluster] cluster_object
243
294
  # @param [String] quota_user
244
295
  # Available to use for quota purposes for server-side applications. Can be any
245
296
  # arbitrary string assigned to a user, but should not exceed 40 characters.
297
+ # @param [String] fields
298
+ # Selector specifying which fields to include in a partial response.
246
299
  # @param [Google::Apis::RequestOptions] options
247
300
  # Request-specific options
248
301
  #
249
302
  # @yield [result, err] Result & error if block supplied
250
- # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
303
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
251
304
  # @yieldparam err [StandardError] error object if request failed
252
305
  #
253
- # @return [Google::Apis::DataprocV1::Empty]
306
+ # @return [Google::Apis::DataprocV1::Operation]
254
307
  #
255
308
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
256
309
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
257
310
  # @raise [Google::Apis::AuthorizationError] Authorization is required
258
- def delete_project_region_job(project_id, region, job_id, fields: nil, quota_user: nil, options: nil, &block)
259
- command = make_simple_command(:delete, 'v1/projects/{projectId}/regions/{region}/jobs/{jobId}', options)
260
- command.response_representation = Google::Apis::DataprocV1::Empty::Representation
261
- command.response_class = Google::Apis::DataprocV1::Empty
311
+ def create_cluster(project_id, region, cluster_object = nil, quota_user: nil, fields: nil, options: nil, &block)
312
+ command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/clusters', options)
313
+ command.request_representation = Google::Apis::DataprocV1::Cluster::Representation
314
+ command.request_object = cluster_object
315
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
316
+ command.response_class = Google::Apis::DataprocV1::Operation
262
317
  command.params['projectId'] = project_id unless project_id.nil?
263
318
  command.params['region'] = region unless region.nil?
264
- command.params['jobId'] = job_id unless job_id.nil?
265
- command.query['fields'] = fields unless fields.nil?
266
319
  command.query['quotaUser'] = quota_user unless quota_user.nil?
320
+ command.query['fields'] = fields unless fields.nil?
267
321
  execute_or_queue_command(command, &block)
268
322
  end
269
323
 
270
- # Lists regions/`region`/jobs in a project.
271
- # @param [String] project_id
272
- # Required. The ID of the Google Cloud Platform project that the job belongs to.
273
- # @param [String] region
274
- # Required. The Cloud Dataproc region in which to handle the request.
275
- # @param [String] cluster_name
276
- # Optional. If set, the returned jobs list includes only jobs that were
277
- # submitted to the named cluster.
278
- # @param [String] filter
279
- # Optional. A filter constraining the jobs to list. Filters are case-sensitive
280
- # and have the following syntax:field = value AND field = value ...where field
281
- # is status.state or labels.[KEY], and [KEY] is a label key. value can be * to
282
- # match all values. status.state can be either ACTIVE or INACTIVE. Only the
283
- # logical AND operator is supported; space-separated items are treated as having
284
- # an implicit AND operator.Example filter:status.state = ACTIVE AND labels.env =
285
- # staging AND labels.starred = *
286
- # @param [String] job_state_matcher
287
- # Optional. Specifies enumerated categories of jobs to list (default = match ALL
288
- # jobs).
289
- # @param [String] page_token
290
- # Optional. The page token, returned by a previous call, to request the next
291
- # page of results.
292
- # @param [Fixnum] page_size
293
- # Optional. The number of results to return in each response.
294
- # @param [String] fields
295
- # Selector specifying which fields to include in a partial response.
324
+ # Starts asynchronous cancellation on a long-running operation. The server makes
325
+ # a best effort to cancel the operation, but success is not guaranteed. If the
326
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
327
+ # Clients can use Operations.GetOperation or other methods to check whether the
328
+ # cancellation succeeded or whether the operation completed despite cancellation.
329
+ # On successful cancellation, the operation is not deleted; instead, it becomes
330
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
331
+ # corresponding to Code.CANCELLED.
332
+ # @param [String] name
333
+ # The name of the operation resource to be cancelled.
296
334
  # @param [String] quota_user
297
335
  # Available to use for quota purposes for server-side applications. Can be any
298
336
  # arbitrary string assigned to a user, but should not exceed 40 characters.
337
+ # @param [String] fields
338
+ # Selector specifying which fields to include in a partial response.
299
339
  # @param [Google::Apis::RequestOptions] options
300
340
  # Request-specific options
301
341
  #
302
342
  # @yield [result, err] Result & error if block supplied
303
- # @yieldparam result [Google::Apis::DataprocV1::ListJobsResponse] parsed result object
343
+ # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
304
344
  # @yieldparam err [StandardError] error object if request failed
305
345
  #
306
- # @return [Google::Apis::DataprocV1::ListJobsResponse]
346
+ # @return [Google::Apis::DataprocV1::Empty]
307
347
  #
308
348
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
309
349
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
310
350
  # @raise [Google::Apis::AuthorizationError] Authorization is required
311
- def list_project_region_jobs(project_id, region, cluster_name: nil, filter: nil, job_state_matcher: nil, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
312
- command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/jobs', options)
313
- command.response_representation = Google::Apis::DataprocV1::ListJobsResponse::Representation
314
- command.response_class = Google::Apis::DataprocV1::ListJobsResponse
315
- command.params['projectId'] = project_id unless project_id.nil?
316
- command.params['region'] = region unless region.nil?
317
- command.query['clusterName'] = cluster_name unless cluster_name.nil?
318
- command.query['filter'] = filter unless filter.nil?
319
- command.query['jobStateMatcher'] = job_state_matcher unless job_state_matcher.nil?
320
- command.query['pageToken'] = page_token unless page_token.nil?
321
- command.query['pageSize'] = page_size unless page_size.nil?
322
- command.query['fields'] = fields unless fields.nil?
351
+ def cancel_operation(name, quota_user: nil, fields: nil, options: nil, &block)
352
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
353
+ command.response_representation = Google::Apis::DataprocV1::Empty::Representation
354
+ command.response_class = Google::Apis::DataprocV1::Empty
355
+ command.params['name'] = name unless name.nil?
323
356
  command.query['quotaUser'] = quota_user unless quota_user.nil?
357
+ command.query['fields'] = fields unless fields.nil?
324
358
  execute_or_queue_command(command, &block)
325
359
  end
326
360
 
327
- # Starts a job cancellation request. To access the job resource after
328
- # cancellation, call regions/`region`/jobs.list or regions/`region`/jobs.get.
329
- # @param [String] project_id
330
- # Required. The ID of the Google Cloud Platform project that the job belongs to.
331
- # @param [String] region
332
- # Required. The Cloud Dataproc region in which to handle the request.
333
- # @param [String] job_id
334
- # Required. The job ID.
335
- # @param [Google::Apis::DataprocV1::CancelJobRequest] cancel_job_request_object
336
- # @param [String] fields
337
- # Selector specifying which fields to include in a partial response.
361
+ # Deletes a long-running operation. This method indicates that the client is no
362
+ # longer interested in the operation result. It does not cancel the operation.
363
+ # If the server doesn't support this method, it returns google.rpc.Code.
364
+ # UNIMPLEMENTED.
365
+ # @param [String] name
366
+ # The name of the operation resource to be deleted.
338
367
  # @param [String] quota_user
339
368
  # Available to use for quota purposes for server-side applications. Can be any
340
369
  # arbitrary string assigned to a user, but should not exceed 40 characters.
370
+ # @param [String] fields
371
+ # Selector specifying which fields to include in a partial response.
341
372
  # @param [Google::Apis::RequestOptions] options
342
373
  # Request-specific options
343
374
  #
344
375
  # @yield [result, err] Result & error if block supplied
345
- # @yieldparam result [Google::Apis::DataprocV1::Job] parsed result object
376
+ # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
346
377
  # @yieldparam err [StandardError] error object if request failed
347
378
  #
348
- # @return [Google::Apis::DataprocV1::Job]
379
+ # @return [Google::Apis::DataprocV1::Empty]
349
380
  #
350
381
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
351
382
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
352
383
  # @raise [Google::Apis::AuthorizationError] Authorization is required
353
- def cancel_job(project_id, region, job_id, cancel_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
354
- command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/jobs/{jobId}:cancel', options)
355
- command.request_representation = Google::Apis::DataprocV1::CancelJobRequest::Representation
356
- command.request_object = cancel_job_request_object
357
- command.response_representation = Google::Apis::DataprocV1::Job::Representation
358
- command.response_class = Google::Apis::DataprocV1::Job
359
- command.params['projectId'] = project_id unless project_id.nil?
360
- command.params['region'] = region unless region.nil?
361
- command.params['jobId'] = job_id unless job_id.nil?
362
- command.query['fields'] = fields unless fields.nil?
384
+ def delete_operation(name, quota_user: nil, fields: nil, options: nil, &block)
385
+ command = make_simple_command(:delete, 'v1/{+name}', options)
386
+ command.response_representation = Google::Apis::DataprocV1::Empty::Representation
387
+ command.response_class = Google::Apis::DataprocV1::Empty
388
+ command.params['name'] = name unless name.nil?
363
389
  command.query['quotaUser'] = quota_user unless quota_user.nil?
390
+ command.query['fields'] = fields unless fields.nil?
364
391
  execute_or_queue_command(command, &block)
365
392
  end
366
393
 
367
- # Gets the resource representation for a job in a project.
368
- # @param [String] project_id
369
- # Required. The ID of the Google Cloud Platform project that the job belongs to.
370
- # @param [String] region
371
- # Required. The Cloud Dataproc region in which to handle the request.
372
- # @param [String] job_id
373
- # Required. The job ID.
374
- # @param [String] fields
375
- # Selector specifying which fields to include in a partial response.
394
+ # Gets the latest state of a long-running operation. Clients can use this method
395
+ # to poll the operation result at intervals as recommended by the API service.
396
+ # @param [String] name
397
+ # The name of the operation resource.
376
398
  # @param [String] quota_user
377
399
  # Available to use for quota purposes for server-side applications. Can be any
378
400
  # arbitrary string assigned to a user, but should not exceed 40 characters.
401
+ # @param [String] fields
402
+ # Selector specifying which fields to include in a partial response.
379
403
  # @param [Google::Apis::RequestOptions] options
380
404
  # Request-specific options
381
405
  #
382
406
  # @yield [result, err] Result & error if block supplied
383
- # @yieldparam result [Google::Apis::DataprocV1::Job] parsed result object
407
+ # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
384
408
  # @yieldparam err [StandardError] error object if request failed
385
409
  #
386
- # @return [Google::Apis::DataprocV1::Job]
410
+ # @return [Google::Apis::DataprocV1::Operation]
387
411
  #
388
412
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
389
413
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
390
414
  # @raise [Google::Apis::AuthorizationError] Authorization is required
391
- def get_project_region_job(project_id, region, job_id, fields: nil, quota_user: nil, options: nil, &block)
392
- command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/jobs/{jobId}', options)
393
- command.response_representation = Google::Apis::DataprocV1::Job::Representation
394
- command.response_class = Google::Apis::DataprocV1::Job
395
- command.params['projectId'] = project_id unless project_id.nil?
396
- command.params['region'] = region unless region.nil?
397
- command.params['jobId'] = job_id unless job_id.nil?
415
+ def get_operation(name, quota_user: nil, fields: nil, options: nil, &block)
416
+ command = make_simple_command(:get, 'v1/{+name}', options)
417
+ command.response_representation = Google::Apis::DataprocV1::Operation::Representation
418
+ command.response_class = Google::Apis::DataprocV1::Operation
419
+ command.params['name'] = name unless name.nil?
420
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
398
421
  command.query['fields'] = fields unless fields.nil?
422
+ execute_or_queue_command(command, &block)
423
+ end
424
+
425
+ # Lists operations that match the specified filter in the request. If the server
426
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
427
+ # allows API services to override the binding to use different resource name
428
+ # schemes, such as users/*/operations. To override the binding, API services can
429
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
430
+ # configuration. For backwards compatibility, the default name includes the
431
+ # operations collection id, however overriding users must ensure the name
432
+ # binding is the parent resource, without the operations collection id.
433
+ # @param [String] name
434
+ # The name of the operation's parent resource.
435
+ # @param [String] filter
436
+ # The standard list filter.
437
+ # @param [String] page_token
438
+ # The standard list page token.
439
+ # @param [Fixnum] page_size
440
+ # The standard list page size.
441
+ # @param [String] quota_user
442
+ # Available to use for quota purposes for server-side applications. Can be any
443
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
444
+ # @param [String] fields
445
+ # Selector specifying which fields to include in a partial response.
446
+ # @param [Google::Apis::RequestOptions] options
447
+ # Request-specific options
448
+ #
449
+ # @yield [result, err] Result & error if block supplied
450
+ # @yieldparam result [Google::Apis::DataprocV1::ListOperationsResponse] parsed result object
451
+ # @yieldparam err [StandardError] error object if request failed
452
+ #
453
+ # @return [Google::Apis::DataprocV1::ListOperationsResponse]
454
+ #
455
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
456
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
457
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
458
+ def list_operations(name, filter: nil, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
459
+ command = make_simple_command(:get, 'v1/{+name}', options)
460
+ command.response_representation = Google::Apis::DataprocV1::ListOperationsResponse::Representation
461
+ command.response_class = Google::Apis::DataprocV1::ListOperationsResponse
462
+ command.params['name'] = name unless name.nil?
463
+ command.query['filter'] = filter unless filter.nil?
464
+ command.query['pageToken'] = page_token unless page_token.nil?
465
+ command.query['pageSize'] = page_size unless page_size.nil?
399
466
  command.query['quotaUser'] = quota_user unless quota_user.nil?
467
+ command.query['fields'] = fields unless fields.nil?
400
468
  execute_or_queue_command(command, &block)
401
469
  end
402
470
 
@@ -414,11 +482,11 @@ module Google
414
482
  # parameter would be specified as <code>labels</code>, and the PATCH request
415
483
  # body would specify the new value. <strong>Note:</strong> Currently, <code>
416
484
  # labels</code> is the only field that can be updated.
417
- # @param [String] fields
418
- # Selector specifying which fields to include in a partial response.
419
485
  # @param [String] quota_user
420
486
  # Available to use for quota purposes for server-side applications. Can be any
421
487
  # arbitrary string assigned to a user, but should not exceed 40 characters.
488
+ # @param [String] fields
489
+ # Selector specifying which fields to include in a partial response.
422
490
  # @param [Google::Apis::RequestOptions] options
423
491
  # Request-specific options
424
492
  #
@@ -431,7 +499,7 @@ module Google
431
499
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
432
500
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
433
501
  # @raise [Google::Apis::AuthorizationError] Authorization is required
434
- def patch_project_region_job(project_id, region, job_id, job_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
502
+ def patch_project_region_job(project_id, region, job_id, job_object = nil, update_mask: nil, quota_user: nil, fields: nil, options: nil, &block)
435
503
  command = make_simple_command(:patch, 'v1/projects/{projectId}/regions/{region}/jobs/{jobId}', options)
436
504
  command.request_representation = Google::Apis::DataprocV1::Job::Representation
437
505
  command.request_object = job_object
@@ -441,282 +509,214 @@ module Google
441
509
  command.params['region'] = region unless region.nil?
442
510
  command.params['jobId'] = job_id unless job_id.nil?
443
511
  command.query['updateMask'] = update_mask unless update_mask.nil?
444
- command.query['fields'] = fields unless fields.nil?
445
512
  command.query['quotaUser'] = quota_user unless quota_user.nil?
513
+ command.query['fields'] = fields unless fields.nil?
446
514
  execute_or_queue_command(command, &block)
447
515
  end
448
516
 
449
- # Gets the resource representation for a cluster in a project.
517
+ # Gets the resource representation for a job in a project.
450
518
  # @param [String] project_id
451
- # Required. The ID of the Google Cloud Platform project that the cluster belongs
452
- # to.
519
+ # Required. The ID of the Google Cloud Platform project that the job belongs to.
453
520
  # @param [String] region
454
521
  # Required. The Cloud Dataproc region in which to handle the request.
455
- # @param [String] cluster_name
456
- # Required. The cluster name.
457
- # @param [String] fields
458
- # Selector specifying which fields to include in a partial response.
522
+ # @param [String] job_id
523
+ # Required. The job ID.
459
524
  # @param [String] quota_user
460
525
  # Available to use for quota purposes for server-side applications. Can be any
461
526
  # arbitrary string assigned to a user, but should not exceed 40 characters.
462
- # @param [Google::Apis::RequestOptions] options
463
- # Request-specific options
464
- #
465
- # @yield [result, err] Result & error if block supplied
466
- # @yieldparam result [Google::Apis::DataprocV1::Cluster] parsed result object
467
- # @yieldparam err [StandardError] error object if request failed
468
- #
469
- # @return [Google::Apis::DataprocV1::Cluster]
470
- #
471
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
472
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
473
- # @raise [Google::Apis::AuthorizationError] Authorization is required
474
- def get_project_region_cluster(project_id, region, cluster_name, fields: nil, quota_user: nil, options: nil, &block)
475
- command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}', options)
476
- command.response_representation = Google::Apis::DataprocV1::Cluster::Representation
477
- command.response_class = Google::Apis::DataprocV1::Cluster
478
- command.params['projectId'] = project_id unless project_id.nil?
479
- command.params['region'] = region unless region.nil?
480
- command.params['clusterName'] = cluster_name unless cluster_name.nil?
481
- command.query['fields'] = fields unless fields.nil?
482
- command.query['quotaUser'] = quota_user unless quota_user.nil?
483
- execute_or_queue_command(command, &block)
484
- end
485
-
486
- # Updates a cluster in a project.
487
- # @param [String] project_id
488
- # Required. The ID of the Google Cloud Platform project the cluster belongs to.
489
- # @param [String] region
490
- # Required. The Cloud Dataproc region in which to handle the request.
491
- # @param [String] cluster_name
492
- # Required. The cluster name.
493
- # @param [Google::Apis::DataprocV1::Cluster] cluster_object
494
- # @param [String] update_mask
495
- # Required. Specifies the path, relative to Cluster, of the field to update. For
496
- # example, to change the number of workers in a cluster to 5, the update_mask
497
- # parameter would be specified as config.worker_config.num_instances, and the
498
- # PATCH request body would specify the new value, as follows:
499
- # `
500
- # "config":`
501
- # "workerConfig":`
502
- # "numInstances":"5"
503
- # `
504
- # `
505
- # `
506
- # Similarly, to change the number of preemptible workers in a cluster to 5, the
507
- # update_mask parameter would be config.secondary_worker_config.num_instances,
508
- # and the PATCH request body would be set as follows:
509
- # `
510
- # "config":`
511
- # "secondaryWorkerConfig":`
512
- # "numInstances":"5"
513
- # `
514
- # `
515
- # `
516
- # <strong>Note:</strong> Currently, only the following fields can be updated:<
517
- # table> <tbody> <tr> <td><strong>Mask</strong></td> <td><strong>Purpose</
518
- # strong></td> </tr> <tr> <td><strong><em>labels</em></strong></td> <td>
519
- # Update labels</td> </tr> <tr> <td><strong><em>config.worker_config.
520
- # num_instances</em></strong></td> <td>Resize primary worker group</td> </tr>
521
- # <tr> <td><strong><em>config.secondary_worker_config.num_instances</em></
522
- # strong></td> <td>Resize secondary worker group</td> </tr> </tbody> </table>
523
527
  # @param [String] fields
524
528
  # Selector specifying which fields to include in a partial response.
525
- # @param [String] quota_user
526
- # Available to use for quota purposes for server-side applications. Can be any
527
- # arbitrary string assigned to a user, but should not exceed 40 characters.
528
529
  # @param [Google::Apis::RequestOptions] options
529
530
  # Request-specific options
530
531
  #
531
532
  # @yield [result, err] Result & error if block supplied
532
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
533
+ # @yieldparam result [Google::Apis::DataprocV1::Job] parsed result object
533
534
  # @yieldparam err [StandardError] error object if request failed
534
535
  #
535
- # @return [Google::Apis::DataprocV1::Operation]
536
+ # @return [Google::Apis::DataprocV1::Job]
536
537
  #
537
538
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
538
539
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
539
540
  # @raise [Google::Apis::AuthorizationError] Authorization is required
540
- def patch_project_region_cluster(project_id, region, cluster_name, cluster_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
541
- command = make_simple_command(:patch, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}', options)
542
- command.request_representation = Google::Apis::DataprocV1::Cluster::Representation
543
- command.request_object = cluster_object
544
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
545
- command.response_class = Google::Apis::DataprocV1::Operation
541
+ def get_job(project_id, region, job_id, quota_user: nil, fields: nil, options: nil, &block)
542
+ command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/jobs/{jobId}', options)
543
+ command.response_representation = Google::Apis::DataprocV1::Job::Representation
544
+ command.response_class = Google::Apis::DataprocV1::Job
546
545
  command.params['projectId'] = project_id unless project_id.nil?
547
546
  command.params['region'] = region unless region.nil?
548
- command.params['clusterName'] = cluster_name unless cluster_name.nil?
549
- command.query['updateMask'] = update_mask unless update_mask.nil?
550
- command.query['fields'] = fields unless fields.nil?
547
+ command.params['jobId'] = job_id unless job_id.nil?
551
548
  command.query['quotaUser'] = quota_user unless quota_user.nil?
549
+ command.query['fields'] = fields unless fields.nil?
552
550
  execute_or_queue_command(command, &block)
553
551
  end
554
552
 
555
- # Gets cluster diagnostic information. After the operation completes, the
556
- # Operation.response field contains DiagnoseClusterOutputLocation.
553
+ # Submits a job to a cluster.
557
554
  # @param [String] project_id
558
- # Required. The ID of the Google Cloud Platform project that the cluster belongs
559
- # to.
555
+ # Required. The ID of the Google Cloud Platform project that the job belongs to.
560
556
  # @param [String] region
561
557
  # Required. The Cloud Dataproc region in which to handle the request.
562
- # @param [String] cluster_name
563
- # Required. The cluster name.
564
- # @param [Google::Apis::DataprocV1::DiagnoseClusterRequest] diagnose_cluster_request_object
565
- # @param [String] fields
566
- # Selector specifying which fields to include in a partial response.
558
+ # @param [Google::Apis::DataprocV1::SubmitJobRequest] submit_job_request_object
567
559
  # @param [String] quota_user
568
560
  # Available to use for quota purposes for server-side applications. Can be any
569
561
  # arbitrary string assigned to a user, but should not exceed 40 characters.
562
+ # @param [String] fields
563
+ # Selector specifying which fields to include in a partial response.
570
564
  # @param [Google::Apis::RequestOptions] options
571
565
  # Request-specific options
572
566
  #
573
567
  # @yield [result, err] Result & error if block supplied
574
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
568
+ # @yieldparam result [Google::Apis::DataprocV1::Job] parsed result object
575
569
  # @yieldparam err [StandardError] error object if request failed
576
570
  #
577
- # @return [Google::Apis::DataprocV1::Operation]
571
+ # @return [Google::Apis::DataprocV1::Job]
578
572
  #
579
573
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
580
574
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
581
575
  # @raise [Google::Apis::AuthorizationError] Authorization is required
582
- def diagnose_cluster(project_id, region, cluster_name, diagnose_cluster_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
583
- command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:diagnose', options)
584
- command.request_representation = Google::Apis::DataprocV1::DiagnoseClusterRequest::Representation
585
- command.request_object = diagnose_cluster_request_object
586
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
587
- command.response_class = Google::Apis::DataprocV1::Operation
576
+ def submit_job(project_id, region, submit_job_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
577
+ command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/jobs:submit', options)
578
+ command.request_representation = Google::Apis::DataprocV1::SubmitJobRequest::Representation
579
+ command.request_object = submit_job_request_object
580
+ command.response_representation = Google::Apis::DataprocV1::Job::Representation
581
+ command.response_class = Google::Apis::DataprocV1::Job
588
582
  command.params['projectId'] = project_id unless project_id.nil?
589
583
  command.params['region'] = region unless region.nil?
590
- command.params['clusterName'] = cluster_name unless cluster_name.nil?
591
- command.query['fields'] = fields unless fields.nil?
592
584
  command.query['quotaUser'] = quota_user unless quota_user.nil?
585
+ command.query['fields'] = fields unless fields.nil?
593
586
  execute_or_queue_command(command, &block)
594
587
  end
595
588
 
596
- # Deletes a cluster in a project.
589
+ # Deletes the job from the project. If the job is active, the delete fails, and
590
+ # the response returns FAILED_PRECONDITION.
597
591
  # @param [String] project_id
598
- # Required. The ID of the Google Cloud Platform project that the cluster belongs
599
- # to.
592
+ # Required. The ID of the Google Cloud Platform project that the job belongs to.
600
593
  # @param [String] region
601
594
  # Required. The Cloud Dataproc region in which to handle the request.
602
- # @param [String] cluster_name
603
- # Required. The cluster name.
604
- # @param [String] fields
605
- # Selector specifying which fields to include in a partial response.
595
+ # @param [String] job_id
596
+ # Required. The job ID.
606
597
  # @param [String] quota_user
607
598
  # Available to use for quota purposes for server-side applications. Can be any
608
599
  # arbitrary string assigned to a user, but should not exceed 40 characters.
600
+ # @param [String] fields
601
+ # Selector specifying which fields to include in a partial response.
609
602
  # @param [Google::Apis::RequestOptions] options
610
603
  # Request-specific options
611
604
  #
612
605
  # @yield [result, err] Result & error if block supplied
613
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
606
+ # @yieldparam result [Google::Apis::DataprocV1::Empty] parsed result object
614
607
  # @yieldparam err [StandardError] error object if request failed
615
608
  #
616
- # @return [Google::Apis::DataprocV1::Operation]
609
+ # @return [Google::Apis::DataprocV1::Empty]
617
610
  #
618
611
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
619
612
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
620
613
  # @raise [Google::Apis::AuthorizationError] Authorization is required
621
- def delete_project_region_cluster(project_id, region, cluster_name, fields: nil, quota_user: nil, options: nil, &block)
622
- command = make_simple_command(:delete, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}', options)
623
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
624
- command.response_class = Google::Apis::DataprocV1::Operation
614
+ def delete_job(project_id, region, job_id, quota_user: nil, fields: nil, options: nil, &block)
615
+ command = make_simple_command(:delete, 'v1/projects/{projectId}/regions/{region}/jobs/{jobId}', options)
616
+ command.response_representation = Google::Apis::DataprocV1::Empty::Representation
617
+ command.response_class = Google::Apis::DataprocV1::Empty
625
618
  command.params['projectId'] = project_id unless project_id.nil?
626
619
  command.params['region'] = region unless region.nil?
627
- command.params['clusterName'] = cluster_name unless cluster_name.nil?
628
- command.query['fields'] = fields unless fields.nil?
620
+ command.params['jobId'] = job_id unless job_id.nil?
629
621
  command.query['quotaUser'] = quota_user unless quota_user.nil?
622
+ command.query['fields'] = fields unless fields.nil?
630
623
  execute_or_queue_command(command, &block)
631
624
  end
632
625
 
633
- # Lists all regions/`region`/clusters in a project.
626
+ # Lists regions/`region`/jobs in a project.
634
627
  # @param [String] project_id
635
- # Required. The ID of the Google Cloud Platform project that the cluster belongs
636
- # to.
628
+ # Required. The ID of the Google Cloud Platform project that the job belongs to.
637
629
  # @param [String] region
638
630
  # Required. The Cloud Dataproc region in which to handle the request.
639
- # @param [Fixnum] page_size
640
- # Optional. The standard List page size.
641
631
  # @param [String] filter
642
- # Optional. A filter constraining the clusters to list. Filters are case-
643
- # sensitive and have the following syntax:field = value AND field = value ...
644
- # where field is one of status.state, clusterName, or labels.[KEY], and [KEY] is
645
- # a label key. value can be * to match all values. status.state can be one of
646
- # the following: ACTIVE, INACTIVE, CREATING, RUNNING, ERROR, DELETING, or
647
- # UPDATING. ACTIVE contains the CREATING, UPDATING, and RUNNING states. INACTIVE
648
- # contains the DELETING and ERROR states. clusterName is the name of the cluster
649
- # provided at creation time. Only the logical AND operator is supported; space-
650
- # separated items are treated as having an implicit AND operator.Example filter:
651
- # status.state = ACTIVE AND clusterName = mycluster AND labels.env = staging AND
652
- # labels.starred = *
632
+ # Optional. A filter constraining the jobs to list. Filters are case-sensitive
633
+ # and have the following syntax:field = value AND field = value ...where field
634
+ # is status.state or labels.[KEY], and [KEY] is a label key. value can be * to
635
+ # match all values. status.state can be either ACTIVE or INACTIVE. Only the
636
+ # logical AND operator is supported; space-separated items are treated as having
637
+ # an implicit AND operator.Example filter:status.state = ACTIVE AND labels.env =
638
+ # staging AND labels.starred = *
639
+ # @param [String] job_state_matcher
640
+ # Optional. Specifies enumerated categories of jobs to list (default = match ALL
641
+ # jobs).
653
642
  # @param [String] page_token
654
- # Optional. The standard List page token.
655
- # @param [String] fields
656
- # Selector specifying which fields to include in a partial response.
643
+ # Optional. The page token, returned by a previous call, to request the next
644
+ # page of results.
645
+ # @param [Fixnum] page_size
646
+ # Optional. The number of results to return in each response.
647
+ # @param [String] cluster_name
648
+ # Optional. If set, the returned jobs list includes only jobs that were
649
+ # submitted to the named cluster.
657
650
  # @param [String] quota_user
658
651
  # Available to use for quota purposes for server-side applications. Can be any
659
652
  # arbitrary string assigned to a user, but should not exceed 40 characters.
653
+ # @param [String] fields
654
+ # Selector specifying which fields to include in a partial response.
660
655
  # @param [Google::Apis::RequestOptions] options
661
656
  # Request-specific options
662
657
  #
663
658
  # @yield [result, err] Result & error if block supplied
664
- # @yieldparam result [Google::Apis::DataprocV1::ListClustersResponse] parsed result object
659
+ # @yieldparam result [Google::Apis::DataprocV1::ListJobsResponse] parsed result object
665
660
  # @yieldparam err [StandardError] error object if request failed
666
661
  #
667
- # @return [Google::Apis::DataprocV1::ListClustersResponse]
662
+ # @return [Google::Apis::DataprocV1::ListJobsResponse]
668
663
  #
669
664
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
670
665
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
671
666
  # @raise [Google::Apis::AuthorizationError] Authorization is required
672
- def list_project_region_clusters(project_id, region, page_size: nil, filter: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
673
- command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/clusters', options)
674
- command.response_representation = Google::Apis::DataprocV1::ListClustersResponse::Representation
675
- command.response_class = Google::Apis::DataprocV1::ListClustersResponse
667
+ def list_jobs(project_id, region, filter: nil, job_state_matcher: nil, page_token: nil, page_size: nil, cluster_name: nil, quota_user: nil, fields: nil, options: nil, &block)
668
+ command = make_simple_command(:get, 'v1/projects/{projectId}/regions/{region}/jobs', options)
669
+ command.response_representation = Google::Apis::DataprocV1::ListJobsResponse::Representation
670
+ command.response_class = Google::Apis::DataprocV1::ListJobsResponse
676
671
  command.params['projectId'] = project_id unless project_id.nil?
677
672
  command.params['region'] = region unless region.nil?
678
- command.query['pageSize'] = page_size unless page_size.nil?
679
673
  command.query['filter'] = filter unless filter.nil?
674
+ command.query['jobStateMatcher'] = job_state_matcher unless job_state_matcher.nil?
680
675
  command.query['pageToken'] = page_token unless page_token.nil?
681
- command.query['fields'] = fields unless fields.nil?
676
+ command.query['pageSize'] = page_size unless page_size.nil?
677
+ command.query['clusterName'] = cluster_name unless cluster_name.nil?
682
678
  command.query['quotaUser'] = quota_user unless quota_user.nil?
679
+ command.query['fields'] = fields unless fields.nil?
683
680
  execute_or_queue_command(command, &block)
684
681
  end
685
682
 
686
- # Creates a cluster in a project.
683
+ # Starts a job cancellation request. To access the job resource after
684
+ # cancellation, call regions/`region`/jobs.list or regions/`region`/jobs.get.
687
685
  # @param [String] project_id
688
- # Required. The ID of the Google Cloud Platform project that the cluster belongs
689
- # to.
686
+ # Required. The ID of the Google Cloud Platform project that the job belongs to.
690
687
  # @param [String] region
691
688
  # Required. The Cloud Dataproc region in which to handle the request.
692
- # @param [Google::Apis::DataprocV1::Cluster] cluster_object
693
- # @param [String] fields
694
- # Selector specifying which fields to include in a partial response.
689
+ # @param [String] job_id
690
+ # Required. The job ID.
691
+ # @param [Google::Apis::DataprocV1::CancelJobRequest] cancel_job_request_object
695
692
  # @param [String] quota_user
696
693
  # Available to use for quota purposes for server-side applications. Can be any
697
694
  # arbitrary string assigned to a user, but should not exceed 40 characters.
695
+ # @param [String] fields
696
+ # Selector specifying which fields to include in a partial response.
698
697
  # @param [Google::Apis::RequestOptions] options
699
698
  # Request-specific options
700
699
  #
701
700
  # @yield [result, err] Result & error if block supplied
702
- # @yieldparam result [Google::Apis::DataprocV1::Operation] parsed result object
701
+ # @yieldparam result [Google::Apis::DataprocV1::Job] parsed result object
703
702
  # @yieldparam err [StandardError] error object if request failed
704
703
  #
705
- # @return [Google::Apis::DataprocV1::Operation]
704
+ # @return [Google::Apis::DataprocV1::Job]
706
705
  #
707
706
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
708
707
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
709
708
  # @raise [Google::Apis::AuthorizationError] Authorization is required
710
- def create_project_region_cluster(project_id, region, cluster_object = nil, fields: nil, quota_user: nil, options: nil, &block)
711
- command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/clusters', options)
712
- command.request_representation = Google::Apis::DataprocV1::Cluster::Representation
713
- command.request_object = cluster_object
714
- command.response_representation = Google::Apis::DataprocV1::Operation::Representation
715
- command.response_class = Google::Apis::DataprocV1::Operation
709
+ def cancel_job(project_id, region, job_id, cancel_job_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
710
+ command = make_simple_command(:post, 'v1/projects/{projectId}/regions/{region}/jobs/{jobId}:cancel', options)
711
+ command.request_representation = Google::Apis::DataprocV1::CancelJobRequest::Representation
712
+ command.request_object = cancel_job_request_object
713
+ command.response_representation = Google::Apis::DataprocV1::Job::Representation
714
+ command.response_class = Google::Apis::DataprocV1::Job
716
715
  command.params['projectId'] = project_id unless project_id.nil?
717
716
  command.params['region'] = region unless region.nil?
718
- command.query['fields'] = fields unless fields.nil?
717
+ command.params['jobId'] = job_id unless job_id.nil?
719
718
  command.query['quotaUser'] = quota_user unless quota_user.nil?
719
+ command.query['fields'] = fields unless fields.nil?
720
720
  execute_or_queue_command(command, &block)
721
721
  end
722
722