google-api-client 0.34.1 → 0.35.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (312) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +16 -3
  3. data/CHANGELOG.md +114 -0
  4. data/OVERVIEW.md +36 -0
  5. data/README.md +49 -1
  6. data/Rakefile +1 -1
  7. data/docs/api-keys.md +20 -0
  8. data/docs/auth.md +53 -0
  9. data/docs/client-secrets.md +69 -0
  10. data/docs/getting-started.md +340 -0
  11. data/docs/installation.md +0 -0
  12. data/docs/logging.md +34 -0
  13. data/docs/media-upload.md +25 -0
  14. data/docs/oauth-installed.md +191 -0
  15. data/docs/oauth-server.md +135 -0
  16. data/docs/oauth-web.md +280 -0
  17. data/docs/oauth.md +268 -0
  18. data/docs/pagination.md +29 -0
  19. data/docs/performance.md +25 -0
  20. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  21. data/generated/google/apis/adexchangebuyer_v1_3.rb +1 -1
  22. data/generated/google/apis/adexchangebuyer_v1_3/classes.rb +9 -0
  23. data/generated/google/apis/adexchangebuyer_v1_3/representations.rb +1 -0
  24. data/generated/google/apis/adexchangebuyer_v1_4.rb +1 -1
  25. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +9 -0
  26. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +1 -0
  27. data/generated/google/apis/androidmanagement_v1.rb +1 -1
  28. data/generated/google/apis/androidpublisher_v3.rb +1 -1
  29. data/generated/google/apis/androidpublisher_v3/classes.rb +93 -0
  30. data/generated/google/apis/androidpublisher_v3/representations.rb +49 -0
  31. data/generated/google/apis/appengine_v1.rb +1 -1
  32. data/generated/google/apis/appengine_v1beta.rb +1 -1
  33. data/generated/google/apis/appsmarket_v2.rb +1 -1
  34. data/generated/google/apis/bigquery_v2.rb +1 -1
  35. data/generated/google/apis/bigquery_v2/classes.rb +46 -4
  36. data/generated/google/apis/bigquery_v2/representations.rb +17 -0
  37. data/generated/google/apis/bigquery_v2/service.rb +1 -5
  38. data/generated/google/apis/bigqueryconnection_v1beta1.rb +1 -1
  39. data/generated/google/apis/bigqueryconnection_v1beta1/classes.rb +6 -5
  40. data/generated/google/apis/bigquerydatatransfer_v1.rb +1 -1
  41. data/generated/google/apis/bigquerydatatransfer_v1/service.rb +30 -4
  42. data/generated/google/apis/bigqueryreservation_v1.rb +1 -1
  43. data/generated/google/apis/bigqueryreservation_v1/classes.rb +0 -21
  44. data/generated/google/apis/bigqueryreservation_v1/representations.rb +0 -13
  45. data/generated/google/apis/bigqueryreservation_v1alpha2.rb +1 -1
  46. data/generated/google/apis/bigqueryreservation_v1alpha2/classes.rb +116 -1
  47. data/generated/google/apis/bigqueryreservation_v1alpha2/representations.rb +35 -0
  48. data/generated/google/apis/bigqueryreservation_v1alpha2/service.rb +71 -0
  49. data/generated/google/apis/bigqueryreservation_v1beta1.rb +1 -1
  50. data/generated/google/apis/bigqueryreservation_v1beta1/classes.rb +61 -77
  51. data/generated/google/apis/bigqueryreservation_v1beta1/representations.rb +16 -17
  52. data/generated/google/apis/bigqueryreservation_v1beta1/service.rb +112 -78
  53. data/generated/google/apis/bigtableadmin_v1.rb +1 -1
  54. data/generated/google/apis/bigtableadmin_v1/classes.rb +1 -1
  55. data/generated/google/apis/bigtableadmin_v2.rb +1 -1
  56. data/generated/google/apis/bigtableadmin_v2/classes.rb +1 -1
  57. data/generated/google/apis/bigtableadmin_v2/service.rb +1 -1
  58. data/generated/google/apis/{sqladmin_v1beta4.rb → billingbudgets_v1beta1.rb} +10 -13
  59. data/generated/google/apis/billingbudgets_v1beta1/classes.rb +392 -0
  60. data/generated/google/apis/billingbudgets_v1beta1/representations.rb +191 -0
  61. data/generated/google/apis/billingbudgets_v1beta1/service.rb +233 -0
  62. data/generated/google/apis/binaryauthorization_v1.rb +1 -1
  63. data/generated/google/apis/binaryauthorization_v1/classes.rb +6 -5
  64. data/generated/google/apis/binaryauthorization_v1beta1.rb +1 -1
  65. data/generated/google/apis/binaryauthorization_v1beta1/classes.rb +6 -5
  66. data/generated/google/apis/books_v1.rb +1 -1
  67. data/generated/google/apis/books_v1/classes.rb +20 -0
  68. data/generated/google/apis/books_v1/representations.rb +3 -0
  69. data/generated/google/apis/calendar_v3.rb +1 -1
  70. data/generated/google/apis/calendar_v3/classes.rb +1 -1
  71. data/generated/google/apis/calendar_v3/service.rb +18 -30
  72. data/generated/google/apis/civicinfo_v2.rb +1 -1
  73. data/generated/google/apis/civicinfo_v2/classes.rb +0 -156
  74. data/generated/google/apis/civicinfo_v2/representations.rb +0 -58
  75. data/generated/google/apis/cloudasset_v1.rb +1 -1
  76. data/generated/google/apis/cloudasset_v1/classes.rb +6 -5
  77. data/generated/google/apis/cloudasset_v1beta1.rb +1 -1
  78. data/generated/google/apis/cloudasset_v1beta1/classes.rb +6 -5
  79. data/generated/google/apis/cloudbilling_v1.rb +1 -1
  80. data/generated/google/apis/cloudbilling_v1/classes.rb +17 -0
  81. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  82. data/generated/google/apis/cloudbuild_v1/classes.rb +8 -2
  83. data/generated/google/apis/cloudbuild_v1/representations.rb +1 -0
  84. data/generated/google/apis/cloudbuild_v1/service.rb +18 -18
  85. data/generated/google/apis/cloudbuild_v1alpha1.rb +1 -1
  86. data/generated/google/apis/cloudbuild_v1alpha1/classes.rb +8 -2
  87. data/generated/google/apis/cloudbuild_v1alpha1/representations.rb +1 -0
  88. data/generated/google/apis/cloudbuild_v1alpha1/service.rb +4 -1
  89. data/generated/google/apis/cloudfunctions_v1.rb +1 -1
  90. data/generated/google/apis/cloudfunctions_v1/classes.rb +13 -5
  91. data/generated/google/apis/cloudfunctions_v1/representations.rb +1 -0
  92. data/generated/google/apis/cloudfunctions_v1/service.rb +3 -1
  93. data/generated/google/apis/cloudiot_v1.rb +1 -1
  94. data/generated/google/apis/cloudiot_v1/classes.rb +6 -5
  95. data/generated/google/apis/cloudkms_v1.rb +1 -1
  96. data/generated/google/apis/cloudkms_v1/classes.rb +6 -5
  97. data/generated/google/apis/cloudprivatecatalogproducer_v1beta1.rb +1 -1
  98. data/generated/google/apis/cloudprivatecatalogproducer_v1beta1/classes.rb +6 -5
  99. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  100. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +6 -5
  101. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  102. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +6 -5
  103. data/generated/google/apis/cloudresourcemanager_v2.rb +1 -1
  104. data/generated/google/apis/cloudresourcemanager_v2/classes.rb +6 -5
  105. data/generated/google/apis/cloudresourcemanager_v2beta1.rb +1 -1
  106. data/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb +6 -5
  107. data/generated/google/apis/cloudscheduler_v1.rb +1 -1
  108. data/generated/google/apis/cloudscheduler_v1/classes.rb +2 -1
  109. data/generated/google/apis/cloudscheduler_v1beta1.rb +1 -1
  110. data/generated/google/apis/cloudscheduler_v1beta1/classes.rb +2 -1
  111. data/generated/google/apis/cloudsearch_v1.rb +8 -8
  112. data/generated/google/apis/cloudsearch_v1/classes.rb +5 -130
  113. data/generated/google/apis/cloudsearch_v1/representations.rb +0 -75
  114. data/generated/google/apis/cloudsearch_v1/service.rb +42 -7
  115. data/generated/google/apis/cloudtasks_v2.rb +1 -1
  116. data/generated/google/apis/cloudtasks_v2/classes.rb +212 -5
  117. data/generated/google/apis/cloudtasks_v2/representations.rb +50 -0
  118. data/generated/google/apis/cloudtasks_v2beta2.rb +1 -1
  119. data/generated/google/apis/cloudtasks_v2beta2/classes.rb +6 -5
  120. data/generated/google/apis/cloudtasks_v2beta3.rb +1 -1
  121. data/generated/google/apis/cloudtasks_v2beta3/classes.rb +6 -5
  122. data/generated/google/apis/commentanalyzer_v1alpha1.rb +1 -1
  123. data/generated/google/apis/commentanalyzer_v1alpha1/classes.rb +14 -19
  124. data/generated/google/apis/compute_alpha.rb +1 -1
  125. data/generated/google/apis/compute_alpha/classes.rb +75 -12
  126. data/generated/google/apis/compute_alpha/representations.rb +2 -0
  127. data/generated/google/apis/compute_beta.rb +1 -1
  128. data/generated/google/apis/compute_beta/classes.rb +54 -10
  129. data/generated/google/apis/compute_v1.rb +1 -1
  130. data/generated/google/apis/compute_v1/classes.rb +54 -10
  131. data/generated/google/apis/containeranalysis_v1alpha1.rb +1 -1
  132. data/generated/google/apis/containeranalysis_v1alpha1/classes.rb +6 -5
  133. data/generated/google/apis/containeranalysis_v1beta1.rb +1 -1
  134. data/generated/google/apis/containeranalysis_v1beta1/classes.rb +6 -5
  135. data/generated/google/apis/content_v2.rb +1 -1
  136. data/generated/google/apis/content_v2/classes.rb +13 -4
  137. data/generated/google/apis/content_v2_1.rb +1 -1
  138. data/generated/google/apis/content_v2_1/classes.rb +13 -4
  139. data/generated/google/apis/datacatalog_v1beta1.rb +35 -0
  140. data/generated/google/apis/datacatalog_v1beta1/classes.rb +1646 -0
  141. data/generated/google/apis/datacatalog_v1beta1/representations.rb +700 -0
  142. data/generated/google/apis/datacatalog_v1beta1/service.rb +1982 -0
  143. data/generated/google/apis/dataproc_v1.rb +1 -1
  144. data/generated/google/apis/dataproc_v1/classes.rb +75 -4
  145. data/generated/google/apis/dataproc_v1/representations.rb +22 -0
  146. data/generated/google/apis/dataproc_v1/service.rb +14 -7
  147. data/generated/google/apis/dataproc_v1beta2.rb +1 -1
  148. data/generated/google/apis/dataproc_v1beta2/classes.rb +2 -4
  149. data/generated/google/apis/dataproc_v1beta2/service.rb +14 -7
  150. data/generated/google/apis/dfareporting_v3_3.rb +1 -1
  151. data/generated/google/apis/dfareporting_v3_3/classes.rb +21 -1
  152. data/generated/google/apis/dfareporting_v3_3/service.rb +6 -6
  153. data/generated/google/apis/dfareporting_v3_4.rb +40 -0
  154. data/generated/google/apis/dfareporting_v3_4/classes.rb +12717 -0
  155. data/generated/google/apis/dfareporting_v3_4/representations.rb +4595 -0
  156. data/generated/google/apis/dfareporting_v3_4/service.rb +8685 -0
  157. data/generated/google/apis/dialogflow_v2.rb +1 -1
  158. data/generated/google/apis/dialogflow_v2/classes.rb +484 -1
  159. data/generated/google/apis/dialogflow_v2/representations.rb +220 -0
  160. data/generated/google/apis/dialogflow_v2beta1.rb +1 -1
  161. data/generated/google/apis/dialogflow_v2beta1/classes.rb +497 -1
  162. data/generated/google/apis/dialogflow_v2beta1/representations.rb +221 -0
  163. data/generated/google/apis/dlp_v2.rb +1 -1
  164. data/generated/google/apis/dlp_v2/classes.rb +68 -25
  165. data/generated/google/apis/dlp_v2/representations.rb +9 -4
  166. data/generated/google/apis/dlp_v2/service.rb +1925 -193
  167. data/generated/google/apis/dns_v1beta2.rb +1 -1
  168. data/generated/google/apis/dns_v1beta2/classes.rb +47 -0
  169. data/generated/google/apis/dns_v1beta2/representations.rb +17 -0
  170. data/generated/google/apis/docs_v1.rb +1 -1
  171. data/generated/google/apis/docs_v1/classes.rb +4 -8
  172. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  173. data/generated/google/apis/doubleclickbidmanager_v1_1.rb +34 -0
  174. data/generated/google/apis/doubleclickbidmanager_v1_1/classes.rb +826 -0
  175. data/generated/google/apis/doubleclickbidmanager_v1_1/representations.rb +372 -0
  176. data/generated/google/apis/doubleclickbidmanager_v1_1/service.rb +371 -0
  177. data/generated/google/apis/drive_v3.rb +1 -1
  178. data/generated/google/apis/drive_v3/classes.rb +12 -3
  179. data/generated/google/apis/fcm_v1.rb +1 -1
  180. data/generated/google/apis/fcm_v1/classes.rb +15 -0
  181. data/generated/google/apis/fcm_v1/representations.rb +2 -0
  182. data/generated/google/apis/firebase_v1beta1.rb +1 -1
  183. data/generated/google/apis/firebase_v1beta1/classes.rb +3 -4
  184. data/generated/google/apis/firebase_v1beta1/service.rb +6 -6
  185. data/generated/google/apis/firebasehosting_v1beta1.rb +1 -1
  186. data/generated/google/apis/firebasehosting_v1beta1/classes.rb +25 -0
  187. data/generated/google/apis/firebasehosting_v1beta1/representations.rb +15 -0
  188. data/generated/google/apis/firebasehosting_v1beta1/service.rb +47 -0
  189. data/generated/google/apis/firebaserules_v1.rb +1 -1
  190. data/generated/google/apis/firebaserules_v1/classes.rb +26 -0
  191. data/generated/google/apis/firebaserules_v1/representations.rb +15 -0
  192. data/generated/google/apis/genomics_v2alpha1.rb +1 -1
  193. data/generated/google/apis/genomics_v2alpha1/classes.rb +32 -0
  194. data/generated/google/apis/genomics_v2alpha1/representations.rb +16 -0
  195. data/generated/google/apis/healthcare_v1beta1.rb +1 -1
  196. data/generated/google/apis/healthcare_v1beta1/classes.rb +8 -7
  197. data/generated/google/apis/homegraph_v1.rb +1 -1
  198. data/generated/google/apis/homegraph_v1/classes.rb +15 -1
  199. data/generated/google/apis/homegraph_v1/representations.rb +2 -1
  200. data/generated/google/apis/iam_v1.rb +1 -1
  201. data/generated/google/apis/iam_v1/classes.rb +6 -5
  202. data/generated/google/apis/logging_v2.rb +1 -1
  203. data/generated/google/apis/logging_v2/classes.rb +18 -2
  204. data/generated/google/apis/logging_v2/representations.rb +2 -0
  205. data/generated/google/apis/ml_v1.rb +1 -1
  206. data/generated/google/apis/ml_v1/classes.rb +173 -97
  207. data/generated/google/apis/ml_v1/representations.rb +58 -0
  208. data/generated/google/apis/ml_v1/service.rb +37 -0
  209. data/generated/google/apis/monitoring_v3.rb +1 -1
  210. data/generated/google/apis/monitoring_v3/classes.rb +780 -6
  211. data/generated/google/apis/monitoring_v3/representations.rb +347 -0
  212. data/generated/google/apis/monitoring_v3/service.rb +382 -0
  213. data/generated/google/apis/pagespeedonline_v5.rb +1 -1
  214. data/generated/google/apis/pagespeedonline_v5/classes.rb +8 -0
  215. data/generated/google/apis/pagespeedonline_v5/representations.rb +1 -0
  216. data/generated/google/apis/policytroubleshooter_v1beta.rb +1 -1
  217. data/generated/google/apis/policytroubleshooter_v1beta/classes.rb +6 -5
  218. data/generated/google/apis/pubsub_v1.rb +1 -1
  219. data/generated/google/apis/pubsub_v1/classes.rb +8 -6
  220. data/generated/google/apis/pubsub_v1/service.rb +6 -7
  221. data/generated/google/apis/pubsub_v1beta2.rb +1 -1
  222. data/generated/google/apis/pubsub_v1beta2/classes.rb +6 -5
  223. data/generated/google/apis/recommender_v1beta1.rb +1 -1
  224. data/generated/google/apis/recommender_v1beta1/classes.rb +1 -1
  225. data/generated/google/apis/recommender_v1beta1/service.rb +10 -8
  226. data/generated/google/apis/remotebuildexecution_v1.rb +1 -1
  227. data/generated/google/apis/remotebuildexecution_v1/classes.rb +33 -0
  228. data/generated/google/apis/remotebuildexecution_v1/representations.rb +15 -0
  229. data/generated/google/apis/remotebuildexecution_v1alpha.rb +1 -1
  230. data/generated/google/apis/remotebuildexecution_v1alpha/classes.rb +33 -0
  231. data/generated/google/apis/remotebuildexecution_v1alpha/representations.rb +15 -0
  232. data/generated/google/apis/remotebuildexecution_v2.rb +1 -1
  233. data/generated/google/apis/remotebuildexecution_v2/classes.rb +33 -0
  234. data/generated/google/apis/remotebuildexecution_v2/representations.rb +15 -0
  235. data/generated/google/apis/run_v1.rb +1 -1
  236. data/generated/google/apis/run_v1/classes.rb +8 -169
  237. data/generated/google/apis/run_v1/representations.rb +0 -71
  238. data/generated/google/apis/run_v1/service.rb +229 -1207
  239. data/generated/google/apis/run_v1alpha1.rb +1 -1
  240. data/generated/google/apis/run_v1alpha1/classes.rb +9 -9
  241. data/generated/google/apis/runtimeconfig_v1beta1.rb +1 -1
  242. data/generated/google/apis/runtimeconfig_v1beta1/classes.rb +6 -5
  243. data/generated/google/apis/securitycenter_v1.rb +1 -1
  244. data/generated/google/apis/securitycenter_v1/classes.rb +66 -11
  245. data/generated/google/apis/securitycenter_v1/representations.rb +19 -0
  246. data/generated/google/apis/securitycenter_v1beta1.rb +1 -1
  247. data/generated/google/apis/securitycenter_v1beta1/classes.rb +16 -13
  248. data/generated/google/apis/servicebroker_v1.rb +1 -1
  249. data/generated/google/apis/servicebroker_v1/classes.rb +6 -5
  250. data/generated/google/apis/servicebroker_v1alpha1.rb +1 -1
  251. data/generated/google/apis/servicebroker_v1alpha1/classes.rb +6 -5
  252. data/generated/google/apis/servicebroker_v1beta1.rb +1 -1
  253. data/generated/google/apis/servicebroker_v1beta1/classes.rb +6 -5
  254. data/generated/google/apis/serviceconsumermanagement_v1.rb +1 -1
  255. data/generated/google/apis/serviceconsumermanagement_v1/classes.rb +3 -2
  256. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  257. data/generated/google/apis/servicecontrol_v1/classes.rb +8 -1
  258. data/generated/google/apis/servicecontrol_v1/representations.rb +1 -0
  259. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  260. data/generated/google/apis/servicemanagement_v1/classes.rb +12 -9
  261. data/generated/google/apis/servicemanagement_v1/service.rb +1 -9
  262. data/generated/google/apis/servicenetworking_v1.rb +1 -1
  263. data/generated/google/apis/servicenetworking_v1/classes.rb +130 -13
  264. data/generated/google/apis/servicenetworking_v1/representations.rb +58 -0
  265. data/generated/google/apis/servicenetworking_v1/service.rb +42 -3
  266. data/generated/google/apis/servicenetworking_v1beta.rb +1 -1
  267. data/generated/google/apis/servicenetworking_v1beta/classes.rb +3 -2
  268. data/generated/google/apis/serviceusage_v1.rb +1 -1
  269. data/generated/google/apis/serviceusage_v1/classes.rb +3 -2
  270. data/generated/google/apis/serviceusage_v1beta1.rb +1 -1
  271. data/generated/google/apis/serviceusage_v1beta1/classes.rb +3 -2
  272. data/generated/google/apis/sheets_v4.rb +1 -1
  273. data/generated/google/apis/spanner_v1.rb +1 -1
  274. data/generated/google/apis/spanner_v1/classes.rb +70 -30
  275. data/generated/google/apis/spanner_v1/service.rb +270 -0
  276. data/generated/google/apis/speech_v1.rb +1 -1
  277. data/generated/google/apis/speech_v1/classes.rb +6 -0
  278. data/generated/google/apis/speech_v1/representations.rb +1 -0
  279. data/generated/google/apis/speech_v1p1beta1.rb +1 -1
  280. data/generated/google/apis/speech_v1p1beta1/classes.rb +6 -0
  281. data/generated/google/apis/speech_v1p1beta1/representations.rb +1 -0
  282. data/generated/google/apis/sql_v1beta4.rb +1 -1
  283. data/generated/google/apis/sql_v1beta4/service.rb +59 -10
  284. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  285. data/generated/google/apis/videointelligence_v1.rb +1 -1
  286. data/generated/google/apis/videointelligence_v1/classes.rb +112 -0
  287. data/generated/google/apis/videointelligence_v1/representations.rb +62 -0
  288. data/generated/google/apis/videointelligence_v1beta2.rb +1 -1
  289. data/generated/google/apis/videointelligence_v1beta2/classes.rb +112 -0
  290. data/generated/google/apis/videointelligence_v1beta2/representations.rb +62 -0
  291. data/generated/google/apis/videointelligence_v1p1beta1.rb +1 -1
  292. data/generated/google/apis/videointelligence_v1p1beta1/classes.rb +112 -0
  293. data/generated/google/apis/videointelligence_v1p1beta1/representations.rb +62 -0
  294. data/generated/google/apis/videointelligence_v1p2beta1.rb +1 -1
  295. data/generated/google/apis/videointelligence_v1p2beta1/classes.rb +112 -0
  296. data/generated/google/apis/videointelligence_v1p2beta1/representations.rb +62 -0
  297. data/generated/google/apis/videointelligence_v1p3beta1.rb +1 -1
  298. data/generated/google/apis/videointelligence_v1p3beta1/classes.rb +112 -0
  299. data/generated/google/apis/videointelligence_v1p3beta1/representations.rb +62 -0
  300. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  301. data/lib/google/apis/core/api_command.rb +3 -0
  302. data/lib/google/apis/core/http_command.rb +10 -8
  303. data/lib/google/apis/version.rb +1 -1
  304. data/rakelib/devsite/devsite_builder.rb +1 -1
  305. metadata +33 -11
  306. data/generated/google/apis/sqladmin_v1beta4/classes.rb +0 -2633
  307. data/generated/google/apis/sqladmin_v1beta4/representations.rb +0 -1110
  308. data/generated/google/apis/sqladmin_v1beta4/service.rb +0 -1793
  309. data/generated/google/apis/storage_v1beta1.rb +0 -40
  310. data/generated/google/apis/storage_v1beta1/classes.rb +0 -616
  311. data/generated/google/apis/storage_v1beta1/representations.rb +0 -249
  312. data/generated/google/apis/storage_v1beta1/service.rb +0 -1032
