google-api-client 0.10.2 → 0.10.3

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 (248) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +25 -0
  3. data/MIGRATING.md +22 -7
  4. data/README.md +4 -8
  5. data/api_names.yaml +1210 -37815
  6. data/generated/google/apis/acceleratedmobilepageurl_v1.rb +32 -0
  7. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +144 -0
  8. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +86 -0
  9. data/generated/google/apis/acceleratedmobilepageurl_v1/service.rb +90 -0
  10. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  11. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +764 -764
  12. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +180 -180
  13. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +421 -421
  14. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +1 -0
  15. data/generated/google/apis/admin_directory_v1/classes.rb +1 -0
  16. data/generated/google/apis/admin_reports_v1.rb +1 -1
  17. data/generated/google/apis/adsense_v1_4.rb +1 -1
  18. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  19. data/generated/google/apis/analyticsreporting_v4/classes.rb +187 -187
  20. data/generated/google/apis/analyticsreporting_v4/representations.rb +42 -42
  21. data/generated/google/apis/appengine_v1.rb +40 -0
  22. data/generated/google/apis/appengine_v1/classes.rb +2251 -0
  23. data/generated/google/apis/appengine_v1/representations.rb +858 -0
  24. data/generated/google/apis/appengine_v1/service.rb +894 -0
  25. data/generated/google/apis/bigquery_v2.rb +1 -1
  26. data/generated/google/apis/bigquery_v2/classes.rb +11 -6
  27. data/generated/google/apis/books_v1.rb +1 -1
  28. data/generated/google/apis/books_v1/classes.rb +26 -0
  29. data/generated/google/apis/books_v1/representations.rb +15 -0
  30. data/generated/google/apis/books_v1/service.rb +4 -1
  31. data/generated/google/apis/calendar_v3.rb +1 -1
  32. data/generated/google/apis/classroom_v1.rb +1 -1
  33. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  34. data/generated/google/apis/cloudbuild_v1/classes.rb +638 -637
  35. data/generated/google/apis/cloudbuild_v1/representations.rb +110 -110
  36. data/generated/google/apis/cloudbuild_v1/service.rb +139 -139
  37. data/generated/google/apis/clouddebugger_v2.rb +3 -3
  38. data/generated/google/apis/clouddebugger_v2/classes.rb +131 -131
  39. data/generated/google/apis/clouddebugger_v2/representations.rb +25 -25
  40. data/generated/google/apis/clouderrorreporting_v1beta1.rb +36 -0
  41. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +590 -0
  42. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +252 -0
  43. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +350 -0
  44. data/generated/google/apis/cloudfunctions_v1.rb +35 -0
  45. data/generated/google/apis/cloudfunctions_v1/classes.rb +98 -0
  46. data/generated/google/apis/cloudfunctions_v1/representations.rb +57 -0
  47. data/generated/google/apis/cloudfunctions_v1/service.rb +89 -0
  48. data/generated/google/apis/cloudkms_v1/classes.rb +277 -270
  49. data/generated/google/apis/cloudkms_v1/representations.rb +73 -73
  50. data/generated/google/apis/cloudkms_v1/service.rb +194 -194
  51. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  52. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +1147 -1144
  53. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +188 -188
  54. data/generated/google/apis/cloudresourcemanager_v1/service.rb +513 -936
  55. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  56. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +307 -916
  57. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +63 -285
  58. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +333 -681
  59. data/generated/google/apis/cloudtrace_v1/classes.rb +38 -38
  60. data/generated/google/apis/cloudtrace_v1/representations.rb +13 -13
  61. data/generated/google/apis/cloudtrace_v1/service.rb +16 -16
  62. data/generated/google/apis/compute_beta.rb +1 -1
  63. data/generated/google/apis/compute_beta/classes.rb +32 -7
  64. data/generated/google/apis/compute_beta/representations.rb +2 -0
  65. data/generated/google/apis/compute_beta/service.rb +11 -11
  66. data/generated/google/apis/compute_v1.rb +1 -1
  67. data/generated/google/apis/compute_v1/classes.rb +95 -2
  68. data/generated/google/apis/compute_v1/representations.rb +33 -0
  69. data/generated/google/apis/dataflow_v1b3/classes.rb +3333 -3333
  70. data/generated/google/apis/dataflow_v1b3/representations.rb +759 -759
  71. data/generated/google/apis/dataflow_v1b3/service.rb +154 -154
  72. data/generated/google/apis/dataproc_v1.rb +1 -1
  73. data/generated/google/apis/dataproc_v1/classes.rb +1097 -1097
  74. data/generated/google/apis/dataproc_v1/representations.rb +200 -200
  75. data/generated/google/apis/dataproc_v1/service.rb +356 -356
  76. data/generated/google/apis/datastore_v1.rb +4 -4
  77. data/generated/google/apis/datastore_v1/classes.rb +701 -690
  78. data/generated/google/apis/datastore_v1/representations.rb +160 -160
  79. data/generated/google/apis/datastore_v1/service.rb +52 -52
  80. data/generated/google/apis/deploymentmanager_v2/classes.rb +4 -0
  81. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  82. data/generated/google/apis/drive_v2.rb +1 -1
  83. data/generated/google/apis/drive_v2/classes.rb +158 -35
  84. data/generated/google/apis/drive_v2/representations.rb +39 -0
  85. data/generated/google/apis/drive_v2/service.rb +4 -4
  86. data/generated/google/apis/drive_v3.rb +1 -1
  87. data/generated/google/apis/drive_v3/classes.rb +162 -33
  88. data/generated/google/apis/drive_v3/representations.rb +39 -0
  89. data/generated/google/apis/drive_v3/service.rb +4 -4
  90. data/generated/google/apis/firebasedynamiclinks_v1.rb +35 -0
  91. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +466 -0
  92. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +222 -0
  93. data/generated/google/apis/firebasedynamiclinks_v1/service.rb +95 -0
  94. data/generated/google/apis/firebaserules_v1.rb +41 -0
  95. data/generated/google/apis/firebaserules_v1/classes.rb +425 -0
  96. data/generated/google/apis/firebaserules_v1/representations.rb +222 -0
  97. data/generated/google/apis/firebaserules_v1/service.rb +495 -0
  98. data/generated/google/apis/games_v1/classes.rb +4 -0
  99. data/generated/google/apis/genomics_v1.rb +7 -7
  100. data/generated/google/apis/genomics_v1/classes.rb +2336 -2335
  101. data/generated/google/apis/genomics_v1/representations.rb +387 -387
  102. data/generated/google/apis/genomics_v1/service.rb +1187 -1187
  103. data/generated/google/apis/gmail_v1/classes.rb +3 -0
  104. data/generated/google/apis/iam_v1.rb +1 -1
  105. data/generated/google/apis/iam_v1/classes.rb +123 -117
  106. data/generated/google/apis/iam_v1/representations.rb +33 -33
  107. data/generated/google/apis/iam_v1/service.rb +109 -109
  108. data/generated/google/apis/identitytoolkit_v3/classes.rb +5 -0
  109. data/generated/google/apis/kgsearch_v1/classes.rb +6 -6
  110. data/generated/google/apis/kgsearch_v1/representations.rb +1 -1
  111. data/generated/google/apis/kgsearch_v1/service.rb +4 -4
  112. data/generated/google/apis/language_v1.rb +36 -0
  113. data/generated/google/apis/language_v1/classes.rb +757 -0
  114. data/generated/google/apis/language_v1/representations.rb +338 -0
  115. data/generated/google/apis/language_v1/service.rb +185 -0
  116. data/generated/google/apis/language_v1beta1/classes.rb +407 -407
  117. data/generated/google/apis/language_v1beta1/representations.rb +103 -103
  118. data/generated/google/apis/language_v1beta1/service.rb +45 -45
  119. data/generated/google/apis/logging_v2.rb +46 -0
  120. data/generated/google/apis/logging_v2/classes.rb +1271 -0
  121. data/generated/google/apis/logging_v2/representations.rb +421 -0
  122. data/generated/google/apis/logging_v2/service.rb +1569 -0
  123. data/generated/google/apis/logging_v2beta1.rb +1 -1
  124. data/generated/google/apis/logging_v2beta1/classes.rb +886 -886
  125. data/generated/google/apis/logging_v2beta1/representations.rb +132 -132
  126. data/generated/google/apis/logging_v2beta1/service.rb +235 -235
  127. data/generated/google/apis/manufacturers_v1/classes.rb +147 -147
  128. data/generated/google/apis/manufacturers_v1/representations.rb +29 -29
  129. data/generated/google/apis/ml_v1.rb +34 -0
  130. data/generated/google/apis/ml_v1/classes.rb +1617 -0
  131. data/generated/google/apis/ml_v1/representations.rb +498 -0
  132. data/generated/google/apis/ml_v1/service.rb +769 -0
  133. data/generated/google/apis/monitoring_v3.rb +4 -4
  134. data/generated/google/apis/monitoring_v3/classes.rb +630 -630
  135. data/generated/google/apis/monitoring_v3/representations.rb +134 -134
  136. data/generated/google/apis/monitoring_v3/service.rb +240 -240
  137. data/generated/google/apis/pagespeedonline_v2/classes.rb +1 -0
  138. data/generated/google/apis/partners_v2.rb +1 -1
  139. data/generated/google/apis/partners_v2/classes.rb +639 -639
  140. data/generated/google/apis/partners_v2/representations.rb +168 -168
  141. data/generated/google/apis/partners_v2/service.rb +381 -381
  142. data/generated/google/apis/people_v1.rb +10 -10
  143. data/generated/google/apis/people_v1/classes.rb +524 -524
  144. data/generated/google/apis/people_v1/representations.rb +143 -143
  145. data/generated/google/apis/people_v1/service.rb +30 -30
  146. data/generated/google/apis/plus_domains_v1.rb +1 -1
  147. data/generated/google/apis/plus_v1.rb +1 -1
  148. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +454 -444
  149. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +90 -90
  150. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +110 -110
  151. data/generated/google/apis/pubsub_v1/classes.rb +175 -173
  152. data/generated/google/apis/pubsub_v1/representations.rb +53 -53
  153. data/generated/google/apis/pubsub_v1/service.rb +210 -210
  154. data/generated/google/apis/replicapool_v1beta2/classes.rb +2 -0
  155. data/generated/google/apis/runtimeconfig_v1.rb +38 -0
  156. data/generated/google/apis/runtimeconfig_v1/classes.rb +252 -0
  157. data/generated/google/apis/runtimeconfig_v1/representations.rb +98 -0
  158. data/generated/google/apis/runtimeconfig_v1/service.rb +176 -0
  159. data/generated/google/apis/script_v1.rb +1 -1
  160. data/generated/google/apis/script_v1/classes.rb +6 -6
  161. data/generated/google/apis/script_v1/representations.rb +1 -1
  162. data/generated/google/apis/searchconsole_v1.rb +31 -0
  163. data/generated/google/apis/searchconsole_v1/classes.rb +205 -0
  164. data/generated/google/apis/searchconsole_v1/representations.rb +129 -0
  165. data/generated/google/apis/searchconsole_v1/service.rb +88 -0
  166. data/generated/google/apis/servicecontrol_v1.rb +38 -0
  167. data/generated/google/apis/servicecontrol_v1/classes.rb +1675 -0
  168. data/generated/google/apis/servicecontrol_v1/representations.rb +601 -0
  169. data/generated/google/apis/servicecontrol_v1/service.rb +337 -0
  170. data/generated/google/apis/servicemanagement_v1.rb +45 -0
  171. data/generated/google/apis/servicemanagement_v1/classes.rb +4934 -0
  172. data/generated/google/apis/servicemanagement_v1/representations.rb +1526 -0
  173. data/generated/google/apis/servicemanagement_v1/service.rb +860 -0
  174. data/generated/google/apis/serviceuser_v1.rb +42 -0
  175. data/generated/google/apis/serviceuser_v1/classes.rb +3746 -0
  176. data/generated/google/apis/serviceuser_v1/representations.rb +1041 -0
  177. data/generated/google/apis/serviceuser_v1/service.rb +214 -0
  178. data/generated/google/apis/sheets_v4.rb +3 -3
  179. data/generated/google/apis/sheets_v4/classes.rb +4390 -4390
  180. data/generated/google/apis/sheets_v4/representations.rb +381 -381
  181. data/generated/google/apis/sheets_v4/service.rb +48 -48
  182. data/generated/google/apis/slides_v1.rb +3 -3
  183. data/generated/google/apis/slides_v1/classes.rb +2860 -2860
  184. data/generated/google/apis/slides_v1/representations.rb +693 -693
  185. data/generated/google/apis/slides_v1/service.rb +30 -30
  186. data/generated/google/apis/sourcerepo_v1.rb +34 -0
  187. data/generated/google/apis/sourcerepo_v1/classes.rb +687 -0
  188. data/generated/google/apis/sourcerepo_v1/representations.rb +285 -0
  189. data/generated/google/apis/sourcerepo_v1/service.rb +291 -0
  190. data/generated/google/apis/spanner_v1.rb +35 -0
  191. data/generated/google/apis/spanner_v1/classes.rb +3294 -0
  192. data/generated/google/apis/spanner_v1/representations.rb +984 -0
  193. data/generated/google/apis/spanner_v1/service.rb +1504 -0
  194. data/generated/google/apis/speech_v1beta1.rb +1 -1
  195. data/generated/google/apis/speech_v1beta1/classes.rb +197 -196
  196. data/generated/google/apis/speech_v1beta1/representations.rb +53 -53
  197. data/generated/google/apis/speech_v1beta1/service.rb +27 -27
  198. data/generated/google/apis/storage_v1.rb +1 -1
  199. data/generated/google/apis/storage_v1/classes.rb +131 -0
  200. data/generated/google/apis/storage_v1/representations.rb +51 -0
  201. data/generated/google/apis/storage_v1/service.rb +182 -0
  202. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  203. data/generated/google/apis/storagetransfer_v1/classes.rb +732 -661
  204. data/generated/google/apis/storagetransfer_v1/representations.rb +132 -132
  205. data/generated/google/apis/storagetransfer_v1/service.rb +174 -197
  206. data/generated/google/apis/surveys_v2.rb +40 -0
  207. data/generated/google/apis/surveys_v2/classes.rb +806 -0
  208. data/generated/google/apis/surveys_v2/representations.rb +347 -0
  209. data/generated/google/apis/surveys_v2/service.rb +477 -0
  210. data/generated/google/apis/tagmanager_v2.rb +52 -0
  211. data/generated/google/apis/tagmanager_v2/classes.rb +2435 -0
  212. data/generated/google/apis/tagmanager_v2/representations.rb +993 -0
  213. data/generated/google/apis/tagmanager_v2/service.rb +2865 -0
  214. data/generated/google/apis/toolresults_v1beta3.rb +34 -0
  215. data/generated/google/apis/toolresults_v1beta3/classes.rb +2160 -0
  216. data/generated/google/apis/toolresults_v1beta3/representations.rb +729 -0
  217. data/generated/google/apis/toolresults_v1beta3/service.rb +1236 -0
  218. data/generated/google/apis/tracing_v1.rb +40 -0
  219. data/generated/google/apis/tracing_v1/classes.rb +664 -0
  220. data/generated/google/apis/tracing_v1/representations.rb +279 -0
  221. data/generated/google/apis/tracing_v1/service.rb +225 -0
  222. data/generated/google/apis/vision_v1.rb +1 -1
  223. data/generated/google/apis/vision_v1/classes.rb +1223 -1222
  224. data/generated/google/apis/vision_v1/representations.rb +234 -234
  225. data/generated/google/apis/vision_v1/service.rb +10 -10
  226. data/generated/google/apis/webfonts_v1.rb +33 -0
  227. data/generated/google/apis/webfonts_v1/classes.rb +113 -0
  228. data/generated/google/apis/webfonts_v1/representations.rb +62 -0
  229. data/generated/google/apis/webfonts_v1/service.rb +102 -0
  230. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  231. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  232. data/generated/google/apis/youtube_partner_v1/classes.rb +31 -0
  233. data/generated/google/apis/youtube_partner_v1/representations.rb +6 -0
  234. data/generated/google/apis/youtube_partner_v1/service.rb +41 -0
  235. data/generated/google/apis/youtube_v3/classes.rb +1 -0
  236. data/generated/google/apis/youtubereporting_v1.rb +4 -4
  237. data/generated/google/apis/youtubereporting_v1/classes.rb +76 -76
  238. data/generated/google/apis/youtubereporting_v1/representations.rb +25 -25
  239. data/generated/google/apis/youtubereporting_v1/service.rb +95 -95
  240. data/lib/google/apis/generator/annotator.rb +5 -4
  241. data/lib/google/apis/generator/templates/_class.tmpl +3 -0
  242. data/lib/google/apis/version.rb +1 -1
  243. data/samples/cli/lib/samples/adsense.rb +99 -0
  244. data/samples/cli/lib/samples/analytics.rb +18 -0
  245. data/samples/cli/lib/samples/gmail.rb +33 -0
  246. data/samples/cli/lib/samples/vision.rb +69 -0
  247. metadata +89 -4
  248. data/sync.rb +0 -71
