google-api-client 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (315) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +7 -0
  3. data/api_names.yaml +945 -41609
  4. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +12 -12
  5. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +2 -2
  6. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +1437 -412
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +516 -71
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +1098 -422
  10. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +6 -6
  11. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +3 -3
  12. data/generated/google/apis/adexchangebuyer_v1_4/service.rb +3 -3
  13. data/generated/google/apis/adexchangeseller_v2_0/service.rb +10 -10
  14. data/generated/google/apis/admin_directory_v1/service.rb +26 -26
  15. data/generated/google/apis/adsense_v1_4.rb +1 -1
  16. data/generated/google/apis/adsense_v1_4/classes.rb +2 -2
  17. data/generated/google/apis/adsense_v1_4/representations.rb +3 -3
  18. data/generated/google/apis/adsense_v1_4/service.rb +44 -44
  19. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  20. data/generated/google/apis/adsensehost_v4_1/service.rb +22 -22
  21. data/generated/google/apis/analytics_v3/classes.rb +3 -3
  22. data/generated/google/apis/analytics_v3/representations.rb +3 -3
  23. data/generated/google/apis/analytics_v3/service.rb +82 -82
  24. data/generated/google/apis/analyticsreporting_v4/classes.rb +937 -937
  25. data/generated/google/apis/analyticsreporting_v4/representations.rb +128 -128
  26. data/generated/google/apis/analyticsreporting_v4/service.rb +1 -1
  27. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  28. data/generated/google/apis/androidenterprise_v1/classes.rb +10 -10
  29. data/generated/google/apis/androidenterprise_v1/representations.rb +20 -20
  30. data/generated/google/apis/androidenterprise_v1/service.rb +43 -43
  31. data/generated/google/apis/androidpublisher_v2/classes.rb +26 -26
  32. data/generated/google/apis/androidpublisher_v2/representations.rb +46 -46
  33. data/generated/google/apis/androidpublisher_v2/service.rb +95 -95
  34. data/generated/google/apis/appengine_v1.rb +4 -4
  35. data/generated/google/apis/appengine_v1/classes.rb +1570 -1512
  36. data/generated/google/apis/appengine_v1/representations.rb +362 -343
  37. data/generated/google/apis/appengine_v1/service.rb +220 -220
  38. data/generated/google/apis/appstate_v1.rb +1 -1
  39. data/generated/google/apis/bigquery_v2.rb +1 -1
  40. data/generated/google/apis/bigquery_v2/classes.rb +5 -5
  41. data/generated/google/apis/bigquery_v2/representations.rb +8 -8
  42. data/generated/google/apis/bigquery_v2/service.rb +13 -13
  43. data/generated/google/apis/blogger_v3/service.rb +3 -3
  44. data/generated/google/apis/books_v1/classes.rb +55 -55
  45. data/generated/google/apis/books_v1/representations.rb +67 -67
  46. data/generated/google/apis/books_v1/service.rb +82 -82
  47. data/generated/google/apis/calendar_v3.rb +1 -1
  48. data/generated/google/apis/calendar_v3/classes.rb +6 -6
  49. data/generated/google/apis/calendar_v3/representations.rb +3 -3
  50. data/generated/google/apis/calendar_v3/service.rb +2 -2
  51. data/generated/google/apis/civicinfo_v2/classes.rb +2 -2
  52. data/generated/google/apis/civicinfo_v2/representations.rb +4 -4
  53. data/generated/google/apis/civicinfo_v2/service.rb +12 -12
  54. data/generated/google/apis/classroom_v1.rb +7 -7
  55. data/generated/google/apis/classroom_v1/classes.rb +1013 -991
  56. data/generated/google/apis/classroom_v1/representations.rb +207 -204
  57. data/generated/google/apis/classroom_v1/service.rb +709 -709
  58. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  59. data/generated/google/apis/cloudbuild_v1/classes.rb +307 -307
  60. data/generated/google/apis/cloudbuild_v1/representations.rb +84 -84
  61. data/generated/google/apis/cloudbuild_v1/service.rb +125 -125
  62. data/generated/google/apis/clouddebugger_v2/classes.rb +673 -673
  63. data/generated/google/apis/clouddebugger_v2/representations.rb +152 -152
  64. data/generated/google/apis/clouddebugger_v2/service.rb +55 -55
  65. data/generated/google/apis/clouderrorreporting_v1beta1.rb +1 -1
  66. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +121 -121
  67. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +25 -25
  68. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +74 -74
  69. data/generated/google/apis/cloudkms_v1.rb +1 -1
  70. data/generated/google/apis/cloudkms_v1/classes.rb +668 -613
  71. data/generated/google/apis/cloudkms_v1/representations.rb +151 -133
  72. data/generated/google/apis/cloudkms_v1/service.rb +267 -267
  73. data/generated/google/apis/cloudresourcemanager_v1.rb +4 -4
  74. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1167 -1168
  75. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +193 -193
  76. data/generated/google/apis/cloudresourcemanager_v1/service.rb +470 -469
  77. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  78. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +508 -509
  79. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +94 -94
  80. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +157 -156
  81. data/generated/google/apis/cloudtrace_v1/service.rb +34 -34
  82. data/generated/google/apis/compute_beta.rb +1 -1
  83. data/generated/google/apis/compute_beta/classes.rb +163 -15
  84. data/generated/google/apis/compute_beta/representations.rb +54 -14
  85. data/generated/google/apis/compute_beta/service.rb +2258 -482
  86. data/generated/google/apis/compute_v1.rb +1 -1
  87. data/generated/google/apis/compute_v1/classes.rb +465 -13
  88. data/generated/google/apis/compute_v1/representations.rb +202 -16
  89. data/generated/google/apis/compute_v1/service.rb +573 -309
  90. data/generated/google/apis/container_v1.rb +1 -1
  91. data/generated/google/apis/container_v1/classes.rb +635 -589
  92. data/generated/google/apis/container_v1/representations.rb +139 -111
  93. data/generated/google/apis/container_v1/service.rb +272 -227
  94. data/generated/google/apis/content_v2.rb +1 -1
  95. data/generated/google/apis/content_v2/classes.rb +86 -74
  96. data/generated/google/apis/content_v2/representations.rb +107 -105
  97. data/generated/google/apis/content_v2/service.rb +131 -130
  98. data/generated/google/apis/customsearch_v1.rb +2 -2
  99. data/generated/google/apis/customsearch_v1/classes.rb +0 -6
  100. data/generated/google/apis/customsearch_v1/representations.rb +0 -1
  101. data/generated/google/apis/customsearch_v1/service.rb +2 -5
  102. data/generated/google/apis/dataflow_v1b3.rb +7 -4
  103. data/generated/google/apis/dataflow_v1b3/classes.rb +3405 -3405
  104. data/generated/google/apis/dataflow_v1b3/representations.rb +834 -834
  105. data/generated/google/apis/dataflow_v1b3/service.rb +244 -244
  106. data/generated/google/apis/dataproc_v1.rb +1 -1
  107. data/generated/google/apis/dataproc_v1/classes.rb +543 -691
  108. data/generated/google/apis/dataproc_v1/representations.rb +129 -185
  109. data/generated/google/apis/dataproc_v1/service.rb +347 -347
  110. data/generated/google/apis/datastore_v1.rb +4 -4
  111. data/generated/google/apis/datastore_v1/classes.rb +833 -833
  112. data/generated/google/apis/datastore_v1/representations.rb +182 -182
  113. data/generated/google/apis/datastore_v1/service.rb +45 -45
  114. data/generated/google/apis/deploymentmanager_v2/classes.rb +5 -5
  115. data/generated/google/apis/deploymentmanager_v2/representations.rb +10 -10
  116. data/generated/google/apis/deploymentmanager_v2/service.rb +20 -20
  117. data/generated/google/apis/discovery_v1/classes.rb +4 -4
  118. data/generated/google/apis/discovery_v1/representations.rb +2 -2
  119. data/generated/google/apis/discovery_v1/service.rb +1 -1
  120. data/generated/google/apis/dns_v1.rb +1 -1
  121. data/generated/google/apis/dns_v1/classes.rb +3 -3
  122. data/generated/google/apis/dns_v1/representations.rb +6 -6
  123. data/generated/google/apis/dns_v1/service.rb +12 -12
  124. data/generated/google/apis/dns_v2beta1.rb +1 -1
  125. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +8 -8
  126. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  127. data/generated/google/apis/drive_v2.rb +1 -1
  128. data/generated/google/apis/drive_v2/classes.rb +1 -1
  129. data/generated/google/apis/drive_v2/service.rb +1 -1
  130. data/generated/google/apis/drive_v3.rb +1 -1
  131. data/generated/google/apis/drive_v3/service.rb +1 -1
  132. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  133. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +160 -110
  134. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +60 -31
  135. data/generated/google/apis/firebasedynamiclinks_v1/service.rb +38 -3
  136. data/generated/google/apis/firebaserules_v1/classes.rb +354 -354
  137. data/generated/google/apis/firebaserules_v1/representations.rb +87 -87
  138. data/generated/google/apis/firebaserules_v1/service.rb +103 -103
  139. data/generated/google/apis/fusiontables_v2/service.rb +2 -2
  140. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  141. data/generated/google/apis/games_configuration_v1configuration/classes.rb +2 -2
  142. data/generated/google/apis/games_configuration_v1configuration/representations.rb +4 -4
  143. data/generated/google/apis/games_configuration_v1configuration/service.rb +8 -8
  144. data/generated/google/apis/games_management_v1management.rb +1 -1
  145. data/generated/google/apis/games_v1.rb +1 -1
  146. data/generated/google/apis/games_v1/classes.rb +23 -23
  147. data/generated/google/apis/games_v1/representations.rb +43 -43
  148. data/generated/google/apis/games_v1/service.rb +72 -72
  149. data/generated/google/apis/genomics_v1.rb +1 -1
  150. data/generated/google/apis/genomics_v1/classes.rb +2316 -2316
  151. data/generated/google/apis/genomics_v1/representations.rb +291 -291
  152. data/generated/google/apis/genomics_v1/service.rb +821 -821
  153. data/generated/google/apis/gmail_v1.rb +1 -1
  154. data/generated/google/apis/groupsmigration_v1.rb +1 -1
  155. data/generated/google/apis/groupssettings_v1.rb +1 -1
  156. data/generated/google/apis/groupssettings_v1/classes.rb +2 -2
  157. data/generated/google/apis/groupssettings_v1/service.rb +3 -0
  158. data/generated/google/apis/iam_v1/classes.rb +338 -338
  159. data/generated/google/apis/iam_v1/representations.rb +98 -98
  160. data/generated/google/apis/iam_v1/service.rb +35 -35
  161. data/generated/google/apis/identitytoolkit_v3/classes.rb +15 -15
  162. data/generated/google/apis/identitytoolkit_v3/representations.rb +30 -30
  163. data/generated/google/apis/identitytoolkit_v3/service.rb +64 -64
  164. data/generated/google/apis/kgsearch_v1/service.rb +13 -13
  165. data/generated/google/apis/language_v1.rb +1 -1
  166. data/generated/google/apis/language_v1/classes.rb +374 -374
  167. data/generated/google/apis/language_v1/representations.rb +97 -97
  168. data/generated/google/apis/language_v1/service.rb +16 -16
  169. data/generated/google/apis/language_v1beta1.rb +1 -1
  170. data/generated/google/apis/language_v1beta1/classes.rb +441 -441
  171. data/generated/google/apis/language_v1beta1/representations.rb +108 -108
  172. data/generated/google/apis/language_v1beta1/service.rb +30 -30
  173. data/generated/google/apis/licensing_v1/service.rb +2 -2
  174. data/generated/google/apis/logging_v2.rb +1 -1
  175. data/generated/google/apis/logging_v2/classes.rb +712 -712
  176. data/generated/google/apis/logging_v2/representations.rb +109 -109
  177. data/generated/google/apis/logging_v2/service.rb +543 -539
  178. data/generated/google/apis/logging_v2beta1.rb +1 -1
  179. data/generated/google/apis/logging_v2beta1/classes.rb +752 -752
  180. data/generated/google/apis/logging_v2beta1/representations.rb +94 -94
  181. data/generated/google/apis/logging_v2beta1/service.rb +257 -256
  182. data/generated/google/apis/manufacturers_v1/classes.rb +130 -130
  183. data/generated/google/apis/manufacturers_v1/representations.rb +28 -28
  184. data/generated/google/apis/mirror_v1/classes.rb +5 -5
  185. data/generated/google/apis/mirror_v1/representations.rb +10 -10
  186. data/generated/google/apis/mirror_v1/service.rb +20 -20
  187. data/generated/google/apis/ml_v1.rb +1 -1
  188. data/generated/google/apis/ml_v1/classes.rb +1830 -1210
  189. data/generated/google/apis/ml_v1/representations.rb +342 -120
  190. data/generated/google/apis/ml_v1/service.rb +365 -258
  191. data/generated/google/apis/monitoring_v3.rb +4 -4
  192. data/generated/google/apis/monitoring_v3/classes.rb +889 -889
  193. data/generated/google/apis/monitoring_v3/representations.rb +174 -174
  194. data/generated/google/apis/monitoring_v3/service.rb +119 -119
  195. data/generated/google/apis/mybusiness_v3/service.rb +5 -5
  196. data/generated/google/apis/oauth2_v2/service.rb +1 -1
  197. data/generated/google/apis/pagespeedonline_v2/classes.rb +11 -11
  198. data/generated/google/apis/pagespeedonline_v2/representations.rb +13 -13
  199. data/generated/google/apis/pagespeedonline_v2/service.rb +1 -1
  200. data/generated/google/apis/partners_v2.rb +1 -1
  201. data/generated/google/apis/partners_v2/classes.rb +550 -536
  202. data/generated/google/apis/partners_v2/representations.rb +118 -116
  203. data/generated/google/apis/partners_v2/service.rb +439 -439
  204. data/generated/google/apis/people_v1.rb +4 -4
  205. data/generated/google/apis/people_v1/classes.rb +414 -413
  206. data/generated/google/apis/people_v1/representations.rb +85 -85
  207. data/generated/google/apis/people_v1/service.rb +111 -18
  208. data/generated/google/apis/plus_domains_v1.rb +1 -1
  209. data/generated/google/apis/plus_domains_v1/service.rb +4 -4
  210. data/generated/google/apis/plus_v1.rb +1 -1
  211. data/generated/google/apis/plus_v1/service.rb +1 -1
  212. data/generated/google/apis/prediction_v1_6/service.rb +8 -8
  213. data/generated/google/apis/proximitybeacon_v1beta1.rb +1 -1
  214. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +443 -443
  215. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +92 -92
  216. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +152 -152
  217. data/generated/google/apis/pubsub_v1/classes.rb +249 -249
  218. data/generated/google/apis/pubsub_v1/representations.rb +80 -80
  219. data/generated/google/apis/pubsub_v1/service.rb +415 -415
  220. data/generated/google/apis/qpx_express_v1/classes.rb +2 -2
  221. data/generated/google/apis/qpx_express_v1/representations.rb +4 -4
  222. data/generated/google/apis/qpx_express_v1/service.rb +8 -8
  223. data/generated/google/apis/replicapool_v1beta2/classes.rb +5 -5
  224. data/generated/google/apis/replicapool_v1beta2/representations.rb +10 -10
  225. data/generated/google/apis/replicapool_v1beta2/service.rb +21 -21
  226. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +1 -1
  227. data/generated/google/apis/resourceviews_v1beta2/classes.rb +5 -5
  228. data/generated/google/apis/resourceviews_v1beta2/representations.rb +10 -10
  229. data/generated/google/apis/resourceviews_v1beta2/service.rb +20 -20
  230. data/generated/google/apis/runtimeconfig_v1.rb +4 -4
  231. data/generated/google/apis/runtimeconfig_v1/classes.rb +15 -15
  232. data/generated/google/apis/runtimeconfig_v1/representations.rb +2 -2
  233. data/generated/google/apis/runtimeconfig_v1/service.rb +4 -4
  234. data/generated/google/apis/script_v1.rb +17 -17
  235. data/generated/google/apis/script_v1/classes.rb +27 -27
  236. data/generated/google/apis/script_v1/representations.rb +5 -5
  237. data/generated/google/apis/script_v1/service.rb +4 -4
  238. data/generated/google/apis/searchconsole_v1.rb +1 -1
  239. data/generated/google/apis/searchconsole_v1/classes.rb +53 -53
  240. data/generated/google/apis/searchconsole_v1/representations.rb +23 -23
  241. data/generated/google/apis/searchconsole_v1/service.rb +4 -4
  242. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  243. data/generated/google/apis/servicecontrol_v1/classes.rb +1175 -1175
  244. data/generated/google/apis/servicecontrol_v1/representations.rb +206 -206
  245. data/generated/google/apis/servicecontrol_v1/service.rb +116 -116
  246. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  247. data/generated/google/apis/servicemanagement_v1/classes.rb +1186 -1125
  248. data/generated/google/apis/servicemanagement_v1/representations.rb +241 -223
  249. data/generated/google/apis/servicemanagement_v1/service.rb +201 -201
  250. data/generated/google/apis/serviceuser_v1.rb +1 -1
  251. data/generated/google/apis/serviceuser_v1/classes.rb +2645 -2641
  252. data/generated/google/apis/serviceuser_v1/representations.rb +234 -234
  253. data/generated/google/apis/serviceuser_v1/service.rb +37 -37
  254. data/generated/google/apis/sheets_v4.rb +1 -1
  255. data/generated/google/apis/sheets_v4/classes.rb +5042 -4111
  256. data/generated/google/apis/sheets_v4/representations.rb +994 -824
  257. data/generated/google/apis/sheets_v4/service.rb +80 -80
  258. data/generated/google/apis/site_verification_v1/classes.rb +6 -6
  259. data/generated/google/apis/site_verification_v1/representations.rb +8 -8
  260. data/generated/google/apis/site_verification_v1/service.rb +12 -12
  261. data/generated/google/apis/slides_v1.rb +1 -1
  262. data/generated/google/apis/slides_v1/classes.rb +2885 -2885
  263. data/generated/google/apis/slides_v1/representations.rb +310 -310
  264. data/generated/google/apis/slides_v1/service.rb +54 -54
  265. data/generated/google/apis/sourcerepo_v1/classes.rb +206 -206
  266. data/generated/google/apis/sourcerepo_v1/representations.rb +52 -52
  267. data/generated/google/apis/sourcerepo_v1/service.rb +5 -5
  268. data/generated/google/apis/spanner_v1.rb +1 -1
  269. data/generated/google/apis/spanner_v1/classes.rb +2142 -2141
  270. data/generated/google/apis/spanner_v1/representations.rb +174 -174
  271. data/generated/google/apis/spanner_v1/service.rb +497 -497
  272. data/generated/google/apis/speech_v1beta1.rb +1 -1
  273. data/generated/google/apis/speech_v1beta1/classes.rb +227 -227
  274. data/generated/google/apis/speech_v1beta1/representations.rb +50 -50
  275. data/generated/google/apis/speech_v1beta1/service.rb +33 -33
  276. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  277. data/generated/google/apis/sqladmin_v1beta4/classes.rb +21 -21
  278. data/generated/google/apis/sqladmin_v1beta4/representations.rb +29 -29
  279. data/generated/google/apis/sqladmin_v1beta4/service.rb +56 -56
  280. data/generated/google/apis/storage_v1.rb +1 -1
  281. data/generated/google/apis/storage_v1/classes.rb +40 -6
  282. data/generated/google/apis/storage_v1/representations.rb +20 -4
  283. data/generated/google/apis/storage_v1/service.rb +61 -46
  284. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  285. data/generated/google/apis/storagetransfer_v1/classes.rb +184 -184
  286. data/generated/google/apis/storagetransfer_v1/representations.rb +35 -35
  287. data/generated/google/apis/storagetransfer_v1/service.rb +70 -70
  288. data/generated/google/apis/tagmanager_v1/service.rb +33 -33
  289. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  290. data/generated/google/apis/translate_v2/classes.rb +12 -12
  291. data/generated/google/apis/translate_v2/representations.rb +10 -10
  292. data/generated/google/apis/translate_v2/service.rb +62 -62
  293. data/generated/google/apis/vision_v1.rb +1 -1
  294. data/generated/google/apis/vision_v1/classes.rb +1267 -1267
  295. data/generated/google/apis/vision_v1/representations.rb +200 -200
  296. data/generated/google/apis/vision_v1/service.rb +10 -10
  297. data/generated/google/apis/webmasters_v3.rb +1 -1
  298. data/generated/google/apis/webmasters_v3/classes.rb +4 -4
  299. data/generated/google/apis/webmasters_v3/representations.rb +8 -8
  300. data/generated/google/apis/webmasters_v3/service.rb +21 -21
  301. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  302. data/generated/google/apis/youtube_analytics_v1/classes.rb +2 -2
  303. data/generated/google/apis/youtube_analytics_v1/representations.rb +4 -4
  304. data/generated/google/apis/youtube_analytics_v1/service.rb +8 -8
  305. data/generated/google/apis/youtube_v3/classes.rb +20 -20
  306. data/generated/google/apis/youtube_v3/representations.rb +40 -40
  307. data/generated/google/apis/youtube_v3/service.rb +80 -80
  308. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  309. data/generated/google/apis/youtubereporting_v1/classes.rb +129 -129
  310. data/generated/google/apis/youtubereporting_v1/representations.rb +38 -38
  311. data/generated/google/apis/youtubereporting_v1/service.rb +97 -97
  312. data/lib/google/apis/generator/annotator.rb +2 -2
  313. data/lib/google/apis/generator/model.rb +2 -2
  314. data/lib/google/apis/version.rb +1 -1
  315. metadata +2 -2
