google-api-client 0.12.0 → 0.13.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (315) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +7 -0
  3. data/api_names.yaml +945 -41609
  4. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +12 -12
  5. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +2 -2
  6. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  7. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +1437 -412
  8. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +516 -71
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +1098 -422
  10. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +6 -6
  11. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +3 -3
  12. data/generated/google/apis/adexchangebuyer_v1_4/service.rb +3 -3
  13. data/generated/google/apis/adexchangeseller_v2_0/service.rb +10 -10
  14. data/generated/google/apis/admin_directory_v1/service.rb +26 -26
  15. data/generated/google/apis/adsense_v1_4.rb +1 -1
  16. data/generated/google/apis/adsense_v1_4/classes.rb +2 -2
  17. data/generated/google/apis/adsense_v1_4/representations.rb +3 -3
  18. data/generated/google/apis/adsense_v1_4/service.rb +44 -44
  19. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  20. data/generated/google/apis/adsensehost_v4_1/service.rb +22 -22
  21. data/generated/google/apis/analytics_v3/classes.rb +3 -3
  22. data/generated/google/apis/analytics_v3/representations.rb +3 -3
  23. data/generated/google/apis/analytics_v3/service.rb +82 -82
  24. data/generated/google/apis/analyticsreporting_v4/classes.rb +937 -937
  25. data/generated/google/apis/analyticsreporting_v4/representations.rb +128 -128
  26. data/generated/google/apis/analyticsreporting_v4/service.rb +1 -1
  27. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  28. data/generated/google/apis/androidenterprise_v1/classes.rb +10 -10
  29. data/generated/google/apis/androidenterprise_v1/representations.rb +20 -20
  30. data/generated/google/apis/androidenterprise_v1/service.rb +43 -43
  31. data/generated/google/apis/androidpublisher_v2/classes.rb +26 -26
  32. data/generated/google/apis/androidpublisher_v2/representations.rb +46 -46
  33. data/generated/google/apis/androidpublisher_v2/service.rb +95 -95
  34. data/generated/google/apis/appengine_v1.rb +4 -4
  35. data/generated/google/apis/appengine_v1/classes.rb +1570 -1512
  36. data/generated/google/apis/appengine_v1/representations.rb +362 -343
  37. data/generated/google/apis/appengine_v1/service.rb +220 -220
  38. data/generated/google/apis/appstate_v1.rb +1 -1
  39. data/generated/google/apis/bigquery_v2.rb +1 -1
  40. data/generated/google/apis/bigquery_v2/classes.rb +5 -5
  41. data/generated/google/apis/bigquery_v2/representations.rb +8 -8
  42. data/generated/google/apis/bigquery_v2/service.rb +13 -13
  43. data/generated/google/apis/blogger_v3/service.rb +3 -3
  44. data/generated/google/apis/books_v1/classes.rb +55 -55
  45. data/generated/google/apis/books_v1/representations.rb +67 -67
  46. data/generated/google/apis/books_v1/service.rb +82 -82
  47. data/generated/google/apis/calendar_v3.rb +1 -1
  48. data/generated/google/apis/calendar_v3/classes.rb +6 -6
  49. data/generated/google/apis/calendar_v3/representations.rb +3 -3
  50. data/generated/google/apis/calendar_v3/service.rb +2 -2
  51. data/generated/google/apis/civicinfo_v2/classes.rb +2 -2
  52. data/generated/google/apis/civicinfo_v2/representations.rb +4 -4
  53. data/generated/google/apis/civicinfo_v2/service.rb +12 -12
  54. data/generated/google/apis/classroom_v1.rb +7 -7
  55. data/generated/google/apis/classroom_v1/classes.rb +1013 -991
  56. data/generated/google/apis/classroom_v1/representations.rb +207 -204
  57. data/generated/google/apis/classroom_v1/service.rb +709 -709
  58. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  59. data/generated/google/apis/cloudbuild_v1/classes.rb +307 -307
  60. data/generated/google/apis/cloudbuild_v1/representations.rb +84 -84
  61. data/generated/google/apis/cloudbuild_v1/service.rb +125 -125
  62. data/generated/google/apis/clouddebugger_v2/classes.rb +673 -673
  63. data/generated/google/apis/clouddebugger_v2/representations.rb +152 -152
  64. data/generated/google/apis/clouddebugger_v2/service.rb +55 -55
  65. data/generated/google/apis/clouderrorreporting_v1beta1.rb +1 -1
  66. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +121 -121
  67. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +25 -25
  68. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +74 -74
  69. data/generated/google/apis/cloudkms_v1.rb +1 -1
  70. data/generated/google/apis/cloudkms_v1/classes.rb +668 -613
  71. data/generated/google/apis/cloudkms_v1/representations.rb +151 -133
  72. data/generated/google/apis/cloudkms_v1/service.rb +267 -267
  73. data/generated/google/apis/cloudresourcemanager_v1.rb +4 -4
  74. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1167 -1168
  75. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +193 -193
  76. data/generated/google/apis/cloudresourcemanager_v1/service.rb +470 -469
  77. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  78. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +508 -509
  79. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +94 -94
  80. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +157 -156
  81. data/generated/google/apis/cloudtrace_v1/service.rb +34 -34
  82. data/generated/google/apis/compute_beta.rb +1 -1
  83. data/generated/google/apis/compute_beta/classes.rb +163 -15
  84. data/generated/google/apis/compute_beta/representations.rb +54 -14
  85. data/generated/google/apis/compute_beta/service.rb +2258 -482
  86. data/generated/google/apis/compute_v1.rb +1 -1
  87. data/generated/google/apis/compute_v1/classes.rb +465 -13
  88. data/generated/google/apis/compute_v1/representations.rb +202 -16
  89. data/generated/google/apis/compute_v1/service.rb +573 -309
  90. data/generated/google/apis/container_v1.rb +1 -1
  91. data/generated/google/apis/container_v1/classes.rb +635 -589
  92. data/generated/google/apis/container_v1/representations.rb +139 -111
  93. data/generated/google/apis/container_v1/service.rb +272 -227
  94. data/generated/google/apis/content_v2.rb +1 -1
  95. data/generated/google/apis/content_v2/classes.rb +86 -74
  96. data/generated/google/apis/content_v2/representations.rb +107 -105
  97. data/generated/google/apis/content_v2/service.rb +131 -130
  98. data/generated/google/apis/customsearch_v1.rb +2 -2
  99. data/generated/google/apis/customsearch_v1/classes.rb +0 -6
  100. data/generated/google/apis/customsearch_v1/representations.rb +0 -1
  101. data/generated/google/apis/customsearch_v1/service.rb +2 -5
  102. data/generated/google/apis/dataflow_v1b3.rb +7 -4
  103. data/generated/google/apis/dataflow_v1b3/classes.rb +3405 -3405
  104. data/generated/google/apis/dataflow_v1b3/representations.rb +834 -834
  105. data/generated/google/apis/dataflow_v1b3/service.rb +244 -244
  106. data/generated/google/apis/dataproc_v1.rb +1 -1
  107. data/generated/google/apis/dataproc_v1/classes.rb +543 -691
  108. data/generated/google/apis/dataproc_v1/representations.rb +129 -185
  109. data/generated/google/apis/dataproc_v1/service.rb +347 -347
  110. data/generated/google/apis/datastore_v1.rb +4 -4
  111. data/generated/google/apis/datastore_v1/classes.rb +833 -833
  112. data/generated/google/apis/datastore_v1/representations.rb +182 -182
  113. data/generated/google/apis/datastore_v1/service.rb +45 -45
  114. data/generated/google/apis/deploymentmanager_v2/classes.rb +5 -5
  115. data/generated/google/apis/deploymentmanager_v2/representations.rb +10 -10
  116. data/generated/google/apis/deploymentmanager_v2/service.rb +20 -20
  117. data/generated/google/apis/discovery_v1/classes.rb +4 -4
  118. data/generated/google/apis/discovery_v1/representations.rb +2 -2
  119. data/generated/google/apis/discovery_v1/service.rb +1 -1
  120. data/generated/google/apis/dns_v1.rb +1 -1
  121. data/generated/google/apis/dns_v1/classes.rb +3 -3
  122. data/generated/google/apis/dns_v1/representations.rb +6 -6
  123. data/generated/google/apis/dns_v1/service.rb +12 -12
  124. data/generated/google/apis/dns_v2beta1.rb +1 -1
  125. data/generated/google/apis/doubleclickbidmanager_v1/service.rb +8 -8
  126. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  127. data/generated/google/apis/drive_v2.rb +1 -1
  128. data/generated/google/apis/drive_v2/classes.rb +1 -1
  129. data/generated/google/apis/drive_v2/service.rb +1 -1
  130. data/generated/google/apis/drive_v3.rb +1 -1
  131. data/generated/google/apis/drive_v3/service.rb +1 -1
  132. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  133. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +160 -110
  134. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +60 -31
  135. data/generated/google/apis/firebasedynamiclinks_v1/service.rb +38 -3
  136. data/generated/google/apis/firebaserules_v1/classes.rb +354 -354
  137. data/generated/google/apis/firebaserules_v1/representations.rb +87 -87
  138. data/generated/google/apis/firebaserules_v1/service.rb +103 -103
  139. data/generated/google/apis/fusiontables_v2/service.rb +2 -2
  140. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  141. data/generated/google/apis/games_configuration_v1configuration/classes.rb +2 -2
  142. data/generated/google/apis/games_configuration_v1configuration/representations.rb +4 -4
  143. data/generated/google/apis/games_configuration_v1configuration/service.rb +8 -8
  144. data/generated/google/apis/games_management_v1management.rb +1 -1
  145. data/generated/google/apis/games_v1.rb +1 -1
  146. data/generated/google/apis/games_v1/classes.rb +23 -23
  147. data/generated/google/apis/games_v1/representations.rb +43 -43
  148. data/generated/google/apis/games_v1/service.rb +72 -72
  149. data/generated/google/apis/genomics_v1.rb +1 -1
  150. data/generated/google/apis/genomics_v1/classes.rb +2316 -2316
  151. data/generated/google/apis/genomics_v1/representations.rb +291 -291
  152. data/generated/google/apis/genomics_v1/service.rb +821 -821
  153. data/generated/google/apis/gmail_v1.rb +1 -1
  154. data/generated/google/apis/groupsmigration_v1.rb +1 -1
  155. data/generated/google/apis/groupssettings_v1.rb +1 -1
  156. data/generated/google/apis/groupssettings_v1/classes.rb +2 -2
  157. data/generated/google/apis/groupssettings_v1/service.rb +3 -0
  158. data/generated/google/apis/iam_v1/classes.rb +338 -338
  159. data/generated/google/apis/iam_v1/representations.rb +98 -98
  160. data/generated/google/apis/iam_v1/service.rb +35 -35
  161. data/generated/google/apis/identitytoolkit_v3/classes.rb +15 -15
  162. data/generated/google/apis/identitytoolkit_v3/representations.rb +30 -30
  163. data/generated/google/apis/identitytoolkit_v3/service.rb +64 -64
  164. data/generated/google/apis/kgsearch_v1/service.rb +13 -13
  165. data/generated/google/apis/language_v1.rb +1 -1
  166. data/generated/google/apis/language_v1/classes.rb +374 -374
  167. data/generated/google/apis/language_v1/representations.rb +97 -97
  168. data/generated/google/apis/language_v1/service.rb +16 -16
  169. data/generated/google/apis/language_v1beta1.rb +1 -1
  170. data/generated/google/apis/language_v1beta1/classes.rb +441 -441
  171. data/generated/google/apis/language_v1beta1/representations.rb +108 -108
  172. data/generated/google/apis/language_v1beta1/service.rb +30 -30
  173. data/generated/google/apis/licensing_v1/service.rb +2 -2
  174. data/generated/google/apis/logging_v2.rb +1 -1
  175. data/generated/google/apis/logging_v2/classes.rb +712 -712
  176. data/generated/google/apis/logging_v2/representations.rb +109 -109
  177. data/generated/google/apis/logging_v2/service.rb +543 -539
  178. data/generated/google/apis/logging_v2beta1.rb +1 -1
  179. data/generated/google/apis/logging_v2beta1/classes.rb +752 -752
  180. data/generated/google/apis/logging_v2beta1/representations.rb +94 -94
  181. data/generated/google/apis/logging_v2beta1/service.rb +257 -256
  182. data/generated/google/apis/manufacturers_v1/classes.rb +130 -130
  183. data/generated/google/apis/manufacturers_v1/representations.rb +28 -28
  184. data/generated/google/apis/mirror_v1/classes.rb +5 -5
  185. data/generated/google/apis/mirror_v1/representations.rb +10 -10
  186. data/generated/google/apis/mirror_v1/service.rb +20 -20
  187. data/generated/google/apis/ml_v1.rb +1 -1
  188. data/generated/google/apis/ml_v1/classes.rb +1830 -1210
  189. data/generated/google/apis/ml_v1/representations.rb +342 -120
  190. data/generated/google/apis/ml_v1/service.rb +365 -258
  191. data/generated/google/apis/monitoring_v3.rb +4 -4
  192. data/generated/google/apis/monitoring_v3/classes.rb +889 -889
  193. data/generated/google/apis/monitoring_v3/representations.rb +174 -174
  194. data/generated/google/apis/monitoring_v3/service.rb +119 -119
  195. data/generated/google/apis/mybusiness_v3/service.rb +5 -5
  196. data/generated/google/apis/oauth2_v2/service.rb +1 -1
  197. data/generated/google/apis/pagespeedonline_v2/classes.rb +11 -11
  198. data/generated/google/apis/pagespeedonline_v2/representations.rb +13 -13
  199. data/generated/google/apis/pagespeedonline_v2/service.rb +1 -1
  200. data/generated/google/apis/partners_v2.rb +1 -1
  201. data/generated/google/apis/partners_v2/classes.rb +550 -536
  202. data/generated/google/apis/partners_v2/representations.rb +118 -116
  203. data/generated/google/apis/partners_v2/service.rb +439 -439
  204. data/generated/google/apis/people_v1.rb +4 -4
  205. data/generated/google/apis/people_v1/classes.rb +414 -413
  206. data/generated/google/apis/people_v1/representations.rb +85 -85
  207. data/generated/google/apis/people_v1/service.rb +111 -18
  208. data/generated/google/apis/plus_domains_v1.rb +1 -1
  209. data/generated/google/apis/plus_domains_v1/service.rb +4 -4
  210. data/generated/google/apis/plus_v1.rb +1 -1
  211. data/generated/google/apis/plus_v1/service.rb +1 -1
  212. data/generated/google/apis/prediction_v1_6/service.rb +8 -8
  213. data/generated/google/apis/proximitybeacon_v1beta1.rb +1 -1
  214. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +443 -443
  215. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +92 -92
  216. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +152 -152
  217. data/generated/google/apis/pubsub_v1/classes.rb +249 -249
  218. data/generated/google/apis/pubsub_v1/representations.rb +80 -80
  219. data/generated/google/apis/pubsub_v1/service.rb +415 -415
  220. data/generated/google/apis/qpx_express_v1/classes.rb +2 -2
  221. data/generated/google/apis/qpx_express_v1/representations.rb +4 -4
  222. data/generated/google/apis/qpx_express_v1/service.rb +8 -8
  223. data/generated/google/apis/replicapool_v1beta2/classes.rb +5 -5
  224. data/generated/google/apis/replicapool_v1beta2/representations.rb +10 -10
  225. data/generated/google/apis/replicapool_v1beta2/service.rb +21 -21
  226. data/generated/google/apis/replicapoolupdater_v1beta1/service.rb +1 -1
  227. data/generated/google/apis/resourceviews_v1beta2/classes.rb +5 -5
  228. data/generated/google/apis/resourceviews_v1beta2/representations.rb +10 -10
  229. data/generated/google/apis/resourceviews_v1beta2/service.rb +20 -20
  230. data/generated/google/apis/runtimeconfig_v1.rb +4 -4
  231. data/generated/google/apis/runtimeconfig_v1/classes.rb +15 -15
  232. data/generated/google/apis/runtimeconfig_v1/representations.rb +2 -2
  233. data/generated/google/apis/runtimeconfig_v1/service.rb +4 -4
  234. data/generated/google/apis/script_v1.rb +17 -17
  235. data/generated/google/apis/script_v1/classes.rb +27 -27
  236. data/generated/google/apis/script_v1/representations.rb +5 -5
  237. data/generated/google/apis/script_v1/service.rb +4 -4
  238. data/generated/google/apis/searchconsole_v1.rb +1 -1
  239. data/generated/google/apis/searchconsole_v1/classes.rb +53 -53
  240. data/generated/google/apis/searchconsole_v1/representations.rb +23 -23
  241. data/generated/google/apis/searchconsole_v1/service.rb +4 -4
  242. data/generated/google/apis/servicecontrol_v1.rb +1 -1
  243. data/generated/google/apis/servicecontrol_v1/classes.rb +1175 -1175
  244. data/generated/google/apis/servicecontrol_v1/representations.rb +206 -206
  245. data/generated/google/apis/servicecontrol_v1/service.rb +116 -116
  246. data/generated/google/apis/servicemanagement_v1.rb +1 -1
  247. data/generated/google/apis/servicemanagement_v1/classes.rb +1186 -1125
  248. data/generated/google/apis/servicemanagement_v1/representations.rb +241 -223
  249. data/generated/google/apis/servicemanagement_v1/service.rb +201 -201
  250. data/generated/google/apis/serviceuser_v1.rb +1 -1
  251. data/generated/google/apis/serviceuser_v1/classes.rb +2645 -2641
  252. data/generated/google/apis/serviceuser_v1/representations.rb +234 -234
  253. data/generated/google/apis/serviceuser_v1/service.rb +37 -37
  254. data/generated/google/apis/sheets_v4.rb +1 -1
  255. data/generated/google/apis/sheets_v4/classes.rb +5042 -4111
  256. data/generated/google/apis/sheets_v4/representations.rb +994 -824
  257. data/generated/google/apis/sheets_v4/service.rb +80 -80
  258. data/generated/google/apis/site_verification_v1/classes.rb +6 -6
  259. data/generated/google/apis/site_verification_v1/representations.rb +8 -8
  260. data/generated/google/apis/site_verification_v1/service.rb +12 -12
  261. data/generated/google/apis/slides_v1.rb +1 -1
  262. data/generated/google/apis/slides_v1/classes.rb +2885 -2885
  263. data/generated/google/apis/slides_v1/representations.rb +310 -310
  264. data/generated/google/apis/slides_v1/service.rb +54 -54
  265. data/generated/google/apis/sourcerepo_v1/classes.rb +206 -206
  266. data/generated/google/apis/sourcerepo_v1/representations.rb +52 -52
  267. data/generated/google/apis/sourcerepo_v1/service.rb +5 -5
  268. data/generated/google/apis/spanner_v1.rb +1 -1
  269. data/generated/google/apis/spanner_v1/classes.rb +2142 -2141
  270. data/generated/google/apis/spanner_v1/representations.rb +174 -174
  271. data/generated/google/apis/spanner_v1/service.rb +497 -497
  272. data/generated/google/apis/speech_v1beta1.rb +1 -1
  273. data/generated/google/apis/speech_v1beta1/classes.rb +227 -227
  274. data/generated/google/apis/speech_v1beta1/representations.rb +50 -50
  275. data/generated/google/apis/speech_v1beta1/service.rb +33 -33
  276. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  277. data/generated/google/apis/sqladmin_v1beta4/classes.rb +21 -21
  278. data/generated/google/apis/sqladmin_v1beta4/representations.rb +29 -29
  279. data/generated/google/apis/sqladmin_v1beta4/service.rb +56 -56
  280. data/generated/google/apis/storage_v1.rb +1 -1
  281. data/generated/google/apis/storage_v1/classes.rb +40 -6
  282. data/generated/google/apis/storage_v1/representations.rb +20 -4
  283. data/generated/google/apis/storage_v1/service.rb +61 -46
  284. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  285. data/generated/google/apis/storagetransfer_v1/classes.rb +184 -184
  286. data/generated/google/apis/storagetransfer_v1/representations.rb +35 -35
  287. data/generated/google/apis/storagetransfer_v1/service.rb +70 -70
  288. data/generated/google/apis/tagmanager_v1/service.rb +33 -33
  289. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  290. data/generated/google/apis/translate_v2/classes.rb +12 -12
  291. data/generated/google/apis/translate_v2/representations.rb +10 -10
  292. data/generated/google/apis/translate_v2/service.rb +62 -62
  293. data/generated/google/apis/vision_v1.rb +1 -1
  294. data/generated/google/apis/vision_v1/classes.rb +1267 -1267
  295. data/generated/google/apis/vision_v1/representations.rb +200 -200
  296. data/generated/google/apis/vision_v1/service.rb +10 -10
  297. data/generated/google/apis/webmasters_v3.rb +1 -1
  298. data/generated/google/apis/webmasters_v3/classes.rb +4 -4
  299. data/generated/google/apis/webmasters_v3/representations.rb +8 -8
  300. data/generated/google/apis/webmasters_v3/service.rb +21 -21
  301. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  302. data/generated/google/apis/youtube_analytics_v1/classes.rb +2 -2
  303. data/generated/google/apis/youtube_analytics_v1/representations.rb +4 -4
  304. data/generated/google/apis/youtube_analytics_v1/service.rb +8 -8
  305. data/generated/google/apis/youtube_v3/classes.rb +20 -20
  306. data/generated/google/apis/youtube_v3/representations.rb +40 -40
  307. data/generated/google/apis/youtube_v3/service.rb +80 -80
  308. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  309. data/generated/google/apis/youtubereporting_v1/classes.rb +129 -129
  310. data/generated/google/apis/youtubereporting_v1/representations.rb +38 -38
  311. data/generated/google/apis/youtubereporting_v1/service.rb +97 -97
  312. data/lib/google/apis/generator/annotator.rb +2 -2
  313. data/lib/google/apis/generator/model.rb +2 -2
  314. data/lib/google/apis/version.rb +1 -1
  315. metadata +2 -2
@@ -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)