@@ -0,0 +1,1504 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module SpannerV1
23
+ # Cloud Spanner API
24
+ #
25
+ # Cloud Spanner is a managed, mission-critical, globally consistent and scalable
26
+ # relational database service.
27
+ #
28
+ # @example
29
+ # require 'google/apis/spanner_v1'
30
+ #
31
+ # Spanner = Google::Apis::SpannerV1 # Alias the module
32
+ # service = Spanner::SpannerService.new
33
+ #
34
+ # @see https://cloud.google.com/spanner/
35
+ class SpannerService < Google::Apis::Core::BaseService
36
+ # @return [String]
37
+ # API key. Your API key identifies your project and provides you with API access,
38
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
39
+ attr_accessor :key
40
+
41
+ # @return [String]
42
+ # Available to use for quota purposes for server-side applications. Can be any
43
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
44
+ attr_accessor :quota_user
45
+
46
+ def initialize
47
+ super('https://spanner.googleapis.com/', '')
48
+ end
49
+
50
+ # Deletes an instance.
51
+ # Immediately upon completion of the request:
52
+ # * Billing ceases for all of the instance's reserved resources.
53
+ # Soon afterward:
54
+ # * The instance and *all of its databases* immediately and
55
+ # irrevocably disappear from the API. All data in the databases
56
+ # is permanently deleted.
57
+ # @param [String] name
58
+ # Required. The name of the instance to be deleted. Values are of the form
59
+ # `projects/<project>/instances/<instance>`
60
+ # @param [String] fields
61
+ # Selector specifying which fields to include in a partial response.
62
+ # @param [String] quota_user
63
+ # Available to use for quota purposes for server-side applications. Can be any
64
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
65
+ # @param [Google::Apis::RequestOptions] options
66
+ # Request-specific options
67
+ #
68
+ # @yield [result, err] Result & error if block supplied
69
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
70
+ # @yieldparam err [StandardError] error object if request failed
71
+ #
72
+ # @return [Google::Apis::SpannerV1::Empty]
73
+ #
74
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
75
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
76
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
77
+ def delete_project_instance(name, fields: nil, quota_user: nil, options: nil, &block)
78
+ command = make_simple_command(:delete, 'v1/{+name}', options)
79
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
80
+ command.response_class = Google::Apis::SpannerV1::Empty
81
+ command.params['name'] = name unless name.nil?
82
+ command.query['fields'] = fields unless fields.nil?
83
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
84
+ execute_or_queue_command(command, &block)
85
+ end
86
+
87
+ # Lists all instances in the given project.
88
+ # @param [String] parent
89
+ # Required. The name of the project for which a list of instances is
90
+ # requested. Values are of the form `projects/<project>`.
91
+ # @param [String] filter
92
+ # An expression for filtering the results of the request. Filter rules are
93
+ # case insensitive. The fields eligible for filtering are:
94
+ # * name
95
+ # * display_name
96
+ # * labels.key where key is the name of a label
97
+ # Some examples of using filters are:
98
+ # * name:* --> The instance has a name.
99
+ # * name:Howl --> The instance's name contains the string "howl".
100
+ # * name:HOWL --> Equivalent to above.
101
+ # * NAME:howl --> Equivalent to above.
102
+ # * labels.env:* --> The instance has the label "env".
103
+ # * labels.env:dev --> The instance has the label "env" and the value of
104
+ # the label contains the string "dev".
105
+ # * name:howl labels.env:dev --> The instance's name contains "howl" and
106
+ # it has the label "env" with its value
107
+ # containing "dev".
108
+ # @param [String] page_token
109
+ # If non-empty, `page_token` should contain a
110
+ # next_page_token from a
111
+ # previous ListInstancesResponse.
112
+ # @param [Fixnum] page_size
113
+ # Number of instances to be returned in the response. If 0 or less, defaults
114
+ # to the server's maximum allowed page size.
115
+ # @param [String] fields
116
+ # Selector specifying which fields to include in a partial response.
117
+ # @param [String] quota_user
118
+ # Available to use for quota purposes for server-side applications. Can be any
119
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
120
+ # @param [Google::Apis::RequestOptions] options
121
+ # Request-specific options
122
+ #
123
+ # @yield [result, err] Result & error if block supplied
124
+ # @yieldparam result [Google::Apis::SpannerV1::ListInstancesResponse] parsed result object
125
+ # @yieldparam err [StandardError] error object if request failed
126
+ #
127
+ # @return [Google::Apis::SpannerV1::ListInstancesResponse]
128
+ #
129
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
130
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
131
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
132
+ def list_project_instances(parent, filter: nil, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
133
+ command = make_simple_command(:get, 'v1/{+parent}/instances', options)
134
+ command.response_representation = Google::Apis::SpannerV1::ListInstancesResponse::Representation
135
+ command.response_class = Google::Apis::SpannerV1::ListInstancesResponse
136
+ command.params['parent'] = parent unless parent.nil?
137
+ command.query['filter'] = filter unless filter.nil?
138
+ command.query['pageToken'] = page_token unless page_token.nil?
139
+ command.query['pageSize'] = page_size unless page_size.nil?
140
+ command.query['fields'] = fields unless fields.nil?
141
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
142
+ execute_or_queue_command(command, &block)
143
+ end
144
+
145
+ # Creates an instance and begins preparing it to begin serving. The
146
+ # returned long-running operation
147
+ # can be used to track the progress of preparing the new
148
+ # instance. The instance name is assigned by the caller. If the
149
+ # named instance already exists, `CreateInstance` returns
150
+ # `ALREADY_EXISTS`.
151
+ # Immediately upon completion of this request:
152
+ # * The instance is readable via the API, with all requested attributes
153
+ # but no allocated resources. Its state is `CREATING`.
154
+ # Until completion of the returned operation:
155
+ # * Cancelling the operation renders the instance immediately unreadable
156
+ # via the API.
157
+ # * The instance can be deleted.
158
+ # * All other attempts to modify the instance are rejected.
159
+ # Upon completion of the returned operation:
160
+ # * Billing for all successfully-allocated resources begins (some types
161
+ # may have lower than the requested levels).
162
+ # * Databases can be created in the instance.
163
+ # * The instance's allocated resource levels are readable via the API.
164
+ # * The instance's state becomes `READY`.
165
+ # The returned long-running operation will
166
+ # have a name of the format `<instance_name>/operations/<operation_id>` and
167
+ # can be used to track creation of the instance. The
168
+ # metadata field type is
169
+ # CreateInstanceMetadata.
170
+ # The response field type is
171
+ # Instance, if successful.
172
+ # @param [String] parent
173
+ # Required. The name of the project in which to create the instance. Values
174
+ # are of the form `projects/<project>`.
175
+ # @param [Google::Apis::SpannerV1::CreateInstanceRequest] create_instance_request_object
176
+ # @param [String] fields
177
+ # Selector specifying which fields to include in a partial response.
178
+ # @param [String] quota_user
179
+ # Available to use for quota purposes for server-side applications. Can be any
180
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
181
+ # @param [Google::Apis::RequestOptions] options
182
+ # Request-specific options
183
+ #
184
+ # @yield [result, err] Result & error if block supplied
185
+ # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
186
+ # @yieldparam err [StandardError] error object if request failed
187
+ #
188
+ # @return [Google::Apis::SpannerV1::Operation]
189
+ #
190
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
191
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
192
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
193
+ def create_instance(parent, create_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
194
+ command = make_simple_command(:post, 'v1/{+parent}/instances', options)
195
+ command.request_representation = Google::Apis::SpannerV1::CreateInstanceRequest::Representation
196
+ command.request_object = create_instance_request_object
197
+ command.response_representation = Google::Apis::SpannerV1::Operation::Representation
198
+ command.response_class = Google::Apis::SpannerV1::Operation
199
+ command.params['parent'] = parent unless parent.nil?
200
+ command.query['fields'] = fields unless fields.nil?
201
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
202
+ execute_or_queue_command(command, &block)
203
+ end
204
+
205
+ # Sets the access control policy on an instance resource. Replaces any
206
+ # existing policy.
207
+ # Authorization requires `spanner.instances.setIamPolicy` on
208
+ # resource.
209
+ # @param [String] resource
210
+ # REQUIRED: The Cloud Spanner resource for which the policy is being set. The
211
+ # format is `projects/<project ID>/instances/<instance ID>` for instance
212
+ # resources and `projects/<project ID>/instances/<instance ID>/databases/<
213
+ # database ID>` for databases resources.
214
+ # @param [Google::Apis::SpannerV1::SetIamPolicyRequest] set_iam_policy_request_object
215
+ # @param [String] fields
216
+ # Selector specifying which fields to include in a partial response.
217
+ # @param [String] quota_user
218
+ # Available to use for quota purposes for server-side applications. Can be any
219
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
220
+ # @param [Google::Apis::RequestOptions] options
221
+ # Request-specific options
222
+ #
223
+ # @yield [result, err] Result & error if block supplied
224
+ # @yieldparam result [Google::Apis::SpannerV1::Policy] parsed result object
225
+ # @yieldparam err [StandardError] error object if request failed
226
+ #
227
+ # @return [Google::Apis::SpannerV1::Policy]
228
+ #
229
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
230
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
231
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
232
+ def set_instance_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
233
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
234
+ command.request_representation = Google::Apis::SpannerV1::SetIamPolicyRequest::Representation
235
+ command.request_object = set_iam_policy_request_object
236
+ command.response_representation = Google::Apis::SpannerV1::Policy::Representation
237
+ command.response_class = Google::Apis::SpannerV1::Policy
238
+ command.params['resource'] = resource unless resource.nil?
239
+ command.query['fields'] = fields unless fields.nil?
240
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
241
+ execute_or_queue_command(command, &block)
242
+ end
243
+
244
+ # Gets the access control policy for an instance resource. Returns an empty
245
+ # policy if an instance exists but does not have a policy set.
246
+ # Authorization requires `spanner.instances.getIamPolicy` on
247
+ # resource.
248
+ # @param [String] resource
249
+ # REQUIRED: The Cloud Spanner resource for which the policy is being retrieved.
250
+ # The format is `projects/<project ID>/instances/<instance ID>` for instance
251
+ # resources and `projects/<project ID>/instances/<instance ID>/databases/<
252
+ # database ID>` for database resources.
253
+ # @param [Google::Apis::SpannerV1::GetIamPolicyRequest] get_iam_policy_request_object
254
+ # @param [String] fields
255
+ # Selector specifying which fields to include in a partial response.
256
+ # @param [String] quota_user
257
+ # Available to use for quota purposes for server-side applications. Can be any
258
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
259
+ # @param [Google::Apis::RequestOptions] options
260
+ # Request-specific options
261
+ #
262
+ # @yield [result, err] Result & error if block supplied
263
+ # @yieldparam result [Google::Apis::SpannerV1::Policy] parsed result object
264
+ # @yieldparam err [StandardError] error object if request failed
265
+ #
266
+ # @return [Google::Apis::SpannerV1::Policy]
267
+ #
268
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
269
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
270
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
271
+ def get_instance_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
272
+ command = make_simple_command(:post, 'v1/{+resource}:getIamPolicy', options)
273
+ command.request_representation = Google::Apis::SpannerV1::GetIamPolicyRequest::Representation
274
+ command.request_object = get_iam_policy_request_object
275
+ command.response_representation = Google::Apis::SpannerV1::Policy::Representation
276
+ command.response_class = Google::Apis::SpannerV1::Policy
277
+ command.params['resource'] = resource unless resource.nil?
278
+ command.query['fields'] = fields unless fields.nil?
279
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
280
+ execute_or_queue_command(command, &block)
281
+ end
282
+
283
+ # Gets information about a particular instance.
284
+ # @param [String] name
285
+ # Required. The name of the requested instance. Values are of the form
286
+ # `projects/<project>/instances/<instance>`.
287
+ # @param [String] fields
288
+ # Selector specifying which fields to include in a partial response.
289
+ # @param [String] quota_user
290
+ # Available to use for quota purposes for server-side applications. Can be any
291
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
292
+ # @param [Google::Apis::RequestOptions] options
293
+ # Request-specific options
294
+ #
295
+ # @yield [result, err] Result & error if block supplied
296
+ # @yieldparam result [Google::Apis::SpannerV1::Instance] parsed result object
297
+ # @yieldparam err [StandardError] error object if request failed
298
+ #
299
+ # @return [Google::Apis::SpannerV1::Instance]
300
+ #
301
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
302
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
303
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
304
+ def get_project_instance(name, fields: nil, quota_user: nil, options: nil, &block)
305
+ command = make_simple_command(:get, 'v1/{+name}', options)
306
+ command.response_representation = Google::Apis::SpannerV1::Instance::Representation
307
+ command.response_class = Google::Apis::SpannerV1::Instance
308
+ command.params['name'] = name unless name.nil?
309
+ command.query['fields'] = fields unless fields.nil?
310
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
311
+ execute_or_queue_command(command, &block)
312
+ end
313
+
314
+ # Updates an instance, and begins allocating or releasing resources
315
+ # as requested. The returned long-running
316
+ # operation can be used to track the
317
+ # progress of updating the instance. If the named instance does not
318
+ # exist, returns `NOT_FOUND`.
319
+ # Immediately upon completion of this request:
320
+ # * For resource types for which a decrease in the instance's allocation
321
+ # has been requested, billing is based on the newly-requested level.
322
+ # Until completion of the returned operation:
323
+ # * Cancelling the operation sets its metadata's
324
+ # cancel_time, and begins
325
+ # restoring resources to their pre-request values. The operation
326
+ # is guaranteed to succeed at undoing all resource changes,
327
+ # after which point it terminates with a `CANCELLED` status.
328
+ # * All other attempts to modify the instance are rejected.
329
+ # * Reading the instance via the API continues to give the pre-request
330
+ # resource levels.
331
+ # Upon completion of the returned operation:
332
+ # * Billing begins for all successfully-allocated resources (some types
333
+ # may have lower than the requested levels).
334
+ # * All newly-reserved resources are available for serving the instance's
335
+ # tables.
336
+ # * The instance's new resource levels are readable via the API.
337
+ # The returned long-running operation will
338
+ # have a name of the format `<instance_name>/operations/<operation_id>` and
339
+ # can be used to track the instance modification. The
340
+ # metadata field type is
341
+ # UpdateInstanceMetadata.
342
+ # The response field type is
343
+ # Instance, if successful.
344
+ # Authorization requires `spanner.instances.update` permission on
345
+ # resource name.
346
+ # @param [String] name
347
+ # Required. A unique identifier for the instance, which cannot be changed
348
+ # after the instance is created. Values are of the form
349
+ # `projects/<project>/instances/a-z*[a-z0-9]`. The final
350
+ # segment of the name must be between 6 and 30 characters in length.
351
+ # @param [Google::Apis::SpannerV1::UpdateInstanceRequest] update_instance_request_object
352
+ # @param [String] fields
353
+ # Selector specifying which fields to include in a partial response.
354
+ # @param [String] quota_user
355
+ # Available to use for quota purposes for server-side applications. Can be any
356
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
357
+ # @param [Google::Apis::RequestOptions] options
358
+ # Request-specific options
359
+ #
360
+ # @yield [result, err] Result & error if block supplied
361
+ # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
362
+ # @yieldparam err [StandardError] error object if request failed
363
+ #
364
+ # @return [Google::Apis::SpannerV1::Operation]
365
+ #
366
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
367
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
368
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
369
+ def patch_project_instance(name, update_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
370
+ command = make_simple_command(:patch, 'v1/{+name}', options)
371
+ command.request_representation = Google::Apis::SpannerV1::UpdateInstanceRequest::Representation
372
+ command.request_object = update_instance_request_object
373
+ command.response_representation = Google::Apis::SpannerV1::Operation::Representation
374
+ command.response_class = Google::Apis::SpannerV1::Operation
375
+ command.params['name'] = name unless name.nil?
376
+ command.query['fields'] = fields unless fields.nil?
377
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
378
+ execute_or_queue_command(command, &block)
379
+ end
380
+
381
+ # Returns permissions that the caller has on the specified instance resource.
382
+ # Attempting this RPC on a non-existent Cloud Spanner instance resource will
383
+ # result in a NOT_FOUND error if the user has `spanner.instances.list`
384
+ # permission on the containing Google Cloud Project. Otherwise returns an
385
+ # empty set of permissions.
386
+ # @param [String] resource
387
+ # REQUIRED: The Cloud Spanner resource for which permissions are being tested.
388
+ # The format is `projects/<project ID>/instances/<instance ID>` for instance
389
+ # resources and `projects/<project ID>/instances/<instance ID>/databases/<
390
+ # database ID>` for database resources.
391
+ # @param [Google::Apis::SpannerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
392
+ # @param [String] fields
393
+ # Selector specifying which fields to include in a partial response.
394
+ # @param [String] quota_user
395
+ # Available to use for quota purposes for server-side applications. Can be any
396
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
397
+ # @param [Google::Apis::RequestOptions] options
398
+ # Request-specific options
399
+ #
400
+ # @yield [result, err] Result & error if block supplied
401
+ # @yieldparam result [Google::Apis::SpannerV1::TestIamPermissionsResponse] parsed result object
402
+ # @yieldparam err [StandardError] error object if request failed
403
+ #
404
+ # @return [Google::Apis::SpannerV1::TestIamPermissionsResponse]
405
+ #
406
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
407
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
408
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
409
+ def test_instance_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
410
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
411
+ command.request_representation = Google::Apis::SpannerV1::TestIamPermissionsRequest::Representation
412
+ command.request_object = test_iam_permissions_request_object
413
+ command.response_representation = Google::Apis::SpannerV1::TestIamPermissionsResponse::Representation
414
+ command.response_class = Google::Apis::SpannerV1::TestIamPermissionsResponse
415
+ command.params['resource'] = resource unless resource.nil?
416
+ command.query['fields'] = fields unless fields.nil?
417
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
418
+ execute_or_queue_command(command, &block)
419
+ end
420
+
421
+ # Returns the schema of a Cloud Spanner database as a list of formatted
422
+ # DDL statements. This method does not show pending schema updates, those may
423
+ # be queried using the Operations API.
424
+ # @param [String] database
425
+ # Required. The database whose schema we wish to get.
426
+ # @param [String] fields
427
+ # Selector specifying which fields to include in a partial response.
428
+ # @param [String] quota_user
429
+ # Available to use for quota purposes for server-side applications. Can be any
430
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
431
+ # @param [Google::Apis::RequestOptions] options
432
+ # Request-specific options
433
+ #
434
+ # @yield [result, err] Result & error if block supplied
435
+ # @yieldparam result [Google::Apis::SpannerV1::GetDatabaseDdlResponse] parsed result object
436
+ # @yieldparam err [StandardError] error object if request failed
437
+ #
438
+ # @return [Google::Apis::SpannerV1::GetDatabaseDdlResponse]
439
+ #
440
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
441
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
442
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
443
+ def get_project_instance_database_ddl(database, fields: nil, quota_user: nil, options: nil, &block)
444
+ command = make_simple_command(:get, 'v1/{+database}/ddl', options)
445
+ command.response_representation = Google::Apis::SpannerV1::GetDatabaseDdlResponse::Representation
446
+ command.response_class = Google::Apis::SpannerV1::GetDatabaseDdlResponse
447
+ command.params['database'] = database unless database.nil?
448
+ command.query['fields'] = fields unless fields.nil?
449
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
450
+ execute_or_queue_command(command, &block)
451
+ end
452
+
453
+ # Lists Cloud Spanner databases.
454
+ # @param [String] parent
455
+ # Required. The instance whose databases should be listed.
456
+ # Values are of the form `projects/<project>/instances/<instance>`.
457
+ # @param [String] page_token
458
+ # If non-empty, `page_token` should contain a
459
+ # next_page_token from a
460
+ # previous ListDatabasesResponse.
461
+ # @param [Fixnum] page_size
462
+ # Number of databases to be returned in the response. If 0 or less,
463
+ # defaults to the server's maximum allowed page size.
464
+ # @param [String] fields
465
+ # Selector specifying which fields to include in a partial response.
466
+ # @param [String] quota_user
467
+ # Available to use for quota purposes for server-side applications. Can be any
468
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
469
+ # @param [Google::Apis::RequestOptions] options
470
+ # Request-specific options
471
+ #
472
+ # @yield [result, err] Result & error if block supplied
473
+ # @yieldparam result [Google::Apis::SpannerV1::ListDatabasesResponse] parsed result object
474
+ # @yieldparam err [StandardError] error object if request failed
475
+ #
476
+ # @return [Google::Apis::SpannerV1::ListDatabasesResponse]
477
+ #
478
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
479
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
480
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
481
+ def list_project_instance_databases(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
482
+ command = make_simple_command(:get, 'v1/{+parent}/databases', options)
483
+ command.response_representation = Google::Apis::SpannerV1::ListDatabasesResponse::Representation
484
+ command.response_class = Google::Apis::SpannerV1::ListDatabasesResponse
485
+ command.params['parent'] = parent unless parent.nil?
486
+ command.query['pageToken'] = page_token unless page_token.nil?
487
+ command.query['pageSize'] = page_size unless page_size.nil?
488
+ command.query['fields'] = fields unless fields.nil?
489
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
490
+ execute_or_queue_command(command, &block)
491
+ end
492
+
493
+ # Sets the access control policy on a database resource. Replaces any
494
+ # existing policy.
495
+ # Authorization requires `spanner.databases.setIamPolicy` permission on
496
+ # resource.
497
+ # @param [String] resource
498
+ # REQUIRED: The Cloud Spanner resource for which the policy is being set. The
499
+ # format is `projects/<project ID>/instances/<instance ID>` for instance
500
+ # resources and `projects/<project ID>/instances/<instance ID>/databases/<
501
+ # database ID>` for databases resources.
502
+ # @param [Google::Apis::SpannerV1::SetIamPolicyRequest] set_iam_policy_request_object
503
+ # @param [String] fields
504
+ # Selector specifying which fields to include in a partial response.
505
+ # @param [String] quota_user
506
+ # Available to use for quota purposes for server-side applications. Can be any
507
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
508
+ # @param [Google::Apis::RequestOptions] options
509
+ # Request-specific options
510
+ #
511
+ # @yield [result, err] Result & error if block supplied
512
+ # @yieldparam result [Google::Apis::SpannerV1::Policy] parsed result object
513
+ # @yieldparam err [StandardError] error object if request failed
514
+ #
515
+ # @return [Google::Apis::SpannerV1::Policy]
516
+ #
517
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
518
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
519
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
520
+ def set_database_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
521
+ command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
522
+ command.request_representation = Google::Apis::SpannerV1::SetIamPolicyRequest::Representation
523
+ command.request_object = set_iam_policy_request_object
524
+ command.response_representation = Google::Apis::SpannerV1::Policy::Representation
525
+ command.response_class = Google::Apis::SpannerV1::Policy
526
+ command.params['resource'] = resource unless resource.nil?
527
+ command.query['fields'] = fields unless fields.nil?
528
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
529
+ execute_or_queue_command(command, &block)
530
+ end
531
+
532
+ # Creates a new Cloud Spanner database and starts to prepare it for serving.
533
+ # The returned long-running operation will
534
+ # have a name of the format `<database_name>/operations/<operation_id>` and
535
+ # can be used to track preparation of the database. The
536
+ # metadata field type is
537
+ # CreateDatabaseMetadata. The
538
+ # response field type is
539
+ # Database, if successful.
540
+ # @param [String] parent
541
+ # Required. The name of the instance that will serve the new database.
542
+ # Values are of the form `projects/<project>/instances/<instance>`.
543
+ # @param [Google::Apis::SpannerV1::CreateDatabaseRequest] create_database_request_object
544
+ # @param [String] fields
545
+ # Selector specifying which fields to include in a partial response.
546
+ # @param [String] quota_user
547
+ # Available to use for quota purposes for server-side applications. Can be any
548
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
549
+ # @param [Google::Apis::RequestOptions] options
550
+ # Request-specific options
551
+ #
552
+ # @yield [result, err] Result & error if block supplied
553
+ # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
554
+ # @yieldparam err [StandardError] error object if request failed
555
+ #
556
+ # @return [Google::Apis::SpannerV1::Operation]
557
+ #
558
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
559
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
560
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
561
+ def create_database(parent, create_database_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
562
+ command = make_simple_command(:post, 'v1/{+parent}/databases', options)
563
+ command.request_representation = Google::Apis::SpannerV1::CreateDatabaseRequest::Representation
564
+ command.request_object = create_database_request_object
565
+ command.response_representation = Google::Apis::SpannerV1::Operation::Representation
566
+ command.response_class = Google::Apis::SpannerV1::Operation
567
+ command.params['parent'] = parent unless parent.nil?
568
+ command.query['fields'] = fields unless fields.nil?
569
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
570
+ execute_or_queue_command(command, &block)
571
+ end
572
+
573
+ # Gets the access control policy for a database resource. Returns an empty
574
+ # policy if a database exists but does not have a policy set.
575
+ # Authorization requires `spanner.databases.getIamPolicy` permission on
576
+ # resource.
577
+ # @param [String] resource
578
+ # REQUIRED: The Cloud Spanner resource for which the policy is being retrieved.
579
+ # The format is `projects/<project ID>/instances/<instance ID>` for instance
580
+ # resources and `projects/<project ID>/instances/<instance ID>/databases/<
581
+ # database ID>` for database resources.
582
+ # @param [Google::Apis::SpannerV1::GetIamPolicyRequest] get_iam_policy_request_object
583
+ # @param [String] fields
584
+ # Selector specifying which fields to include in a partial response.
585
+ # @param [String] quota_user
586
+ # Available to use for quota purposes for server-side applications. Can be any
587
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
588
+ # @param [Google::Apis::RequestOptions] options
589
+ # Request-specific options
590
+ #
591
+ # @yield [result, err] Result & error if block supplied
592
+ # @yieldparam result [Google::Apis::SpannerV1::Policy] parsed result object
593
+ # @yieldparam err [StandardError] error object if request failed
594
+ #
595
+ # @return [Google::Apis::SpannerV1::Policy]
596
+ #
597
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
598
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
599
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
600
+ def get_database_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
601
+ command = make_simple_command(:post, 'v1/{+resource}:getIamPolicy', options)
602
+ command.request_representation = Google::Apis::SpannerV1::GetIamPolicyRequest::Representation
603
+ command.request_object = get_iam_policy_request_object
604
+ command.response_representation = Google::Apis::SpannerV1::Policy::Representation
605
+ command.response_class = Google::Apis::SpannerV1::Policy
606
+ command.params['resource'] = resource unless resource.nil?
607
+ command.query['fields'] = fields unless fields.nil?
608
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
609
+ execute_or_queue_command(command, &block)
610
+ end
611
+
612
+ # Gets the state of a Cloud Spanner database.
613
+ # @param [String] name
614
+ # Required. The name of the requested database. Values are of the form
615
+ # `projects/<project>/instances/<instance>/databases/<database>`.
616
+ # @param [String] fields
617
+ # Selector specifying which fields to include in a partial response.
618
+ # @param [String] quota_user
619
+ # Available to use for quota purposes for server-side applications. Can be any
620
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
621
+ # @param [Google::Apis::RequestOptions] options
622
+ # Request-specific options
623
+ #
624
+ # @yield [result, err] Result & error if block supplied
625
+ # @yieldparam result [Google::Apis::SpannerV1::Database] parsed result object
626
+ # @yieldparam err [StandardError] error object if request failed
627
+ #
628
+ # @return [Google::Apis::SpannerV1::Database]
629
+ #
630
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
631
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
632
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
633
+ def get_project_instance_database(name, fields: nil, quota_user: nil, options: nil, &block)
634
+ command = make_simple_command(:get, 'v1/{+name}', options)
635
+ command.response_representation = Google::Apis::SpannerV1::Database::Representation
636
+ command.response_class = Google::Apis::SpannerV1::Database
637
+ command.params['name'] = name unless name.nil?
638
+ command.query['fields'] = fields unless fields.nil?
639
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
640
+ execute_or_queue_command(command, &block)
641
+ end
642
+
643
+ # Drops (aka deletes) a Cloud Spanner database.
644
+ # @param [String] database
645
+ # Required. The database to be dropped.
646
+ # @param [String] fields
647
+ # Selector specifying which fields to include in a partial response.
648
+ # @param [String] quota_user
649
+ # Available to use for quota purposes for server-side applications. Can be any
650
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
651
+ # @param [Google::Apis::RequestOptions] options
652
+ # Request-specific options
653
+ #
654
+ # @yield [result, err] Result & error if block supplied
655
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
656
+ # @yieldparam err [StandardError] error object if request failed
657
+ #
658
+ # @return [Google::Apis::SpannerV1::Empty]
659
+ #
660
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
661
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
662
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
663
+ def drop_project_instance_database_database(database, fields: nil, quota_user: nil, options: nil, &block)
664
+ command = make_simple_command(:delete, 'v1/{+database}', options)
665
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
666
+ command.response_class = Google::Apis::SpannerV1::Empty
667
+ command.params['database'] = database unless database.nil?
668
+ command.query['fields'] = fields unless fields.nil?
669
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
670
+ execute_or_queue_command(command, &block)
671
+ end
672
+
673
+ # Updates the schema of a Cloud Spanner database by
674
+ # creating/altering/dropping tables, columns, indexes, etc. The returned
675
+ # long-running operation will have a name of
676
+ # the format `<database_name>/operations/<operation_id>` and can be used to
677
+ # track execution of the schema change(s). The
678
+ # metadata field type is
679
+ # UpdateDatabaseDdlMetadata. The operation has no response.
680
+ # @param [String] database
681
+ # Required. The database to update.
682
+ # @param [Google::Apis::SpannerV1::UpdateDatabaseDdlRequest] update_database_ddl_request_object
683
+ # @param [String] fields
684
+ # Selector specifying which fields to include in a partial response.
685
+ # @param [String] quota_user
686
+ # Available to use for quota purposes for server-side applications. Can be any
687
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
688
+ # @param [Google::Apis::RequestOptions] options
689
+ # Request-specific options
690
+ #
691
+ # @yield [result, err] Result & error if block supplied
692
+ # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
693
+ # @yieldparam err [StandardError] error object if request failed
694
+ #
695
+ # @return [Google::Apis::SpannerV1::Operation]
696
+ #
697
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
698
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
699
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
700
+ def update_project_instance_database_ddl(database, update_database_ddl_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
701
+ command = make_simple_command(:patch, 'v1/{+database}/ddl', options)
702
+ command.request_representation = Google::Apis::SpannerV1::UpdateDatabaseDdlRequest::Representation
703
+ command.request_object = update_database_ddl_request_object
704
+ command.response_representation = Google::Apis::SpannerV1::Operation::Representation
705
+ command.response_class = Google::Apis::SpannerV1::Operation
706
+ command.params['database'] = database unless database.nil?
707
+ command.query['fields'] = fields unless fields.nil?
708
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
709
+ execute_or_queue_command(command, &block)
710
+ end
711
+
712
+ # Returns permissions that the caller has on the specified database resource.
713
+ # Attempting this RPC on a non-existent Cloud Spanner database will result in
714
+ # a NOT_FOUND error if the user has `spanner.databases.list` permission on
715
+ # the containing Cloud Spanner instance. Otherwise returns an empty set of
716
+ # permissions.
717
+ # @param [String] resource
718
+ # REQUIRED: The Cloud Spanner resource for which permissions are being tested.
719
+ # The format is `projects/<project ID>/instances/<instance ID>` for instance
720
+ # resources and `projects/<project ID>/instances/<instance ID>/databases/<
721
+ # database ID>` for database resources.
722
+ # @param [Google::Apis::SpannerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
723
+ # @param [String] fields
724
+ # Selector specifying which fields to include in a partial response.
725
+ # @param [String] quota_user
726
+ # Available to use for quota purposes for server-side applications. Can be any
727
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
728
+ # @param [Google::Apis::RequestOptions] options
729
+ # Request-specific options
730
+ #
731
+ # @yield [result, err] Result & error if block supplied
732
+ # @yieldparam result [Google::Apis::SpannerV1::TestIamPermissionsResponse] parsed result object
733
+ # @yieldparam err [StandardError] error object if request failed
734
+ #
735
+ # @return [Google::Apis::SpannerV1::TestIamPermissionsResponse]
736
+ #
737
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
738
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
739
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
740
+ def test_database_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
741
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
742
+ command.request_representation = Google::Apis::SpannerV1::TestIamPermissionsRequest::Representation
743
+ command.request_object = test_iam_permissions_request_object
744
+ command.response_representation = Google::Apis::SpannerV1::TestIamPermissionsResponse::Representation
745
+ command.response_class = Google::Apis::SpannerV1::TestIamPermissionsResponse
746
+ command.params['resource'] = resource unless resource.nil?
747
+ command.query['fields'] = fields unless fields.nil?
748
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
749
+ execute_or_queue_command(command, &block)
750
+ end
751
+
752
+ # Starts asynchronous cancellation on a long-running operation. The server
753
+ # makes a best effort to cancel the operation, but success is not
754
+ # guaranteed. If the server doesn't support this method, it returns
755
+ # `google.rpc.Code.UNIMPLEMENTED`. Clients can use
756
+ # Operations.GetOperation or
757
+ # other methods to check whether the cancellation succeeded or whether the
758
+ # operation completed despite cancellation. On successful cancellation,
759
+ # the operation is not deleted; instead, it becomes an operation with
760
+ # an Operation.error value with a google.rpc.Status.code of 1,
761
+ # corresponding to `Code.CANCELLED`.
762
+ # @param [String] name
763
+ # The name of the operation resource to be cancelled.
764
+ # @param [String] fields
765
+ # Selector specifying which fields to include in a partial response.
766
+ # @param [String] quota_user
767
+ # Available to use for quota purposes for server-side applications. Can be any
768
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
769
+ # @param [Google::Apis::RequestOptions] options
770
+ # Request-specific options
771
+ #
772
+ # @yield [result, err] Result & error if block supplied
773
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
774
+ # @yieldparam err [StandardError] error object if request failed
775
+ #
776
+ # @return [Google::Apis::SpannerV1::Empty]
777
+ #
778
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
779
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
780
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
781
+ def cancel_project_instance_database_operation(name, fields: nil, quota_user: nil, options: nil, &block)
782
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
783
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
784
+ command.response_class = Google::Apis::SpannerV1::Empty
785
+ command.params['name'] = name unless name.nil?
786
+ command.query['fields'] = fields unless fields.nil?
787
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
788
+ execute_or_queue_command(command, &block)
789
+ end
790
+
791
+ # Deletes a long-running operation. This method indicates that the client is
792
+ # no longer interested in the operation result. It does not cancel the
793
+ # operation. If the server doesn't support this method, it returns
794
+ # `google.rpc.Code.UNIMPLEMENTED`.
795
+ # @param [String] name
796
+ # The name of the operation resource to be deleted.
797
+ # @param [String] fields
798
+ # Selector specifying which fields to include in a partial response.
799
+ # @param [String] quota_user
800
+ # Available to use for quota purposes for server-side applications. Can be any
801
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
802
+ # @param [Google::Apis::RequestOptions] options
803
+ # Request-specific options
804
+ #
805
+ # @yield [result, err] Result & error if block supplied
806
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
807
+ # @yieldparam err [StandardError] error object if request failed
808
+ #
809
+ # @return [Google::Apis::SpannerV1::Empty]
810
+ #
811
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
812
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
813
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
814
+ def delete_project_instance_database_operation(name, fields: nil, quota_user: nil, options: nil, &block)
815
+ command = make_simple_command(:delete, 'v1/{+name}', options)
816
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
817
+ command.response_class = Google::Apis::SpannerV1::Empty
818
+ command.params['name'] = name unless name.nil?
819
+ command.query['fields'] = fields unless fields.nil?
820
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
821
+ execute_or_queue_command(command, &block)
822
+ end
823
+
824
+ # Lists operations that match the specified filter in the request. If the
825
+ # server doesn't support this method, it returns `UNIMPLEMENTED`.
826
+ # NOTE: the `name` binding below allows API services to override the binding
827
+ # to use different resource name schemes, such as `users/*/operations`.
828
+ # @param [String] name
829
+ # The name of the operation collection.
830
+ # @param [String] filter
831
+ # The standard list filter.
832
+ # @param [String] page_token
833
+ # The standard list page token.
834
+ # @param [Fixnum] page_size
835
+ # The standard list page size.
836
+ # @param [String] fields
837
+ # Selector specifying which fields to include in a partial response.
838
+ # @param [String] quota_user
839
+ # Available to use for quota purposes for server-side applications. Can be any
840
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
841
+ # @param [Google::Apis::RequestOptions] options
842
+ # Request-specific options
843
+ #
844
+ # @yield [result, err] Result & error if block supplied
845
+ # @yieldparam result [Google::Apis::SpannerV1::ListOperationsResponse] parsed result object
846
+ # @yieldparam err [StandardError] error object if request failed
847
+ #
848
+ # @return [Google::Apis::SpannerV1::ListOperationsResponse]
849
+ #
850
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
851
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
852
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
853
+ def list_project_instance_database_operations(name, filter: nil, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
854
+ command = make_simple_command(:get, 'v1/{+name}', options)
855
+ command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
856
+ command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
857
+ command.params['name'] = name unless name.nil?
858
+ command.query['filter'] = filter unless filter.nil?
859
+ command.query['pageToken'] = page_token unless page_token.nil?
860
+ command.query['pageSize'] = page_size unless page_size.nil?
861
+ command.query['fields'] = fields unless fields.nil?
862
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
863
+ execute_or_queue_command(command, &block)
864
+ end
865
+
866
+ # Gets the latest state of a long-running operation. Clients can use this
867
+ # method to poll the operation result at intervals as recommended by the API
868
+ # service.
869
+ # @param [String] name
870
+ # The name of the operation resource.
871
+ # @param [String] fields
872
+ # Selector specifying which fields to include in a partial response.
873
+ # @param [String] quota_user
874
+ # Available to use for quota purposes for server-side applications. Can be any
875
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
876
+ # @param [Google::Apis::RequestOptions] options
877
+ # Request-specific options
878
+ #
879
+ # @yield [result, err] Result & error if block supplied
880
+ # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
881
+ # @yieldparam err [StandardError] error object if request failed
882
+ #
883
+ # @return [Google::Apis::SpannerV1::Operation]
884
+ #
885
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
886
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
887
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
888
+ def get_project_instance_database_operation(name, fields: nil, quota_user: nil, options: nil, &block)
889
+ command = make_simple_command(:get, 'v1/{+name}', options)
890
+ command.response_representation = Google::Apis::SpannerV1::Operation::Representation
891
+ command.response_class = Google::Apis::SpannerV1::Operation
892
+ command.params['name'] = name unless name.nil?
893
+ command.query['fields'] = fields unless fields.nil?
894
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
895
+ execute_or_queue_command(command, &block)
896
+ end
897
+
898
+ # Like Read, except returns the result set as a
899
+ # stream. Unlike Read, there is no limit on the
900
+ # size of the returned result set. However, no individual row in
901
+ # the result set can exceed 100 MiB, and no column value can exceed
902
+ # 10 MiB.
903
+ # @param [String] session
904
+ # Required. The session in which the read should be performed.
905
+ # @param [Google::Apis::SpannerV1::ReadRequest] read_request_object
906
+ # @param [String] fields
907
+ # Selector specifying which fields to include in a partial response.
908
+ # @param [String] quota_user
909
+ # Available to use for quota purposes for server-side applications. Can be any
910
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
911
+ # @param [Google::Apis::RequestOptions] options
912
+ # Request-specific options
913
+ #
914
+ # @yield [result, err] Result & error if block supplied
915
+ # @yieldparam result [Google::Apis::SpannerV1::PartialResultSet] parsed result object
916
+ # @yieldparam err [StandardError] error object if request failed
917
+ #
918
+ # @return [Google::Apis::SpannerV1::PartialResultSet]
919
+ #
920
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
921
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
922
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
923
+ def streaming_project_instance_database_session_read(session, read_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
924
+ command = make_simple_command(:post, 'v1/{+session}:streamingRead', options)
925
+ command.request_representation = Google::Apis::SpannerV1::ReadRequest::Representation
926
+ command.request_object = read_request_object
927
+ command.response_representation = Google::Apis::SpannerV1::PartialResultSet::Representation
928
+ command.response_class = Google::Apis::SpannerV1::PartialResultSet
929
+ command.params['session'] = session unless session.nil?
930
+ command.query['fields'] = fields unless fields.nil?
931
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
932
+ execute_or_queue_command(command, &block)
933
+ end
934
+
935
+ # Rolls back a transaction, releasing any locks it holds. It is a good
936
+ # idea to call this for any transaction that includes one or more
937
+ # Read or ExecuteSql requests and
938
+ # ultimately decides not to commit.
939
+ # `Rollback` returns `OK` if it successfully aborts the transaction, the
940
+ # transaction was already aborted, or the transaction is not
941
+ # found. `Rollback` never returns `ABORTED`.
942
+ # @param [String] session
943
+ # Required. The session in which the transaction to roll back is running.
944
+ # @param [Google::Apis::SpannerV1::RollbackRequest] rollback_request_object
945
+ # @param [String] fields
946
+ # Selector specifying which fields to include in a partial response.
947
+ # @param [String] quota_user
948
+ # Available to use for quota purposes for server-side applications. Can be any
949
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
950
+ # @param [Google::Apis::RequestOptions] options
951
+ # Request-specific options
952
+ #
953
+ # @yield [result, err] Result & error if block supplied
954
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
955
+ # @yieldparam err [StandardError] error object if request failed
956
+ #
957
+ # @return [Google::Apis::SpannerV1::Empty]
958
+ #
959
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
960
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
961
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
962
+ def rollback_session(session, rollback_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
963
+ command = make_simple_command(:post, 'v1/{+session}:rollback', options)
964
+ command.request_representation = Google::Apis::SpannerV1::RollbackRequest::Representation
965
+ command.request_object = rollback_request_object
966
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
967
+ command.response_class = Google::Apis::SpannerV1::Empty
968
+ command.params['session'] = session unless session.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # Creates a new session. A session can be used to perform
975
+ # transactions that read and/or modify data in a Cloud Spanner database.
976
+ # Sessions are meant to be reused for many consecutive
977
+ # transactions.
978
+ # Sessions can only execute one transaction at a time. To execute
979
+ # multiple concurrent read-write/write-only transactions, create
980
+ # multiple sessions. Note that standalone reads and queries use a
981
+ # transaction internally, and count toward the one transaction
982
+ # limit.
983
+ # Cloud Spanner limits the number of sessions that can exist at any given
984
+ # time; thus, it is a good idea to delete idle and/or unneeded sessions.
985
+ # Aside from explicit deletes, Cloud Spanner can delete sessions for which no
986
+ # operations are sent for more than an hour. If a session is deleted,
987
+ # requests to it return `NOT_FOUND`.
988
+ # Idle sessions can be kept alive by sending a trivial SQL query
989
+ # periodically, e.g., `"SELECT 1"`.
990
+ # @param [String] database
991
+ # Required. The database in which the new session is created.
992
+ # @param [String] fields
993
+ # Selector specifying which fields to include in a partial response.
994
+ # @param [String] quota_user
995
+ # Available to use for quota purposes for server-side applications. Can be any
996
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
997
+ # @param [Google::Apis::RequestOptions] options
998
+ # Request-specific options
999
+ #
1000
+ # @yield [result, err] Result & error if block supplied
1001
+ # @yieldparam result [Google::Apis::SpannerV1::Session] parsed result object
1002
+ # @yieldparam err [StandardError] error object if request failed
1003
+ #
1004
+ # @return [Google::Apis::SpannerV1::Session]
1005
+ #
1006
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1007
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1008
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1009
+ def create_project_instance_database_session(database, fields: nil, quota_user: nil, options: nil, &block)
1010
+ command = make_simple_command(:post, 'v1/{+database}/sessions', options)
1011
+ command.response_representation = Google::Apis::SpannerV1::Session::Representation
1012
+ command.response_class = Google::Apis::SpannerV1::Session
1013
+ command.params['database'] = database unless database.nil?
1014
+ command.query['fields'] = fields unless fields.nil?
1015
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1016
+ execute_or_queue_command(command, &block)
1017
+ end
1018
+
1019
+ # Reads rows from the database using key lookups and scans, as a
1020
+ # simple key/value style alternative to
1021
+ # ExecuteSql. This method cannot be used to
1022
+ # return a result set larger than 10 MiB; if the read matches more
1023
+ # data than that, the read fails with a `FAILED_PRECONDITION`
1024
+ # error.
1025
+ # Reads inside read-write transactions might return `ABORTED`. If
1026
+ # this occurs, the application should restart the transaction from
1027
+ # the beginning. See Transaction for more details.
1028
+ # Larger result sets can be yielded in streaming fashion by calling
1029
+ # StreamingRead instead.
1030
+ # @param [String] session
1031
+ # Required. The session in which the read should be performed.
1032
+ # @param [Google::Apis::SpannerV1::ReadRequest] read_request_object
1033
+ # @param [String] fields
1034
+ # Selector specifying which fields to include in a partial response.
1035
+ # @param [String] quota_user
1036
+ # Available to use for quota purposes for server-side applications. Can be any
1037
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1038
+ # @param [Google::Apis::RequestOptions] options
1039
+ # Request-specific options
1040
+ #
1041
+ # @yield [result, err] Result & error if block supplied
1042
+ # @yieldparam result [Google::Apis::SpannerV1::ResultSet] parsed result object
1043
+ # @yieldparam err [StandardError] error object if request failed
1044
+ #
1045
+ # @return [Google::Apis::SpannerV1::ResultSet]
1046
+ #
1047
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1048
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1049
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1050
+ def read_session(session, read_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1051
+ command = make_simple_command(:post, 'v1/{+session}:read', options)
1052
+ command.request_representation = Google::Apis::SpannerV1::ReadRequest::Representation
1053
+ command.request_object = read_request_object
1054
+ command.response_representation = Google::Apis::SpannerV1::ResultSet::Representation
1055
+ command.response_class = Google::Apis::SpannerV1::ResultSet
1056
+ command.params['session'] = session unless session.nil?
1057
+ command.query['fields'] = fields unless fields.nil?
1058
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1059
+ execute_or_queue_command(command, &block)
1060
+ end
1061
+
1062
+ # Gets a session. Returns `NOT_FOUND` if the session does not exist.
1063
+ # This is mainly useful for determining whether a session is still
1064
+ # alive.
1065
+ # @param [String] name
1066
+ # Required. The name of the session to retrieve.
1067
+ # @param [String] fields
1068
+ # Selector specifying which fields to include in a partial response.
1069
+ # @param [String] quota_user
1070
+ # Available to use for quota purposes for server-side applications. Can be any
1071
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1072
+ # @param [Google::Apis::RequestOptions] options
1073
+ # Request-specific options
1074
+ #
1075
+ # @yield [result, err] Result & error if block supplied
1076
+ # @yieldparam result [Google::Apis::SpannerV1::Session] parsed result object
1077
+ # @yieldparam err [StandardError] error object if request failed
1078
+ #
1079
+ # @return [Google::Apis::SpannerV1::Session]
1080
+ #
1081
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1082
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1083
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1084
+ def get_project_instance_database_session(name, fields: nil, quota_user: nil, options: nil, &block)
1085
+ command = make_simple_command(:get, 'v1/{+name}', options)
1086
+ command.response_representation = Google::Apis::SpannerV1::Session::Representation
1087
+ command.response_class = Google::Apis::SpannerV1::Session
1088
+ command.params['name'] = name unless name.nil?
1089
+ command.query['fields'] = fields unless fields.nil?
1090
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1091
+ execute_or_queue_command(command, &block)
1092
+ end
1093
+
1094
+ # Ends a session, releasing server resources associated with it.
1095
+ # @param [String] name
1096
+ # Required. The name of the session to delete.
1097
+ # @param [String] fields
1098
+ # Selector specifying which fields to include in a partial response.
1099
+ # @param [String] quota_user
1100
+ # Available to use for quota purposes for server-side applications. Can be any
1101
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1102
+ # @param [Google::Apis::RequestOptions] options
1103
+ # Request-specific options
1104
+ #
1105
+ # @yield [result, err] Result & error if block supplied
1106
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1107
+ # @yieldparam err [StandardError] error object if request failed
1108
+ #
1109
+ # @return [Google::Apis::SpannerV1::Empty]
1110
+ #
1111
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1112
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1113
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1114
+ def delete_project_instance_database_session(name, fields: nil, quota_user: nil, options: nil, &block)
1115
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1116
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1117
+ command.response_class = Google::Apis::SpannerV1::Empty
1118
+ command.params['name'] = name unless name.nil?
1119
+ command.query['fields'] = fields unless fields.nil?
1120
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1121
+ execute_or_queue_command(command, &block)
1122
+ end
1123
+
1124
+ # Like ExecuteSql, except returns the result
1125
+ # set as a stream. Unlike ExecuteSql, there
1126
+ # is no limit on the size of the returned result set. However, no
1127
+ # individual row in the result set can exceed 100 MiB, and no
1128
+ # column value can exceed 10 MiB.
1129
+ # @param [String] session
1130
+ # Required. The session in which the SQL query should be performed.
1131
+ # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
1132
+ # @param [String] fields
1133
+ # Selector specifying which fields to include in a partial response.
1134
+ # @param [String] quota_user
1135
+ # Available to use for quota purposes for server-side applications. Can be any
1136
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1137
+ # @param [Google::Apis::RequestOptions] options
1138
+ # Request-specific options
1139
+ #
1140
+ # @yield [result, err] Result & error if block supplied
1141
+ # @yieldparam result [Google::Apis::SpannerV1::PartialResultSet] parsed result object
1142
+ # @yieldparam err [StandardError] error object if request failed
1143
+ #
1144
+ # @return [Google::Apis::SpannerV1::PartialResultSet]
1145
+ #
1146
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1147
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1148
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1149
+ def execute_project_instance_database_session_streaming_sql(session, execute_sql_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1150
+ command = make_simple_command(:post, 'v1/{+session}:executeStreamingSql', options)
1151
+ command.request_representation = Google::Apis::SpannerV1::ExecuteSqlRequest::Representation
1152
+ command.request_object = execute_sql_request_object
1153
+ command.response_representation = Google::Apis::SpannerV1::PartialResultSet::Representation
1154
+ command.response_class = Google::Apis::SpannerV1::PartialResultSet
1155
+ command.params['session'] = session unless session.nil?
1156
+ command.query['fields'] = fields unless fields.nil?
1157
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1158
+ execute_or_queue_command(command, &block)
1159
+ end
1160
+
1161
+ # Commits a transaction. The request includes the mutations to be
1162
+ # applied to rows in the database.
1163
+ # `Commit` might return an `ABORTED` error. This can occur at any time;
1164
+ # commonly, the cause is conflicts with concurrent
1165
+ # transactions. However, it can also happen for a variety of other
1166
+ # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
1167
+ # the transaction from the beginning, re-using the same session.
1168
+ # @param [String] session
1169
+ # Required. The session in which the transaction to be committed is running.
1170
+ # @param [Google::Apis::SpannerV1::CommitRequest] commit_request_object
1171
+ # @param [String] fields
1172
+ # Selector specifying which fields to include in a partial response.
1173
+ # @param [String] quota_user
1174
+ # Available to use for quota purposes for server-side applications. Can be any
1175
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1176
+ # @param [Google::Apis::RequestOptions] options
1177
+ # Request-specific options
1178
+ #
1179
+ # @yield [result, err] Result & error if block supplied
1180
+ # @yieldparam result [Google::Apis::SpannerV1::CommitResponse] parsed result object
1181
+ # @yieldparam err [StandardError] error object if request failed
1182
+ #
1183
+ # @return [Google::Apis::SpannerV1::CommitResponse]
1184
+ #
1185
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1186
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1187
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1188
+ def commit_session(session, commit_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1189
+ command = make_simple_command(:post, 'v1/{+session}:commit', options)
1190
+ command.request_representation = Google::Apis::SpannerV1::CommitRequest::Representation
1191
+ command.request_object = commit_request_object
1192
+ command.response_representation = Google::Apis::SpannerV1::CommitResponse::Representation
1193
+ command.response_class = Google::Apis::SpannerV1::CommitResponse
1194
+ command.params['session'] = session unless session.nil?
1195
+ command.query['fields'] = fields unless fields.nil?
1196
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1197
+ execute_or_queue_command(command, &block)
1198
+ end
1199
+
1200
+ # Begins a new transaction. This step can often be skipped:
1201
+ # Read, ExecuteSql and
1202
+ # Commit can begin a new transaction as a
1203
+ # side-effect.
1204
+ # @param [String] session
1205
+ # Required. The session in which the transaction runs.
1206
+ # @param [Google::Apis::SpannerV1::BeginTransactionRequest] begin_transaction_request_object
1207
+ # @param [String] fields
1208
+ # Selector specifying which fields to include in a partial response.
1209
+ # @param [String] quota_user
1210
+ # Available to use for quota purposes for server-side applications. Can be any
1211
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1212
+ # @param [Google::Apis::RequestOptions] options
1213
+ # Request-specific options
1214
+ #
1215
+ # @yield [result, err] Result & error if block supplied
1216
+ # @yieldparam result [Google::Apis::SpannerV1::Transaction] parsed result object
1217
+ # @yieldparam err [StandardError] error object if request failed
1218
+ #
1219
+ # @return [Google::Apis::SpannerV1::Transaction]
1220
+ #
1221
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1222
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1223
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1224
+ def begin_session_transaction(session, begin_transaction_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1225
+ command = make_simple_command(:post, 'v1/{+session}:beginTransaction', options)
1226
+ command.request_representation = Google::Apis::SpannerV1::BeginTransactionRequest::Representation
1227
+ command.request_object = begin_transaction_request_object
1228
+ command.response_representation = Google::Apis::SpannerV1::Transaction::Representation
1229
+ command.response_class = Google::Apis::SpannerV1::Transaction
1230
+ command.params['session'] = session unless session.nil?
1231
+ command.query['fields'] = fields unless fields.nil?
1232
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1233
+ execute_or_queue_command(command, &block)
1234
+ end
1235
+
1236
+ # Executes an SQL query, returning all rows in a single reply. This
1237
+ # method cannot be used to return a result set larger than 10 MiB;
1238
+ # if the query yields more data than that, the query fails with
1239
+ # a `FAILED_PRECONDITION` error.
1240
+ # Queries inside read-write transactions might return `ABORTED`. If
1241
+ # this occurs, the application should restart the transaction from
1242
+ # the beginning. See Transaction for more details.
1243
+ # Larger result sets can be fetched in streaming fashion by calling
1244
+ # ExecuteStreamingSql instead.
1245
+ # @param [String] session
1246
+ # Required. The session in which the SQL query should be performed.
1247
+ # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
1248
+ # @param [String] fields
1249
+ # Selector specifying which fields to include in a partial response.
1250
+ # @param [String] quota_user
1251
+ # Available to use for quota purposes for server-side applications. Can be any
1252
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1253
+ # @param [Google::Apis::RequestOptions] options
1254
+ # Request-specific options
1255
+ #
1256
+ # @yield [result, err] Result & error if block supplied
1257
+ # @yieldparam result [Google::Apis::SpannerV1::ResultSet] parsed result object
1258
+ # @yieldparam err [StandardError] error object if request failed
1259
+ #
1260
+ # @return [Google::Apis::SpannerV1::ResultSet]
1261
+ #
1262
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1263
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1264
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1265
+ def execute_session_sql(session, execute_sql_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1266
+ command = make_simple_command(:post, 'v1/{+session}:executeSql', options)
1267
+ command.request_representation = Google::Apis::SpannerV1::ExecuteSqlRequest::Representation
1268
+ command.request_object = execute_sql_request_object
1269
+ command.response_representation = Google::Apis::SpannerV1::ResultSet::Representation
1270
+ command.response_class = Google::Apis::SpannerV1::ResultSet
1271
+ command.params['session'] = session unless session.nil?
1272
+ command.query['fields'] = fields unless fields.nil?
1273
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1274
+ execute_or_queue_command(command, &block)
1275
+ end
1276
+
1277
+ # Starts asynchronous cancellation on a long-running operation. The server
1278
+ # makes a best effort to cancel the operation, but success is not
1279
+ # guaranteed. If the server doesn't support this method, it returns
1280
+ # `google.rpc.Code.UNIMPLEMENTED`. Clients can use
1281
+ # Operations.GetOperation or
1282
+ # other methods to check whether the cancellation succeeded or whether the
1283
+ # operation completed despite cancellation. On successful cancellation,
1284
+ # the operation is not deleted; instead, it becomes an operation with
1285
+ # an Operation.error value with a google.rpc.Status.code of 1,
1286
+ # corresponding to `Code.CANCELLED`.
1287
+ # @param [String] name
1288
+ # The name of the operation resource to be cancelled.
1289
+ # @param [String] fields
1290
+ # Selector specifying which fields to include in a partial response.
1291
+ # @param [String] quota_user
1292
+ # Available to use for quota purposes for server-side applications. Can be any
1293
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1294
+ # @param [Google::Apis::RequestOptions] options
1295
+ # Request-specific options
1296
+ #
1297
+ # @yield [result, err] Result & error if block supplied
1298
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1299
+ # @yieldparam err [StandardError] error object if request failed
1300
+ #
1301
+ # @return [Google::Apis::SpannerV1::Empty]
1302
+ #
1303
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1304
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1305
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1306
+ def cancel_project_instance_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1307
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1308
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1309
+ command.response_class = Google::Apis::SpannerV1::Empty
1310
+ command.params['name'] = name unless name.nil?
1311
+ command.query['fields'] = fields unless fields.nil?
1312
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1313
+ execute_or_queue_command(command, &block)
1314
+ end
1315
+
1316
+ # Deletes a long-running operation. This method indicates that the client is
1317
+ # no longer interested in the operation result. It does not cancel the
1318
+ # operation. If the server doesn't support this method, it returns
1319
+ # `google.rpc.Code.UNIMPLEMENTED`.
1320
+ # @param [String] name
1321
+ # The name of the operation resource to be deleted.
1322
+ # @param [String] fields
1323
+ # Selector specifying which fields to include in a partial response.
1324
+ # @param [String] quota_user
1325
+ # Available to use for quota purposes for server-side applications. Can be any
1326
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1327
+ # @param [Google::Apis::RequestOptions] options
1328
+ # Request-specific options
1329
+ #
1330
+ # @yield [result, err] Result & error if block supplied
1331
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1332
+ # @yieldparam err [StandardError] error object if request failed
1333
+ #
1334
+ # @return [Google::Apis::SpannerV1::Empty]
1335
+ #
1336
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1337
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1338
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1339
+ def delete_project_instance_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1340
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1341
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1342
+ command.response_class = Google::Apis::SpannerV1::Empty
1343
+ command.params['name'] = name unless name.nil?
1344
+ command.query['fields'] = fields unless fields.nil?
1345
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1346
+ execute_or_queue_command(command, &block)
1347
+ end
1348
+
1349
+ # Lists operations that match the specified filter in the request. If the
1350
+ # server doesn't support this method, it returns `UNIMPLEMENTED`.
1351
+ # NOTE: the `name` binding below allows API services to override the binding
1352
+ # to use different resource name schemes, such as `users/*/operations`.
1353
+ # @param [String] name
1354
+ # The name of the operation collection.
1355
+ # @param [String] page_token
1356
+ # The standard list page token.
1357
+ # @param [Fixnum] page_size
1358
+ # The standard list page size.
1359
+ # @param [String] filter
1360
+ # The standard list filter.
1361
+ # @param [String] fields
1362
+ # Selector specifying which fields to include in a partial response.
1363
+ # @param [String] quota_user
1364
+ # Available to use for quota purposes for server-side applications. Can be any
1365
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1366
+ # @param [Google::Apis::RequestOptions] options
1367
+ # Request-specific options
1368
+ #
1369
+ # @yield [result, err] Result & error if block supplied
1370
+ # @yieldparam result [Google::Apis::SpannerV1::ListOperationsResponse] parsed result object
1371
+ # @yieldparam err [StandardError] error object if request failed
1372
+ #
1373
+ # @return [Google::Apis::SpannerV1::ListOperationsResponse]
1374
+ #
1375
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1376
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1377
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1378
+ def list_project_instance_operations(name, page_token: nil, page_size: nil, filter: nil, fields: nil, quota_user: nil, options: nil, &block)
1379
+ command = make_simple_command(:get, 'v1/{+name}', options)
1380
+ command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
1381
+ command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
1382
+ command.params['name'] = name unless name.nil?
1383
+ command.query['pageToken'] = page_token unless page_token.nil?
1384
+ command.query['pageSize'] = page_size unless page_size.nil?
1385
+ command.query['filter'] = filter unless filter.nil?
1386
+ command.query['fields'] = fields unless fields.nil?
1387
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1388
+ execute_or_queue_command(command, &block)
1389
+ end
1390
+
1391
+ # Gets the latest state of a long-running operation. Clients can use this
1392
+ # method to poll the operation result at intervals as recommended by the API
1393
+ # service.
1394
+ # @param [String] name
1395
+ # The name of the operation resource.
1396
+ # @param [String] fields
1397
+ # Selector specifying which fields to include in a partial response.
1398
+ # @param [String] quota_user
1399
+ # Available to use for quota purposes for server-side applications. Can be any
1400
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1401
+ # @param [Google::Apis::RequestOptions] options
1402
+ # Request-specific options
1403
+ #
1404
+ # @yield [result, err] Result & error if block supplied
1405
+ # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
1406
+ # @yieldparam err [StandardError] error object if request failed
1407
+ #
1408
+ # @return [Google::Apis::SpannerV1::Operation]
1409
+ #
1410
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1411
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1412
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1413
+ def get_project_instance_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1414
+ command = make_simple_command(:get, 'v1/{+name}', options)
1415
+ command.response_representation = Google::Apis::SpannerV1::Operation::Representation
1416
+ command.response_class = Google::Apis::SpannerV1::Operation
1417
+ command.params['name'] = name unless name.nil?
1418
+ command.query['fields'] = fields unless fields.nil?
1419
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1420
+ execute_or_queue_command(command, &block)
1421
+ end
1422
+
1423
+ # Lists the supported instance configurations for a given project.
1424
+ # @param [String] parent
1425
+ # Required. The name of the project for which a list of supported instance
1426
+ # configurations is requested. Values are of the form
1427
+ # `projects/<project>`.
1428
+ # @param [String] page_token
1429
+ # If non-empty, `page_token` should contain a
1430
+ # next_page_token
1431
+ # from a previous ListInstanceConfigsResponse.
1432
+ # @param [Fixnum] page_size
1433
+ # Number of instance configurations to be returned in the response. If 0 or
1434
+ # less, defaults to the server's maximum allowed page size.
1435
+ # @param [String] fields
1436
+ # Selector specifying which fields to include in a partial response.
1437
+ # @param [String] quota_user
1438
+ # Available to use for quota purposes for server-side applications. Can be any
1439
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1440
+ # @param [Google::Apis::RequestOptions] options
1441
+ # Request-specific options
1442
+ #
1443
+ # @yield [result, err] Result & error if block supplied
1444
+ # @yieldparam result [Google::Apis::SpannerV1::ListInstanceConfigsResponse] parsed result object
1445
+ # @yieldparam err [StandardError] error object if request failed
1446
+ #
1447
+ # @return [Google::Apis::SpannerV1::ListInstanceConfigsResponse]
1448
+ #
1449
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1450
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1451
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1452
+ def list_project_instance_configs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
1453
+ command = make_simple_command(:get, 'v1/{+parent}/instanceConfigs', options)
1454
+ command.response_representation = Google::Apis::SpannerV1::ListInstanceConfigsResponse::Representation
1455
+ command.response_class = Google::Apis::SpannerV1::ListInstanceConfigsResponse
1456
+ command.params['parent'] = parent unless parent.nil?
1457
+ command.query['pageToken'] = page_token unless page_token.nil?
1458
+ command.query['pageSize'] = page_size unless page_size.nil?
1459
+ command.query['fields'] = fields unless fields.nil?
1460
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1461
+ execute_or_queue_command(command, &block)
1462
+ end
1463
+
1464
+ # Gets information about a particular instance configuration.
1465
+ # @param [String] name
1466
+ # Required. The name of the requested instance configuration. Values are of
1467
+ # the form `projects/<project>/instanceConfigs/<config>`.
1468
+ # @param [String] fields
1469
+ # Selector specifying which fields to include in a partial response.
1470
+ # @param [String] quota_user
1471
+ # Available to use for quota purposes for server-side applications. Can be any
1472
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1473
+ # @param [Google::Apis::RequestOptions] options
1474
+ # Request-specific options
1475
+ #
1476
+ # @yield [result, err] Result & error if block supplied
1477
+ # @yieldparam result [Google::Apis::SpannerV1::InstanceConfig] parsed result object
1478
+ # @yieldparam err [StandardError] error object if request failed
1479
+ #
1480
+ # @return [Google::Apis::SpannerV1::InstanceConfig]
1481
+ #
1482
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1483
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1484
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1485
+ def get_project_instance_config(name, fields: nil, quota_user: nil, options: nil, &block)
1486
+ command = make_simple_command(:get, 'v1/{+name}', options)
1487
+ command.response_representation = Google::Apis::SpannerV1::InstanceConfig::Representation
1488
+ command.response_class = Google::Apis::SpannerV1::InstanceConfig
1489
+ command.params['name'] = name unless name.nil?
1490
+ command.query['fields'] = fields unless fields.nil?
1491
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1492
+ execute_or_queue_command(command, &block)
1493
+ end
1494
+
1495
+ protected
1496
+
1497
+ def apply_command_defaults(command)
1498
+ command.query['key'] = key unless key.nil?
1499
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1500
+ end
1501
+ end
1502
+ end
1503
+ end
1504
+ end