google-api-client 0.11.2 → 0.11.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 (246) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +6 -1
  3. data/README.md +6 -0
  4. data/api_names.yaml +1 -0
  5. data/generated/google/apis/acceleratedmobilepageurl_v1/classes.rb +38 -38
  6. data/generated/google/apis/acceleratedmobilepageurl_v1/representations.rb +13 -13
  7. data/generated/google/apis/acceleratedmobilepageurl_v1/service.rb +10 -10
  8. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  9. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +201 -201
  10. data/generated/google/apis/adexchangebuyer2_v2beta1/representations.rb +46 -46
  11. data/generated/google/apis/adexchangebuyer2_v2beta1/service.rb +119 -119
  12. data/generated/google/apis/adexchangebuyer_v1_4.rb +1 -1
  13. data/generated/google/apis/adexchangebuyer_v1_4/classes.rb +52 -9
  14. data/generated/google/apis/adexchangebuyer_v1_4/representations.rb +9 -0
  15. data/generated/google/apis/adsense_v1_4.rb +1 -1
  16. data/generated/google/apis/adsensehost_v4_1.rb +1 -1
  17. data/generated/google/apis/analyticsreporting_v4/classes.rb +926 -926
  18. data/generated/google/apis/analyticsreporting_v4/representations.rb +149 -149
  19. data/generated/google/apis/androidenterprise_v1.rb +1 -1
  20. data/generated/google/apis/androidenterprise_v1/classes.rb +18 -11
  21. data/generated/google/apis/androidenterprise_v1/representations.rb +1 -0
  22. data/generated/google/apis/androidpublisher_v2.rb +1 -1
  23. data/generated/google/apis/appengine_v1.rb +1 -1
  24. data/generated/google/apis/appengine_v1/classes.rb +1487 -1487
  25. data/generated/google/apis/appengine_v1/representations.rb +229 -229
  26. data/generated/google/apis/appengine_v1/service.rb +188 -188
  27. data/generated/google/apis/appstate_v1.rb +1 -1
  28. data/generated/google/apis/bigquery_v2.rb +1 -1
  29. data/generated/google/apis/bigquery_v2/classes.rb +15 -10
  30. data/generated/google/apis/calendar_v3.rb +1 -1
  31. data/generated/google/apis/calendar_v3/service.rb +10 -4
  32. data/generated/google/apis/classroom_v1.rb +26 -17
  33. data/generated/google/apis/classroom_v1/classes.rb +990 -990
  34. data/generated/google/apis/classroom_v1/representations.rb +239 -239
  35. data/generated/google/apis/classroom_v1/service.rb +853 -853
  36. data/generated/google/apis/cloudbilling_v1.rb +1 -1
  37. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  38. data/generated/google/apis/cloudbuild_v1/classes.rb +627 -627
  39. data/generated/google/apis/cloudbuild_v1/representations.rb +116 -116
  40. data/generated/google/apis/cloudbuild_v1/service.rb +162 -157
  41. data/generated/google/apis/clouddebugger_v2/classes.rb +258 -258
  42. data/generated/google/apis/clouddebugger_v2/representations.rb +80 -80
  43. data/generated/google/apis/clouddebugger_v2/service.rb +163 -163
  44. data/generated/google/apis/clouderrorreporting_v1beta1.rb +3 -4
  45. data/generated/google/apis/clouderrorreporting_v1beta1/classes.rb +202 -167
  46. data/generated/google/apis/clouderrorreporting_v1beta1/representations.rb +53 -37
  47. data/generated/google/apis/clouderrorreporting_v1beta1/service.rb +50 -51
  48. data/generated/google/apis/cloudfunctions_v1.rb +1 -1
  49. data/generated/google/apis/cloudkms_v1.rb +1 -1
  50. data/generated/google/apis/cloudkms_v1/classes.rb +628 -622
  51. data/generated/google/apis/cloudkms_v1/representations.rb +134 -133
  52. data/generated/google/apis/cloudkms_v1/service.rb +190 -190
  53. data/generated/google/apis/cloudresourcemanager_v1.rb +1 -1
  54. data/generated/google/apis/cloudresourcemanager_v1/classes.rb +835 -835
  55. data/generated/google/apis/cloudresourcemanager_v1/representations.rb +138 -138
  56. data/generated/google/apis/cloudresourcemanager_v1/service.rb +474 -474
  57. data/generated/google/apis/cloudresourcemanager_v1beta1.rb +1 -1
  58. data/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +386 -386
  59. data/generated/google/apis/cloudresourcemanager_v1beta1/representations.rb +75 -75
  60. data/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +64 -64
  61. data/generated/google/apis/cloudtrace_v1.rb +4 -4
  62. data/generated/google/apis/cloudtrace_v1/classes.rb +114 -114
  63. data/generated/google/apis/cloudtrace_v1/representations.rb +23 -23
  64. data/generated/google/apis/cloudtrace_v1/service.rb +14 -14
  65. data/generated/google/apis/compute_beta.rb +1 -1
  66. data/generated/google/apis/compute_beta/classes.rb +66 -25
  67. data/generated/google/apis/compute_beta/representations.rb +16 -0
  68. data/generated/google/apis/compute_beta/service.rb +85 -3
  69. data/generated/google/apis/compute_v1.rb +1 -1
  70. data/generated/google/apis/compute_v1/classes.rb +375 -24
  71. data/generated/google/apis/compute_v1/representations.rb +155 -0
  72. data/generated/google/apis/compute_v1/service.rb +481 -3
  73. data/generated/google/apis/container_v1.rb +1 -1
  74. data/generated/google/apis/container_v1/classes.rb +301 -301
  75. data/generated/google/apis/container_v1/representations.rb +59 -59
  76. data/generated/google/apis/container_v1/service.rb +178 -178
  77. data/generated/google/apis/content_v2.rb +1 -1
  78. data/generated/google/apis/content_v2/classes.rb +37 -2
  79. data/generated/google/apis/content_v2/representations.rb +15 -0
  80. data/generated/google/apis/content_v2/service.rb +58 -3
  81. data/generated/google/apis/dataflow_v1b3.rb +4 -1
  82. data/generated/google/apis/dataflow_v1b3/classes.rb +3514 -3279
  83. data/generated/google/apis/dataflow_v1b3/representations.rb +530 -440
  84. data/generated/google/apis/dataflow_v1b3/service.rb +378 -137
  85. data/generated/google/apis/dataproc_v1.rb +1 -1
  86. data/generated/google/apis/dataproc_v1/classes.rb +446 -446
  87. data/generated/google/apis/dataproc_v1/representations.rb +96 -96
  88. data/generated/google/apis/dataproc_v1/service.rb +302 -302
  89. data/generated/google/apis/datastore_v1.rb +1 -1
  90. data/generated/google/apis/datastore_v1/classes.rb +370 -374
  91. data/generated/google/apis/datastore_v1/representations.rb +120 -120
  92. data/generated/google/apis/datastore_v1/service.rb +62 -62
  93. data/generated/google/apis/dns_v1.rb +1 -1
  94. data/generated/google/apis/dns_v2beta1.rb +1 -1
  95. data/generated/google/apis/doubleclickbidmanager_v1.rb +3 -0
  96. data/generated/google/apis/doubleclicksearch_v2.rb +1 -1
  97. data/generated/google/apis/drive_v2.rb +1 -1
  98. data/generated/google/apis/drive_v2/classes.rb +24 -21
  99. data/generated/google/apis/drive_v3.rb +1 -1
  100. data/generated/google/apis/drive_v3/classes.rb +24 -22
  101. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  102. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +148 -149
  103. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +42 -42
  104. data/generated/google/apis/firebaserules_v1/classes.rb +71 -71
  105. data/generated/google/apis/firebaserules_v1/representations.rb +22 -22
  106. data/generated/google/apis/firebaserules_v1/service.rb +68 -68
  107. data/generated/google/apis/games_configuration_v1configuration.rb +1 -1
  108. data/generated/google/apis/games_management_v1management.rb +1 -1
  109. data/generated/google/apis/games_v1.rb +1 -1
  110. data/generated/google/apis/genomics_v1.rb +1 -1
  111. data/generated/google/apis/genomics_v1/classes.rb +2348 -2348
  112. data/generated/google/apis/genomics_v1/representations.rb +430 -430
  113. data/generated/google/apis/genomics_v1/service.rb +1159 -1159
  114. data/generated/google/apis/gmail_v1.rb +1 -1
  115. data/generated/google/apis/gmail_v1/service.rb +2 -2
  116. data/generated/google/apis/iam_v1.rb +1 -1
  117. data/generated/google/apis/iam_v1/classes.rb +305 -298
  118. data/generated/google/apis/iam_v1/representations.rb +97 -96
  119. data/generated/google/apis/iam_v1/service.rb +86 -86
  120. data/generated/google/apis/kgsearch_v1/classes.rb +6 -6
  121. data/generated/google/apis/kgsearch_v1/representations.rb +1 -1
  122. data/generated/google/apis/kgsearch_v1/service.rb +10 -10
  123. data/generated/google/apis/language_v1.rb +4 -4
  124. data/generated/google/apis/language_v1/classes.rb +452 -452
  125. data/generated/google/apis/language_v1/representations.rb +93 -93
  126. data/generated/google/apis/language_v1/service.rb +48 -48
  127. data/generated/google/apis/language_v1beta1.rb +4 -4
  128. data/generated/google/apis/language_v1beta1/classes.rb +84 -84
  129. data/generated/google/apis/language_v1beta1/representations.rb +22 -22
  130. data/generated/google/apis/language_v1beta1/service.rb +3 -3
  131. data/generated/google/apis/logging_v2.rb +1 -1
  132. data/generated/google/apis/logging_v2/classes.rb +884 -873
  133. data/generated/google/apis/logging_v2/representations.rb +167 -166
  134. data/generated/google/apis/logging_v2/service.rb +430 -430
  135. data/generated/google/apis/logging_v2beta1.rb +1 -1
  136. data/generated/google/apis/logging_v2beta1/classes.rb +550 -539
  137. data/generated/google/apis/logging_v2beta1/representations.rb +124 -123
  138. data/generated/google/apis/logging_v2beta1/service.rb +292 -292
  139. data/generated/google/apis/manufacturers_v1/classes.rb +322 -322
  140. data/generated/google/apis/manufacturers_v1/representations.rb +66 -66
  141. data/generated/google/apis/ml_v1.rb +1 -1
  142. data/generated/google/apis/ml_v1/classes.rb +501 -494
  143. data/generated/google/apis/ml_v1/representations.rb +92 -91
  144. data/generated/google/apis/ml_v1/service.rb +190 -190
  145. data/generated/google/apis/monitoring_v3.rb +1 -1
  146. data/generated/google/apis/monitoring_v3/classes.rb +878 -878
  147. data/generated/google/apis/monitoring_v3/representations.rb +176 -176
  148. data/generated/google/apis/monitoring_v3/service.rb +223 -262
  149. data/generated/google/apis/oauth2_v2.rb +1 -1
  150. data/generated/google/apis/partners_v2.rb +1 -1
  151. data/generated/google/apis/partners_v2/classes.rb +1506 -1506
  152. data/generated/google/apis/partners_v2/representations.rb +370 -370
  153. data/generated/google/apis/partners_v2/service.rb +393 -393
  154. data/generated/google/apis/people_v1.rb +13 -13
  155. data/generated/google/apis/people_v1/classes.rb +597 -594
  156. data/generated/google/apis/people_v1/representations.rb +121 -121
  157. data/generated/google/apis/people_v1/service.rb +39 -48
  158. data/generated/google/apis/plus_domains_v1.rb +1 -1
  159. data/generated/google/apis/plus_v1.rb +1 -1
  160. data/generated/google/apis/proximitybeacon_v1beta1.rb +1 -1
  161. data/generated/google/apis/proximitybeacon_v1beta1/classes.rb +323 -327
  162. data/generated/google/apis/proximitybeacon_v1beta1/representations.rb +100 -100
  163. data/generated/google/apis/proximitybeacon_v1beta1/service.rb +184 -184
  164. data/generated/google/apis/pubsub_v1.rb +1 -1
  165. data/generated/google/apis/pubsub_v1/classes.rb +178 -178
  166. data/generated/google/apis/pubsub_v1/representations.rb +55 -55
  167. data/generated/google/apis/pubsub_v1/service.rb +357 -357
  168. data/generated/google/apis/runtimeconfig_v1.rb +1 -1
  169. data/generated/google/apis/runtimeconfig_v1/classes.rb +20 -20
  170. data/generated/google/apis/runtimeconfig_v1/representations.rb +2 -2
  171. data/generated/google/apis/runtimeconfig_v1/service.rb +12 -7
  172. data/generated/google/apis/script_v1.rb +16 -16
  173. data/generated/google/apis/script_v1/classes.rb +113 -113
  174. data/generated/google/apis/script_v1/representations.rb +28 -28
  175. data/generated/google/apis/script_v1/service.rb +4 -4
  176. data/generated/google/apis/searchconsole_v1.rb +1 -1
  177. data/generated/google/apis/searchconsole_v1/classes.rb +84 -84
  178. data/generated/google/apis/searchconsole_v1/representations.rb +32 -32
  179. data/generated/google/apis/searchconsole_v1/service.rb +6 -6
  180. data/generated/google/apis/servicecontrol_v1.rb +4 -4
  181. data/generated/google/apis/servicecontrol_v1/classes.rb +1146 -1145
  182. data/generated/google/apis/servicecontrol_v1/representations.rb +203 -203
  183. data/generated/google/apis/servicecontrol_v1/service.rb +57 -57
  184. data/generated/google/apis/servicemanagement_v1.rb +4 -4
  185. data/generated/google/apis/servicemanagement_v1/classes.rb +3486 -3360
  186. data/generated/google/apis/servicemanagement_v1/representations.rb +342 -329
  187. data/generated/google/apis/servicemanagement_v1/service.rb +260 -250
  188. data/generated/google/apis/serviceuser_v1.rb +1 -1
  189. data/generated/google/apis/serviceuser_v1/classes.rb +2716 -2596
  190. data/generated/google/apis/serviceuser_v1/representations.rb +391 -379
  191. data/generated/google/apis/serviceuser_v1/service.rb +16 -16
  192. data/generated/google/apis/sheets_v4.rb +1 -1
  193. data/generated/google/apis/sheets_v4/classes.rb +4255 -4252
  194. data/generated/google/apis/sheets_v4/representations.rb +548 -548
  195. data/generated/google/apis/sheets_v4/service.rb +170 -170
  196. data/generated/google/apis/slides_v1.rb +4 -4
  197. data/generated/google/apis/slides_v1/classes.rb +2945 -2916
  198. data/generated/google/apis/slides_v1/representations.rb +700 -697
  199. data/generated/google/apis/slides_v1/service.rb +44 -44
  200. data/generated/google/apis/sourcerepo_v1.rb +2 -2
  201. data/generated/google/apis/sourcerepo_v1/classes.rb +419 -410
  202. data/generated/google/apis/sourcerepo_v1/representations.rb +88 -87
  203. data/generated/google/apis/sourcerepo_v1/service.rb +67 -58
  204. data/generated/google/apis/spanner_v1/classes.rb +2187 -2187
  205. data/generated/google/apis/spanner_v1/representations.rb +323 -323
  206. data/generated/google/apis/spanner_v1/service.rb +383 -383
  207. data/generated/google/apis/speech_v1beta1.rb +1 -1
  208. data/generated/google/apis/speech_v1beta1/classes.rb +226 -226
  209. data/generated/google/apis/speech_v1beta1/representations.rb +44 -44
  210. data/generated/google/apis/speech_v1beta1/service.rb +37 -32
  211. data/generated/google/apis/sqladmin_v1beta4.rb +1 -1
  212. data/generated/google/apis/sqladmin_v1beta4/classes.rb +10 -28
  213. data/generated/google/apis/sqladmin_v1beta4/representations.rb +2 -16
  214. data/generated/google/apis/sqladmin_v1beta4/service.rb +1 -1
  215. data/generated/google/apis/storage_v1.rb +1 -1
  216. data/generated/google/apis/storage_v1/classes.rb +26 -0
  217. data/generated/google/apis/storage_v1/representations.rb +15 -0
  218. data/generated/google/apis/storage_v1/service.rb +168 -42
  219. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  220. data/generated/google/apis/storagetransfer_v1/classes.rb +218 -218
  221. data/generated/google/apis/storagetransfer_v1/representations.rb +47 -47
  222. data/generated/google/apis/storagetransfer_v1/service.rb +68 -68
  223. data/generated/google/apis/toolresults_v1beta3.rb +1 -1
  224. data/generated/google/apis/toolresults_v1beta3/classes.rb +7 -4
  225. data/generated/google/apis/toolresults_v1beta3/service.rb +9 -8
  226. data/generated/google/apis/translate_v2.rb +11 -4
  227. data/generated/google/apis/translate_v2/classes.rb +140 -37
  228. data/generated/google/apis/translate_v2/representations.rb +62 -15
  229. data/generated/google/apis/translate_v2/service.rb +119 -66
  230. data/generated/google/apis/vision_v1.rb +1 -1
  231. data/generated/google/apis/vision_v1/classes.rb +1265 -1273
  232. data/generated/google/apis/vision_v1/representations.rb +202 -202
  233. data/generated/google/apis/vision_v1/service.rb +4 -4
  234. data/generated/google/apis/webmasters_v3.rb +1 -1
  235. data/generated/google/apis/youtube_analytics_v1.rb +1 -1
  236. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  237. data/generated/google/apis/youtube_partner_v1/classes.rb +2 -1
  238. data/generated/google/apis/youtubereporting_v1.rb +1 -1
  239. data/generated/google/apis/youtubereporting_v1/classes.rb +91 -91
  240. data/generated/google/apis/youtubereporting_v1/representations.rb +25 -25
  241. data/generated/google/apis/youtubereporting_v1/service.rb +94 -94
  242. data/lib/google/apis/core/api_command.rb +43 -10
  243. data/lib/google/apis/core/json_representation.rb +1 -1
  244. data/lib/google/apis/options.rb +6 -2
  245. data/lib/google/apis/version.rb +1 -1
  246. metadata +3 -3