@@ -51,12 +51,12 @@ module Google
51
51
  # Lists information about the supported locations for this service.
52
52
  # @param [String] name
53
53
  # The resource that owns the locations collection, if applicable.
54
+ # @param [String] filter
55
+ # The standard list filter.
54
56
  # @param [String] page_token
55
57
  # The standard list page token.
56
58
  # @param [Fixnum] page_size
57
59
  # The standard list page size.
58
- # @param [String] filter
59
- # The standard list filter.
60
60
  # @param [String] fields
61
61
  # Selector specifying which fields to include in a partial response.
62
62
  # @param [String] quota_user
@@ -74,14 +74,14 @@ module Google
74
74
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
75
75
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
76
76
  # @raise [Google::Apis::AuthorizationError] Authorization is required
77
- def list_project_locations(name, page_token: nil, page_size: nil, filter: nil, fields: nil, quota_user: nil, options: nil, &block)
77
+ def list_project_locations(name, filter: nil, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
78
78
  command = make_simple_command(:get, 'v1/{+name}/locations', options)
79
79
  command.response_representation = Google::Apis::CloudkmsV1::ListLocationsResponse::Representation
80
80
  command.response_class = Google::Apis::CloudkmsV1::ListLocationsResponse
81
81
  command.params['name'] = name unless name.nil?
82
+ command.query['filter'] = filter unless filter.nil?
82
83
  command.query['pageToken'] = page_token unless page_token.nil?
83
84
  command.query['pageSize'] = page_size unless page_size.nil?
84
- command.query['filter'] = filter unless filter.nil?
85
85
  command.query['fields'] = fields unless fields.nil?
86
86
  command.query['quotaUser'] = quota_user unless quota_user.nil?
87
87
  execute_or_queue_command(command, &block)
@@ -117,6 +117,39 @@ module Google
117
117
  execute_or_queue_command(command, &block)
118
118
  end
119
119
 
120
+ # Gets the access control policy for a resource.
121
+ # Returns an empty policy if the resource exists and does not have a policy
122
+ # set.
123
+ # @param [String] resource
124
+ # REQUIRED: The resource for which the policy is being requested.
125
+ # See the operation documentation for the appropriate value for this field.
126
+ # @param [String] fields
127
+ # Selector specifying which fields to include in a partial response.
128
+ # @param [String] quota_user
129
+ # Available to use for quota purposes for server-side applications. Can be any
130
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
131
+ # @param [Google::Apis::RequestOptions] options
132
+ # Request-specific options
133
+ #
134
+ # @yield [result, err] Result & error if block supplied
135
+ # @yieldparam result [Google::Apis::CloudkmsV1::Policy] parsed result object
136
+ # @yieldparam err [StandardError] error object if request failed
137
+ #
138
+ # @return [Google::Apis::CloudkmsV1::Policy]
139
+ #
140
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
141
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
142
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
143
+ def get_project_location_key_ring_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
144
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
145
+ command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation
146
+ command.response_class = Google::Apis::CloudkmsV1::Policy
147
+ command.params['resource'] = resource unless resource.nil?
148
+ command.query['fields'] = fields unless fields.nil?
149
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
150
+ execute_or_queue_command(command, &block)
151
+ end
152
+
120
153
  # Returns metadata for a given KeyRing.
121
154
  # @param [String] name
122
155
  # The name of the KeyRing to get.
@@ -190,14 +223,14 @@ module Google
190
223
  # @param [String] parent
191
224
  # Required. The resource name of the location associated with the
192
225
  # KeyRings, in the format `projects/*/locations/*`.
193
- # @param [String] page_token
194
- # Optional pagination token, returned earlier via
195
- # ListKeyRingsResponse.next_page_token.
196
226
  # @param [Fixnum] page_size
197
227
  # Optional limit on the number of KeyRings to include in the
198
228
  # response. Further KeyRings can subsequently be obtained by
199
229
  # including the ListKeyRingsResponse.next_page_token in a subsequent
200
230
  # request. If unspecified, the server will pick an appropriate default.
231
+ # @param [String] page_token
232
+ # Optional pagination token, returned earlier via
233
+ # ListKeyRingsResponse.next_page_token.
201
234
  # @param [String] fields
202
235
  # Selector specifying which fields to include in a partial response.
203
236
  # @param [String] quota_user
@@ -215,13 +248,13 @@ module Google
215
248
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
216
249
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
217
250
  # @raise [Google::Apis::AuthorizationError] Authorization is required
218
- def list_project_location_key_rings(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
251
+ def list_project_location_key_rings(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
219
252
  command = make_simple_command(:get, 'v1/{+parent}/keyRings', options)
220
253
  command.response_representation = Google::Apis::CloudkmsV1::ListKeyRingsResponse::Representation
221
254
  command.response_class = Google::Apis::CloudkmsV1::ListKeyRingsResponse
222
255
  command.params['parent'] = parent unless parent.nil?
223
- command.query['pageToken'] = page_token unless page_token.nil?
224
256
  command.query['pageSize'] = page_size unless page_size.nil?
257
+ command.query['pageToken'] = page_token unless page_token.nil?
225
258
  command.query['fields'] = fields unless fields.nil?
226
259
  command.query['quotaUser'] = quota_user unless quota_user.nil?
227
260
  execute_or_queue_command(command, &block)
@@ -300,12 +333,18 @@ module Google
300
333
  execute_or_queue_command(command, &block)
301
334
  end
302
335
 
303
- # Gets the access control policy for a resource.
304
- # Returns an empty policy if the resource exists and does not have a policy
305
- # set.
306
- # @param [String] resource
307
- # REQUIRED: The resource for which the policy is being requested.
308
- # See the operation documentation for the appropriate value for this field.
336
+ # Lists CryptoKeys.
337
+ # @param [String] parent
338
+ # Required. The resource name of the KeyRing to list, in the format
339
+ # `projects/*/locations/*/keyRings/*`.
340
+ # @param [String] page_token
341
+ # Optional pagination token, returned earlier via
342
+ # ListCryptoKeysResponse.next_page_token.
343
+ # @param [Fixnum] page_size
344
+ # Optional limit on the number of CryptoKeys to include in the
345
+ # response. Further CryptoKeys can subsequently be obtained by
346
+ # including the ListCryptoKeysResponse.next_page_token in a subsequent
347
+ # request. If unspecified, the server will pick an appropriate default.
309
348
  # @param [String] fields
310
349
  # Selector specifying which fields to include in a partial response.
311
350
  # @param [String] quota_user
@@ -315,31 +354,33 @@ module Google
315
354
  # Request-specific options
316
355
  #
317
356
  # @yield [result, err] Result & error if block supplied
318
- # @yieldparam result [Google::Apis::CloudkmsV1::Policy] parsed result object
357
+ # @yieldparam result [Google::Apis::CloudkmsV1::ListCryptoKeysResponse] parsed result object
319
358
  # @yieldparam err [StandardError] error object if request failed
320
359
  #
321
- # @return [Google::Apis::CloudkmsV1::Policy]
360
+ # @return [Google::Apis::CloudkmsV1::ListCryptoKeysResponse]
322
361
  #
323
362
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
324
363
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
325
364
  # @raise [Google::Apis::AuthorizationError] Authorization is required
326
- def get_project_location_key_ring_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
327
- command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
328
- command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation
329
- command.response_class = Google::Apis::CloudkmsV1::Policy
330
- command.params['resource'] = resource unless resource.nil?
365
+ def list_project_location_key_ring_crypto_keys(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
366
+ command = make_simple_command(:get, 'v1/{+parent}/cryptoKeys', options)
367
+ command.response_representation = Google::Apis::CloudkmsV1::ListCryptoKeysResponse::Representation
368
+ command.response_class = Google::Apis::CloudkmsV1::ListCryptoKeysResponse
369
+ command.params['parent'] = parent unless parent.nil?
370
+ command.query['pageToken'] = page_token unless page_token.nil?
371
+ command.query['pageSize'] = page_size unless page_size.nil?
331
372
  command.query['fields'] = fields unless fields.nil?
332
373
  command.query['quotaUser'] = quota_user unless quota_user.nil?
333
374
  execute_or_queue_command(command, &block)
334
375
  end
335
376
 
336
- # Update a CryptoKey.
377
+ # Encrypts data, so that it can only be recovered by a call to Decrypt.
337
378
  # @param [String] name
338
- # Output only. The resource name for this CryptoKey in the format
339
- # `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
340
- # @param [Google::Apis::CloudkmsV1::CryptoKey] crypto_key_object
341
- # @param [String] update_mask
342
- # Required list of fields to be updated in this request.
379
+ # Required. The resource name of the CryptoKey or CryptoKeyVersion
380
+ # to use for encryption.
381
+ # If a CryptoKey is specified, the server will use its
382
+ # primary version.
383
+ # @param [Google::Apis::CloudkmsV1::EncryptRequest] encrypt_request_object
343
384
  # @param [String] fields
344
385
  # Selector specifying which fields to include in a partial response.
345
386
  # @param [String] quota_user
@@ -349,31 +390,35 @@ module Google
349
390
  # Request-specific options
350
391
  #
351
392
  # @yield [result, err] Result & error if block supplied
352
- # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKey] parsed result object
393
+ # @yieldparam result [Google::Apis::CloudkmsV1::EncryptResponse] parsed result object
353
394
  # @yieldparam err [StandardError] error object if request failed
354
395
  #
355
- # @return [Google::Apis::CloudkmsV1::CryptoKey]
396
+ # @return [Google::Apis::CloudkmsV1::EncryptResponse]
356
397
  #
357
398
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
358
399
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
359
400
  # @raise [Google::Apis::AuthorizationError] Authorization is required
360
- def patch_project_location_key_ring_crypto_key(name, crypto_key_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
361
- command = make_simple_command(:patch, 'v1/{+name}', options)
362
- command.request_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
363
- command.request_object = crypto_key_object
364
- command.response_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
365
- command.response_class = Google::Apis::CloudkmsV1::CryptoKey
401
+ def encrypt_crypto_key(name, encrypt_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
402
+ command = make_simple_command(:post, 'v1/{+name}:encrypt', options)
403
+ command.request_representation = Google::Apis::CloudkmsV1::EncryptRequest::Representation
404
+ command.request_object = encrypt_request_object
405
+ command.response_representation = Google::Apis::CloudkmsV1::EncryptResponse::Representation
406
+ command.response_class = Google::Apis::CloudkmsV1::EncryptResponse
366
407
  command.params['name'] = name unless name.nil?
367
- command.query['updateMask'] = update_mask unless update_mask.nil?
368
408
  command.query['fields'] = fields unless fields.nil?
369
409
  command.query['quotaUser'] = quota_user unless quota_user.nil?
370
410
  execute_or_queue_command(command, &block)
371
411
  end
372
412
 
373
- # Returns metadata for a given CryptoKey, as well as its
374
- # primary CryptoKeyVersion.
375
- # @param [String] name
376
- # The name of the CryptoKey to get.
413
+ # Create a new CryptoKey within a KeyRing.
414
+ # CryptoKey.purpose is required.
415
+ # @param [String] parent
416
+ # Required. The name of the KeyRing associated with the
417
+ # CryptoKeys.
418
+ # @param [Google::Apis::CloudkmsV1::CryptoKey] crypto_key_object
419
+ # @param [String] crypto_key_id
420
+ # Required. It must be unique within a KeyRing and match the regular
421
+ # expression `[a-zA-Z0-9_-]`1,63``
377
422
  # @param [String] fields
378
423
  # Selector specifying which fields to include in a partial response.
379
424
  # @param [String] quota_user
@@ -391,26 +436,25 @@ module Google
391
436
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
392
437
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
393
438
  # @raise [Google::Apis::AuthorizationError] Authorization is required
394
- def get_project_location_key_ring_crypto_key(name, fields: nil, quota_user: nil, options: nil, &block)
395
- command = make_simple_command(:get, 'v1/{+name}', options)
439
+ def create_project_location_key_ring_crypto_key(parent, crypto_key_object = nil, crypto_key_id: nil, fields: nil, quota_user: nil, options: nil, &block)
440
+ command = make_simple_command(:post, 'v1/{+parent}/cryptoKeys', options)
441
+ command.request_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
442
+ command.request_object = crypto_key_object
396
443
  command.response_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
397
444
  command.response_class = Google::Apis::CloudkmsV1::CryptoKey
398
- command.params['name'] = name unless name.nil?
445
+ command.params['parent'] = parent unless parent.nil?
446
+ command.query['cryptoKeyId'] = crypto_key_id unless crypto_key_id.nil?
399
447
  command.query['fields'] = fields unless fields.nil?
400
448
  command.query['quotaUser'] = quota_user unless quota_user.nil?
401
449
  execute_or_queue_command(command, &block)
402
450
  end
403
451
 
404
- # Returns permissions that a caller has on the specified resource.
405
- # If the resource does not exist, this will return an empty set of
406
- # permissions, not a NOT_FOUND error.
407
- # Note: This operation is designed to be used for building permission-aware
408
- # UIs and command-line tools, not for authorization checking. This operation
409
- # may "fail open" without warning.
452
+ # Sets the access control policy on the specified resource. Replaces any
453
+ # existing policy.
410
454
  # @param [String] resource
411
- # REQUIRED: The resource for which the policy detail is being requested.
455
+ # REQUIRED: The resource for which the policy is being specified.
412
456
  # See the operation documentation for the appropriate value for this field.
413
- # @param [Google::Apis::CloudkmsV1::TestIamPermissionsRequest] test_iam_permissions_request_object
457
+ # @param [Google::Apis::CloudkmsV1::SetIamPolicyRequest] set_iam_policy_request_object
414
458
  # @param [String] fields
415
459
  # Selector specifying which fields to include in a partial response.
416
460
  # @param [String] quota_user
@@ -420,31 +464,30 @@ module Google
420
464
  # Request-specific options
421
465
  #
422
466
  # @yield [result, err] Result & error if block supplied
423
- # @yieldparam result [Google::Apis::CloudkmsV1::TestIamPermissionsResponse] parsed result object
467
+ # @yieldparam result [Google::Apis::CloudkmsV1::Policy] parsed result object
424
468
  # @yieldparam err [StandardError] error object if request failed
425
469
  #
426
- # @return [Google::Apis::CloudkmsV1::TestIamPermissionsResponse]
470
+ # @return [Google::Apis::CloudkmsV1::Policy]
427
471
  #
428
472
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
429
473
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
430
474
  # @raise [Google::Apis::AuthorizationError] Authorization is required
431
- def test_crypto_key_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
432
- command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
433
- command.request_representation = Google::Apis::CloudkmsV1::TestIamPermissionsRequest::Representation
434
- command.request_object = test_iam_permissions_request_object
435
- command.response_representation = Google::Apis::CloudkmsV1::TestIamPermissionsResponse::Representation
436
- command.response_class = Google::Apis::CloudkmsV1::TestIamPermissionsResponse
475
+ def set_crypto_key_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
476
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
477
+ command.request_representation = Google::Apis::CloudkmsV1::SetIamPolicyRequest::Representation
478
+ command.request_object = set_iam_policy_request_object
479
+ command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation
480
+ command.response_class = Google::Apis::CloudkmsV1::Policy
437
481
  command.params['resource'] = resource unless resource.nil?
438
482
  command.query['fields'] = fields unless fields.nil?
439
483
  command.query['quotaUser'] = quota_user unless quota_user.nil?
440
484
  execute_or_queue_command(command, &block)
441
485
  end
442
486
 
443
- # Decrypt data that was protected by Encrypt.
487
+ # Update the version of a CryptoKey that will be used in Encrypt
444
488
  # @param [String] name
445
- # Required. The resource name of the CryptoKey to use for decryption.
446
- # The server will choose the appropriate version.
447
- # @param [Google::Apis::CloudkmsV1::DecryptRequest] decrypt_request_object
489
+ # The resource name of the CryptoKey to update.
490
+ # @param [Google::Apis::CloudkmsV1::UpdateCryptoKeyPrimaryVersionRequest] update_crypto_key_primary_version_request_object
448
491
  # @param [String] fields
449
492
  # Selector specifying which fields to include in a partial response.
450
493
  # @param [String] quota_user
@@ -454,38 +497,32 @@ module Google
454
497
  # Request-specific options
455
498
  #
456
499
  # @yield [result, err] Result & error if block supplied
457
- # @yieldparam result [Google::Apis::CloudkmsV1::DecryptResponse] parsed result object
500
+ # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKey] parsed result object
458
501
  # @yieldparam err [StandardError] error object if request failed
459
502
  #
460
- # @return [Google::Apis::CloudkmsV1::DecryptResponse]
503
+ # @return [Google::Apis::CloudkmsV1::CryptoKey]
461
504
  #
462
505
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
463
506
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
464
507
  # @raise [Google::Apis::AuthorizationError] Authorization is required
465
- def decrypt_crypto_key(name, decrypt_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
466
- command = make_simple_command(:post, 'v1/{+name}:decrypt', options)
467
- command.request_representation = Google::Apis::CloudkmsV1::DecryptRequest::Representation
468
- command.request_object = decrypt_request_object
469
- command.response_representation = Google::Apis::CloudkmsV1::DecryptResponse::Representation
470
- command.response_class = Google::Apis::CloudkmsV1::DecryptResponse
508
+ def update_project_location_key_ring_crypto_key_primary_version(name, update_crypto_key_primary_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
509
+ command = make_simple_command(:post, 'v1/{+name}:updatePrimaryVersion', options)
510
+ command.request_representation = Google::Apis::CloudkmsV1::UpdateCryptoKeyPrimaryVersionRequest::Representation
511
+ command.request_object = update_crypto_key_primary_version_request_object
512
+ command.response_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
513
+ command.response_class = Google::Apis::CloudkmsV1::CryptoKey
471
514
  command.params['name'] = name unless name.nil?
472
515
  command.query['fields'] = fields unless fields.nil?
473
516
  command.query['quotaUser'] = quota_user unless quota_user.nil?
474
517
  execute_or_queue_command(command, &block)
475
518
  end
476
519
 
477
- # Lists CryptoKeys.
478
- # @param [String] parent
479
- # Required. The resource name of the KeyRing to list, in the format
480
- # `projects/*/locations/*/keyRings/*`.
481
- # @param [String] page_token
482
- # Optional pagination token, returned earlier via
483
- # ListCryptoKeysResponse.next_page_token.
484
- # @param [Fixnum] page_size
485
- # Optional limit on the number of CryptoKeys to include in the
486
- # response. Further CryptoKeys can subsequently be obtained by
487
- # including the ListCryptoKeysResponse.next_page_token in a subsequent
488
- # request. If unspecified, the server will pick an appropriate default.
520
+ # Gets the access control policy for a resource.
521
+ # Returns an empty policy if the resource exists and does not have a policy
522
+ # set.
523
+ # @param [String] resource
524
+ # REQUIRED: The resource for which the policy is being requested.
525
+ # See the operation documentation for the appropriate value for this field.
489
526
  # @param [String] fields
490
527
  # Selector specifying which fields to include in a partial response.
491
528
  # @param [String] quota_user
@@ -495,33 +532,28 @@ module Google
495
532
  # Request-specific options
496
533
  #
497
534
  # @yield [result, err] Result & error if block supplied
498
- # @yieldparam result [Google::Apis::CloudkmsV1::ListCryptoKeysResponse] parsed result object
535
+ # @yieldparam result [Google::Apis::CloudkmsV1::Policy] parsed result object
499
536
  # @yieldparam err [StandardError] error object if request failed
500
537
  #
501
- # @return [Google::Apis::CloudkmsV1::ListCryptoKeysResponse]
538
+ # @return [Google::Apis::CloudkmsV1::Policy]
502
539
  #
503
540
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
504
541
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
505
542
  # @raise [Google::Apis::AuthorizationError] Authorization is required
506
- def list_project_location_key_ring_crypto_keys(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
507
- command = make_simple_command(:get, 'v1/{+parent}/cryptoKeys', options)
508
- command.response_representation = Google::Apis::CloudkmsV1::ListCryptoKeysResponse::Representation
509
- command.response_class = Google::Apis::CloudkmsV1::ListCryptoKeysResponse
510
- command.params['parent'] = parent unless parent.nil?
511
- command.query['pageToken'] = page_token unless page_token.nil?
512
- command.query['pageSize'] = page_size unless page_size.nil?
543
+ def get_project_location_key_ring_crypto_key_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
544
+ command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
545
+ command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation
546
+ command.response_class = Google::Apis::CloudkmsV1::Policy
547
+ command.params['resource'] = resource unless resource.nil?
513
548
  command.query['fields'] = fields unless fields.nil?
514
549
  command.query['quotaUser'] = quota_user unless quota_user.nil?
515
550
  execute_or_queue_command(command, &block)
516
551
  end
517
552
 
518
- # Encrypt data, so that it can only be recovered by a call to Decrypt.
553
+ # Returns metadata for a given CryptoKey, as well as its
554
+ # primary CryptoKeyVersion.
519
555
  # @param [String] name
520
- # Required. The resource name of the CryptoKey or CryptoKeyVersion
521
- # to use for encryption.
522
- # If a CryptoKey is specified, the server will use its
523
- # primary version.
524
- # @param [Google::Apis::CloudkmsV1::EncryptRequest] encrypt_request_object
556
+ # The name of the CryptoKey to get.
525
557
  # @param [String] fields
526
558
  # Selector specifying which fields to include in a partial response.
527
559
  # @param [String] quota_user
@@ -531,32 +563,31 @@ module Google
531
563
  # Request-specific options
532
564
  #
533
565
  # @yield [result, err] Result & error if block supplied
534
- # @yieldparam result [Google::Apis::CloudkmsV1::EncryptResponse] parsed result object
566
+ # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKey] parsed result object
535
567
  # @yieldparam err [StandardError] error object if request failed
536
568
  #
537
- # @return [Google::Apis::CloudkmsV1::EncryptResponse]
569
+ # @return [Google::Apis::CloudkmsV1::CryptoKey]
538
570
  #
539
571
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
540
572
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
541
573
  # @raise [Google::Apis::AuthorizationError] Authorization is required
542
- def encrypt_crypto_key(name, encrypt_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
543
- command = make_simple_command(:post, 'v1/{+name}:encrypt', options)
544
- command.request_representation = Google::Apis::CloudkmsV1::EncryptRequest::Representation
545
- command.request_object = encrypt_request_object
546
- command.response_representation = Google::Apis::CloudkmsV1::EncryptResponse::Representation
547
- command.response_class = Google::Apis::CloudkmsV1::EncryptResponse
574
+ def get_project_location_key_ring_crypto_key(name, fields: nil, quota_user: nil, options: nil, &block)
575
+ command = make_simple_command(:get, 'v1/{+name}', options)
576
+ command.response_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
577
+ command.response_class = Google::Apis::CloudkmsV1::CryptoKey
548
578
  command.params['name'] = name unless name.nil?
549
579
  command.query['fields'] = fields unless fields.nil?
550
580
  command.query['quotaUser'] = quota_user unless quota_user.nil?
551
581
  execute_or_queue_command(command, &block)
552
582
  end
553
583
 
554
- # Sets the access control policy on the specified resource. Replaces any
555
- # existing policy.
556
- # @param [String] resource
557
- # REQUIRED: The resource for which the policy is being specified.
558
- # See the operation documentation for the appropriate value for this field.
559
- # @param [Google::Apis::CloudkmsV1::SetIamPolicyRequest] set_iam_policy_request_object
584
+ # Update a CryptoKey.
585
+ # @param [String] name
586
+ # Output only. The resource name for this CryptoKey in the format
587
+ # `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
588
+ # @param [Google::Apis::CloudkmsV1::CryptoKey] crypto_key_object
589
+ # @param [String] update_mask
590
+ # Required list of fields to be updated in this request.
560
591
  # @param [String] fields
561
592
  # Selector specifying which fields to include in a partial response.
562
593
  # @param [String] quota_user
@@ -566,35 +597,37 @@ module Google
566
597
  # Request-specific options
567
598
  #
568
599
  # @yield [result, err] Result & error if block supplied
569
- # @yieldparam result [Google::Apis::CloudkmsV1::Policy] parsed result object
600
+ # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKey] parsed result object
570
601
  # @yieldparam err [StandardError] error object if request failed
571
602
  #
572
- # @return [Google::Apis::CloudkmsV1::Policy]
603
+ # @return [Google::Apis::CloudkmsV1::CryptoKey]
573
604
  #
574
605
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
575
606
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
576
607
  # @raise [Google::Apis::AuthorizationError] Authorization is required
577
- def set_crypto_key_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
578
- command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
579
- command.request_representation = Google::Apis::CloudkmsV1::SetIamPolicyRequest::Representation
580
- command.request_object = set_iam_policy_request_object
581
- command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation
582
- command.response_class = Google::Apis::CloudkmsV1::Policy
583
- command.params['resource'] = resource unless resource.nil?
608
+ def patch_project_location_key_ring_crypto_key(name, crypto_key_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
609
+ command = make_simple_command(:patch, 'v1/{+name}', options)
610
+ command.request_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
611
+ command.request_object = crypto_key_object
612
+ command.response_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
613
+ command.response_class = Google::Apis::CloudkmsV1::CryptoKey
614
+ command.params['name'] = name unless name.nil?
615
+ command.query['updateMask'] = update_mask unless update_mask.nil?
584
616
  command.query['fields'] = fields unless fields.nil?
585
617
  command.query['quotaUser'] = quota_user unless quota_user.nil?
586
618
  execute_or_queue_command(command, &block)
587
619
  end
588
620
 
589
- # Create a new CryptoKey within a KeyRing.
590
- # CryptoKey.purpose is required.
591
- # @param [String] parent
592
- # Required. The name of the KeyRing associated with the
593
- # CryptoKeys.
594
- # @param [Google::Apis::CloudkmsV1::CryptoKey] crypto_key_object
595
- # @param [String] crypto_key_id
596
- # Required. It must be unique within a KeyRing and match the regular
597
- # expression `[a-zA-Z0-9_-]`1,63``
621
+ # Returns permissions that a caller has on the specified resource.
622
+ # If the resource does not exist, this will return an empty set of
623
+ # permissions, not a NOT_FOUND error.
624
+ # Note: This operation is designed to be used for building permission-aware
625
+ # UIs and command-line tools, not for authorization checking. This operation
626
+ # may "fail open" without warning.
627
+ # @param [String] resource
628
+ # REQUIRED: The resource for which the policy detail is being requested.
629
+ # See the operation documentation for the appropriate value for this field.
630
+ # @param [Google::Apis::CloudkmsV1::TestIamPermissionsRequest] test_iam_permissions_request_object
598
631
  # @param [String] fields
599
632
  # Selector specifying which fields to include in a partial response.
600
633
  # @param [String] quota_user
@@ -604,31 +637,31 @@ module Google
604
637
  # Request-specific options
605
638
  #
606
639
  # @yield [result, err] Result & error if block supplied
607
- # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKey] parsed result object
640
+ # @yieldparam result [Google::Apis::CloudkmsV1::TestIamPermissionsResponse] parsed result object
608
641
  # @yieldparam err [StandardError] error object if request failed
609
642
  #
610
- # @return [Google::Apis::CloudkmsV1::CryptoKey]
643
+ # @return [Google::Apis::CloudkmsV1::TestIamPermissionsResponse]
611
644
  #
612
645
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
613
646
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
614
647
  # @raise [Google::Apis::AuthorizationError] Authorization is required
615
- def create_project_location_key_ring_crypto_key(parent, crypto_key_object = nil, crypto_key_id: nil, fields: nil, quota_user: nil, options: nil, &block)
616
- command = make_simple_command(:post, 'v1/{+parent}/cryptoKeys', options)
617
- command.request_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
618
- command.request_object = crypto_key_object
619
- command.response_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
620
- command.response_class = Google::Apis::CloudkmsV1::CryptoKey
621
- command.params['parent'] = parent unless parent.nil?
622
- command.query['cryptoKeyId'] = crypto_key_id unless crypto_key_id.nil?
648
+ def test_crypto_key_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
649
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
650
+ command.request_representation = Google::Apis::CloudkmsV1::TestIamPermissionsRequest::Representation
651
+ command.request_object = test_iam_permissions_request_object
652
+ command.response_representation = Google::Apis::CloudkmsV1::TestIamPermissionsResponse::Representation
653
+ command.response_class = Google::Apis::CloudkmsV1::TestIamPermissionsResponse
654
+ command.params['resource'] = resource unless resource.nil?
623
655
  command.query['fields'] = fields unless fields.nil?
624
656
  command.query['quotaUser'] = quota_user unless quota_user.nil?
625
657
  execute_or_queue_command(command, &block)
626
658
  end
627
659
 
628
- # Update the version of a CryptoKey that will be used in Encrypt
660
+ # Decrypts data that was protected by Encrypt.
629
661
  # @param [String] name
630
- # The resource name of the CryptoKey to update.
631
- # @param [Google::Apis::CloudkmsV1::UpdateCryptoKeyPrimaryVersionRequest] update_crypto_key_primary_version_request_object
662
+ # Required. The resource name of the CryptoKey to use for decryption.
663
+ # The server will choose the appropriate version.
664
+ # @param [Google::Apis::CloudkmsV1::DecryptRequest] decrypt_request_object
632
665
  # @param [String] fields
633
666
  # Selector specifying which fields to include in a partial response.
634
667
  # @param [String] quota_user
@@ -638,32 +671,38 @@ module Google
638
671
  # Request-specific options
639
672
  #
640
673
  # @yield [result, err] Result & error if block supplied
641
- # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKey] parsed result object
674
+ # @yieldparam result [Google::Apis::CloudkmsV1::DecryptResponse] parsed result object
642
675
  # @yieldparam err [StandardError] error object if request failed
643
676
  #
644
- # @return [Google::Apis::CloudkmsV1::CryptoKey]
677
+ # @return [Google::Apis::CloudkmsV1::DecryptResponse]
645
678
  #
646
679
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
647
680
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
648
681
  # @raise [Google::Apis::AuthorizationError] Authorization is required
649
- def update_project_location_key_ring_crypto_key_primary_version(name, update_crypto_key_primary_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
650
- command = make_simple_command(:post, 'v1/{+name}:updatePrimaryVersion', options)
651
- command.request_representation = Google::Apis::CloudkmsV1::UpdateCryptoKeyPrimaryVersionRequest::Representation
652
- command.request_object = update_crypto_key_primary_version_request_object
653
- command.response_representation = Google::Apis::CloudkmsV1::CryptoKey::Representation
654
- command.response_class = Google::Apis::CloudkmsV1::CryptoKey
682
+ def decrypt_crypto_key(name, decrypt_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
683
+ command = make_simple_command(:post, 'v1/{+name}:decrypt', options)
684
+ command.request_representation = Google::Apis::CloudkmsV1::DecryptRequest::Representation
685
+ command.request_object = decrypt_request_object
686
+ command.response_representation = Google::Apis::CloudkmsV1::DecryptResponse::Representation
687
+ command.response_class = Google::Apis::CloudkmsV1::DecryptResponse
655
688
  command.params['name'] = name unless name.nil?
656
689
  command.query['fields'] = fields unless fields.nil?
657
690
  command.query['quotaUser'] = quota_user unless quota_user.nil?
658
691
  execute_or_queue_command(command, &block)
659
692
  end
660
693
 
661
- # Gets the access control policy for a resource.
662
- # Returns an empty policy if the resource exists and does not have a policy
663
- # set.
664
- # @param [String] resource
665
- # REQUIRED: The resource for which the policy is being requested.
666
- # See the operation documentation for the appropriate value for this field.
694
+ # Update a CryptoKeyVersion's metadata.
695
+ # state may be changed between
696
+ # ENABLED and
697
+ # DISABLED using this
698
+ # method. See DestroyCryptoKeyVersion and RestoreCryptoKeyVersion to
699
+ # move between other states.
700
+ # @param [String] name
701
+ # Output only. The resource name for this CryptoKeyVersion in the format
702
+ # `projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*`.
703
+ # @param [Google::Apis::CloudkmsV1::CryptoKeyVersion] crypto_key_version_object
704
+ # @param [String] update_mask
705
+ # Required list of fields to be updated in this request.
667
706
  # @param [String] fields
668
707
  # Selector specifying which fields to include in a partial response.
669
708
  # @param [String] quota_user
@@ -673,37 +712,30 @@ module Google
673
712
  # Request-specific options
674
713
  #
675
714
  # @yield [result, err] Result & error if block supplied
676
- # @yieldparam result [Google::Apis::CloudkmsV1::Policy] parsed result object
715
+ # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKeyVersion] parsed result object
677
716
  # @yieldparam err [StandardError] error object if request failed
678
717
  #
679
- # @return [Google::Apis::CloudkmsV1::Policy]
718
+ # @return [Google::Apis::CloudkmsV1::CryptoKeyVersion]
680
719
  #
681
720
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
682
721
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
683
722
  # @raise [Google::Apis::AuthorizationError] Authorization is required
684
- def get_project_location_key_ring_crypto_key_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
685
- command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
686
- command.response_representation = Google::Apis::CloudkmsV1::Policy::Representation
687
- command.response_class = Google::Apis::CloudkmsV1::Policy
688
- command.params['resource'] = resource unless resource.nil?
723
+ def patch_project_location_key_ring_crypto_key_crypto_key_version(name, crypto_key_version_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
724
+ command = make_simple_command(:patch, 'v1/{+name}', options)
725
+ command.request_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
726
+ command.request_object = crypto_key_version_object
727
+ command.response_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
728
+ command.response_class = Google::Apis::CloudkmsV1::CryptoKeyVersion
729
+ command.params['name'] = name unless name.nil?
730
+ command.query['updateMask'] = update_mask unless update_mask.nil?
689
731
  command.query['fields'] = fields unless fields.nil?
690
732
  command.query['quotaUser'] = quota_user unless quota_user.nil?
691
733
  execute_or_queue_command(command, &block)
692
734
  end
693
735
 
694
- # Lists CryptoKeyVersions.
695
- # @param [String] parent
696
- # Required. The resource name of the CryptoKey to list, in the format
697
- # `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
698
- # @param [String] page_token
699
- # Optional pagination token, returned earlier via
700
- # ListCryptoKeyVersionsResponse.next_page_token.
701
- # @param [Fixnum] page_size
702
- # Optional limit on the number of CryptoKeyVersions to
703
- # include in the response. Further CryptoKeyVersions can
704
- # subsequently be obtained by including the
705
- # ListCryptoKeyVersionsResponse.next_page_token in a subsequent request.
706
- # If unspecified, the server will pick an appropriate default.
736
+ # Returns metadata for a given CryptoKeyVersion.
737
+ # @param [String] name
738
+ # The name of the CryptoKeyVersion to get.
707
739
  # @param [String] fields
708
740
  # Selector specifying which fields to include in a partial response.
709
741
  # @param [String] quota_user
@@ -713,39 +745,37 @@ module Google
713
745
  # Request-specific options
714
746
  #
715
747
  # @yield [result, err] Result & error if block supplied
716
- # @yieldparam result [Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse] parsed result object
748
+ # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKeyVersion] parsed result object
717
749
  # @yieldparam err [StandardError] error object if request failed
718
750
  #
719
- # @return [Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse]
751
+ # @return [Google::Apis::CloudkmsV1::CryptoKeyVersion]
720
752
  #
721
753
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
722
754
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
723
755
  # @raise [Google::Apis::AuthorizationError] Authorization is required
724
- def list_project_location_key_ring_crypto_key_crypto_key_versions(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
725
- command = make_simple_command(:get, 'v1/{+parent}/cryptoKeyVersions', options)
726
- command.response_representation = Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse::Representation
727
- command.response_class = Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse
728
- command.params['parent'] = parent unless parent.nil?
729
- command.query['pageToken'] = page_token unless page_token.nil?
730
- command.query['pageSize'] = page_size unless page_size.nil?
756
+ def get_project_location_key_ring_crypto_key_crypto_key_version(name, fields: nil, quota_user: nil, options: nil, &block)
757
+ command = make_simple_command(:get, 'v1/{+name}', options)
758
+ command.response_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
759
+ command.response_class = Google::Apis::CloudkmsV1::CryptoKeyVersion
760
+ command.params['name'] = name unless name.nil?
731
761
  command.query['fields'] = fields unless fields.nil?
732
762
  command.query['quotaUser'] = quota_user unless quota_user.nil?
733
763
  execute_or_queue_command(command, &block)
734
764
  end
735
765
 
736
- # Schedule a CryptoKeyVersion for destruction.
737
- # Upon calling this method, CryptoKeyVersion.state will be set to
738
- # DESTROY_SCHEDULED
739
- # and destroy_time will be set to a time 24
740
- # hours in the future, at which point the state
741
- # will be changed to
742
- # DESTROYED, and the key
743
- # material will be irrevocably destroyed.
744
- # Before the destroy_time is reached,
745
- # RestoreCryptoKeyVersion may be called to reverse the process.
746
- # @param [String] name
747
- # The resource name of the CryptoKeyVersion to destroy.
748
- # @param [Google::Apis::CloudkmsV1::DestroyCryptoKeyVersionRequest] destroy_crypto_key_version_request_object
766
+ # Lists CryptoKeyVersions.
767
+ # @param [String] parent
768
+ # Required. The resource name of the CryptoKey to list, in the format
769
+ # `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
770
+ # @param [Fixnum] page_size
771
+ # Optional limit on the number of CryptoKeyVersions to
772
+ # include in the response. Further CryptoKeyVersions can
773
+ # subsequently be obtained by including the
774
+ # ListCryptoKeyVersionsResponse.next_page_token in a subsequent request.
775
+ # If unspecified, the server will pick an appropriate default.
776
+ # @param [String] page_token
777
+ # Optional pagination token, returned earlier via
778
+ # ListCryptoKeyVersionsResponse.next_page_token.
749
779
  # @param [String] fields
750
780
  # Selector specifying which fields to include in a partial response.
751
781
  # @param [String] quota_user
@@ -755,21 +785,21 @@ module Google
755
785
  # Request-specific options
756
786
  #
757
787
  # @yield [result, err] Result & error if block supplied
758
- # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKeyVersion] parsed result object
788
+ # @yieldparam result [Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse] parsed result object
759
789
  # @yieldparam err [StandardError] error object if request failed
760
790
  #
761
- # @return [Google::Apis::CloudkmsV1::CryptoKeyVersion]
791
+ # @return [Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse]
762
792
  #
763
793
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
764
794
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
765
795
  # @raise [Google::Apis::AuthorizationError] Authorization is required
766
- def destroy_crypto_key_version(name, destroy_crypto_key_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
767
- command = make_simple_command(:post, 'v1/{+name}:destroy', options)
768
- command.request_representation = Google::Apis::CloudkmsV1::DestroyCryptoKeyVersionRequest::Representation
769
- command.request_object = destroy_crypto_key_version_request_object
770
- command.response_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
771
- command.response_class = Google::Apis::CloudkmsV1::CryptoKeyVersion
772
- command.params['name'] = name unless name.nil?
796
+ def list_project_location_key_ring_crypto_key_crypto_key_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
797
+ command = make_simple_command(:get, 'v1/{+parent}/cryptoKeyVersions', options)
798
+ command.response_representation = Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse::Representation
799
+ command.response_class = Google::Apis::CloudkmsV1::ListCryptoKeyVersionsResponse
800
+ command.params['parent'] = parent unless parent.nil?
801
+ command.query['pageSize'] = page_size unless page_size.nil?
802
+ command.query['pageToken'] = page_token unless page_token.nil?
773
803
  command.query['fields'] = fields unless fields.nil?
774
804
  command.query['quotaUser'] = quota_user unless quota_user.nil?
775
805
  execute_or_queue_command(command, &block)
@@ -812,47 +842,19 @@ module Google
812
842
  execute_or_queue_command(command, &block)
813
843
  end
814
844
 
815
- # Restore a CryptoKeyVersion in the
816
- # DESTROY_SCHEDULED,
817
- # state.
818
- # Upon restoration of the CryptoKeyVersion, state
819
- # will be set to DISABLED,
820
- # and destroy_time will be cleared.
821
- # @param [String] name
822
- # The resource name of the CryptoKeyVersion to restore.
823
- # @param [Google::Apis::CloudkmsV1::RestoreCryptoKeyVersionRequest] restore_crypto_key_version_request_object
824
- # @param [String] fields
825
- # Selector specifying which fields to include in a partial response.
826
- # @param [String] quota_user
827
- # Available to use for quota purposes for server-side applications. Can be any
828
- # arbitrary string assigned to a user, but should not exceed 40 characters.
829
- # @param [Google::Apis::RequestOptions] options
830
- # Request-specific options
831
- #
832
- # @yield [result, err] Result & error if block supplied
833
- # @yieldparam result [Google::Apis::CloudkmsV1::CryptoKeyVersion] parsed result object
834
- # @yieldparam err [StandardError] error object if request failed
835
- #
836
- # @return [Google::Apis::CloudkmsV1::CryptoKeyVersion]
837
- #
838
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
839
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
840
- # @raise [Google::Apis::AuthorizationError] Authorization is required
841
- def restore_crypto_key_version(name, restore_crypto_key_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
842
- command = make_simple_command(:post, 'v1/{+name}:restore', options)
843
- command.request_representation = Google::Apis::CloudkmsV1::RestoreCryptoKeyVersionRequest::Representation
844
- command.request_object = restore_crypto_key_version_request_object
845
- command.response_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
846
- command.response_class = Google::Apis::CloudkmsV1::CryptoKeyVersion
847
- command.params['name'] = name unless name.nil?
848
- command.query['fields'] = fields unless fields.nil?
849
- command.query['quotaUser'] = quota_user unless quota_user.nil?
850
- execute_or_queue_command(command, &block)
851
- end
852
-
853
- # Returns metadata for a given CryptoKeyVersion.
845
+ # Schedule a CryptoKeyVersion for destruction.
846
+ # Upon calling this method, CryptoKeyVersion.state will be set to
847
+ # DESTROY_SCHEDULED
848
+ # and destroy_time will be set to a time 24
849
+ # hours in the future, at which point the state
850
+ # will be changed to
851
+ # DESTROYED, and the key
852
+ # material will be irrevocably destroyed.
853
+ # Before the destroy_time is reached,
854
+ # RestoreCryptoKeyVersion may be called to reverse the process.
854
855
  # @param [String] name
855
- # The name of the CryptoKeyVersion to get.
856
+ # The resource name of the CryptoKeyVersion to destroy.
857
+ # @param [Google::Apis::CloudkmsV1::DestroyCryptoKeyVersionRequest] destroy_crypto_key_version_request_object
856
858
  # @param [String] fields
857
859
  # Selector specifying which fields to include in a partial response.
858
860
  # @param [String] quota_user
@@ -870,8 +872,10 @@ module Google
870
872
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
871
873
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
872
874
  # @raise [Google::Apis::AuthorizationError] Authorization is required
873
- def get_project_location_key_ring_crypto_key_crypto_key_version(name, fields: nil, quota_user: nil, options: nil, &block)
874
- command = make_simple_command(:get, 'v1/{+name}', options)
875
+ def destroy_crypto_key_version(name, destroy_crypto_key_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
876
+ command = make_simple_command(:post, 'v1/{+name}:destroy', options)
877
+ command.request_representation = Google::Apis::CloudkmsV1::DestroyCryptoKeyVersionRequest::Representation
878
+ command.request_object = destroy_crypto_key_version_request_object
875
879
  command.response_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
876
880
  command.response_class = Google::Apis::CloudkmsV1::CryptoKeyVersion
877
881
  command.params['name'] = name unless name.nil?
@@ -880,18 +884,15 @@ module Google
880
884
  execute_or_queue_command(command, &block)
881
885
  end
882
886
 
883
- # Update a CryptoKeyVersion's metadata.
884
- # state may be changed between
885
- # ENABLED and
886
- # DISABLED using this
887
- # method. See DestroyCryptoKeyVersion and RestoreCryptoKeyVersion to
888
- # move between other states.
887
+ # Restore a CryptoKeyVersion in the
888
+ # DESTROY_SCHEDULED,
889
+ # state.
890
+ # Upon restoration of the CryptoKeyVersion, state
891
+ # will be set to DISABLED,
892
+ # and destroy_time will be cleared.
889
893
  # @param [String] name
890
- # Output only. The resource name for this CryptoKeyVersion in the format
891
- # `projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*`.
892
- # @param [Google::Apis::CloudkmsV1::CryptoKeyVersion] crypto_key_version_object
893
- # @param [String] update_mask
894
- # Required list of fields to be updated in this request.
894
+ # The resource name of the CryptoKeyVersion to restore.
895
+ # @param [Google::Apis::CloudkmsV1::RestoreCryptoKeyVersionRequest] restore_crypto_key_version_request_object
895
896
  # @param [String] fields
896
897
  # Selector specifying which fields to include in a partial response.
897
898
  # @param [String] quota_user
@@ -909,14 +910,13 @@ module Google
909
910
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
910
911
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
911
912
  # @raise [Google::Apis::AuthorizationError] Authorization is required
912
- def patch_project_location_key_ring_crypto_key_crypto_key_version(name, crypto_key_version_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
913
- command = make_simple_command(:patch, 'v1/{+name}', options)
914
- command.request_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
915
- command.request_object = crypto_key_version_object
913
+ def restore_crypto_key_version(name, restore_crypto_key_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
914
+ command = make_simple_command(:post, 'v1/{+name}:restore', options)
915
+ command.request_representation = Google::Apis::CloudkmsV1::RestoreCryptoKeyVersionRequest::Representation
916
+ command.request_object = restore_crypto_key_version_request_object
916
917
  command.response_representation = Google::Apis::CloudkmsV1::CryptoKeyVersion::Representation
917
918
  command.response_class = Google::Apis::CloudkmsV1::CryptoKeyVersion
918
919
  command.params['name'] = name unless name.nil?
919
- command.query['updateMask'] = update_mask unless update_mask.nil?
920
920
  command.query['fields'] = fields unless fields.nil?
921
921
  command.query['quotaUser'] = quota_user unless quota_user.nil?
922
922
  execute_or_queue_command(command, &block)