@@ -1,1793 +0,0 @@
1
- # Copyright 2015 Google Inc.
2
- #
3
- # Licensed under the Apache License, Version 2.0 (the "License");
4
- # you may not use this file except in compliance with the License.
5
- # You may obtain a copy of the License at
6
- #
7
- # http://www.apache.org/licenses/LICENSE-2.0
8
- #
9
- # Unless required by applicable law or agreed to in writing, software
10
- # distributed under the License is distributed on an "AS IS" BASIS,
11
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- # See the License for the specific language governing permissions and
13
- # limitations under the License.
14
-
15
- require 'google/apis/core/base_service'
16
- require 'google/apis/core/json_representation'
17
- require 'google/apis/core/hashable'
18
- require 'google/apis/errors'
19
-
20
- module Google
21
- module Apis
22
- module SqladminV1beta4
23
- # Cloud SQL Admin API
24
- #
25
- # Creates and manages Cloud SQL instances, which provide fully managed MySQL or
26
- # PostgreSQL databases.
27
- #
28
- # @example
29
- # require 'google/apis/sqladmin_v1beta4'
30
- #
31
- # Sqladmin = Google::Apis::SqladminV1beta4 # Alias the module
32
- # service = Sqladmin::SQLAdminService.new
33
- #
34
- # @see https://cloud.google.com/sql/docs/reference/latest
35
- class SQLAdminService < Google::Apis::Core::BaseService
36
- # @return [String]
37
- # API key. Your API key identifies your project and provides you with API access,
38
- # quota, and reports. Required unless you provide an OAuth 2.0 token.
39
- attr_accessor :key
40
-
41
- # @return [String]
42
- # An opaque string that represents a user for quota purposes. Must not exceed 40
43
- # characters.
44
- attr_accessor :quota_user
45
-
46
- # @return [String]
47
- # Deprecated. Please use quotaUser instead.
48
- attr_accessor :user_ip
49
-
50
- def initialize
51
- super('https://www.googleapis.com/', 'sql/v1beta4/')
52
- @batch_path = 'batch/sqladmin/v1beta4'
53
- end
54
-
55
- # Deletes the backup taken by a backup run.
56
- # @param [String] project
57
- # Project ID of the project that contains the instance.
58
- # @param [String] instance
59
- # Cloud SQL instance ID. This does not include the project ID.
60
- # @param [Fixnum] id
61
- # The ID of the Backup Run to delete. To find a Backup Run ID, use the list
62
- # method.
63
- # @param [String] fields
64
- # Selector specifying which fields to include in a partial response.
65
- # @param [String] quota_user
66
- # An opaque string that represents a user for quota purposes. Must not exceed 40
67
- # characters.
68
- # @param [String] user_ip
69
- # Deprecated. Please use quotaUser instead.
70
- # @param [Google::Apis::RequestOptions] options
71
- # Request-specific options
72
- #
73
- # @yield [result, err] Result & error if block supplied
74
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
75
- # @yieldparam err [StandardError] error object if request failed
76
- #
77
- # @return [Google::Apis::SqladminV1beta4::Operation]
78
- #
79
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
80
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
81
- # @raise [Google::Apis::AuthorizationError] Authorization is required
82
- def delete_backup_run(project, instance, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
83
- command = make_simple_command(:delete, 'projects/{project}/instances/{instance}/backupRuns/{id}', options)
84
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
85
- command.response_class = Google::Apis::SqladminV1beta4::Operation
86
- command.params['project'] = project unless project.nil?
87
- command.params['instance'] = instance unless instance.nil?
88
- command.params['id'] = id unless id.nil?
89
- command.query['fields'] = fields unless fields.nil?
90
- command.query['quotaUser'] = quota_user unless quota_user.nil?
91
- command.query['userIp'] = user_ip unless user_ip.nil?
92
- execute_or_queue_command(command, &block)
93
- end
94
-
95
- # Retrieves a resource containing information about a backup run.
96
- # @param [String] project
97
- # Project ID of the project that contains the instance.
98
- # @param [String] instance
99
- # Cloud SQL instance ID. This does not include the project ID.
100
- # @param [Fixnum] id
101
- # The ID of this Backup Run.
102
- # @param [String] fields
103
- # Selector specifying which fields to include in a partial response.
104
- # @param [String] quota_user
105
- # An opaque string that represents a user for quota purposes. Must not exceed 40
106
- # characters.
107
- # @param [String] user_ip
108
- # Deprecated. Please use quotaUser instead.
109
- # @param [Google::Apis::RequestOptions] options
110
- # Request-specific options
111
- #
112
- # @yield [result, err] Result & error if block supplied
113
- # @yieldparam result [Google::Apis::SqladminV1beta4::BackupRun] parsed result object
114
- # @yieldparam err [StandardError] error object if request failed
115
- #
116
- # @return [Google::Apis::SqladminV1beta4::BackupRun]
117
- #
118
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
119
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
120
- # @raise [Google::Apis::AuthorizationError] Authorization is required
121
- def get_backup_run(project, instance, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
122
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/backupRuns/{id}', options)
123
- command.response_representation = Google::Apis::SqladminV1beta4::BackupRun::Representation
124
- command.response_class = Google::Apis::SqladminV1beta4::BackupRun
125
- command.params['project'] = project unless project.nil?
126
- command.params['instance'] = instance unless instance.nil?
127
- command.params['id'] = id unless id.nil?
128
- command.query['fields'] = fields unless fields.nil?
129
- command.query['quotaUser'] = quota_user unless quota_user.nil?
130
- command.query['userIp'] = user_ip unless user_ip.nil?
131
- execute_or_queue_command(command, &block)
132
- end
133
-
134
- # Creates a new backup run on demand. This method is applicable only to Second
135
- # Generation instances.
136
- # @param [String] project
137
- # Project ID of the project that contains the instance.
138
- # @param [String] instance
139
- # Cloud SQL instance ID. This does not include the project ID.
140
- # @param [Google::Apis::SqladminV1beta4::BackupRun] backup_run_object
141
- # @param [String] fields
142
- # Selector specifying which fields to include in a partial response.
143
- # @param [String] quota_user
144
- # An opaque string that represents a user for quota purposes. Must not exceed 40
145
- # characters.
146
- # @param [String] user_ip
147
- # Deprecated. Please use quotaUser instead.
148
- # @param [Google::Apis::RequestOptions] options
149
- # Request-specific options
150
- #
151
- # @yield [result, err] Result & error if block supplied
152
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
153
- # @yieldparam err [StandardError] error object if request failed
154
- #
155
- # @return [Google::Apis::SqladminV1beta4::Operation]
156
- #
157
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
158
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
159
- # @raise [Google::Apis::AuthorizationError] Authorization is required
160
- def insert_backup_run(project, instance, backup_run_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
161
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/backupRuns', options)
162
- command.request_representation = Google::Apis::SqladminV1beta4::BackupRun::Representation
163
- command.request_object = backup_run_object
164
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
165
- command.response_class = Google::Apis::SqladminV1beta4::Operation
166
- command.params['project'] = project unless project.nil?
167
- command.params['instance'] = instance unless instance.nil?
168
- command.query['fields'] = fields unless fields.nil?
169
- command.query['quotaUser'] = quota_user unless quota_user.nil?
170
- command.query['userIp'] = user_ip unless user_ip.nil?
171
- execute_or_queue_command(command, &block)
172
- end
173
-
174
- # Lists all backup runs associated with a given instance and configuration in
175
- # the reverse chronological order of the backup initiation time.
176
- # @param [String] project
177
- # Project ID of the project that contains the instance.
178
- # @param [String] instance
179
- # Cloud SQL instance ID. This does not include the project ID.
180
- # @param [Fixnum] max_results
181
- # Maximum number of backup runs per response.
182
- # @param [String] page_token
183
- # A previously-returned page token representing part of the larger set of
184
- # results to view.
185
- # @param [String] fields
186
- # Selector specifying which fields to include in a partial response.
187
- # @param [String] quota_user
188
- # An opaque string that represents a user for quota purposes. Must not exceed 40
189
- # characters.
190
- # @param [String] user_ip
191
- # Deprecated. Please use quotaUser instead.
192
- # @param [Google::Apis::RequestOptions] options
193
- # Request-specific options
194
- #
195
- # @yield [result, err] Result & error if block supplied
196
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListBackupRunsResponse] parsed result object
197
- # @yieldparam err [StandardError] error object if request failed
198
- #
199
- # @return [Google::Apis::SqladminV1beta4::ListBackupRunsResponse]
200
- #
201
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
202
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
203
- # @raise [Google::Apis::AuthorizationError] Authorization is required
204
- def list_backup_runs(project, instance, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
205
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/backupRuns', options)
206
- command.response_representation = Google::Apis::SqladminV1beta4::ListBackupRunsResponse::Representation
207
- command.response_class = Google::Apis::SqladminV1beta4::ListBackupRunsResponse
208
- command.params['project'] = project unless project.nil?
209
- command.params['instance'] = instance unless instance.nil?
210
- command.query['maxResults'] = max_results unless max_results.nil?
211
- command.query['pageToken'] = page_token unless page_token.nil?
212
- command.query['fields'] = fields unless fields.nil?
213
- command.query['quotaUser'] = quota_user unless quota_user.nil?
214
- command.query['userIp'] = user_ip unless user_ip.nil?
215
- execute_or_queue_command(command, &block)
216
- end
217
-
218
- # Deletes a database from a Cloud SQL instance.
219
- # @param [String] project
220
- # Project ID of the project that contains the instance.
221
- # @param [String] instance
222
- # Database instance ID. This does not include the project ID.
223
- # @param [String] database
224
- # Name of the database to be deleted in the instance.
225
- # @param [String] fields
226
- # Selector specifying which fields to include in a partial response.
227
- # @param [String] quota_user
228
- # An opaque string that represents a user for quota purposes. Must not exceed 40
229
- # characters.
230
- # @param [String] user_ip
231
- # Deprecated. Please use quotaUser instead.
232
- # @param [Google::Apis::RequestOptions] options
233
- # Request-specific options
234
- #
235
- # @yield [result, err] Result & error if block supplied
236
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
237
- # @yieldparam err [StandardError] error object if request failed
238
- #
239
- # @return [Google::Apis::SqladminV1beta4::Operation]
240
- #
241
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
242
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
243
- # @raise [Google::Apis::AuthorizationError] Authorization is required
244
- def delete_database(project, instance, database, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
245
- command = make_simple_command(:delete, 'projects/{project}/instances/{instance}/databases/{database}', options)
246
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
247
- command.response_class = Google::Apis::SqladminV1beta4::Operation
248
- command.params['project'] = project unless project.nil?
249
- command.params['instance'] = instance unless instance.nil?
250
- command.params['database'] = database unless database.nil?
251
- command.query['fields'] = fields unless fields.nil?
252
- command.query['quotaUser'] = quota_user unless quota_user.nil?
253
- command.query['userIp'] = user_ip unless user_ip.nil?
254
- execute_or_queue_command(command, &block)
255
- end
256
-
257
- # Retrieves a resource containing information about a database inside a Cloud
258
- # SQL instance.
259
- # @param [String] project
260
- # Project ID of the project that contains the instance.
261
- # @param [String] instance
262
- # Database instance ID. This does not include the project ID.
263
- # @param [String] database
264
- # Name of the database in the instance.
265
- # @param [String] fields
266
- # Selector specifying which fields to include in a partial response.
267
- # @param [String] quota_user
268
- # An opaque string that represents a user for quota purposes. Must not exceed 40
269
- # characters.
270
- # @param [String] user_ip
271
- # Deprecated. Please use quotaUser instead.
272
- # @param [Google::Apis::RequestOptions] options
273
- # Request-specific options
274
- #
275
- # @yield [result, err] Result & error if block supplied
276
- # @yieldparam result [Google::Apis::SqladminV1beta4::Database] parsed result object
277
- # @yieldparam err [StandardError] error object if request failed
278
- #
279
- # @return [Google::Apis::SqladminV1beta4::Database]
280
- #
281
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
282
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
283
- # @raise [Google::Apis::AuthorizationError] Authorization is required
284
- def get_database(project, instance, database, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
285
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/databases/{database}', options)
286
- command.response_representation = Google::Apis::SqladminV1beta4::Database::Representation
287
- command.response_class = Google::Apis::SqladminV1beta4::Database
288
- command.params['project'] = project unless project.nil?
289
- command.params['instance'] = instance unless instance.nil?
290
- command.params['database'] = database unless database.nil?
291
- command.query['fields'] = fields unless fields.nil?
292
- command.query['quotaUser'] = quota_user unless quota_user.nil?
293
- command.query['userIp'] = user_ip unless user_ip.nil?
294
- execute_or_queue_command(command, &block)
295
- end
296
-
297
- # Inserts a resource containing information about a database inside a Cloud SQL
298
- # instance.
299
- # @param [String] project
300
- # Project ID of the project that contains the instance.
301
- # @param [String] instance
302
- # Database instance ID. This does not include the project ID.
303
- # @param [Google::Apis::SqladminV1beta4::Database] database_object
304
- # @param [String] fields
305
- # Selector specifying which fields to include in a partial response.
306
- # @param [String] quota_user
307
- # An opaque string that represents a user for quota purposes. Must not exceed 40
308
- # characters.
309
- # @param [String] user_ip
310
- # Deprecated. Please use quotaUser instead.
311
- # @param [Google::Apis::RequestOptions] options
312
- # Request-specific options
313
- #
314
- # @yield [result, err] Result & error if block supplied
315
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
316
- # @yieldparam err [StandardError] error object if request failed
317
- #
318
- # @return [Google::Apis::SqladminV1beta4::Operation]
319
- #
320
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
321
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
322
- # @raise [Google::Apis::AuthorizationError] Authorization is required
323
- def insert_database(project, instance, database_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
324
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/databases', options)
325
- command.request_representation = Google::Apis::SqladminV1beta4::Database::Representation
326
- command.request_object = database_object
327
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
328
- command.response_class = Google::Apis::SqladminV1beta4::Operation
329
- command.params['project'] = project unless project.nil?
330
- command.params['instance'] = instance unless instance.nil?
331
- command.query['fields'] = fields unless fields.nil?
332
- command.query['quotaUser'] = quota_user unless quota_user.nil?
333
- command.query['userIp'] = user_ip unless user_ip.nil?
334
- execute_or_queue_command(command, &block)
335
- end
336
-
337
- # Lists databases in the specified Cloud SQL instance.
338
- # @param [String] project
339
- # Project ID of the project that contains the instance.
340
- # @param [String] instance
341
- # Cloud SQL instance ID. This does not include the project ID.
342
- # @param [String] fields
343
- # Selector specifying which fields to include in a partial response.
344
- # @param [String] quota_user
345
- # An opaque string that represents a user for quota purposes. Must not exceed 40
346
- # characters.
347
- # @param [String] user_ip
348
- # Deprecated. Please use quotaUser instead.
349
- # @param [Google::Apis::RequestOptions] options
350
- # Request-specific options
351
- #
352
- # @yield [result, err] Result & error if block supplied
353
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListDatabasesResponse] parsed result object
354
- # @yieldparam err [StandardError] error object if request failed
355
- #
356
- # @return [Google::Apis::SqladminV1beta4::ListDatabasesResponse]
357
- #
358
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
359
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
360
- # @raise [Google::Apis::AuthorizationError] Authorization is required
361
- def list_databases(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
362
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/databases', options)
363
- command.response_representation = Google::Apis::SqladminV1beta4::ListDatabasesResponse::Representation
364
- command.response_class = Google::Apis::SqladminV1beta4::ListDatabasesResponse
365
- command.params['project'] = project unless project.nil?
366
- command.params['instance'] = instance unless instance.nil?
367
- command.query['fields'] = fields unless fields.nil?
368
- command.query['quotaUser'] = quota_user unless quota_user.nil?
369
- command.query['userIp'] = user_ip unless user_ip.nil?
370
- execute_or_queue_command(command, &block)
371
- end
372
-
373
- # Updates a resource containing information about a database inside a Cloud SQL
374
- # instance. This method supports patch semantics.
375
- # @param [String] project
376
- # Project ID of the project that contains the instance.
377
- # @param [String] instance
378
- # Database instance ID. This does not include the project ID.
379
- # @param [String] database
380
- # Name of the database to be updated in the instance.
381
- # @param [Google::Apis::SqladminV1beta4::Database] database_object
382
- # @param [String] fields
383
- # Selector specifying which fields to include in a partial response.
384
- # @param [String] quota_user
385
- # An opaque string that represents a user for quota purposes. Must not exceed 40
386
- # characters.
387
- # @param [String] user_ip
388
- # Deprecated. Please use quotaUser instead.
389
- # @param [Google::Apis::RequestOptions] options
390
- # Request-specific options
391
- #
392
- # @yield [result, err] Result & error if block supplied
393
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
394
- # @yieldparam err [StandardError] error object if request failed
395
- #
396
- # @return [Google::Apis::SqladminV1beta4::Operation]
397
- #
398
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
399
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
400
- # @raise [Google::Apis::AuthorizationError] Authorization is required
401
- def patch_database(project, instance, database, database_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
402
- command = make_simple_command(:patch, 'projects/{project}/instances/{instance}/databases/{database}', options)
403
- command.request_representation = Google::Apis::SqladminV1beta4::Database::Representation
404
- command.request_object = database_object
405
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
406
- command.response_class = Google::Apis::SqladminV1beta4::Operation
407
- command.params['project'] = project unless project.nil?
408
- command.params['instance'] = instance unless instance.nil?
409
- command.params['database'] = database unless database.nil?
410
- command.query['fields'] = fields unless fields.nil?
411
- command.query['quotaUser'] = quota_user unless quota_user.nil?
412
- command.query['userIp'] = user_ip unless user_ip.nil?
413
- execute_or_queue_command(command, &block)
414
- end
415
-
416
- # Updates a resource containing information about a database inside a Cloud SQL
417
- # instance.
418
- # @param [String] project
419
- # Project ID of the project that contains the instance.
420
- # @param [String] instance
421
- # Database instance ID. This does not include the project ID.
422
- # @param [String] database
423
- # Name of the database to be updated in the instance.
424
- # @param [Google::Apis::SqladminV1beta4::Database] database_object
425
- # @param [String] fields
426
- # Selector specifying which fields to include in a partial response.
427
- # @param [String] quota_user
428
- # An opaque string that represents a user for quota purposes. Must not exceed 40
429
- # characters.
430
- # @param [String] user_ip
431
- # Deprecated. Please use quotaUser instead.
432
- # @param [Google::Apis::RequestOptions] options
433
- # Request-specific options
434
- #
435
- # @yield [result, err] Result & error if block supplied
436
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
437
- # @yieldparam err [StandardError] error object if request failed
438
- #
439
- # @return [Google::Apis::SqladminV1beta4::Operation]
440
- #
441
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
442
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
443
- # @raise [Google::Apis::AuthorizationError] Authorization is required
444
- def update_database(project, instance, database, database_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
445
- command = make_simple_command(:put, 'projects/{project}/instances/{instance}/databases/{database}', options)
446
- command.request_representation = Google::Apis::SqladminV1beta4::Database::Representation
447
- command.request_object = database_object
448
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
449
- command.response_class = Google::Apis::SqladminV1beta4::Operation
450
- command.params['project'] = project unless project.nil?
451
- command.params['instance'] = instance unless instance.nil?
452
- command.params['database'] = database unless database.nil?
453
- command.query['fields'] = fields unless fields.nil?
454
- command.query['quotaUser'] = quota_user unless quota_user.nil?
455
- command.query['userIp'] = user_ip unless user_ip.nil?
456
- execute_or_queue_command(command, &block)
457
- end
458
-
459
- # List all available database flags for Cloud SQL instances.
460
- # @param [String] database_version
461
- # Database type and version you want to retrieve flags for. By default, this
462
- # method returns flags for all database types and versions.
463
- # @param [String] fields
464
- # Selector specifying which fields to include in a partial response.
465
- # @param [String] quota_user
466
- # An opaque string that represents a user for quota purposes. Must not exceed 40
467
- # characters.
468
- # @param [String] user_ip
469
- # Deprecated. Please use quotaUser instead.
470
- # @param [Google::Apis::RequestOptions] options
471
- # Request-specific options
472
- #
473
- # @yield [result, err] Result & error if block supplied
474
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListFlagsResponse] parsed result object
475
- # @yieldparam err [StandardError] error object if request failed
476
- #
477
- # @return [Google::Apis::SqladminV1beta4::ListFlagsResponse]
478
- #
479
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
480
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
481
- # @raise [Google::Apis::AuthorizationError] Authorization is required
482
- def list_flags(database_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
483
- command = make_simple_command(:get, 'flags', options)
484
- command.response_representation = Google::Apis::SqladminV1beta4::ListFlagsResponse::Representation
485
- command.response_class = Google::Apis::SqladminV1beta4::ListFlagsResponse
486
- command.query['databaseVersion'] = database_version unless database_version.nil?
487
- command.query['fields'] = fields unless fields.nil?
488
- command.query['quotaUser'] = quota_user unless quota_user.nil?
489
- command.query['userIp'] = user_ip unless user_ip.nil?
490
- execute_or_queue_command(command, &block)
491
- end
492
-
493
- # Add a new trusted Certificate Authority (CA) version for the specified
494
- # instance. Required to prepare for a certificate rotation. If a CA version was
495
- # previously added but never used in a certificate rotation, this operation
496
- # replaces that version. There cannot be more than one CA version waiting to be
497
- # rotated in.
498
- # @param [String] project
499
- # Project ID of the project that contains the instance.
500
- # @param [String] instance
501
- # Cloud SQL instance ID. This does not include the project ID.
502
- # @param [String] fields
503
- # Selector specifying which fields to include in a partial response.
504
- # @param [String] quota_user
505
- # An opaque string that represents a user for quota purposes. Must not exceed 40
506
- # characters.
507
- # @param [String] user_ip
508
- # Deprecated. Please use quotaUser instead.
509
- # @param [Google::Apis::RequestOptions] options
510
- # Request-specific options
511
- #
512
- # @yield [result, err] Result & error if block supplied
513
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
514
- # @yieldparam err [StandardError] error object if request failed
515
- #
516
- # @return [Google::Apis::SqladminV1beta4::Operation]
517
- #
518
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
519
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
520
- # @raise [Google::Apis::AuthorizationError] Authorization is required
521
- def add_instance_server_ca(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
522
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/addServerCa', options)
523
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
524
- command.response_class = Google::Apis::SqladminV1beta4::Operation
525
- command.params['project'] = project unless project.nil?
526
- command.params['instance'] = instance unless instance.nil?
527
- command.query['fields'] = fields unless fields.nil?
528
- command.query['quotaUser'] = quota_user unless quota_user.nil?
529
- command.query['userIp'] = user_ip unless user_ip.nil?
530
- execute_or_queue_command(command, &block)
531
- end
532
-
533
- # Creates a Cloud SQL instance as a clone of the source instance.
534
- # @param [String] project
535
- # Project ID of the source as well as the clone Cloud SQL instance.
536
- # @param [String] instance
537
- # The ID of the Cloud SQL instance to be cloned (source). This does not include
538
- # the project ID.
539
- # @param [Google::Apis::SqladminV1beta4::CloneInstancesRequest] clone_instances_request_object
540
- # @param [String] fields
541
- # Selector specifying which fields to include in a partial response.
542
- # @param [String] quota_user
543
- # An opaque string that represents a user for quota purposes. Must not exceed 40
544
- # characters.
545
- # @param [String] user_ip
546
- # Deprecated. Please use quotaUser instead.
547
- # @param [Google::Apis::RequestOptions] options
548
- # Request-specific options
549
- #
550
- # @yield [result, err] Result & error if block supplied
551
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
552
- # @yieldparam err [StandardError] error object if request failed
553
- #
554
- # @return [Google::Apis::SqladminV1beta4::Operation]
555
- #
556
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
557
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
558
- # @raise [Google::Apis::AuthorizationError] Authorization is required
559
- def clone_instance(project, instance, clone_instances_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
560
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/clone', options)
561
- command.request_representation = Google::Apis::SqladminV1beta4::CloneInstancesRequest::Representation
562
- command.request_object = clone_instances_request_object
563
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
564
- command.response_class = Google::Apis::SqladminV1beta4::Operation
565
- command.params['project'] = project unless project.nil?
566
- command.params['instance'] = instance unless instance.nil?
567
- command.query['fields'] = fields unless fields.nil?
568
- command.query['quotaUser'] = quota_user unless quota_user.nil?
569
- command.query['userIp'] = user_ip unless user_ip.nil?
570
- execute_or_queue_command(command, &block)
571
- end
572
-
573
- # Deletes a Cloud SQL instance.
574
- # @param [String] project
575
- # Project ID of the project that contains the instance to be deleted.
576
- # @param [String] instance
577
- # Cloud SQL instance ID. This does not include the project ID.
578
- # @param [String] fields
579
- # Selector specifying which fields to include in a partial response.
580
- # @param [String] quota_user
581
- # An opaque string that represents a user for quota purposes. Must not exceed 40
582
- # characters.
583
- # @param [String] user_ip
584
- # Deprecated. Please use quotaUser instead.
585
- # @param [Google::Apis::RequestOptions] options
586
- # Request-specific options
587
- #
588
- # @yield [result, err] Result & error if block supplied
589
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
590
- # @yieldparam err [StandardError] error object if request failed
591
- #
592
- # @return [Google::Apis::SqladminV1beta4::Operation]
593
- #
594
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
595
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
596
- # @raise [Google::Apis::AuthorizationError] Authorization is required
597
- def delete_instance(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
598
- command = make_simple_command(:delete, 'projects/{project}/instances/{instance}', options)
599
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
600
- command.response_class = Google::Apis::SqladminV1beta4::Operation
601
- command.params['project'] = project unless project.nil?
602
- command.params['instance'] = instance unless instance.nil?
603
- command.query['fields'] = fields unless fields.nil?
604
- command.query['quotaUser'] = quota_user unless quota_user.nil?
605
- command.query['userIp'] = user_ip unless user_ip.nil?
606
- execute_or_queue_command(command, &block)
607
- end
608
-
609
- # Demotes the stand-alone instance to be a Cloud SQL read replica for an
610
- # external database server.
611
- # @param [String] project
612
- # ID of the project that contains the instance.
613
- # @param [String] instance
614
- # Cloud SQL instance name.
615
- # @param [Google::Apis::SqladminV1beta4::InstancesDemoteMasterRequest] instances_demote_master_request_object
616
- # @param [String] fields
617
- # Selector specifying which fields to include in a partial response.
618
- # @param [String] quota_user
619
- # An opaque string that represents a user for quota purposes. Must not exceed 40
620
- # characters.
621
- # @param [String] user_ip
622
- # Deprecated. Please use quotaUser instead.
623
- # @param [Google::Apis::RequestOptions] options
624
- # Request-specific options
625
- #
626
- # @yield [result, err] Result & error if block supplied
627
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
628
- # @yieldparam err [StandardError] error object if request failed
629
- #
630
- # @return [Google::Apis::SqladminV1beta4::Operation]
631
- #
632
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
633
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
634
- # @raise [Google::Apis::AuthorizationError] Authorization is required
635
- def demote_instance_master(project, instance, instances_demote_master_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
636
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/demoteMaster', options)
637
- command.request_representation = Google::Apis::SqladminV1beta4::InstancesDemoteMasterRequest::Representation
638
- command.request_object = instances_demote_master_request_object
639
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
640
- command.response_class = Google::Apis::SqladminV1beta4::Operation
641
- command.params['project'] = project unless project.nil?
642
- command.params['instance'] = instance unless instance.nil?
643
- command.query['fields'] = fields unless fields.nil?
644
- command.query['quotaUser'] = quota_user unless quota_user.nil?
645
- command.query['userIp'] = user_ip unless user_ip.nil?
646
- execute_or_queue_command(command, &block)
647
- end
648
-
649
- # Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
650
- # or CSV file.
651
- # @param [String] project
652
- # Project ID of the project that contains the instance to be exported.
653
- # @param [String] instance
654
- # Cloud SQL instance ID. This does not include the project ID.
655
- # @param [Google::Apis::SqladminV1beta4::ExportInstancesRequest] export_instances_request_object
656
- # @param [String] fields
657
- # Selector specifying which fields to include in a partial response.
658
- # @param [String] quota_user
659
- # An opaque string that represents a user for quota purposes. Must not exceed 40
660
- # characters.
661
- # @param [String] user_ip
662
- # Deprecated. Please use quotaUser instead.
663
- # @param [Google::Apis::RequestOptions] options
664
- # Request-specific options
665
- #
666
- # @yield [result, err] Result & error if block supplied
667
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
668
- # @yieldparam err [StandardError] error object if request failed
669
- #
670
- # @return [Google::Apis::SqladminV1beta4::Operation]
671
- #
672
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
673
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
674
- # @raise [Google::Apis::AuthorizationError] Authorization is required
675
- def export_instance(project, instance, export_instances_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
676
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/export', options)
677
- command.request_representation = Google::Apis::SqladminV1beta4::ExportInstancesRequest::Representation
678
- command.request_object = export_instances_request_object
679
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
680
- command.response_class = Google::Apis::SqladminV1beta4::Operation
681
- command.params['project'] = project unless project.nil?
682
- command.params['instance'] = instance unless instance.nil?
683
- command.query['fields'] = fields unless fields.nil?
684
- command.query['quotaUser'] = quota_user unless quota_user.nil?
685
- command.query['userIp'] = user_ip unless user_ip.nil?
686
- execute_or_queue_command(command, &block)
687
- end
688
-
689
- # Failover the instance to its failover replica instance.
690
- # @param [String] project
691
- # ID of the project that contains the read replica.
692
- # @param [String] instance
693
- # Cloud SQL instance ID. This does not include the project ID.
694
- # @param [Google::Apis::SqladminV1beta4::InstancesFailoverRequest] instances_failover_request_object
695
- # @param [String] fields
696
- # Selector specifying which fields to include in a partial response.
697
- # @param [String] quota_user
698
- # An opaque string that represents a user for quota purposes. Must not exceed 40
699
- # characters.
700
- # @param [String] user_ip
701
- # Deprecated. Please use quotaUser instead.
702
- # @param [Google::Apis::RequestOptions] options
703
- # Request-specific options
704
- #
705
- # @yield [result, err] Result & error if block supplied
706
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
707
- # @yieldparam err [StandardError] error object if request failed
708
- #
709
- # @return [Google::Apis::SqladminV1beta4::Operation]
710
- #
711
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
712
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
713
- # @raise [Google::Apis::AuthorizationError] Authorization is required
714
- def failover_instance(project, instance, instances_failover_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
715
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/failover', options)
716
- command.request_representation = Google::Apis::SqladminV1beta4::InstancesFailoverRequest::Representation
717
- command.request_object = instances_failover_request_object
718
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
719
- command.response_class = Google::Apis::SqladminV1beta4::Operation
720
- command.params['project'] = project unless project.nil?
721
- command.params['instance'] = instance unless instance.nil?
722
- command.query['fields'] = fields unless fields.nil?
723
- command.query['quotaUser'] = quota_user unless quota_user.nil?
724
- command.query['userIp'] = user_ip unless user_ip.nil?
725
- execute_or_queue_command(command, &block)
726
- end
727
-
728
- # Retrieves a resource containing information about a Cloud SQL instance.
729
- # @param [String] project
730
- # Project ID of the project that contains the instance.
731
- # @param [String] instance
732
- # Database instance ID. This does not include the project ID.
733
- # @param [String] fields
734
- # Selector specifying which fields to include in a partial response.
735
- # @param [String] quota_user
736
- # An opaque string that represents a user for quota purposes. Must not exceed 40
737
- # characters.
738
- # @param [String] user_ip
739
- # Deprecated. Please use quotaUser instead.
740
- # @param [Google::Apis::RequestOptions] options
741
- # Request-specific options
742
- #
743
- # @yield [result, err] Result & error if block supplied
744
- # @yieldparam result [Google::Apis::SqladminV1beta4::DatabaseInstance] parsed result object
745
- # @yieldparam err [StandardError] error object if request failed
746
- #
747
- # @return [Google::Apis::SqladminV1beta4::DatabaseInstance]
748
- #
749
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
750
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
751
- # @raise [Google::Apis::AuthorizationError] Authorization is required
752
- def get_instance(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
753
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}', options)
754
- command.response_representation = Google::Apis::SqladminV1beta4::DatabaseInstance::Representation
755
- command.response_class = Google::Apis::SqladminV1beta4::DatabaseInstance
756
- command.params['project'] = project unless project.nil?
757
- command.params['instance'] = instance unless instance.nil?
758
- command.query['fields'] = fields unless fields.nil?
759
- command.query['quotaUser'] = quota_user unless quota_user.nil?
760
- command.query['userIp'] = user_ip unless user_ip.nil?
761
- execute_or_queue_command(command, &block)
762
- end
763
-
764
- # Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud
765
- # Storage.
766
- # @param [String] project
767
- # Project ID of the project that contains the instance.
768
- # @param [String] instance
769
- # Cloud SQL instance ID. This does not include the project ID.
770
- # @param [Google::Apis::SqladminV1beta4::ImportInstancesRequest] import_instances_request_object
771
- # @param [String] fields
772
- # Selector specifying which fields to include in a partial response.
773
- # @param [String] quota_user
774
- # An opaque string that represents a user for quota purposes. Must not exceed 40
775
- # characters.
776
- # @param [String] user_ip
777
- # Deprecated. Please use quotaUser instead.
778
- # @param [Google::Apis::RequestOptions] options
779
- # Request-specific options
780
- #
781
- # @yield [result, err] Result & error if block supplied
782
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
783
- # @yieldparam err [StandardError] error object if request failed
784
- #
785
- # @return [Google::Apis::SqladminV1beta4::Operation]
786
- #
787
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
788
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
789
- # @raise [Google::Apis::AuthorizationError] Authorization is required
790
- def import_instance(project, instance, import_instances_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
791
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/import', options)
792
- command.request_representation = Google::Apis::SqladminV1beta4::ImportInstancesRequest::Representation
793
- command.request_object = import_instances_request_object
794
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
795
- command.response_class = Google::Apis::SqladminV1beta4::Operation
796
- command.params['project'] = project unless project.nil?
797
- command.params['instance'] = instance unless instance.nil?
798
- command.query['fields'] = fields unless fields.nil?
799
- command.query['quotaUser'] = quota_user unless quota_user.nil?
800
- command.query['userIp'] = user_ip unless user_ip.nil?
801
- execute_or_queue_command(command, &block)
802
- end
803
-
804
- # Creates a new Cloud SQL instance.
805
- # @param [String] project
806
- # Project ID of the project to which the newly created Cloud SQL instances
807
- # should belong.
808
- # @param [Google::Apis::SqladminV1beta4::DatabaseInstance] database_instance_object
809
- # @param [String] fields
810
- # Selector specifying which fields to include in a partial response.
811
- # @param [String] quota_user
812
- # An opaque string that represents a user for quota purposes. Must not exceed 40
813
- # characters.
814
- # @param [String] user_ip
815
- # Deprecated. Please use quotaUser instead.
816
- # @param [Google::Apis::RequestOptions] options
817
- # Request-specific options
818
- #
819
- # @yield [result, err] Result & error if block supplied
820
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
821
- # @yieldparam err [StandardError] error object if request failed
822
- #
823
- # @return [Google::Apis::SqladminV1beta4::Operation]
824
- #
825
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
826
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
827
- # @raise [Google::Apis::AuthorizationError] Authorization is required
828
- def insert_instance(project, database_instance_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
829
- command = make_simple_command(:post, 'projects/{project}/instances', options)
830
- command.request_representation = Google::Apis::SqladminV1beta4::DatabaseInstance::Representation
831
- command.request_object = database_instance_object
832
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
833
- command.response_class = Google::Apis::SqladminV1beta4::Operation
834
- command.params['project'] = project unless project.nil?
835
- command.query['fields'] = fields unless fields.nil?
836
- command.query['quotaUser'] = quota_user unless quota_user.nil?
837
- command.query['userIp'] = user_ip unless user_ip.nil?
838
- execute_or_queue_command(command, &block)
839
- end
840
-
841
- # Lists instances under a given project in the alphabetical order of the
842
- # instance name.
843
- # @param [String] project
844
- # Project ID of the project for which to list Cloud SQL instances.
845
- # @param [String] filter
846
- # An expression for filtering the results of the request, such as by name or
847
- # label.
848
- # @param [Fixnum] max_results
849
- # The maximum number of results to return per response.
850
- # @param [String] page_token
851
- # A previously-returned page token representing part of the larger set of
852
- # results to view.
853
- # @param [String] fields
854
- # Selector specifying which fields to include in a partial response.
855
- # @param [String] quota_user
856
- # An opaque string that represents a user for quota purposes. Must not exceed 40
857
- # characters.
858
- # @param [String] user_ip
859
- # Deprecated. Please use quotaUser instead.
860
- # @param [Google::Apis::RequestOptions] options
861
- # Request-specific options
862
- #
863
- # @yield [result, err] Result & error if block supplied
864
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListInstancesResponse] parsed result object
865
- # @yieldparam err [StandardError] error object if request failed
866
- #
867
- # @return [Google::Apis::SqladminV1beta4::ListInstancesResponse]
868
- #
869
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
870
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
871
- # @raise [Google::Apis::AuthorizationError] Authorization is required
872
- def list_instances(project, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
873
- command = make_simple_command(:get, 'projects/{project}/instances', options)
874
- command.response_representation = Google::Apis::SqladminV1beta4::ListInstancesResponse::Representation
875
- command.response_class = Google::Apis::SqladminV1beta4::ListInstancesResponse
876
- command.params['project'] = project unless project.nil?
877
- command.query['filter'] = filter unless filter.nil?
878
- command.query['maxResults'] = max_results unless max_results.nil?
879
- command.query['pageToken'] = page_token unless page_token.nil?
880
- command.query['fields'] = fields unless fields.nil?
881
- command.query['quotaUser'] = quota_user unless quota_user.nil?
882
- command.query['userIp'] = user_ip unless user_ip.nil?
883
- execute_or_queue_command(command, &block)
884
- end
885
-
886
- # Lists all of the trusted Certificate Authorities (CAs) for the specified
887
- # instance. There can be up to three CAs listed: the CA that was used to sign
888
- # the certificate that is currently in use, a CA that has been added but not yet
889
- # used to sign a certificate, and a CA used to sign a certificate that has
890
- # previously rotated out.
891
- # @param [String] project
892
- # Project ID of the project that contains the instance.
893
- # @param [String] instance
894
- # Cloud SQL instance ID. This does not include the project ID.
895
- # @param [String] fields
896
- # Selector specifying which fields to include in a partial response.
897
- # @param [String] quota_user
898
- # An opaque string that represents a user for quota purposes. Must not exceed 40
899
- # characters.
900
- # @param [String] user_ip
901
- # Deprecated. Please use quotaUser instead.
902
- # @param [Google::Apis::RequestOptions] options
903
- # Request-specific options
904
- #
905
- # @yield [result, err] Result & error if block supplied
906
- # @yieldparam result [Google::Apis::SqladminV1beta4::InstancesListServerCasResponse] parsed result object
907
- # @yieldparam err [StandardError] error object if request failed
908
- #
909
- # @return [Google::Apis::SqladminV1beta4::InstancesListServerCasResponse]
910
- #
911
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
912
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
913
- # @raise [Google::Apis::AuthorizationError] Authorization is required
914
- def list_instance_server_cas(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
915
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/listServerCas', options)
916
- command.response_representation = Google::Apis::SqladminV1beta4::InstancesListServerCasResponse::Representation
917
- command.response_class = Google::Apis::SqladminV1beta4::InstancesListServerCasResponse
918
- command.params['project'] = project unless project.nil?
919
- command.params['instance'] = instance unless instance.nil?
920
- command.query['fields'] = fields unless fields.nil?
921
- command.query['quotaUser'] = quota_user unless quota_user.nil?
922
- command.query['userIp'] = user_ip unless user_ip.nil?
923
- execute_or_queue_command(command, &block)
924
- end
925
-
926
- # Updates settings of a Cloud SQL instance. Caution: This is not a partial
927
- # update, so you must include values for all the settings that you want to
928
- # retain. For partial updates, use patch.. This method supports patch semantics.
929
- # @param [String] project
930
- # Project ID of the project that contains the instance.
931
- # @param [String] instance
932
- # Cloud SQL instance ID. This does not include the project ID.
933
- # @param [Google::Apis::SqladminV1beta4::DatabaseInstance] database_instance_object
934
- # @param [String] fields
935
- # Selector specifying which fields to include in a partial response.
936
- # @param [String] quota_user
937
- # An opaque string that represents a user for quota purposes. Must not exceed 40
938
- # characters.
939
- # @param [String] user_ip
940
- # Deprecated. Please use quotaUser instead.
941
- # @param [Google::Apis::RequestOptions] options
942
- # Request-specific options
943
- #
944
- # @yield [result, err] Result & error if block supplied
945
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
946
- # @yieldparam err [StandardError] error object if request failed
947
- #
948
- # @return [Google::Apis::SqladminV1beta4::Operation]
949
- #
950
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
951
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
952
- # @raise [Google::Apis::AuthorizationError] Authorization is required
953
- def patch_instance(project, instance, database_instance_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
954
- command = make_simple_command(:patch, 'projects/{project}/instances/{instance}', options)
955
- command.request_representation = Google::Apis::SqladminV1beta4::DatabaseInstance::Representation
956
- command.request_object = database_instance_object
957
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
958
- command.response_class = Google::Apis::SqladminV1beta4::Operation
959
- command.params['project'] = project unless project.nil?
960
- command.params['instance'] = instance unless instance.nil?
961
- command.query['fields'] = fields unless fields.nil?
962
- command.query['quotaUser'] = quota_user unless quota_user.nil?
963
- command.query['userIp'] = user_ip unless user_ip.nil?
964
- execute_or_queue_command(command, &block)
965
- end
966
-
967
- # Promotes the read replica instance to be a stand-alone Cloud SQL instance.
968
- # @param [String] project
969
- # ID of the project that contains the read replica.
970
- # @param [String] instance
971
- # Cloud SQL read replica instance name.
972
- # @param [String] fields
973
- # Selector specifying which fields to include in a partial response.
974
- # @param [String] quota_user
975
- # An opaque string that represents a user for quota purposes. Must not exceed 40
976
- # characters.
977
- # @param [String] user_ip
978
- # Deprecated. Please use quotaUser instead.
979
- # @param [Google::Apis::RequestOptions] options
980
- # Request-specific options
981
- #
982
- # @yield [result, err] Result & error if block supplied
983
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
984
- # @yieldparam err [StandardError] error object if request failed
985
- #
986
- # @return [Google::Apis::SqladminV1beta4::Operation]
987
- #
988
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
989
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
990
- # @raise [Google::Apis::AuthorizationError] Authorization is required
991
- def promote_instance_replica(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
992
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/promoteReplica', options)
993
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
994
- command.response_class = Google::Apis::SqladminV1beta4::Operation
995
- command.params['project'] = project unless project.nil?
996
- command.params['instance'] = instance unless instance.nil?
997
- command.query['fields'] = fields unless fields.nil?
998
- command.query['quotaUser'] = quota_user unless quota_user.nil?
999
- command.query['userIp'] = user_ip unless user_ip.nil?
1000
- execute_or_queue_command(command, &block)
1001
- end
1002
-
1003
- # Deletes all client certificates and generates a new server SSL certificate for
1004
- # the instance.
1005
- # @param [String] project
1006
- # Project ID of the project that contains the instance.
1007
- # @param [String] instance
1008
- # Cloud SQL instance ID. This does not include the project ID.
1009
- # @param [String] fields
1010
- # Selector specifying which fields to include in a partial response.
1011
- # @param [String] quota_user
1012
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1013
- # characters.
1014
- # @param [String] user_ip
1015
- # Deprecated. Please use quotaUser instead.
1016
- # @param [Google::Apis::RequestOptions] options
1017
- # Request-specific options
1018
- #
1019
- # @yield [result, err] Result & error if block supplied
1020
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1021
- # @yieldparam err [StandardError] error object if request failed
1022
- #
1023
- # @return [Google::Apis::SqladminV1beta4::Operation]
1024
- #
1025
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1026
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1027
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1028
- def reset_instance_ssl_config(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1029
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/resetSslConfig', options)
1030
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1031
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1032
- command.params['project'] = project unless project.nil?
1033
- command.params['instance'] = instance unless instance.nil?
1034
- command.query['fields'] = fields unless fields.nil?
1035
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1036
- command.query['userIp'] = user_ip unless user_ip.nil?
1037
- execute_or_queue_command(command, &block)
1038
- end
1039
-
1040
- # Restarts a Cloud SQL instance.
1041
- # @param [String] project
1042
- # Project ID of the project that contains the instance to be restarted.
1043
- # @param [String] instance
1044
- # Cloud SQL instance ID. This does not include the project ID.
1045
- # @param [String] fields
1046
- # Selector specifying which fields to include in a partial response.
1047
- # @param [String] quota_user
1048
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1049
- # characters.
1050
- # @param [String] user_ip
1051
- # Deprecated. Please use quotaUser instead.
1052
- # @param [Google::Apis::RequestOptions] options
1053
- # Request-specific options
1054
- #
1055
- # @yield [result, err] Result & error if block supplied
1056
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1057
- # @yieldparam err [StandardError] error object if request failed
1058
- #
1059
- # @return [Google::Apis::SqladminV1beta4::Operation]
1060
- #
1061
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1062
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1063
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1064
- def restart_instance(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1065
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/restart', options)
1066
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1067
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1068
- command.params['project'] = project unless project.nil?
1069
- command.params['instance'] = instance unless instance.nil?
1070
- command.query['fields'] = fields unless fields.nil?
1071
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1072
- command.query['userIp'] = user_ip unless user_ip.nil?
1073
- execute_or_queue_command(command, &block)
1074
- end
1075
-
1076
- # Restores a backup of a Cloud SQL instance.
1077
- # @param [String] project
1078
- # Project ID of the project that contains the instance.
1079
- # @param [String] instance
1080
- # Cloud SQL instance ID. This does not include the project ID.
1081
- # @param [Google::Apis::SqladminV1beta4::RestoreInstancesBackupRequest] restore_instances_backup_request_object
1082
- # @param [String] fields
1083
- # Selector specifying which fields to include in a partial response.
1084
- # @param [String] quota_user
1085
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1086
- # characters.
1087
- # @param [String] user_ip
1088
- # Deprecated. Please use quotaUser instead.
1089
- # @param [Google::Apis::RequestOptions] options
1090
- # Request-specific options
1091
- #
1092
- # @yield [result, err] Result & error if block supplied
1093
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1094
- # @yieldparam err [StandardError] error object if request failed
1095
- #
1096
- # @return [Google::Apis::SqladminV1beta4::Operation]
1097
- #
1098
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1099
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1100
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1101
- def restore_instance_backup(project, instance, restore_instances_backup_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1102
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/restoreBackup', options)
1103
- command.request_representation = Google::Apis::SqladminV1beta4::RestoreInstancesBackupRequest::Representation
1104
- command.request_object = restore_instances_backup_request_object
1105
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1106
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1107
- command.params['project'] = project unless project.nil?
1108
- command.params['instance'] = instance unless instance.nil?
1109
- command.query['fields'] = fields unless fields.nil?
1110
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1111
- command.query['userIp'] = user_ip unless user_ip.nil?
1112
- execute_or_queue_command(command, &block)
1113
- end
1114
-
1115
- # Rotates the server certificate to one signed by the Certificate Authority (CA)
1116
- # version previously added with the addServerCA method.
1117
- # @param [String] project
1118
- # Project ID of the project that contains the instance.
1119
- # @param [String] instance
1120
- # Cloud SQL instance ID. This does not include the project ID.
1121
- # @param [Google::Apis::SqladminV1beta4::InstancesRotateServerCaRequest] instances_rotate_server_ca_request_object
1122
- # @param [String] fields
1123
- # Selector specifying which fields to include in a partial response.
1124
- # @param [String] quota_user
1125
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1126
- # characters.
1127
- # @param [String] user_ip
1128
- # Deprecated. Please use quotaUser instead.
1129
- # @param [Google::Apis::RequestOptions] options
1130
- # Request-specific options
1131
- #
1132
- # @yield [result, err] Result & error if block supplied
1133
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1134
- # @yieldparam err [StandardError] error object if request failed
1135
- #
1136
- # @return [Google::Apis::SqladminV1beta4::Operation]
1137
- #
1138
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1139
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1140
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1141
- def rotate_instance_server_ca(project, instance, instances_rotate_server_ca_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1142
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/rotateServerCa', options)
1143
- command.request_representation = Google::Apis::SqladminV1beta4::InstancesRotateServerCaRequest::Representation
1144
- command.request_object = instances_rotate_server_ca_request_object
1145
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1146
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1147
- command.params['project'] = project unless project.nil?
1148
- command.params['instance'] = instance unless instance.nil?
1149
- command.query['fields'] = fields unless fields.nil?
1150
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1151
- command.query['userIp'] = user_ip unless user_ip.nil?
1152
- execute_or_queue_command(command, &block)
1153
- end
1154
-
1155
- # Starts the replication in the read replica instance.
1156
- # @param [String] project
1157
- # ID of the project that contains the read replica.
1158
- # @param [String] instance
1159
- # Cloud SQL read replica instance name.
1160
- # @param [String] fields
1161
- # Selector specifying which fields to include in a partial response.
1162
- # @param [String] quota_user
1163
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1164
- # characters.
1165
- # @param [String] user_ip
1166
- # Deprecated. Please use quotaUser instead.
1167
- # @param [Google::Apis::RequestOptions] options
1168
- # Request-specific options
1169
- #
1170
- # @yield [result, err] Result & error if block supplied
1171
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1172
- # @yieldparam err [StandardError] error object if request failed
1173
- #
1174
- # @return [Google::Apis::SqladminV1beta4::Operation]
1175
- #
1176
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1177
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1178
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1179
- def start_instance_replica(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1180
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/startReplica', options)
1181
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1182
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1183
- command.params['project'] = project unless project.nil?
1184
- command.params['instance'] = instance unless instance.nil?
1185
- command.query['fields'] = fields unless fields.nil?
1186
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1187
- command.query['userIp'] = user_ip unless user_ip.nil?
1188
- execute_or_queue_command(command, &block)
1189
- end
1190
-
1191
- # Stops the replication in the read replica instance.
1192
- # @param [String] project
1193
- # ID of the project that contains the read replica.
1194
- # @param [String] instance
1195
- # Cloud SQL read replica instance name.
1196
- # @param [String] fields
1197
- # Selector specifying which fields to include in a partial response.
1198
- # @param [String] quota_user
1199
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1200
- # characters.
1201
- # @param [String] user_ip
1202
- # Deprecated. Please use quotaUser instead.
1203
- # @param [Google::Apis::RequestOptions] options
1204
- # Request-specific options
1205
- #
1206
- # @yield [result, err] Result & error if block supplied
1207
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1208
- # @yieldparam err [StandardError] error object if request failed
1209
- #
1210
- # @return [Google::Apis::SqladminV1beta4::Operation]
1211
- #
1212
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1213
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1214
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1215
- def stop_instance_replica(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1216
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/stopReplica', options)
1217
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1218
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1219
- command.params['project'] = project unless project.nil?
1220
- command.params['instance'] = instance unless instance.nil?
1221
- command.query['fields'] = fields unless fields.nil?
1222
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1223
- command.query['userIp'] = user_ip unless user_ip.nil?
1224
- execute_or_queue_command(command, &block)
1225
- end
1226
-
1227
- # Truncate MySQL general and slow query log tables
1228
- # @param [String] project
1229
- # Project ID of the Cloud SQL project.
1230
- # @param [String] instance
1231
- # Cloud SQL instance ID. This does not include the project ID.
1232
- # @param [Google::Apis::SqladminV1beta4::InstancesTruncateLogRequest] instances_truncate_log_request_object
1233
- # @param [String] fields
1234
- # Selector specifying which fields to include in a partial response.
1235
- # @param [String] quota_user
1236
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1237
- # characters.
1238
- # @param [String] user_ip
1239
- # Deprecated. Please use quotaUser instead.
1240
- # @param [Google::Apis::RequestOptions] options
1241
- # Request-specific options
1242
- #
1243
- # @yield [result, err] Result & error if block supplied
1244
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1245
- # @yieldparam err [StandardError] error object if request failed
1246
- #
1247
- # @return [Google::Apis::SqladminV1beta4::Operation]
1248
- #
1249
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1250
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1251
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1252
- def truncate_instance_log(project, instance, instances_truncate_log_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1253
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/truncateLog', options)
1254
- command.request_representation = Google::Apis::SqladminV1beta4::InstancesTruncateLogRequest::Representation
1255
- command.request_object = instances_truncate_log_request_object
1256
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1257
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1258
- command.params['project'] = project unless project.nil?
1259
- command.params['instance'] = instance unless instance.nil?
1260
- command.query['fields'] = fields unless fields.nil?
1261
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1262
- command.query['userIp'] = user_ip unless user_ip.nil?
1263
- execute_or_queue_command(command, &block)
1264
- end
1265
-
1266
- # Updates settings of a Cloud SQL instance. Caution: This is not a partial
1267
- # update, so you must include values for all the settings that you want to
1268
- # retain. For partial updates, use patch.
1269
- # @param [String] project
1270
- # Project ID of the project that contains the instance.
1271
- # @param [String] instance
1272
- # Cloud SQL instance ID. This does not include the project ID.
1273
- # @param [Google::Apis::SqladminV1beta4::DatabaseInstance] database_instance_object
1274
- # @param [String] fields
1275
- # Selector specifying which fields to include in a partial response.
1276
- # @param [String] quota_user
1277
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1278
- # characters.
1279
- # @param [String] user_ip
1280
- # Deprecated. Please use quotaUser instead.
1281
- # @param [Google::Apis::RequestOptions] options
1282
- # Request-specific options
1283
- #
1284
- # @yield [result, err] Result & error if block supplied
1285
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1286
- # @yieldparam err [StandardError] error object if request failed
1287
- #
1288
- # @return [Google::Apis::SqladminV1beta4::Operation]
1289
- #
1290
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1291
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1292
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1293
- def update_instance(project, instance, database_instance_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1294
- command = make_simple_command(:put, 'projects/{project}/instances/{instance}', options)
1295
- command.request_representation = Google::Apis::SqladminV1beta4::DatabaseInstance::Representation
1296
- command.request_object = database_instance_object
1297
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1298
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1299
- command.params['project'] = project unless project.nil?
1300
- command.params['instance'] = instance unless instance.nil?
1301
- command.query['fields'] = fields unless fields.nil?
1302
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1303
- command.query['userIp'] = user_ip unless user_ip.nil?
1304
- execute_or_queue_command(command, &block)
1305
- end
1306
-
1307
- # Retrieves an instance operation that has been performed on an instance.
1308
- # @param [String] project
1309
- # Project ID of the project that contains the instance.
1310
- # @param [String] operation
1311
- # Instance operation ID.
1312
- # @param [String] fields
1313
- # Selector specifying which fields to include in a partial response.
1314
- # @param [String] quota_user
1315
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1316
- # characters.
1317
- # @param [String] user_ip
1318
- # Deprecated. Please use quotaUser instead.
1319
- # @param [Google::Apis::RequestOptions] options
1320
- # Request-specific options
1321
- #
1322
- # @yield [result, err] Result & error if block supplied
1323
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1324
- # @yieldparam err [StandardError] error object if request failed
1325
- #
1326
- # @return [Google::Apis::SqladminV1beta4::Operation]
1327
- #
1328
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1329
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1330
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1331
- def get_operation(project, operation, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1332
- command = make_simple_command(:get, 'projects/{project}/operations/{operation}', options)
1333
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1334
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1335
- command.params['project'] = project unless project.nil?
1336
- command.params['operation'] = operation unless operation.nil?
1337
- command.query['fields'] = fields unless fields.nil?
1338
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1339
- command.query['userIp'] = user_ip unless user_ip.nil?
1340
- execute_or_queue_command(command, &block)
1341
- end
1342
-
1343
- # Lists all instance operations that have been performed on the given Cloud SQL
1344
- # instance in the reverse chronological order of the start time.
1345
- # @param [String] project
1346
- # Project ID of the project that contains the instance.
1347
- # @param [String] instance
1348
- # Cloud SQL instance ID. This does not include the project ID.
1349
- # @param [Fixnum] max_results
1350
- # Maximum number of operations per response.
1351
- # @param [String] page_token
1352
- # A previously-returned page token representing part of the larger set of
1353
- # results to view.
1354
- # @param [String] fields
1355
- # Selector specifying which fields to include in a partial response.
1356
- # @param [String] quota_user
1357
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1358
- # characters.
1359
- # @param [String] user_ip
1360
- # Deprecated. Please use quotaUser instead.
1361
- # @param [Google::Apis::RequestOptions] options
1362
- # Request-specific options
1363
- #
1364
- # @yield [result, err] Result & error if block supplied
1365
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListOperationsResponse] parsed result object
1366
- # @yieldparam err [StandardError] error object if request failed
1367
- #
1368
- # @return [Google::Apis::SqladminV1beta4::ListOperationsResponse]
1369
- #
1370
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1371
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1372
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1373
- def list_operations(project, instance, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1374
- command = make_simple_command(:get, 'projects/{project}/operations', options)
1375
- command.response_representation = Google::Apis::SqladminV1beta4::ListOperationsResponse::Representation
1376
- command.response_class = Google::Apis::SqladminV1beta4::ListOperationsResponse
1377
- command.params['project'] = project unless project.nil?
1378
- command.query['instance'] = instance unless instance.nil?
1379
- command.query['maxResults'] = max_results unless max_results.nil?
1380
- command.query['pageToken'] = page_token unless page_token.nil?
1381
- command.query['fields'] = fields unless fields.nil?
1382
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1383
- command.query['userIp'] = user_ip unless user_ip.nil?
1384
- execute_or_queue_command(command, &block)
1385
- end
1386
-
1387
- # Generates a short-lived X509 certificate containing the provided public key
1388
- # and signed by a private key specific to the target instance. Users may use the
1389
- # certificate to authenticate as themselves when connecting to the database.
1390
- # @param [String] project
1391
- # Project ID of the Cloud SQL project.
1392
- # @param [String] instance
1393
- # Cloud SQL instance ID. This does not include the project ID.
1394
- # @param [Google::Apis::SqladminV1beta4::SslCertsCreateEphemeralRequest] ssl_certs_create_ephemeral_request_object
1395
- # @param [String] fields
1396
- # Selector specifying which fields to include in a partial response.
1397
- # @param [String] quota_user
1398
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1399
- # characters.
1400
- # @param [String] user_ip
1401
- # Deprecated. Please use quotaUser instead.
1402
- # @param [Google::Apis::RequestOptions] options
1403
- # Request-specific options
1404
- #
1405
- # @yield [result, err] Result & error if block supplied
1406
- # @yieldparam result [Google::Apis::SqladminV1beta4::SslCert] parsed result object
1407
- # @yieldparam err [StandardError] error object if request failed
1408
- #
1409
- # @return [Google::Apis::SqladminV1beta4::SslCert]
1410
- #
1411
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1412
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1413
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1414
- def create_ssl_cert_ephemeral(project, instance, ssl_certs_create_ephemeral_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1415
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/createEphemeral', options)
1416
- command.request_representation = Google::Apis::SqladminV1beta4::SslCertsCreateEphemeralRequest::Representation
1417
- command.request_object = ssl_certs_create_ephemeral_request_object
1418
- command.response_representation = Google::Apis::SqladminV1beta4::SslCert::Representation
1419
- command.response_class = Google::Apis::SqladminV1beta4::SslCert
1420
- command.params['project'] = project unless project.nil?
1421
- command.params['instance'] = instance unless instance.nil?
1422
- command.query['fields'] = fields unless fields.nil?
1423
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1424
- command.query['userIp'] = user_ip unless user_ip.nil?
1425
- execute_or_queue_command(command, &block)
1426
- end
1427
-
1428
- # Deletes the SSL certificate. For First Generation instances, the certificate
1429
- # remains valid until the instance is restarted.
1430
- # @param [String] project
1431
- # Project ID of the project that contains the instance.
1432
- # @param [String] instance
1433
- # Cloud SQL instance ID. This does not include the project ID.
1434
- # @param [String] sha1_fingerprint
1435
- # Sha1 FingerPrint.
1436
- # @param [String] fields
1437
- # Selector specifying which fields to include in a partial response.
1438
- # @param [String] quota_user
1439
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1440
- # characters.
1441
- # @param [String] user_ip
1442
- # Deprecated. Please use quotaUser instead.
1443
- # @param [Google::Apis::RequestOptions] options
1444
- # Request-specific options
1445
- #
1446
- # @yield [result, err] Result & error if block supplied
1447
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1448
- # @yieldparam err [StandardError] error object if request failed
1449
- #
1450
- # @return [Google::Apis::SqladminV1beta4::Operation]
1451
- #
1452
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1453
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1454
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1455
- def delete_ssl_cert(project, instance, sha1_fingerprint, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1456
- command = make_simple_command(:delete, 'projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}', options)
1457
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1458
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1459
- command.params['project'] = project unless project.nil?
1460
- command.params['instance'] = instance unless instance.nil?
1461
- command.params['sha1Fingerprint'] = sha1_fingerprint unless sha1_fingerprint.nil?
1462
- command.query['fields'] = fields unless fields.nil?
1463
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1464
- command.query['userIp'] = user_ip unless user_ip.nil?
1465
- execute_or_queue_command(command, &block)
1466
- end
1467
-
1468
- # Retrieves a particular SSL certificate. Does not include the private key (
1469
- # required for usage). The private key must be saved from the response to
1470
- # initial creation.
1471
- # @param [String] project
1472
- # Project ID of the project that contains the instance.
1473
- # @param [String] instance
1474
- # Cloud SQL instance ID. This does not include the project ID.
1475
- # @param [String] sha1_fingerprint
1476
- # Sha1 FingerPrint.
1477
- # @param [String] fields
1478
- # Selector specifying which fields to include in a partial response.
1479
- # @param [String] quota_user
1480
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1481
- # characters.
1482
- # @param [String] user_ip
1483
- # Deprecated. Please use quotaUser instead.
1484
- # @param [Google::Apis::RequestOptions] options
1485
- # Request-specific options
1486
- #
1487
- # @yield [result, err] Result & error if block supplied
1488
- # @yieldparam result [Google::Apis::SqladminV1beta4::SslCert] parsed result object
1489
- # @yieldparam err [StandardError] error object if request failed
1490
- #
1491
- # @return [Google::Apis::SqladminV1beta4::SslCert]
1492
- #
1493
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1494
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1495
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1496
- def get_ssl_cert(project, instance, sha1_fingerprint, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1497
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}', options)
1498
- command.response_representation = Google::Apis::SqladminV1beta4::SslCert::Representation
1499
- command.response_class = Google::Apis::SqladminV1beta4::SslCert
1500
- command.params['project'] = project unless project.nil?
1501
- command.params['instance'] = instance unless instance.nil?
1502
- command.params['sha1Fingerprint'] = sha1_fingerprint unless sha1_fingerprint.nil?
1503
- command.query['fields'] = fields unless fields.nil?
1504
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1505
- command.query['userIp'] = user_ip unless user_ip.nil?
1506
- execute_or_queue_command(command, &block)
1507
- end
1508
-
1509
- # Creates an SSL certificate and returns it along with the private key and
1510
- # server certificate authority. The new certificate will not be usable until the
1511
- # instance is restarted.
1512
- # @param [String] project
1513
- # Project ID of the project that contains the instance.
1514
- # @param [String] instance
1515
- # Cloud SQL instance ID. This does not include the project ID.
1516
- # @param [Google::Apis::SqladminV1beta4::InsertSslCertsRequest] insert_ssl_certs_request_object
1517
- # @param [String] fields
1518
- # Selector specifying which fields to include in a partial response.
1519
- # @param [String] quota_user
1520
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1521
- # characters.
1522
- # @param [String] user_ip
1523
- # Deprecated. Please use quotaUser instead.
1524
- # @param [Google::Apis::RequestOptions] options
1525
- # Request-specific options
1526
- #
1527
- # @yield [result, err] Result & error if block supplied
1528
- # @yieldparam result [Google::Apis::SqladminV1beta4::InsertSslCertsResponse] parsed result object
1529
- # @yieldparam err [StandardError] error object if request failed
1530
- #
1531
- # @return [Google::Apis::SqladminV1beta4::InsertSslCertsResponse]
1532
- #
1533
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1534
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1535
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1536
- def insert_ssl_cert(project, instance, insert_ssl_certs_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1537
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/sslCerts', options)
1538
- command.request_representation = Google::Apis::SqladminV1beta4::InsertSslCertsRequest::Representation
1539
- command.request_object = insert_ssl_certs_request_object
1540
- command.response_representation = Google::Apis::SqladminV1beta4::InsertSslCertsResponse::Representation
1541
- command.response_class = Google::Apis::SqladminV1beta4::InsertSslCertsResponse
1542
- command.params['project'] = project unless project.nil?
1543
- command.params['instance'] = instance unless instance.nil?
1544
- command.query['fields'] = fields unless fields.nil?
1545
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1546
- command.query['userIp'] = user_ip unless user_ip.nil?
1547
- execute_or_queue_command(command, &block)
1548
- end
1549
-
1550
- # Lists all of the current SSL certificates for the instance.
1551
- # @param [String] project
1552
- # Project ID of the project that contains the instance.
1553
- # @param [String] instance
1554
- # Cloud SQL instance ID. This does not include the project ID.
1555
- # @param [String] fields
1556
- # Selector specifying which fields to include in a partial response.
1557
- # @param [String] quota_user
1558
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1559
- # characters.
1560
- # @param [String] user_ip
1561
- # Deprecated. Please use quotaUser instead.
1562
- # @param [Google::Apis::RequestOptions] options
1563
- # Request-specific options
1564
- #
1565
- # @yield [result, err] Result & error if block supplied
1566
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListSslCertsResponse] parsed result object
1567
- # @yieldparam err [StandardError] error object if request failed
1568
- #
1569
- # @return [Google::Apis::SqladminV1beta4::ListSslCertsResponse]
1570
- #
1571
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1572
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1573
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1574
- def list_ssl_certs(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1575
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/sslCerts', options)
1576
- command.response_representation = Google::Apis::SqladminV1beta4::ListSslCertsResponse::Representation
1577
- command.response_class = Google::Apis::SqladminV1beta4::ListSslCertsResponse
1578
- command.params['project'] = project unless project.nil?
1579
- command.params['instance'] = instance unless instance.nil?
1580
- command.query['fields'] = fields unless fields.nil?
1581
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1582
- command.query['userIp'] = user_ip unless user_ip.nil?
1583
- execute_or_queue_command(command, &block)
1584
- end
1585
-
1586
- # Lists all available machine types (tiers) for Cloud SQL, for example, db-n1-
1587
- # standard-1. For related information, see Pricing.
1588
- # @param [String] project
1589
- # Project ID of the project for which to list tiers.
1590
- # @param [String] fields
1591
- # Selector specifying which fields to include in a partial response.
1592
- # @param [String] quota_user
1593
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1594
- # characters.
1595
- # @param [String] user_ip
1596
- # Deprecated. Please use quotaUser instead.
1597
- # @param [Google::Apis::RequestOptions] options
1598
- # Request-specific options
1599
- #
1600
- # @yield [result, err] Result & error if block supplied
1601
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListTiersResponse] parsed result object
1602
- # @yieldparam err [StandardError] error object if request failed
1603
- #
1604
- # @return [Google::Apis::SqladminV1beta4::ListTiersResponse]
1605
- #
1606
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1607
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1608
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1609
- def list_tiers(project, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1610
- command = make_simple_command(:get, 'projects/{project}/tiers', options)
1611
- command.response_representation = Google::Apis::SqladminV1beta4::ListTiersResponse::Representation
1612
- command.response_class = Google::Apis::SqladminV1beta4::ListTiersResponse
1613
- command.params['project'] = project unless project.nil?
1614
- command.query['fields'] = fields unless fields.nil?
1615
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1616
- command.query['userIp'] = user_ip unless user_ip.nil?
1617
- execute_or_queue_command(command, &block)
1618
- end
1619
-
1620
- # Deletes a user from a Cloud SQL instance.
1621
- # @param [String] project
1622
- # Project ID of the project that contains the instance.
1623
- # @param [String] instance
1624
- # Database instance ID. This does not include the project ID.
1625
- # @param [String] host
1626
- # Host of the user in the instance.
1627
- # @param [String] name
1628
- # Name of the user in the instance.
1629
- # @param [String] fields
1630
- # Selector specifying which fields to include in a partial response.
1631
- # @param [String] quota_user
1632
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1633
- # characters.
1634
- # @param [String] user_ip
1635
- # Deprecated. Please use quotaUser instead.
1636
- # @param [Google::Apis::RequestOptions] options
1637
- # Request-specific options
1638
- #
1639
- # @yield [result, err] Result & error if block supplied
1640
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1641
- # @yieldparam err [StandardError] error object if request failed
1642
- #
1643
- # @return [Google::Apis::SqladminV1beta4::Operation]
1644
- #
1645
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1646
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1647
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1648
- def delete_user(project, instance, host, name, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1649
- command = make_simple_command(:delete, 'projects/{project}/instances/{instance}/users', options)
1650
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1651
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1652
- command.params['project'] = project unless project.nil?
1653
- command.params['instance'] = instance unless instance.nil?
1654
- command.query['host'] = host unless host.nil?
1655
- command.query['name'] = name unless name.nil?
1656
- command.query['fields'] = fields unless fields.nil?
1657
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1658
- command.query['userIp'] = user_ip unless user_ip.nil?
1659
- execute_or_queue_command(command, &block)
1660
- end
1661
-
1662
- # Creates a new user in a Cloud SQL instance.
1663
- # @param [String] project
1664
- # Project ID of the project that contains the instance.
1665
- # @param [String] instance
1666
- # Database instance ID. This does not include the project ID.
1667
- # @param [Google::Apis::SqladminV1beta4::User] user_object
1668
- # @param [String] fields
1669
- # Selector specifying which fields to include in a partial response.
1670
- # @param [String] quota_user
1671
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1672
- # characters.
1673
- # @param [String] user_ip
1674
- # Deprecated. Please use quotaUser instead.
1675
- # @param [Google::Apis::RequestOptions] options
1676
- # Request-specific options
1677
- #
1678
- # @yield [result, err] Result & error if block supplied
1679
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1680
- # @yieldparam err [StandardError] error object if request failed
1681
- #
1682
- # @return [Google::Apis::SqladminV1beta4::Operation]
1683
- #
1684
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1685
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1686
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1687
- def insert_user(project, instance, user_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1688
- command = make_simple_command(:post, 'projects/{project}/instances/{instance}/users', options)
1689
- command.request_representation = Google::Apis::SqladminV1beta4::User::Representation
1690
- command.request_object = user_object
1691
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1692
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1693
- command.params['project'] = project unless project.nil?
1694
- command.params['instance'] = instance unless instance.nil?
1695
- command.query['fields'] = fields unless fields.nil?
1696
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1697
- command.query['userIp'] = user_ip unless user_ip.nil?
1698
- execute_or_queue_command(command, &block)
1699
- end
1700
-
1701
- # Lists users in the specified Cloud SQL instance.
1702
- # @param [String] project
1703
- # Project ID of the project that contains the instance.
1704
- # @param [String] instance
1705
- # Database instance ID. This does not include the project ID.
1706
- # @param [String] fields
1707
- # Selector specifying which fields to include in a partial response.
1708
- # @param [String] quota_user
1709
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1710
- # characters.
1711
- # @param [String] user_ip
1712
- # Deprecated. Please use quotaUser instead.
1713
- # @param [Google::Apis::RequestOptions] options
1714
- # Request-specific options
1715
- #
1716
- # @yield [result, err] Result & error if block supplied
1717
- # @yieldparam result [Google::Apis::SqladminV1beta4::ListUsersResponse] parsed result object
1718
- # @yieldparam err [StandardError] error object if request failed
1719
- #
1720
- # @return [Google::Apis::SqladminV1beta4::ListUsersResponse]
1721
- #
1722
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1723
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1724
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1725
- def list_users(project, instance, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1726
- command = make_simple_command(:get, 'projects/{project}/instances/{instance}/users', options)
1727
- command.response_representation = Google::Apis::SqladminV1beta4::ListUsersResponse::Representation
1728
- command.response_class = Google::Apis::SqladminV1beta4::ListUsersResponse
1729
- command.params['project'] = project unless project.nil?
1730
- command.params['instance'] = instance unless instance.nil?
1731
- command.query['fields'] = fields unless fields.nil?
1732
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1733
- command.query['userIp'] = user_ip unless user_ip.nil?
1734
- execute_or_queue_command(command, &block)
1735
- end
1736
-
1737
- # Updates an existing user in a Cloud SQL instance.
1738
- # @param [String] project
1739
- # Project ID of the project that contains the instance.
1740
- # @param [String] instance
1741
- # Database instance ID. This does not include the project ID.
1742
- # @param [String] name
1743
- # Name of the user in the instance.
1744
- # @param [Google::Apis::SqladminV1beta4::User] user_object
1745
- # @param [String] host
1746
- # Host of the user in the instance. For a MySQL instance, it's required; For a
1747
- # PostgreSQL instance, it's optional.
1748
- # @param [String] fields
1749
- # Selector specifying which fields to include in a partial response.
1750
- # @param [String] quota_user
1751
- # An opaque string that represents a user for quota purposes. Must not exceed 40
1752
- # characters.
1753
- # @param [String] user_ip
1754
- # Deprecated. Please use quotaUser instead.
1755
- # @param [Google::Apis::RequestOptions] options
1756
- # Request-specific options
1757
- #
1758
- # @yield [result, err] Result & error if block supplied
1759
- # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
1760
- # @yieldparam err [StandardError] error object if request failed
1761
- #
1762
- # @return [Google::Apis::SqladminV1beta4::Operation]
1763
- #
1764
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1765
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1766
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1767
- def update_user(project, instance, name, user_object = nil, host: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1768
- command = make_simple_command(:put, 'projects/{project}/instances/{instance}/users', options)
1769
- command.request_representation = Google::Apis::SqladminV1beta4::User::Representation
1770
- command.request_object = user_object
1771
- command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
1772
- command.response_class = Google::Apis::SqladminV1beta4::Operation
1773
- command.params['project'] = project unless project.nil?
1774
- command.params['instance'] = instance unless instance.nil?
1775
- command.query['host'] = host unless host.nil?
1776
- command.query['name'] = name unless name.nil?
1777
- command.query['fields'] = fields unless fields.nil?
1778
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1779
- command.query['userIp'] = user_ip unless user_ip.nil?
1780
- execute_or_queue_command(command, &block)
1781
- end
1782
-
1783
- protected
1784
-
1785
- def apply_command_defaults(command)
1786
- command.query['key'] = key unless key.nil?
1787
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1788
- command.query['userIp'] = user_ip unless user_ip.nil?
1789
- end
1790
- end
1791
- end
1792
- end
1793
- end