google-api-client 0.34.1 → 0.35.0

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