google-api-client 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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