@@ -48,10 +48,18 @@ module Google
48
48
  @batch_path = 'batch'
49
49
  end
50
50
 
51
- # Gets information about a particular instance.
52
- # @param [String] name
53
- # Required. The name of the requested instance. Values are of the form
54
- # `projects/<project>/instances/<instance>`.
51
+ # Lists the supported instance configurations for a given project.
52
+ # @param [String] parent
53
+ # Required. The name of the project for which a list of supported instance
54
+ # configurations is requested. Values are of the form
55
+ # `projects/<project>`.
56
+ # @param [Fixnum] page_size
57
+ # Number of instance configurations to be returned in the response. If 0 or
58
+ # less, defaults to the server's maximum allowed page size.
59
+ # @param [String] page_token
60
+ # If non-empty, `page_token` should contain a
61
+ # next_page_token
62
+ # from a previous ListInstanceConfigsResponse.
55
63
  # @param [String] quota_user
56
64
  # Available to use for quota purposes for server-side applications. Can be any
57
65
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -61,62 +69,30 @@ module Google
61
69
  # Request-specific options
62
70
  #
63
71
  # @yield [result, err] Result & error if block supplied
64
- # @yieldparam result [Google::Apis::SpannerV1::Instance] parsed result object
72
+ # @yieldparam result [Google::Apis::SpannerV1::ListInstanceConfigsResponse] parsed result object
65
73
  # @yieldparam err [StandardError] error object if request failed
66
74
  #
67
- # @return [Google::Apis::SpannerV1::Instance]
75
+ # @return [Google::Apis::SpannerV1::ListInstanceConfigsResponse]
68
76
  #
69
77
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
70
78
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
71
79
  # @raise [Google::Apis::AuthorizationError] Authorization is required
72
- def get_project_instance(name, quota_user: nil, fields: nil, options: nil, &block)
73
- command = make_simple_command(:get, 'v1/{+name}', options)
74
- command.response_representation = Google::Apis::SpannerV1::Instance::Representation
75
- command.response_class = Google::Apis::SpannerV1::Instance
76
- command.params['name'] = name unless name.nil?
80
+ def list_project_instance_configs(parent, page_size: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
81
+ command = make_simple_command(:get, 'v1/{+parent}/instanceConfigs', options)
82
+ command.response_representation = Google::Apis::SpannerV1::ListInstanceConfigsResponse::Representation
83
+ command.response_class = Google::Apis::SpannerV1::ListInstanceConfigsResponse
84
+ command.params['parent'] = parent unless parent.nil?
85
+ command.query['pageSize'] = page_size unless page_size.nil?
86
+ command.query['pageToken'] = page_token unless page_token.nil?
77
87
  command.query['quotaUser'] = quota_user unless quota_user.nil?
78
88
  command.query['fields'] = fields unless fields.nil?
79
89
  execute_or_queue_command(command, &block)
80
90
  end
81
91
 
82
- # Updates an instance, and begins allocating or releasing resources
83
- # as requested. The returned long-running
84
- # operation can be used to track the
85
- # progress of updating the instance. If the named instance does not
86
- # exist, returns `NOT_FOUND`.
87
- # Immediately upon completion of this request:
88
- # * For resource types for which a decrease in the instance's allocation
89
- # has been requested, billing is based on the newly-requested level.
90
- # Until completion of the returned operation:
91
- # * Cancelling the operation sets its metadata's
92
- # cancel_time, and begins
93
- # restoring resources to their pre-request values. The operation
94
- # is guaranteed to succeed at undoing all resource changes,
95
- # after which point it terminates with a `CANCELLED` status.
96
- # * All other attempts to modify the instance are rejected.
97
- # * Reading the instance via the API continues to give the pre-request
98
- # resource levels.
99
- # Upon completion of the returned operation:
100
- # * Billing begins for all successfully-allocated resources (some types
101
- # may have lower than the requested levels).
102
- # * All newly-reserved resources are available for serving the instance's
103
- # tables.
104
- # * The instance's new resource levels are readable via the API.
105
- # The returned long-running operation will
106
- # have a name of the format `<instance_name>/operations/<operation_id>` and
107
- # can be used to track the instance modification. The
108
- # metadata field type is
109
- # UpdateInstanceMetadata.
110
- # The response field type is
111
- # Instance, if successful.
112
- # Authorization requires `spanner.instances.update` permission on
113
- # resource name.
92
+ # Gets information about a particular instance configuration.
114
93
  # @param [String] name
115
- # Required. A unique identifier for the instance, which cannot be changed
116
- # after the instance is created. Values are of the form
117
- # `projects/<project>/instances/a-z*[a-z0-9]`. The final
118
- # segment of the name must be between 6 and 30 characters in length.
119
- # @param [Google::Apis::SpannerV1::UpdateInstanceRequest] update_instance_request_object
94
+ # Required. The name of the requested instance configuration. Values are of
95
+ # the form `projects/<project>/instanceConfigs/<config>`.
120
96
  # @param [String] quota_user
121
97
  # Available to use for quota purposes for server-side applications. Can be any
122
98
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -126,66 +102,24 @@ module Google
126
102
  # Request-specific options
127
103
  #
128
104
  # @yield [result, err] Result & error if block supplied
129
- # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
105
+ # @yieldparam result [Google::Apis::SpannerV1::InstanceConfig] parsed result object
130
106
  # @yieldparam err [StandardError] error object if request failed
131
107
  #
132
- # @return [Google::Apis::SpannerV1::Operation]
108
+ # @return [Google::Apis::SpannerV1::InstanceConfig]
133
109
  #
134
110
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
135
111
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
136
112
  # @raise [Google::Apis::AuthorizationError] Authorization is required
137
- def patch_project_instance(name, update_instance_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
138
- command = make_simple_command(:patch, 'v1/{+name}', options)
139
- command.request_representation = Google::Apis::SpannerV1::UpdateInstanceRequest::Representation
140
- command.request_object = update_instance_request_object
141
- command.response_representation = Google::Apis::SpannerV1::Operation::Representation
142
- command.response_class = Google::Apis::SpannerV1::Operation
113
+ def get_project_instance_config(name, quota_user: nil, fields: nil, options: nil, &block)
114
+ command = make_simple_command(:get, 'v1/{+name}', options)
115
+ command.response_representation = Google::Apis::SpannerV1::InstanceConfig::Representation
116
+ command.response_class = Google::Apis::SpannerV1::InstanceConfig
143
117
  command.params['name'] = name unless name.nil?
144
118
  command.query['quotaUser'] = quota_user unless quota_user.nil?
145
119
  command.query['fields'] = fields unless fields.nil?
146
120
  execute_or_queue_command(command, &block)
147
121
  end
148
122
 
149
- # Returns permissions that the caller has on the specified instance resource.
150
- # Attempting this RPC on a non-existent Cloud Spanner instance resource will
151
- # result in a NOT_FOUND error if the user has `spanner.instances.list`
152
- # permission on the containing Google Cloud Project. Otherwise returns an
153
- # empty set of permissions.
154
- # @param [String] resource
155
- # REQUIRED: The Cloud Spanner resource for which permissions are being tested.
156
- # The format is `projects/<project ID>/instances/<instance ID>` for instance
157
- # resources and `projects/<project ID>/instances/<instance ID>/databases/<
158
- # database ID>` for database resources.
159
- # @param [Google::Apis::SpannerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
160
- # @param [String] quota_user
161
- # Available to use for quota purposes for server-side applications. Can be any
162
- # arbitrary string assigned to a user, but should not exceed 40 characters.
163
- # @param [String] fields
164
- # Selector specifying which fields to include in a partial response.
165
- # @param [Google::Apis::RequestOptions] options
166
- # Request-specific options
167
- #
168
- # @yield [result, err] Result & error if block supplied
169
- # @yieldparam result [Google::Apis::SpannerV1::TestIamPermissionsResponse] parsed result object
170
- # @yieldparam err [StandardError] error object if request failed
171
- #
172
- # @return [Google::Apis::SpannerV1::TestIamPermissionsResponse]
173
- #
174
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
175
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
176
- # @raise [Google::Apis::AuthorizationError] Authorization is required
177
- def test_instance_iam_permissions(resource, test_iam_permissions_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
178
- command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
179
- command.request_representation = Google::Apis::SpannerV1::TestIamPermissionsRequest::Representation
180
- command.request_object = test_iam_permissions_request_object
181
- command.response_representation = Google::Apis::SpannerV1::TestIamPermissionsResponse::Representation
182
- command.response_class = Google::Apis::SpannerV1::TestIamPermissionsResponse
183
- command.params['resource'] = resource unless resource.nil?
184
- command.query['quotaUser'] = quota_user unless quota_user.nil?
185
- command.query['fields'] = fields unless fields.nil?
186
- execute_or_queue_command(command, &block)
187
- end
188
-
189
123
  # Deletes an instance.
190
124
  # Immediately upon completion of the request:
191
125
  # * Billing ceases for all of the instance's reserved resources.
@@ -227,6 +161,10 @@ module Google
227
161
  # @param [String] parent
228
162
  # Required. The name of the project for which a list of instances is
229
163
  # requested. Values are of the form `projects/<project>`.
164
+ # @param [String] page_token
165
+ # If non-empty, `page_token` should contain a
166
+ # next_page_token from a
167
+ # previous ListInstancesResponse.
230
168
  # @param [Fixnum] page_size
231
169
  # Number of instances to be returned in the response. If 0 or less, defaults
232
170
  # to the server's maximum allowed page size.
@@ -247,10 +185,6 @@ module Google
247
185
  # * name:howl labels.env:dev --> The instance's name contains "howl" and
248
186
  # it has the label "env" with its value
249
187
  # containing "dev".
250
- # @param [String] page_token
251
- # If non-empty, `page_token` should contain a
252
- # next_page_token from a
253
- # previous ListInstancesResponse.
254
188
  # @param [String] quota_user
255
189
  # Available to use for quota purposes for server-side applications. Can be any
256
190
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -268,14 +202,14 @@ module Google
268
202
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
269
203
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
270
204
  # @raise [Google::Apis::AuthorizationError] Authorization is required
271
- def list_project_instances(parent, page_size: nil, filter: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
205
+ def list_project_instances(parent, page_token: nil, page_size: nil, filter: nil, quota_user: nil, fields: nil, options: nil, &block)
272
206
  command = make_simple_command(:get, 'v1/{+parent}/instances', options)
273
207
  command.response_representation = Google::Apis::SpannerV1::ListInstancesResponse::Representation
274
208
  command.response_class = Google::Apis::SpannerV1::ListInstancesResponse
275
209
  command.params['parent'] = parent unless parent.nil?
210
+ command.query['pageToken'] = page_token unless page_token.nil?
276
211
  command.query['pageSize'] = page_size unless page_size.nil?
277
212
  command.query['filter'] = filter unless filter.nil?
278
- command.query['pageToken'] = page_token unless page_token.nil?
279
213
  command.query['quotaUser'] = quota_user unless quota_user.nil?
280
214
  command.query['fields'] = fields unless fields.nil?
281
215
  execute_or_queue_command(command, &block)
@@ -419,17 +353,10 @@ module Google
419
353
  execute_or_queue_command(command, &block)
420
354
  end
421
355
 
422
- # Lists Cloud Spanner databases.
423
- # @param [String] parent
424
- # Required. The instance whose databases should be listed.
425
- # Values are of the form `projects/<project>/instances/<instance>`.
426
- # @param [Fixnum] page_size
427
- # Number of databases to be returned in the response. If 0 or less,
428
- # defaults to the server's maximum allowed page size.
429
- # @param [String] page_token
430
- # If non-empty, `page_token` should contain a
431
- # next_page_token from a
432
- # previous ListDatabasesResponse.
356
+ # Gets information about a particular instance.
357
+ # @param [String] name
358
+ # Required. The name of the requested instance. Values are of the form
359
+ # `projects/<project>/instances/<instance>`.
433
360
  # @param [String] quota_user
434
361
  # Available to use for quota purposes for server-side applications. Can be any
435
362
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -439,38 +366,62 @@ module Google
439
366
  # Request-specific options
440
367
  #
441
368
  # @yield [result, err] Result & error if block supplied
442
- # @yieldparam result [Google::Apis::SpannerV1::ListDatabasesResponse] parsed result object
369
+ # @yieldparam result [Google::Apis::SpannerV1::Instance] parsed result object
443
370
  # @yieldparam err [StandardError] error object if request failed
444
371
  #
445
- # @return [Google::Apis::SpannerV1::ListDatabasesResponse]
372
+ # @return [Google::Apis::SpannerV1::Instance]
446
373
  #
447
374
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
448
375
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
449
376
  # @raise [Google::Apis::AuthorizationError] Authorization is required
450
- def list_project_instance_databases(parent, page_size: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
451
- command = make_simple_command(:get, 'v1/{+parent}/databases', options)
452
- command.response_representation = Google::Apis::SpannerV1::ListDatabasesResponse::Representation
453
- command.response_class = Google::Apis::SpannerV1::ListDatabasesResponse
454
- command.params['parent'] = parent unless parent.nil?
455
- command.query['pageSize'] = page_size unless page_size.nil?
456
- command.query['pageToken'] = page_token unless page_token.nil?
377
+ def get_project_instance(name, quota_user: nil, fields: nil, options: nil, &block)
378
+ command = make_simple_command(:get, 'v1/{+name}', options)
379
+ command.response_representation = Google::Apis::SpannerV1::Instance::Representation
380
+ command.response_class = Google::Apis::SpannerV1::Instance
381
+ command.params['name'] = name unless name.nil?
457
382
  command.query['quotaUser'] = quota_user unless quota_user.nil?
458
383
  command.query['fields'] = fields unless fields.nil?
459
384
  execute_or_queue_command(command, &block)
460
385
  end
461
386
 
462
- # Creates a new Cloud Spanner database and starts to prepare it for serving.
387
+ # Updates an instance, and begins allocating or releasing resources
388
+ # as requested. The returned long-running
389
+ # operation can be used to track the
390
+ # progress of updating the instance. If the named instance does not
391
+ # exist, returns `NOT_FOUND`.
392
+ # Immediately upon completion of this request:
393
+ # * For resource types for which a decrease in the instance's allocation
394
+ # has been requested, billing is based on the newly-requested level.
395
+ # Until completion of the returned operation:
396
+ # * Cancelling the operation sets its metadata's
397
+ # cancel_time, and begins
398
+ # restoring resources to their pre-request values. The operation
399
+ # is guaranteed to succeed at undoing all resource changes,
400
+ # after which point it terminates with a `CANCELLED` status.
401
+ # * All other attempts to modify the instance are rejected.
402
+ # * Reading the instance via the API continues to give the pre-request
403
+ # resource levels.
404
+ # Upon completion of the returned operation:
405
+ # * Billing begins for all successfully-allocated resources (some types
406
+ # may have lower than the requested levels).
407
+ # * All newly-reserved resources are available for serving the instance's
408
+ # tables.
409
+ # * The instance's new resource levels are readable via the API.
463
410
  # The returned long-running operation will
464
- # have a name of the format `<database_name>/operations/<operation_id>` and
465
- # can be used to track preparation of the database. The
411
+ # have a name of the format `<instance_name>/operations/<operation_id>` and
412
+ # can be used to track the instance modification. The
466
413
  # metadata field type is
467
- # CreateDatabaseMetadata. The
468
- # response field type is
469
- # Database, if successful.
470
- # @param [String] parent
471
- # Required. The name of the instance that will serve the new database.
472
- # Values are of the form `projects/<project>/instances/<instance>`.
473
- # @param [Google::Apis::SpannerV1::CreateDatabaseRequest] create_database_request_object
414
+ # UpdateInstanceMetadata.
415
+ # The response field type is
416
+ # Instance, if successful.
417
+ # Authorization requires `spanner.instances.update` permission on
418
+ # resource name.
419
+ # @param [String] name
420
+ # Required. A unique identifier for the instance, which cannot be changed
421
+ # after the instance is created. Values are of the form
422
+ # `projects/<project>/instances/a-z*[a-z0-9]`. The final
423
+ # segment of the name must be between 6 and 30 characters in length.
424
+ # @param [Google::Apis::SpannerV1::UpdateInstanceRequest] update_instance_request_object
474
425
  # @param [String] quota_user
475
426
  # Available to use for quota purposes for server-side applications. Can be any
476
427
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -488,13 +439,125 @@ module Google
488
439
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
489
440
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
490
441
  # @raise [Google::Apis::AuthorizationError] Authorization is required
491
- def create_database(parent, create_database_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
492
- command = make_simple_command(:post, 'v1/{+parent}/databases', options)
493
- command.request_representation = Google::Apis::SpannerV1::CreateDatabaseRequest::Representation
494
- command.request_object = create_database_request_object
442
+ def patch_project_instance(name, update_instance_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
443
+ command = make_simple_command(:patch, 'v1/{+name}', options)
444
+ command.request_representation = Google::Apis::SpannerV1::UpdateInstanceRequest::Representation
445
+ command.request_object = update_instance_request_object
495
446
  command.response_representation = Google::Apis::SpannerV1::Operation::Representation
496
447
  command.response_class = Google::Apis::SpannerV1::Operation
448
+ command.params['name'] = name unless name.nil?
449
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
450
+ command.query['fields'] = fields unless fields.nil?
451
+ execute_or_queue_command(command, &block)
452
+ end
453
+
454
+ # Returns permissions that the caller has on the specified instance resource.
455
+ # Attempting this RPC on a non-existent Cloud Spanner instance resource will
456
+ # result in a NOT_FOUND error if the user has `spanner.instances.list`
457
+ # permission on the containing Google Cloud Project. Otherwise returns an
458
+ # empty set of permissions.
459
+ # @param [String] resource
460
+ # REQUIRED: The Cloud Spanner resource for which permissions are being tested.
461
+ # The format is `projects/<project ID>/instances/<instance ID>` for instance
462
+ # resources and `projects/<project ID>/instances/<instance ID>/databases/<
463
+ # database ID>` for database resources.
464
+ # @param [Google::Apis::SpannerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
465
+ # @param [String] quota_user
466
+ # Available to use for quota purposes for server-side applications. Can be any
467
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
468
+ # @param [String] fields
469
+ # Selector specifying which fields to include in a partial response.
470
+ # @param [Google::Apis::RequestOptions] options
471
+ # Request-specific options
472
+ #
473
+ # @yield [result, err] Result & error if block supplied
474
+ # @yieldparam result [Google::Apis::SpannerV1::TestIamPermissionsResponse] parsed result object
475
+ # @yieldparam err [StandardError] error object if request failed
476
+ #
477
+ # @return [Google::Apis::SpannerV1::TestIamPermissionsResponse]
478
+ #
479
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
480
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
481
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
482
+ def test_instance_iam_permissions(resource, test_iam_permissions_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
483
+ command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
484
+ command.request_representation = Google::Apis::SpannerV1::TestIamPermissionsRequest::Representation
485
+ command.request_object = test_iam_permissions_request_object
486
+ command.response_representation = Google::Apis::SpannerV1::TestIamPermissionsResponse::Representation
487
+ command.response_class = Google::Apis::SpannerV1::TestIamPermissionsResponse
488
+ command.params['resource'] = resource unless resource.nil?
489
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
490
+ command.query['fields'] = fields unless fields.nil?
491
+ execute_or_queue_command(command, &block)
492
+ end
493
+
494
+ # Returns the schema of a Cloud Spanner database as a list of formatted
495
+ # DDL statements. This method does not show pending schema updates, those may
496
+ # be queried using the Operations API.
497
+ # @param [String] database
498
+ # Required. The database whose schema we wish to get.
499
+ # @param [String] quota_user
500
+ # Available to use for quota purposes for server-side applications. Can be any
501
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
502
+ # @param [String] fields
503
+ # Selector specifying which fields to include in a partial response.
504
+ # @param [Google::Apis::RequestOptions] options
505
+ # Request-specific options
506
+ #
507
+ # @yield [result, err] Result & error if block supplied
508
+ # @yieldparam result [Google::Apis::SpannerV1::GetDatabaseDdlResponse] parsed result object
509
+ # @yieldparam err [StandardError] error object if request failed
510
+ #
511
+ # @return [Google::Apis::SpannerV1::GetDatabaseDdlResponse]
512
+ #
513
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
514
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
515
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
516
+ def get_project_instance_database_ddl(database, quota_user: nil, fields: nil, options: nil, &block)
517
+ command = make_simple_command(:get, 'v1/{+database}/ddl', options)
518
+ command.response_representation = Google::Apis::SpannerV1::GetDatabaseDdlResponse::Representation
519
+ command.response_class = Google::Apis::SpannerV1::GetDatabaseDdlResponse
520
+ command.params['database'] = database unless database.nil?
521
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
522
+ command.query['fields'] = fields unless fields.nil?
523
+ execute_or_queue_command(command, &block)
524
+ end
525
+
526
+ # Lists Cloud Spanner databases.
527
+ # @param [String] parent
528
+ # Required. The instance whose databases should be listed.
529
+ # Values are of the form `projects/<project>/instances/<instance>`.
530
+ # @param [String] page_token
531
+ # If non-empty, `page_token` should contain a
532
+ # next_page_token from a
533
+ # previous ListDatabasesResponse.
534
+ # @param [Fixnum] page_size
535
+ # Number of databases to be returned in the response. If 0 or less,
536
+ # defaults to the server's maximum allowed page size.
537
+ # @param [String] quota_user
538
+ # Available to use for quota purposes for server-side applications. Can be any
539
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
540
+ # @param [String] fields
541
+ # Selector specifying which fields to include in a partial response.
542
+ # @param [Google::Apis::RequestOptions] options
543
+ # Request-specific options
544
+ #
545
+ # @yield [result, err] Result & error if block supplied
546
+ # @yieldparam result [Google::Apis::SpannerV1::ListDatabasesResponse] parsed result object
547
+ # @yieldparam err [StandardError] error object if request failed
548
+ #
549
+ # @return [Google::Apis::SpannerV1::ListDatabasesResponse]
550
+ #
551
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
552
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
553
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
554
+ def list_project_instance_databases(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
555
+ command = make_simple_command(:get, 'v1/{+parent}/databases', options)
556
+ command.response_representation = Google::Apis::SpannerV1::ListDatabasesResponse::Representation
557
+ command.response_class = Google::Apis::SpannerV1::ListDatabasesResponse
497
558
  command.params['parent'] = parent unless parent.nil?
559
+ command.query['pageToken'] = page_token unless page_token.nil?
560
+ command.query['pageSize'] = page_size unless page_size.nil?
498
561
  command.query['quotaUser'] = quota_user unless quota_user.nil?
499
562
  command.query['fields'] = fields unless fields.nil?
500
563
  execute_or_queue_command(command, &block)
@@ -539,6 +602,47 @@ module Google
539
602
  execute_or_queue_command(command, &block)
540
603
  end
541
604
 
605
+ # Creates a new Cloud Spanner database and starts to prepare it for serving.
606
+ # The returned long-running operation will
607
+ # have a name of the format `<database_name>/operations/<operation_id>` and
608
+ # can be used to track preparation of the database. The
609
+ # metadata field type is
610
+ # CreateDatabaseMetadata. The
611
+ # response field type is
612
+ # Database, if successful.
613
+ # @param [String] parent
614
+ # Required. The name of the instance that will serve the new database.
615
+ # Values are of the form `projects/<project>/instances/<instance>`.
616
+ # @param [Google::Apis::SpannerV1::CreateDatabaseRequest] create_database_request_object
617
+ # @param [String] quota_user
618
+ # Available to use for quota purposes for server-side applications. Can be any
619
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
620
+ # @param [String] fields
621
+ # Selector specifying which fields to include in a partial response.
622
+ # @param [Google::Apis::RequestOptions] options
623
+ # Request-specific options
624
+ #
625
+ # @yield [result, err] Result & error if block supplied
626
+ # @yieldparam result [Google::Apis::SpannerV1::Operation] parsed result object
627
+ # @yieldparam err [StandardError] error object if request failed
628
+ #
629
+ # @return [Google::Apis::SpannerV1::Operation]
630
+ #
631
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
632
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
633
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
634
+ def create_database(parent, create_database_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
635
+ command = make_simple_command(:post, 'v1/{+parent}/databases', options)
636
+ command.request_representation = Google::Apis::SpannerV1::CreateDatabaseRequest::Representation
637
+ command.request_object = create_database_request_object
638
+ command.response_representation = Google::Apis::SpannerV1::Operation::Representation
639
+ command.response_class = Google::Apis::SpannerV1::Operation
640
+ command.params['parent'] = parent unless parent.nil?
641
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
642
+ command.query['fields'] = fields unless fields.nil?
643
+ execute_or_queue_command(command, &block)
644
+ end
645
+
542
646
  # Gets the access control policy for a database resource. Returns an empty
543
647
  # policy if a database exists but does not have a policy set.
544
648
  # Authorization requires `spanner.databases.getIamPolicy` permission on
@@ -718,50 +822,18 @@ module Google
718
822
  execute_or_queue_command(command, &block)
719
823
  end
720
824
 
721
- # Returns the schema of a Cloud Spanner database as a list of formatted
722
- # DDL statements. This method does not show pending schema updates, those may
723
- # be queried using the Operations API.
724
- # @param [String] database
725
- # Required. The database whose schema we wish to get.
726
- # @param [String] quota_user
727
- # Available to use for quota purposes for server-side applications. Can be any
728
- # arbitrary string assigned to a user, but should not exceed 40 characters.
729
- # @param [String] fields
730
- # Selector specifying which fields to include in a partial response.
731
- # @param [Google::Apis::RequestOptions] options
732
- # Request-specific options
733
- #
734
- # @yield [result, err] Result & error if block supplied
735
- # @yieldparam result [Google::Apis::SpannerV1::GetDatabaseDdlResponse] parsed result object
736
- # @yieldparam err [StandardError] error object if request failed
737
- #
738
- # @return [Google::Apis::SpannerV1::GetDatabaseDdlResponse]
739
- #
740
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
741
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
742
- # @raise [Google::Apis::AuthorizationError] Authorization is required
743
- def get_project_instance_database_ddl(database, quota_user: nil, fields: nil, options: nil, &block)
744
- command = make_simple_command(:get, 'v1/{+database}/ddl', options)
745
- command.response_representation = Google::Apis::SpannerV1::GetDatabaseDdlResponse::Representation
746
- command.response_class = Google::Apis::SpannerV1::GetDatabaseDdlResponse
747
- command.params['database'] = database unless database.nil?
748
- command.query['quotaUser'] = quota_user unless quota_user.nil?
749
- command.query['fields'] = fields unless fields.nil?
750
- execute_or_queue_command(command, &block)
751
- end
752
-
753
825
  # Lists operations that match the specified filter in the request. If the
754
826
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
755
827
  # NOTE: the `name` binding below allows API services to override the binding
756
828
  # to use different resource name schemes, such as `users/*/operations`.
757
829
  # @param [String] name
758
830
  # The name of the operation collection.
759
- # @param [Fixnum] page_size
760
- # The standard list page size.
761
831
  # @param [String] filter
762
832
  # The standard list filter.
763
833
  # @param [String] page_token
764
834
  # The standard list page token.
835
+ # @param [Fixnum] page_size
836
+ # The standard list page size.
765
837
  # @param [String] quota_user
766
838
  # Available to use for quota purposes for server-side applications. Can be any
767
839
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -779,14 +851,14 @@ module Google
779
851
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
780
852
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
781
853
  # @raise [Google::Apis::AuthorizationError] Authorization is required
782
- def list_project_instance_database_operations(name, page_size: nil, filter: nil, page_token: nil, quota_user: nil, fields: nil, options: nil, &block)
854
+ def list_project_instance_database_operations(name, filter: nil, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
783
855
  command = make_simple_command(:get, 'v1/{+name}', options)
784
856
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
785
857
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
786
858
  command.params['name'] = name unless name.nil?
787
- command.query['pageSize'] = page_size unless page_size.nil?
788
859
  command.query['filter'] = filter unless filter.nil?
789
860
  command.query['pageToken'] = page_token unless page_token.nil?
861
+ command.query['pageSize'] = page_size unless page_size.nil?
790
862
  command.query['quotaUser'] = quota_user unless quota_user.nil?
791
863
  command.query['fields'] = fields unless fields.nil?
792
864
  execute_or_queue_command(command, &block)
@@ -896,78 +968,16 @@ module Google
896
968
  execute_or_queue_command(command, &block)
897
969
  end
898
970
 
899
- # Gets a session. Returns `NOT_FOUND` if the session does not exist.
900
- # This is mainly useful for determining whether a session is still
901
- # alive.
902
- # @param [String] name
903
- # Required. The name of the session to retrieve.
904
- # @param [String] quota_user
905
- # Available to use for quota purposes for server-side applications. Can be any
906
- # arbitrary string assigned to a user, but should not exceed 40 characters.
907
- # @param [String] fields
908
- # Selector specifying which fields to include in a partial response.
909
- # @param [Google::Apis::RequestOptions] options
910
- # Request-specific options
911
- #
912
- # @yield [result, err] Result & error if block supplied
913
- # @yieldparam result [Google::Apis::SpannerV1::Session] parsed result object
914
- # @yieldparam err [StandardError] error object if request failed
915
- #
916
- # @return [Google::Apis::SpannerV1::Session]
917
- #
918
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
919
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
920
- # @raise [Google::Apis::AuthorizationError] Authorization is required
921
- def get_project_instance_database_session(name, quota_user: nil, fields: nil, options: nil, &block)
922
- command = make_simple_command(:get, 'v1/{+name}', options)
923
- command.response_representation = Google::Apis::SpannerV1::Session::Representation
924
- command.response_class = Google::Apis::SpannerV1::Session
925
- command.params['name'] = name unless name.nil?
926
- command.query['quotaUser'] = quota_user unless quota_user.nil?
927
- command.query['fields'] = fields unless fields.nil?
928
- execute_or_queue_command(command, &block)
929
- end
930
-
931
- # Like ExecuteSql, except returns the result
932
- # set as a stream. Unlike ExecuteSql, there
933
- # is no limit on the size of the returned result set. However, no
934
- # individual row in the result set can exceed 100 MiB, and no
935
- # column value can exceed 10 MiB.
971
+ # Commits a transaction. The request includes the mutations to be
972
+ # applied to rows in the database.
973
+ # `Commit` might return an `ABORTED` error. This can occur at any time;
974
+ # commonly, the cause is conflicts with concurrent
975
+ # transactions. However, it can also happen for a variety of other
976
+ # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
977
+ # the transaction from the beginning, re-using the same session.
936
978
  # @param [String] session
937
- # Required. The session in which the SQL query should be performed.
938
- # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
939
- # @param [String] quota_user
940
- # Available to use for quota purposes for server-side applications. Can be any
941
- # arbitrary string assigned to a user, but should not exceed 40 characters.
942
- # @param [String] fields
943
- # Selector specifying which fields to include in a partial response.
944
- # @param [Google::Apis::RequestOptions] options
945
- # Request-specific options
946
- #
947
- # @yield [result, err] Result & error if block supplied
948
- # @yieldparam result [Google::Apis::SpannerV1::PartialResultSet] parsed result object
949
- # @yieldparam err [StandardError] error object if request failed
950
- #
951
- # @return [Google::Apis::SpannerV1::PartialResultSet]
952
- #
953
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
954
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
955
- # @raise [Google::Apis::AuthorizationError] Authorization is required
956
- def execute_project_instance_database_session_streaming_sql(session, execute_sql_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
957
- command = make_simple_command(:post, 'v1/{+session}:executeStreamingSql', options)
958
- command.request_representation = Google::Apis::SpannerV1::ExecuteSqlRequest::Representation
959
- command.request_object = execute_sql_request_object
960
- command.response_representation = Google::Apis::SpannerV1::PartialResultSet::Representation
961
- command.response_class = Google::Apis::SpannerV1::PartialResultSet
962
- command.params['session'] = session unless session.nil?
963
- command.query['quotaUser'] = quota_user unless quota_user.nil?
964
- command.query['fields'] = fields unless fields.nil?
965
- execute_or_queue_command(command, &block)
966
- end
967
-
968
- # Ends a session, releasing server resources associated with it.
969
- # @param [String] name
970
- # Required. The name of the session to delete.
979
+ # Required. The session in which the transaction to be committed is running.
980
+ # @param [Google::Apis::SpannerV1::CommitRequest] commit_request_object
971
981
  # @param [String] quota_user
972
982
  # Available to use for quota purposes for server-side applications. Can be any
973
983
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -977,19 +987,21 @@ module Google
977
987
  # Request-specific options
978
988
  #
979
989
  # @yield [result, err] Result & error if block supplied
980
- # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
990
+ # @yieldparam result [Google::Apis::SpannerV1::CommitResponse] parsed result object
981
991
  # @yieldparam err [StandardError] error object if request failed
982
992
  #
983
- # @return [Google::Apis::SpannerV1::Empty]
993
+ # @return [Google::Apis::SpannerV1::CommitResponse]
984
994
  #
985
995
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
986
996
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
987
997
  # @raise [Google::Apis::AuthorizationError] Authorization is required
988
- def delete_project_instance_database_session(name, quota_user: nil, fields: nil, options: nil, &block)
989
- command = make_simple_command(:delete, 'v1/{+name}', options)
990
- command.response_representation = Google::Apis::SpannerV1::Empty::Representation
991
- command.response_class = Google::Apis::SpannerV1::Empty
992
- command.params['name'] = name unless name.nil?
998
+ def commit_session(session, commit_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
999
+ command = make_simple_command(:post, 'v1/{+session}:commit', options)
1000
+ command.request_representation = Google::Apis::SpannerV1::CommitRequest::Representation
1001
+ command.request_object = commit_request_object
1002
+ command.response_representation = Google::Apis::SpannerV1::CommitResponse::Representation
1003
+ command.response_class = Google::Apis::SpannerV1::CommitResponse
1004
+ command.params['session'] = session unless session.nil?
993
1005
  command.query['quotaUser'] = quota_user unless quota_user.nil?
994
1006
  command.query['fields'] = fields unless fields.nil?
995
1007
  execute_or_queue_command(command, &block)
@@ -1031,16 +1043,44 @@ module Google
1031
1043
  execute_or_queue_command(command, &block)
1032
1044
  end
1033
1045
 
1034
- # Commits a transaction. The request includes the mutations to be
1035
- # applied to rows in the database.
1036
- # `Commit` might return an `ABORTED` error. This can occur at any time;
1037
- # commonly, the cause is conflicts with concurrent
1038
- # transactions. However, it can also happen for a variety of other
1039
- # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
1040
- # the transaction from the beginning, re-using the same session.
1046
+ # Ends a session, releasing server resources associated with it.
1047
+ # @param [String] name
1048
+ # Required. The name of the session to delete.
1049
+ # @param [String] quota_user
1050
+ # Available to use for quota purposes for server-side applications. Can be any
1051
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1052
+ # @param [String] fields
1053
+ # Selector specifying which fields to include in a partial response.
1054
+ # @param [Google::Apis::RequestOptions] options
1055
+ # Request-specific options
1056
+ #
1057
+ # @yield [result, err] Result & error if block supplied
1058
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1059
+ # @yieldparam err [StandardError] error object if request failed
1060
+ #
1061
+ # @return [Google::Apis::SpannerV1::Empty]
1062
+ #
1063
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1064
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1065
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1066
+ def delete_project_instance_database_session(name, quota_user: nil, fields: nil, options: nil, &block)
1067
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1068
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1069
+ command.response_class = Google::Apis::SpannerV1::Empty
1070
+ command.params['name'] = name unless name.nil?
1071
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1072
+ command.query['fields'] = fields unless fields.nil?
1073
+ execute_or_queue_command(command, &block)
1074
+ end
1075
+
1076
+ # Like ExecuteSql, except returns the result
1077
+ # set as a stream. Unlike ExecuteSql, there
1078
+ # is no limit on the size of the returned result set. However, no
1079
+ # individual row in the result set can exceed 100 MiB, and no
1080
+ # column value can exceed 10 MiB.
1041
1081
  # @param [String] session
1042
- # Required. The session in which the transaction to be committed is running.
1043
- # @param [Google::Apis::SpannerV1::CommitRequest] commit_request_object
1082
+ # Required. The session in which the SQL query should be performed.
1083
+ # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
1044
1084
  # @param [String] quota_user
1045
1085
  # Available to use for quota purposes for server-side applications. Can be any
1046
1086
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -1050,20 +1090,20 @@ module Google
1050
1090
  # Request-specific options
1051
1091
  #
1052
1092
  # @yield [result, err] Result & error if block supplied
1053
- # @yieldparam result [Google::Apis::SpannerV1::CommitResponse] parsed result object
1093
+ # @yieldparam result [Google::Apis::SpannerV1::PartialResultSet] parsed result object
1054
1094
  # @yieldparam err [StandardError] error object if request failed
1055
1095
  #
1056
- # @return [Google::Apis::SpannerV1::CommitResponse]
1096
+ # @return [Google::Apis::SpannerV1::PartialResultSet]
1057
1097
  #
1058
1098
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1059
1099
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1060
1100
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1061
- def commit_session(session, commit_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1062
- command = make_simple_command(:post, 'v1/{+session}:commit', options)
1063
- command.request_representation = Google::Apis::SpannerV1::CommitRequest::Representation
1064
- command.request_object = commit_request_object
1065
- command.response_representation = Google::Apis::SpannerV1::CommitResponse::Representation
1066
- command.response_class = Google::Apis::SpannerV1::CommitResponse
1101
+ def execute_project_instance_database_session_streaming_sql(session, execute_sql_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1102
+ command = make_simple_command(:post, 'v1/{+session}:executeStreamingSql', options)
1103
+ command.request_representation = Google::Apis::SpannerV1::ExecuteSqlRequest::Representation
1104
+ command.request_object = execute_sql_request_object
1105
+ command.response_representation = Google::Apis::SpannerV1::PartialResultSet::Representation
1106
+ command.response_class = Google::Apis::SpannerV1::PartialResultSet
1067
1107
  command.params['session'] = session unless session.nil?
1068
1108
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1069
1109
  command.query['fields'] = fields unless fields.nil?
@@ -1111,16 +1151,14 @@ module Google
1111
1151
  execute_or_queue_command(command, &block)
1112
1152
  end
1113
1153
 
1114
- # Rolls back a transaction, releasing any locks it holds. It is a good
1115
- # idea to call this for any transaction that includes one or more
1116
- # Read or ExecuteSql requests and
1117
- # ultimately decides not to commit.
1118
- # `Rollback` returns `OK` if it successfully aborts the transaction, the
1119
- # transaction was already aborted, or the transaction is not
1120
- # found. `Rollback` never returns `ABORTED`.
1154
+ # Like Read, except returns the result set as a
1155
+ # stream. Unlike Read, there is no limit on the
1156
+ # size of the returned result set. However, no individual row in
1157
+ # the result set can exceed 100 MiB, and no column value can exceed
1158
+ # 10 MiB.
1121
1159
  # @param [String] session
1122
- # Required. The session in which the transaction to roll back is running.
1123
- # @param [Google::Apis::SpannerV1::RollbackRequest] rollback_request_object
1160
+ # Required. The session in which the read should be performed.
1161
+ # @param [Google::Apis::SpannerV1::ReadRequest] read_request_object
1124
1162
  # @param [String] quota_user
1125
1163
  # Available to use for quota purposes for server-side applications. Can be any
1126
1164
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -1130,34 +1168,36 @@ module Google
1130
1168
  # Request-specific options
1131
1169
  #
1132
1170
  # @yield [result, err] Result & error if block supplied
1133
- # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1171
+ # @yieldparam result [Google::Apis::SpannerV1::PartialResultSet] parsed result object
1134
1172
  # @yieldparam err [StandardError] error object if request failed
1135
1173
  #
1136
- # @return [Google::Apis::SpannerV1::Empty]
1174
+ # @return [Google::Apis::SpannerV1::PartialResultSet]
1137
1175
  #
1138
1176
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1139
1177
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1140
1178
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1141
- def rollback_session(session, rollback_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1142
- command = make_simple_command(:post, 'v1/{+session}:rollback', options)
1143
- command.request_representation = Google::Apis::SpannerV1::RollbackRequest::Representation
1144
- command.request_object = rollback_request_object
1145
- command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1146
- command.response_class = Google::Apis::SpannerV1::Empty
1179
+ def streaming_project_instance_database_session_read(session, read_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1180
+ command = make_simple_command(:post, 'v1/{+session}:streamingRead', options)
1181
+ command.request_representation = Google::Apis::SpannerV1::ReadRequest::Representation
1182
+ command.request_object = read_request_object
1183
+ command.response_representation = Google::Apis::SpannerV1::PartialResultSet::Representation
1184
+ command.response_class = Google::Apis::SpannerV1::PartialResultSet
1147
1185
  command.params['session'] = session unless session.nil?
1148
1186
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1149
1187
  command.query['fields'] = fields unless fields.nil?
1150
1188
  execute_or_queue_command(command, &block)
1151
1189
  end
1152
1190
 
1153
- # Like Read, except returns the result set as a
1154
- # stream. Unlike Read, there is no limit on the
1155
- # size of the returned result set. However, no individual row in
1156
- # the result set can exceed 100 MiB, and no column value can exceed
1157
- # 10 MiB.
1191
+ # Rolls back a transaction, releasing any locks it holds. It is a good
1192
+ # idea to call this for any transaction that includes one or more
1193
+ # Read or ExecuteSql requests and
1194
+ # ultimately decides not to commit.
1195
+ # `Rollback` returns `OK` if it successfully aborts the transaction, the
1196
+ # transaction was already aborted, or the transaction is not
1197
+ # found. `Rollback` never returns `ABORTED`.
1158
1198
  # @param [String] session
1159
- # Required. The session in which the read should be performed.
1160
- # @param [Google::Apis::SpannerV1::ReadRequest] read_request_object
1199
+ # Required. The session in which the transaction to roll back is running.
1200
+ # @param [Google::Apis::SpannerV1::RollbackRequest] rollback_request_object
1161
1201
  # @param [String] quota_user
1162
1202
  # Available to use for quota purposes for server-side applications. Can be any
1163
1203
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -1167,20 +1207,20 @@ module Google
1167
1207
  # Request-specific options
1168
1208
  #
1169
1209
  # @yield [result, err] Result & error if block supplied
1170
- # @yieldparam result [Google::Apis::SpannerV1::PartialResultSet] parsed result object
1210
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1171
1211
  # @yieldparam err [StandardError] error object if request failed
1172
1212
  #
1173
- # @return [Google::Apis::SpannerV1::PartialResultSet]
1213
+ # @return [Google::Apis::SpannerV1::Empty]
1174
1214
  #
1175
1215
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1176
1216
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1177
1217
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1178
- def streaming_project_instance_database_session_read(session, read_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1179
- command = make_simple_command(:post, 'v1/{+session}:streamingRead', options)
1180
- command.request_representation = Google::Apis::SpannerV1::ReadRequest::Representation
1181
- command.request_object = read_request_object
1182
- command.response_representation = Google::Apis::SpannerV1::PartialResultSet::Representation
1183
- command.response_class = Google::Apis::SpannerV1::PartialResultSet
1218
+ def rollback_session(session, rollback_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
1219
+ command = make_simple_command(:post, 'v1/{+session}:rollback', options)
1220
+ command.request_representation = Google::Apis::SpannerV1::RollbackRequest::Representation
1221
+ command.request_object = rollback_request_object
1222
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1223
+ command.response_class = Google::Apis::SpannerV1::Empty
1184
1224
  command.params['session'] = session unless session.nil?
1185
1225
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1186
1226
  command.query['fields'] = fields unless fields.nil?
@@ -1275,51 +1315,11 @@ module Google
1275
1315
  execute_or_queue_command(command, &block)
1276
1316
  end
1277
1317
 
1278
- # Starts asynchronous cancellation on a long-running operation. The server
1279
- # makes a best effort to cancel the operation, but success is not
1280
- # guaranteed. If the server doesn't support this method, it returns
1281
- # `google.rpc.Code.UNIMPLEMENTED`. Clients can use
1282
- # Operations.GetOperation or
1283
- # other methods to check whether the cancellation succeeded or whether the
1284
- # operation completed despite cancellation. On successful cancellation,
1285
- # the operation is not deleted; instead, it becomes an operation with
1286
- # an Operation.error value with a google.rpc.Status.code of 1,
1287
- # corresponding to `Code.CANCELLED`.
1288
- # @param [String] name
1289
- # The name of the operation resource to be cancelled.
1290
- # @param [String] quota_user
1291
- # Available to use for quota purposes for server-side applications. Can be any
1292
- # arbitrary string assigned to a user, but should not exceed 40 characters.
1293
- # @param [String] fields
1294
- # Selector specifying which fields to include in a partial response.
1295
- # @param [Google::Apis::RequestOptions] options
1296
- # Request-specific options
1297
- #
1298
- # @yield [result, err] Result & error if block supplied
1299
- # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1300
- # @yieldparam err [StandardError] error object if request failed
1301
- #
1302
- # @return [Google::Apis::SpannerV1::Empty]
1303
- #
1304
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1305
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1306
- # @raise [Google::Apis::AuthorizationError] Authorization is required
1307
- def cancel_project_instance_operation(name, quota_user: nil, fields: nil, options: nil, &block)
1308
- command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1309
- command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1310
- command.response_class = Google::Apis::SpannerV1::Empty
1311
- command.params['name'] = name unless name.nil?
1312
- command.query['quotaUser'] = quota_user unless quota_user.nil?
1313
- command.query['fields'] = fields unless fields.nil?
1314
- execute_or_queue_command(command, &block)
1315
- end
1316
-
1317
- # Deletes a long-running operation. This method indicates that the client is
1318
- # no longer interested in the operation result. It does not cancel the
1319
- # operation. If the server doesn't support this method, it returns
1320
- # `google.rpc.Code.UNIMPLEMENTED`.
1318
+ # Gets a session. Returns `NOT_FOUND` if the session does not exist.
1319
+ # This is mainly useful for determining whether a session is still
1320
+ # alive.
1321
1321
  # @param [String] name
1322
- # The name of the operation resource to be deleted.
1322
+ # Required. The name of the session to retrieve.
1323
1323
  # @param [String] quota_user
1324
1324
  # Available to use for quota purposes for server-side applications. Can be any
1325
1325
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -1329,18 +1329,18 @@ module Google
1329
1329
  # Request-specific options
1330
1330
  #
1331
1331
  # @yield [result, err] Result & error if block supplied
1332
- # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1332
+ # @yieldparam result [Google::Apis::SpannerV1::Session] parsed result object
1333
1333
  # @yieldparam err [StandardError] error object if request failed
1334
1334
  #
1335
- # @return [Google::Apis::SpannerV1::Empty]
1335
+ # @return [Google::Apis::SpannerV1::Session]
1336
1336
  #
1337
1337
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1338
1338
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1339
1339
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1340
- def delete_project_instance_operation(name, quota_user: nil, fields: nil, options: nil, &block)
1341
- command = make_simple_command(:delete, 'v1/{+name}', options)
1342
- command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1343
- command.response_class = Google::Apis::SpannerV1::Empty
1340
+ def get_project_instance_database_session(name, quota_user: nil, fields: nil, options: nil, &block)
1341
+ command = make_simple_command(:get, 'v1/{+name}', options)
1342
+ command.response_representation = Google::Apis::SpannerV1::Session::Representation
1343
+ command.response_class = Google::Apis::SpannerV1::Session
1344
1344
  command.params['name'] = name unless name.nil?
1345
1345
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1346
1346
  command.query['fields'] = fields unless fields.nil?
@@ -1353,12 +1353,12 @@ module Google
1353
1353
  # to use different resource name schemes, such as `users/*/operations`.
1354
1354
  # @param [String] name
1355
1355
  # The name of the operation collection.
1356
- # @param [String] filter
1357
- # The standard list filter.
1358
1356
  # @param [String] page_token
1359
1357
  # The standard list page token.
1360
1358
  # @param [Fixnum] page_size
1361
1359
  # The standard list page size.
1360
+ # @param [String] filter
1361
+ # The standard list filter.
1362
1362
  # @param [String] quota_user
1363
1363
  # Available to use for quota purposes for server-side applications. Can be any
1364
1364
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -1376,14 +1376,14 @@ module Google
1376
1376
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1377
1377
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1378
1378
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1379
- def list_project_instance_operations(name, filter: nil, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
1379
+ def list_project_instance_operations(name, page_token: nil, page_size: nil, filter: nil, quota_user: nil, fields: nil, options: nil, &block)
1380
1380
  command = make_simple_command(:get, 'v1/{+name}', options)
1381
1381
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
1382
1382
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
1383
1383
  command.params['name'] = name unless name.nil?
1384
- command.query['filter'] = filter unless filter.nil?
1385
1384
  command.query['pageToken'] = page_token unless page_token.nil?
1386
1385
  command.query['pageSize'] = page_size unless page_size.nil?
1386
+ command.query['filter'] = filter unless filter.nil?
1387
1387
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1388
1388
  command.query['fields'] = fields unless fields.nil?
1389
1389
  execute_or_queue_command(command, &block)
@@ -1421,18 +1421,18 @@ module Google
1421
1421
  execute_or_queue_command(command, &block)
1422
1422
  end
1423
1423
 
1424
- # Lists the supported instance configurations for a given project.
1425
- # @param [String] parent
1426
- # Required. The name of the project for which a list of supported instance
1427
- # configurations is requested. Values are of the form
1428
- # `projects/<project>`.
1429
- # @param [String] page_token
1430
- # If non-empty, `page_token` should contain a
1431
- # next_page_token
1432
- # from a previous ListInstanceConfigsResponse.
1433
- # @param [Fixnum] page_size
1434
- # Number of instance configurations to be returned in the response. If 0 or
1435
- # less, defaults to the server's maximum allowed page size.
1424
+ # Starts asynchronous cancellation on a long-running operation. The server
1425
+ # makes a best effort to cancel the operation, but success is not
1426
+ # guaranteed. If the server doesn't support this method, it returns
1427
+ # `google.rpc.Code.UNIMPLEMENTED`. Clients can use
1428
+ # Operations.GetOperation or
1429
+ # other methods to check whether the cancellation succeeded or whether the
1430
+ # operation completed despite cancellation. On successful cancellation,
1431
+ # the operation is not deleted; instead, it becomes an operation with
1432
+ # an Operation.error value with a google.rpc.Status.code of 1,
1433
+ # corresponding to `Code.CANCELLED`.
1434
+ # @param [String] name
1435
+ # The name of the operation resource to be cancelled.
1436
1436
  # @param [String] quota_user
1437
1437
  # Available to use for quota purposes for server-side applications. Can be any
1438
1438
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -1442,30 +1442,30 @@ module Google
1442
1442
  # Request-specific options
1443
1443
  #
1444
1444
  # @yield [result, err] Result & error if block supplied
1445
- # @yieldparam result [Google::Apis::SpannerV1::ListInstanceConfigsResponse] parsed result object
1445
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1446
1446
  # @yieldparam err [StandardError] error object if request failed
1447
1447
  #
1448
- # @return [Google::Apis::SpannerV1::ListInstanceConfigsResponse]
1448
+ # @return [Google::Apis::SpannerV1::Empty]
1449
1449
  #
1450
1450
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1451
1451
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1452
1452
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1453
- def list_project_instance_configs(parent, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
1454
- command = make_simple_command(:get, 'v1/{+parent}/instanceConfigs', options)
1455
- command.response_representation = Google::Apis::SpannerV1::ListInstanceConfigsResponse::Representation
1456
- command.response_class = Google::Apis::SpannerV1::ListInstanceConfigsResponse
1457
- command.params['parent'] = parent unless parent.nil?
1458
- command.query['pageToken'] = page_token unless page_token.nil?
1459
- command.query['pageSize'] = page_size unless page_size.nil?
1453
+ def cancel_project_instance_operation(name, quota_user: nil, fields: nil, options: nil, &block)
1454
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1455
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1456
+ command.response_class = Google::Apis::SpannerV1::Empty
1457
+ command.params['name'] = name unless name.nil?
1460
1458
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1461
1459
  command.query['fields'] = fields unless fields.nil?
1462
1460
  execute_or_queue_command(command, &block)
1463
1461
  end
1464
1462
 
1465
- # Gets information about a particular instance configuration.
1463
+ # Deletes a long-running operation. This method indicates that the client is
1464
+ # no longer interested in the operation result. It does not cancel the
1465
+ # operation. If the server doesn't support this method, it returns
1466
+ # `google.rpc.Code.UNIMPLEMENTED`.
1466
1467
  # @param [String] name
1467
- # Required. The name of the requested instance configuration. Values are of
1468
- # the form `projects/<project>/instanceConfigs/<config>`.
1468
+ # The name of the operation resource to be deleted.
1469
1469
  # @param [String] quota_user
1470
1470
  # Available to use for quota purposes for server-side applications. Can be any
1471
1471
  # arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -1475,18 +1475,18 @@ module Google
1475
1475
  # Request-specific options
1476
1476
  #
1477
1477
  # @yield [result, err] Result & error if block supplied
1478
- # @yieldparam result [Google::Apis::SpannerV1::InstanceConfig] parsed result object
1478
+ # @yieldparam result [Google::Apis::SpannerV1::Empty] parsed result object
1479
1479
  # @yieldparam err [StandardError] error object if request failed
1480
1480
  #
1481
- # @return [Google::Apis::SpannerV1::InstanceConfig]
1481
+ # @return [Google::Apis::SpannerV1::Empty]
1482
1482
  #
1483
1483
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1484
1484
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1485
1485
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1486
- def get_project_instance_config(name, quota_user: nil, fields: nil, options: nil, &block)
1487
- command = make_simple_command(:get, 'v1/{+name}', options)
1488
- command.response_representation = Google::Apis::SpannerV1::InstanceConfig::Representation
1489
- command.response_class = Google::Apis::SpannerV1::InstanceConfig
1486
+ def delete_project_instance_operation(name, quota_user: nil, fields: nil, options: nil, &block)
1487
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1488
+ command.response_representation = Google::Apis::SpannerV1::Empty::Representation
1489
+ command.response_class = Google::Apis::SpannerV1::Empty
1490
1490
  command.params['name'] = name unless name.nil?
1491
1491
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1492
1492
  command.query['fields'] = fields unless fields.nil?