google-apis-appengine_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1569 @@
1
+ # Copyright 2020 Google LLC
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 AppengineV1
23
+ # App Engine Admin API
24
+ #
25
+ # Provisions and manages developers' App Engine applications.
26
+ #
27
+ # @example
28
+ # require 'google/apis/appengine_v1'
29
+ #
30
+ # Appengine = Google::Apis::AppengineV1 # Alias the module
31
+ # service = Appengine::AppengineService.new
32
+ #
33
+ # @see https://cloud.google.com/appengine/docs/admin-api/
34
+ class AppengineService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ attr_accessor :quota_user
44
+
45
+ def initialize
46
+ super('https://appengine.googleapis.com/', '',
47
+ client_name: 'google-apis-appengine_v1',
48
+ client_version: Google::Apis::AppengineV1::GEM_VERSION)
49
+ @batch_path = 'batch'
50
+ end
51
+
52
+ # Creates an App Engine application for a Google Cloud Platform project.
53
+ # Required fields: id - The ID of the target Cloud Platform project. location -
54
+ # The region (https://cloud.google.com/appengine/docs/locations) where you want
55
+ # the App Engine application located.For more information about App Engine
56
+ # applications, see Managing Projects, Applications, and Billing (https://cloud.
57
+ # google.com/appengine/docs/standard/python/console/).
58
+ # @param [Google::Apis::AppengineV1::Application] application_object
59
+ # @param [String] fields
60
+ # Selector specifying which fields to include in a partial response.
61
+ # @param [String] quota_user
62
+ # Available to use for quota purposes for server-side applications. Can be any
63
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
64
+ # @param [Google::Apis::RequestOptions] options
65
+ # Request-specific options
66
+ #
67
+ # @yield [result, err] Result & error if block supplied
68
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
69
+ # @yieldparam err [StandardError] error object if request failed
70
+ #
71
+ # @return [Google::Apis::AppengineV1::Operation]
72
+ #
73
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
74
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
75
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
76
+ def create_app(application_object = nil, fields: nil, quota_user: nil, options: nil, &block)
77
+ command = make_simple_command(:post, 'v1/apps', options)
78
+ command.request_representation = Google::Apis::AppengineV1::Application::Representation
79
+ command.request_object = application_object
80
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
81
+ command.response_class = Google::Apis::AppengineV1::Operation
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
+ # Gets information about an application.
88
+ # @param [String] apps_id
89
+ # Part of `name`. Name of the Application resource to get. Example: apps/myapp.
90
+ # @param [String] fields
91
+ # Selector specifying which fields to include in a partial response.
92
+ # @param [String] quota_user
93
+ # Available to use for quota purposes for server-side applications. Can be any
94
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
95
+ # @param [Google::Apis::RequestOptions] options
96
+ # Request-specific options
97
+ #
98
+ # @yield [result, err] Result & error if block supplied
99
+ # @yieldparam result [Google::Apis::AppengineV1::Application] parsed result object
100
+ # @yieldparam err [StandardError] error object if request failed
101
+ #
102
+ # @return [Google::Apis::AppengineV1::Application]
103
+ #
104
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
105
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
106
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
107
+ def get_app(apps_id, fields: nil, quota_user: nil, options: nil, &block)
108
+ command = make_simple_command(:get, 'v1/apps/{appsId}', options)
109
+ command.response_representation = Google::Apis::AppengineV1::Application::Representation
110
+ command.response_class = Google::Apis::AppengineV1::Application
111
+ command.params['appsId'] = apps_id unless apps_id.nil?
112
+ command.query['fields'] = fields unless fields.nil?
113
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
114
+ execute_or_queue_command(command, &block)
115
+ end
116
+
117
+ # Updates the specified Application resource. You can update the following
118
+ # fields: auth_domain - Google authentication domain for controlling user access
119
+ # to the application. default_cookie_expiration - Cookie expiration policy for
120
+ # the application.
121
+ # @param [String] apps_id
122
+ # Part of `name`. Name of the Application resource to update. Example: apps/
123
+ # myapp.
124
+ # @param [Google::Apis::AppengineV1::Application] application_object
125
+ # @param [String] update_mask
126
+ # Standard field mask for the set of fields to be updated.
127
+ # @param [String] fields
128
+ # Selector specifying which fields to include in a partial response.
129
+ # @param [String] quota_user
130
+ # Available to use for quota purposes for server-side applications. Can be any
131
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
132
+ # @param [Google::Apis::RequestOptions] options
133
+ # Request-specific options
134
+ #
135
+ # @yield [result, err] Result & error if block supplied
136
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
137
+ # @yieldparam err [StandardError] error object if request failed
138
+ #
139
+ # @return [Google::Apis::AppengineV1::Operation]
140
+ #
141
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
142
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
143
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
144
+ def patch_app(apps_id, application_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
145
+ command = make_simple_command(:patch, 'v1/apps/{appsId}', options)
146
+ command.request_representation = Google::Apis::AppengineV1::Application::Representation
147
+ command.request_object = application_object
148
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
149
+ command.response_class = Google::Apis::AppengineV1::Operation
150
+ command.params['appsId'] = apps_id unless apps_id.nil?
151
+ command.query['updateMask'] = update_mask unless update_mask.nil?
152
+ command.query['fields'] = fields unless fields.nil?
153
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
154
+ execute_or_queue_command(command, &block)
155
+ end
156
+
157
+ # Recreates the required App Engine features for the specified App Engine
158
+ # application, for example a Cloud Storage bucket or App Engine service account.
159
+ # Use this method if you receive an error message about a missing feature, for
160
+ # example, Error retrieving the App Engine service account. If you have deleted
161
+ # your App Engine service account, this will not be able to recreate it. Instead,
162
+ # you should attempt to use the IAM undelete API if possible at https://cloud.
163
+ # google.com/iam/reference/rest/v1/projects.serviceAccounts/undelete?apix_params=
164
+ # %7B"name"%3A"projects%2F-%2FserviceAccounts%2Funique_id"%2C"resource"%3A%7B%7D%
165
+ # 7D . If the deletion was recent, the numeric ID can be found in the Cloud
166
+ # Console Activity Log.
167
+ # @param [String] apps_id
168
+ # Part of `name`. Name of the application to repair. Example: apps/myapp
169
+ # @param [Google::Apis::AppengineV1::RepairApplicationRequest] repair_application_request_object
170
+ # @param [String] fields
171
+ # Selector specifying which fields to include in a partial response.
172
+ # @param [String] quota_user
173
+ # Available to use for quota purposes for server-side applications. Can be any
174
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
175
+ # @param [Google::Apis::RequestOptions] options
176
+ # Request-specific options
177
+ #
178
+ # @yield [result, err] Result & error if block supplied
179
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
180
+ # @yieldparam err [StandardError] error object if request failed
181
+ #
182
+ # @return [Google::Apis::AppengineV1::Operation]
183
+ #
184
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
185
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
186
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
187
+ def repair_application(apps_id, repair_application_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
188
+ command = make_simple_command(:post, 'v1/apps/{appsId}:repair', options)
189
+ command.request_representation = Google::Apis::AppengineV1::RepairApplicationRequest::Representation
190
+ command.request_object = repair_application_request_object
191
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
192
+ command.response_class = Google::Apis::AppengineV1::Operation
193
+ command.params['appsId'] = apps_id unless apps_id.nil?
194
+ command.query['fields'] = fields unless fields.nil?
195
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
196
+ execute_or_queue_command(command, &block)
197
+ end
198
+
199
+ # Uploads the specified SSL certificate.
200
+ # @param [String] apps_id
201
+ # Part of `parent`. Name of the parent Application resource. Example: apps/myapp.
202
+ # @param [Google::Apis::AppengineV1::AuthorizedCertificate] authorized_certificate_object
203
+ # @param [String] fields
204
+ # Selector specifying which fields to include in a partial response.
205
+ # @param [String] quota_user
206
+ # Available to use for quota purposes for server-side applications. Can be any
207
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
208
+ # @param [Google::Apis::RequestOptions] options
209
+ # Request-specific options
210
+ #
211
+ # @yield [result, err] Result & error if block supplied
212
+ # @yieldparam result [Google::Apis::AppengineV1::AuthorizedCertificate] parsed result object
213
+ # @yieldparam err [StandardError] error object if request failed
214
+ #
215
+ # @return [Google::Apis::AppengineV1::AuthorizedCertificate]
216
+ #
217
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
218
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
219
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
220
+ def create_app_authorized_certificate(apps_id, authorized_certificate_object = nil, fields: nil, quota_user: nil, options: nil, &block)
221
+ command = make_simple_command(:post, 'v1/apps/{appsId}/authorizedCertificates', options)
222
+ command.request_representation = Google::Apis::AppengineV1::AuthorizedCertificate::Representation
223
+ command.request_object = authorized_certificate_object
224
+ command.response_representation = Google::Apis::AppengineV1::AuthorizedCertificate::Representation
225
+ command.response_class = Google::Apis::AppengineV1::AuthorizedCertificate
226
+ command.params['appsId'] = apps_id unless apps_id.nil?
227
+ command.query['fields'] = fields unless fields.nil?
228
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
229
+ execute_or_queue_command(command, &block)
230
+ end
231
+
232
+ # Deletes the specified SSL certificate.
233
+ # @param [String] apps_id
234
+ # Part of `name`. Name of the resource to delete. Example: apps/myapp/
235
+ # authorizedCertificates/12345.
236
+ # @param [String] authorized_certificates_id
237
+ # Part of `name`. See documentation of `appsId`.
238
+ # @param [String] fields
239
+ # Selector specifying which fields to include in a partial response.
240
+ # @param [String] quota_user
241
+ # Available to use for quota purposes for server-side applications. Can be any
242
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
243
+ # @param [Google::Apis::RequestOptions] options
244
+ # Request-specific options
245
+ #
246
+ # @yield [result, err] Result & error if block supplied
247
+ # @yieldparam result [Google::Apis::AppengineV1::Empty] parsed result object
248
+ # @yieldparam err [StandardError] error object if request failed
249
+ #
250
+ # @return [Google::Apis::AppengineV1::Empty]
251
+ #
252
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
253
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
254
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
255
+ def delete_app_authorized_certificate(apps_id, authorized_certificates_id, fields: nil, quota_user: nil, options: nil, &block)
256
+ command = make_simple_command(:delete, 'v1/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}', options)
257
+ command.response_representation = Google::Apis::AppengineV1::Empty::Representation
258
+ command.response_class = Google::Apis::AppengineV1::Empty
259
+ command.params['appsId'] = apps_id unless apps_id.nil?
260
+ command.params['authorizedCertificatesId'] = authorized_certificates_id unless authorized_certificates_id.nil?
261
+ command.query['fields'] = fields unless fields.nil?
262
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
263
+ execute_or_queue_command(command, &block)
264
+ end
265
+
266
+ # Gets the specified SSL certificate.
267
+ # @param [String] apps_id
268
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/
269
+ # authorizedCertificates/12345.
270
+ # @param [String] authorized_certificates_id
271
+ # Part of `name`. See documentation of `appsId`.
272
+ # @param [String] view
273
+ # Controls the set of fields returned in the GET response.
274
+ # @param [String] fields
275
+ # Selector specifying which fields to include in a partial response.
276
+ # @param [String] quota_user
277
+ # Available to use for quota purposes for server-side applications. Can be any
278
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
279
+ # @param [Google::Apis::RequestOptions] options
280
+ # Request-specific options
281
+ #
282
+ # @yield [result, err] Result & error if block supplied
283
+ # @yieldparam result [Google::Apis::AppengineV1::AuthorizedCertificate] parsed result object
284
+ # @yieldparam err [StandardError] error object if request failed
285
+ #
286
+ # @return [Google::Apis::AppengineV1::AuthorizedCertificate]
287
+ #
288
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
289
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
290
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
291
+ def get_app_authorized_certificate(apps_id, authorized_certificates_id, view: nil, fields: nil, quota_user: nil, options: nil, &block)
292
+ command = make_simple_command(:get, 'v1/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}', options)
293
+ command.response_representation = Google::Apis::AppengineV1::AuthorizedCertificate::Representation
294
+ command.response_class = Google::Apis::AppengineV1::AuthorizedCertificate
295
+ command.params['appsId'] = apps_id unless apps_id.nil?
296
+ command.params['authorizedCertificatesId'] = authorized_certificates_id unless authorized_certificates_id.nil?
297
+ command.query['view'] = view unless view.nil?
298
+ command.query['fields'] = fields unless fields.nil?
299
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
300
+ execute_or_queue_command(command, &block)
301
+ end
302
+
303
+ # Lists all SSL certificates the user is authorized to administer.
304
+ # @param [String] apps_id
305
+ # Part of `parent`. Name of the parent Application resource. Example: apps/myapp.
306
+ # @param [Fixnum] page_size
307
+ # Maximum results to return per page.
308
+ # @param [String] page_token
309
+ # Continuation token for fetching the next page of results.
310
+ # @param [String] view
311
+ # Controls the set of fields returned in the LIST response.
312
+ # @param [String] fields
313
+ # Selector specifying which fields to include in a partial response.
314
+ # @param [String] quota_user
315
+ # Available to use for quota purposes for server-side applications. Can be any
316
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
317
+ # @param [Google::Apis::RequestOptions] options
318
+ # Request-specific options
319
+ #
320
+ # @yield [result, err] Result & error if block supplied
321
+ # @yieldparam result [Google::Apis::AppengineV1::ListAuthorizedCertificatesResponse] parsed result object
322
+ # @yieldparam err [StandardError] error object if request failed
323
+ #
324
+ # @return [Google::Apis::AppengineV1::ListAuthorizedCertificatesResponse]
325
+ #
326
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
327
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
328
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
329
+ def list_app_authorized_certificates(apps_id, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
330
+ command = make_simple_command(:get, 'v1/apps/{appsId}/authorizedCertificates', options)
331
+ command.response_representation = Google::Apis::AppengineV1::ListAuthorizedCertificatesResponse::Representation
332
+ command.response_class = Google::Apis::AppengineV1::ListAuthorizedCertificatesResponse
333
+ command.params['appsId'] = apps_id unless apps_id.nil?
334
+ command.query['pageSize'] = page_size unless page_size.nil?
335
+ command.query['pageToken'] = page_token unless page_token.nil?
336
+ command.query['view'] = view unless view.nil?
337
+ command.query['fields'] = fields unless fields.nil?
338
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
339
+ execute_or_queue_command(command, &block)
340
+ end
341
+
342
+ # Updates the specified SSL certificate. To renew a certificate and maintain its
343
+ # existing domain mappings, update certificate_data with a new certificate. The
344
+ # new certificate must be applicable to the same domains as the original
345
+ # certificate. The certificate display_name may also be updated.
346
+ # @param [String] apps_id
347
+ # Part of `name`. Name of the resource to update. Example: apps/myapp/
348
+ # authorizedCertificates/12345.
349
+ # @param [String] authorized_certificates_id
350
+ # Part of `name`. See documentation of `appsId`.
351
+ # @param [Google::Apis::AppengineV1::AuthorizedCertificate] authorized_certificate_object
352
+ # @param [String] update_mask
353
+ # Standard field mask for the set of fields to be updated. Updates are only
354
+ # supported on the certificate_raw_data and display_name fields.
355
+ # @param [String] fields
356
+ # Selector specifying which fields to include in a partial response.
357
+ # @param [String] quota_user
358
+ # Available to use for quota purposes for server-side applications. Can be any
359
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
360
+ # @param [Google::Apis::RequestOptions] options
361
+ # Request-specific options
362
+ #
363
+ # @yield [result, err] Result & error if block supplied
364
+ # @yieldparam result [Google::Apis::AppengineV1::AuthorizedCertificate] parsed result object
365
+ # @yieldparam err [StandardError] error object if request failed
366
+ #
367
+ # @return [Google::Apis::AppengineV1::AuthorizedCertificate]
368
+ #
369
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
370
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
371
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
372
+ def patch_app_authorized_certificate(apps_id, authorized_certificates_id, authorized_certificate_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
373
+ command = make_simple_command(:patch, 'v1/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}', options)
374
+ command.request_representation = Google::Apis::AppengineV1::AuthorizedCertificate::Representation
375
+ command.request_object = authorized_certificate_object
376
+ command.response_representation = Google::Apis::AppengineV1::AuthorizedCertificate::Representation
377
+ command.response_class = Google::Apis::AppengineV1::AuthorizedCertificate
378
+ command.params['appsId'] = apps_id unless apps_id.nil?
379
+ command.params['authorizedCertificatesId'] = authorized_certificates_id unless authorized_certificates_id.nil?
380
+ command.query['updateMask'] = update_mask unless update_mask.nil?
381
+ command.query['fields'] = fields unless fields.nil?
382
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
383
+ execute_or_queue_command(command, &block)
384
+ end
385
+
386
+ # Lists all domains the user is authorized to administer.
387
+ # @param [String] apps_id
388
+ # Part of `parent`. Name of the parent Application resource. Example: apps/myapp.
389
+ # @param [Fixnum] page_size
390
+ # Maximum results to return per page.
391
+ # @param [String] page_token
392
+ # Continuation token for fetching the next page of results.
393
+ # @param [String] fields
394
+ # Selector specifying which fields to include in a partial response.
395
+ # @param [String] quota_user
396
+ # Available to use for quota purposes for server-side applications. Can be any
397
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
398
+ # @param [Google::Apis::RequestOptions] options
399
+ # Request-specific options
400
+ #
401
+ # @yield [result, err] Result & error if block supplied
402
+ # @yieldparam result [Google::Apis::AppengineV1::ListAuthorizedDomainsResponse] parsed result object
403
+ # @yieldparam err [StandardError] error object if request failed
404
+ #
405
+ # @return [Google::Apis::AppengineV1::ListAuthorizedDomainsResponse]
406
+ #
407
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
408
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
409
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
410
+ def list_app_authorized_domains(apps_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
411
+ command = make_simple_command(:get, 'v1/apps/{appsId}/authorizedDomains', options)
412
+ command.response_representation = Google::Apis::AppengineV1::ListAuthorizedDomainsResponse::Representation
413
+ command.response_class = Google::Apis::AppengineV1::ListAuthorizedDomainsResponse
414
+ command.params['appsId'] = apps_id unless apps_id.nil?
415
+ command.query['pageSize'] = page_size unless page_size.nil?
416
+ command.query['pageToken'] = page_token unless page_token.nil?
417
+ command.query['fields'] = fields unless fields.nil?
418
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
419
+ execute_or_queue_command(command, &block)
420
+ end
421
+
422
+ # Maps a domain to an application. A user must be authorized to administer a
423
+ # domain in order to map it to an application. For a list of available
424
+ # authorized domains, see AuthorizedDomains.ListAuthorizedDomains.
425
+ # @param [String] apps_id
426
+ # Part of `parent`. Name of the parent Application resource. Example: apps/myapp.
427
+ # @param [Google::Apis::AppengineV1::DomainMapping] domain_mapping_object
428
+ # @param [String] override_strategy
429
+ # Whether the domain creation should override any existing mappings for this
430
+ # domain. By default, overrides are rejected.
431
+ # @param [String] fields
432
+ # Selector specifying which fields to include in a partial response.
433
+ # @param [String] quota_user
434
+ # Available to use for quota purposes for server-side applications. Can be any
435
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
436
+ # @param [Google::Apis::RequestOptions] options
437
+ # Request-specific options
438
+ #
439
+ # @yield [result, err] Result & error if block supplied
440
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
441
+ # @yieldparam err [StandardError] error object if request failed
442
+ #
443
+ # @return [Google::Apis::AppengineV1::Operation]
444
+ #
445
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
446
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
447
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
448
+ def create_app_domain_mapping(apps_id, domain_mapping_object = nil, override_strategy: nil, fields: nil, quota_user: nil, options: nil, &block)
449
+ command = make_simple_command(:post, 'v1/apps/{appsId}/domainMappings', options)
450
+ command.request_representation = Google::Apis::AppengineV1::DomainMapping::Representation
451
+ command.request_object = domain_mapping_object
452
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
453
+ command.response_class = Google::Apis::AppengineV1::Operation
454
+ command.params['appsId'] = apps_id unless apps_id.nil?
455
+ command.query['overrideStrategy'] = override_strategy unless override_strategy.nil?
456
+ command.query['fields'] = fields unless fields.nil?
457
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
458
+ execute_or_queue_command(command, &block)
459
+ end
460
+
461
+ # Deletes the specified domain mapping. A user must be authorized to administer
462
+ # the associated domain in order to delete a DomainMapping resource.
463
+ # @param [String] apps_id
464
+ # Part of `name`. Name of the resource to delete. Example: apps/myapp/
465
+ # domainMappings/example.com.
466
+ # @param [String] domain_mappings_id
467
+ # Part of `name`. See documentation of `appsId`.
468
+ # @param [String] fields
469
+ # Selector specifying which fields to include in a partial response.
470
+ # @param [String] quota_user
471
+ # Available to use for quota purposes for server-side applications. Can be any
472
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
473
+ # @param [Google::Apis::RequestOptions] options
474
+ # Request-specific options
475
+ #
476
+ # @yield [result, err] Result & error if block supplied
477
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
478
+ # @yieldparam err [StandardError] error object if request failed
479
+ #
480
+ # @return [Google::Apis::AppengineV1::Operation]
481
+ #
482
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
483
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
484
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
485
+ def delete_app_domain_mapping(apps_id, domain_mappings_id, fields: nil, quota_user: nil, options: nil, &block)
486
+ command = make_simple_command(:delete, 'v1/apps/{appsId}/domainMappings/{domainMappingsId}', options)
487
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
488
+ command.response_class = Google::Apis::AppengineV1::Operation
489
+ command.params['appsId'] = apps_id unless apps_id.nil?
490
+ command.params['domainMappingsId'] = domain_mappings_id unless domain_mappings_id.nil?
491
+ command.query['fields'] = fields unless fields.nil?
492
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
493
+ execute_or_queue_command(command, &block)
494
+ end
495
+
496
+ # Gets the specified domain mapping.
497
+ # @param [String] apps_id
498
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/
499
+ # domainMappings/example.com.
500
+ # @param [String] domain_mappings_id
501
+ # Part of `name`. See documentation of `appsId`.
502
+ # @param [String] fields
503
+ # Selector specifying which fields to include in a partial response.
504
+ # @param [String] quota_user
505
+ # Available to use for quota purposes for server-side applications. Can be any
506
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
507
+ # @param [Google::Apis::RequestOptions] options
508
+ # Request-specific options
509
+ #
510
+ # @yield [result, err] Result & error if block supplied
511
+ # @yieldparam result [Google::Apis::AppengineV1::DomainMapping] parsed result object
512
+ # @yieldparam err [StandardError] error object if request failed
513
+ #
514
+ # @return [Google::Apis::AppengineV1::DomainMapping]
515
+ #
516
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
517
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
518
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
519
+ def get_app_domain_mapping(apps_id, domain_mappings_id, fields: nil, quota_user: nil, options: nil, &block)
520
+ command = make_simple_command(:get, 'v1/apps/{appsId}/domainMappings/{domainMappingsId}', options)
521
+ command.response_representation = Google::Apis::AppengineV1::DomainMapping::Representation
522
+ command.response_class = Google::Apis::AppengineV1::DomainMapping
523
+ command.params['appsId'] = apps_id unless apps_id.nil?
524
+ command.params['domainMappingsId'] = domain_mappings_id unless domain_mappings_id.nil?
525
+ command.query['fields'] = fields unless fields.nil?
526
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
527
+ execute_or_queue_command(command, &block)
528
+ end
529
+
530
+ # Lists the domain mappings on an application.
531
+ # @param [String] apps_id
532
+ # Part of `parent`. Name of the parent Application resource. Example: apps/myapp.
533
+ # @param [Fixnum] page_size
534
+ # Maximum results to return per page.
535
+ # @param [String] page_token
536
+ # Continuation token for fetching the next page of results.
537
+ # @param [String] fields
538
+ # Selector specifying which fields to include in a partial response.
539
+ # @param [String] quota_user
540
+ # Available to use for quota purposes for server-side applications. Can be any
541
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
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::AppengineV1::ListDomainMappingsResponse] parsed result object
547
+ # @yieldparam err [StandardError] error object if request failed
548
+ #
549
+ # @return [Google::Apis::AppengineV1::ListDomainMappingsResponse]
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_app_domain_mappings(apps_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
555
+ command = make_simple_command(:get, 'v1/apps/{appsId}/domainMappings', options)
556
+ command.response_representation = Google::Apis::AppengineV1::ListDomainMappingsResponse::Representation
557
+ command.response_class = Google::Apis::AppengineV1::ListDomainMappingsResponse
558
+ command.params['appsId'] = apps_id unless apps_id.nil?
559
+ command.query['pageSize'] = page_size unless page_size.nil?
560
+ command.query['pageToken'] = page_token unless page_token.nil?
561
+ command.query['fields'] = fields unless fields.nil?
562
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
563
+ execute_or_queue_command(command, &block)
564
+ end
565
+
566
+ # Updates the specified domain mapping. To map an SSL certificate to a domain
567
+ # mapping, update certificate_id to point to an AuthorizedCertificate resource.
568
+ # A user must be authorized to administer the associated domain in order to
569
+ # update a DomainMapping resource.
570
+ # @param [String] apps_id
571
+ # Part of `name`. Name of the resource to update. Example: apps/myapp/
572
+ # domainMappings/example.com.
573
+ # @param [String] domain_mappings_id
574
+ # Part of `name`. See documentation of `appsId`.
575
+ # @param [Google::Apis::AppengineV1::DomainMapping] domain_mapping_object
576
+ # @param [String] update_mask
577
+ # Standard field mask for the set of fields to be updated.
578
+ # @param [String] fields
579
+ # Selector specifying which fields to include in a partial response.
580
+ # @param [String] quota_user
581
+ # Available to use for quota purposes for server-side applications. Can be any
582
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
583
+ # @param [Google::Apis::RequestOptions] options
584
+ # Request-specific options
585
+ #
586
+ # @yield [result, err] Result & error if block supplied
587
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
588
+ # @yieldparam err [StandardError] error object if request failed
589
+ #
590
+ # @return [Google::Apis::AppengineV1::Operation]
591
+ #
592
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
593
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
594
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
595
+ def patch_app_domain_mapping(apps_id, domain_mappings_id, domain_mapping_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
596
+ command = make_simple_command(:patch, 'v1/apps/{appsId}/domainMappings/{domainMappingsId}', options)
597
+ command.request_representation = Google::Apis::AppengineV1::DomainMapping::Representation
598
+ command.request_object = domain_mapping_object
599
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
600
+ command.response_class = Google::Apis::AppengineV1::Operation
601
+ command.params['appsId'] = apps_id unless apps_id.nil?
602
+ command.params['domainMappingsId'] = domain_mappings_id unless domain_mappings_id.nil?
603
+ command.query['updateMask'] = update_mask unless update_mask.nil?
604
+ command.query['fields'] = fields unless fields.nil?
605
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
606
+ execute_or_queue_command(command, &block)
607
+ end
608
+
609
+ # Replaces the entire firewall ruleset in one bulk operation. This overrides and
610
+ # replaces the rules of an existing firewall with the new rules.If the final
611
+ # rule does not match traffic with the '*' wildcard IP range, then an "allow all"
612
+ # rule is explicitly added to the end of the list.
613
+ # @param [String] apps_id
614
+ # Part of `name`. Name of the Firewall collection to set. Example: apps/myapp/
615
+ # firewall/ingressRules.
616
+ # @param [Google::Apis::AppengineV1::BatchUpdateIngressRulesRequest] batch_update_ingress_rules_request_object
617
+ # @param [String] fields
618
+ # Selector specifying which fields to include in a partial response.
619
+ # @param [String] quota_user
620
+ # Available to use for quota purposes for server-side applications. Can be any
621
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
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::AppengineV1::BatchUpdateIngressRulesResponse] parsed result object
627
+ # @yieldparam err [StandardError] error object if request failed
628
+ #
629
+ # @return [Google::Apis::AppengineV1::BatchUpdateIngressRulesResponse]
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 batch_update_ingress_rules(apps_id, batch_update_ingress_rules_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
635
+ command = make_simple_command(:post, 'v1/apps/{appsId}/firewall/ingressRules:batchUpdate', options)
636
+ command.request_representation = Google::Apis::AppengineV1::BatchUpdateIngressRulesRequest::Representation
637
+ command.request_object = batch_update_ingress_rules_request_object
638
+ command.response_representation = Google::Apis::AppengineV1::BatchUpdateIngressRulesResponse::Representation
639
+ command.response_class = Google::Apis::AppengineV1::BatchUpdateIngressRulesResponse
640
+ command.params['appsId'] = apps_id unless apps_id.nil?
641
+ command.query['fields'] = fields unless fields.nil?
642
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
643
+ execute_or_queue_command(command, &block)
644
+ end
645
+
646
+ # Creates a firewall rule for the application.
647
+ # @param [String] apps_id
648
+ # Part of `parent`. Name of the parent Firewall collection in which to create a
649
+ # new rule. Example: apps/myapp/firewall/ingressRules.
650
+ # @param [Google::Apis::AppengineV1::FirewallRule] firewall_rule_object
651
+ # @param [String] fields
652
+ # Selector specifying which fields to include in a partial response.
653
+ # @param [String] quota_user
654
+ # Available to use for quota purposes for server-side applications. Can be any
655
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
656
+ # @param [Google::Apis::RequestOptions] options
657
+ # Request-specific options
658
+ #
659
+ # @yield [result, err] Result & error if block supplied
660
+ # @yieldparam result [Google::Apis::AppengineV1::FirewallRule] parsed result object
661
+ # @yieldparam err [StandardError] error object if request failed
662
+ #
663
+ # @return [Google::Apis::AppengineV1::FirewallRule]
664
+ #
665
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
666
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
667
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
668
+ def create_app_firewall_ingress_rule(apps_id, firewall_rule_object = nil, fields: nil, quota_user: nil, options: nil, &block)
669
+ command = make_simple_command(:post, 'v1/apps/{appsId}/firewall/ingressRules', options)
670
+ command.request_representation = Google::Apis::AppengineV1::FirewallRule::Representation
671
+ command.request_object = firewall_rule_object
672
+ command.response_representation = Google::Apis::AppengineV1::FirewallRule::Representation
673
+ command.response_class = Google::Apis::AppengineV1::FirewallRule
674
+ command.params['appsId'] = apps_id unless apps_id.nil?
675
+ command.query['fields'] = fields unless fields.nil?
676
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
677
+ execute_or_queue_command(command, &block)
678
+ end
679
+
680
+ # Deletes the specified firewall rule.
681
+ # @param [String] apps_id
682
+ # Part of `name`. Name of the Firewall resource to delete. Example: apps/myapp/
683
+ # firewall/ingressRules/100.
684
+ # @param [String] ingress_rules_id
685
+ # Part of `name`. See documentation of `appsId`.
686
+ # @param [String] fields
687
+ # Selector specifying which fields to include in a partial response.
688
+ # @param [String] quota_user
689
+ # Available to use for quota purposes for server-side applications. Can be any
690
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
691
+ # @param [Google::Apis::RequestOptions] options
692
+ # Request-specific options
693
+ #
694
+ # @yield [result, err] Result & error if block supplied
695
+ # @yieldparam result [Google::Apis::AppengineV1::Empty] parsed result object
696
+ # @yieldparam err [StandardError] error object if request failed
697
+ #
698
+ # @return [Google::Apis::AppengineV1::Empty]
699
+ #
700
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
701
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
702
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
703
+ def delete_app_firewall_ingress_rule(apps_id, ingress_rules_id, fields: nil, quota_user: nil, options: nil, &block)
704
+ command = make_simple_command(:delete, 'v1/apps/{appsId}/firewall/ingressRules/{ingressRulesId}', options)
705
+ command.response_representation = Google::Apis::AppengineV1::Empty::Representation
706
+ command.response_class = Google::Apis::AppengineV1::Empty
707
+ command.params['appsId'] = apps_id unless apps_id.nil?
708
+ command.params['ingressRulesId'] = ingress_rules_id unless ingress_rules_id.nil?
709
+ command.query['fields'] = fields unless fields.nil?
710
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
711
+ execute_or_queue_command(command, &block)
712
+ end
713
+
714
+ # Gets the specified firewall rule.
715
+ # @param [String] apps_id
716
+ # Part of `name`. Name of the Firewall resource to retrieve. Example: apps/myapp/
717
+ # firewall/ingressRules/100.
718
+ # @param [String] ingress_rules_id
719
+ # Part of `name`. See documentation of `appsId`.
720
+ # @param [String] fields
721
+ # Selector specifying which fields to include in a partial response.
722
+ # @param [String] quota_user
723
+ # Available to use for quota purposes for server-side applications. Can be any
724
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
725
+ # @param [Google::Apis::RequestOptions] options
726
+ # Request-specific options
727
+ #
728
+ # @yield [result, err] Result & error if block supplied
729
+ # @yieldparam result [Google::Apis::AppengineV1::FirewallRule] parsed result object
730
+ # @yieldparam err [StandardError] error object if request failed
731
+ #
732
+ # @return [Google::Apis::AppengineV1::FirewallRule]
733
+ #
734
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
735
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
736
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
737
+ def get_app_firewall_ingress_rule(apps_id, ingress_rules_id, fields: nil, quota_user: nil, options: nil, &block)
738
+ command = make_simple_command(:get, 'v1/apps/{appsId}/firewall/ingressRules/{ingressRulesId}', options)
739
+ command.response_representation = Google::Apis::AppengineV1::FirewallRule::Representation
740
+ command.response_class = Google::Apis::AppengineV1::FirewallRule
741
+ command.params['appsId'] = apps_id unless apps_id.nil?
742
+ command.params['ingressRulesId'] = ingress_rules_id unless ingress_rules_id.nil?
743
+ command.query['fields'] = fields unless fields.nil?
744
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
745
+ execute_or_queue_command(command, &block)
746
+ end
747
+
748
+ # Lists the firewall rules of an application.
749
+ # @param [String] apps_id
750
+ # Part of `parent`. Name of the Firewall collection to retrieve. Example: apps/
751
+ # myapp/firewall/ingressRules.
752
+ # @param [String] matching_address
753
+ # A valid IP Address. If set, only rules matching this address will be returned.
754
+ # The first returned rule will be the rule that fires on requests from this IP.
755
+ # @param [Fixnum] page_size
756
+ # Maximum results to return per page.
757
+ # @param [String] page_token
758
+ # Continuation token for fetching the next page of results.
759
+ # @param [String] fields
760
+ # Selector specifying which fields to include in a partial response.
761
+ # @param [String] quota_user
762
+ # Available to use for quota purposes for server-side applications. Can be any
763
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
764
+ # @param [Google::Apis::RequestOptions] options
765
+ # Request-specific options
766
+ #
767
+ # @yield [result, err] Result & error if block supplied
768
+ # @yieldparam result [Google::Apis::AppengineV1::ListIngressRulesResponse] parsed result object
769
+ # @yieldparam err [StandardError] error object if request failed
770
+ #
771
+ # @return [Google::Apis::AppengineV1::ListIngressRulesResponse]
772
+ #
773
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
774
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
775
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
776
+ def list_app_firewall_ingress_rules(apps_id, matching_address: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
777
+ command = make_simple_command(:get, 'v1/apps/{appsId}/firewall/ingressRules', options)
778
+ command.response_representation = Google::Apis::AppengineV1::ListIngressRulesResponse::Representation
779
+ command.response_class = Google::Apis::AppengineV1::ListIngressRulesResponse
780
+ command.params['appsId'] = apps_id unless apps_id.nil?
781
+ command.query['matchingAddress'] = matching_address unless matching_address.nil?
782
+ command.query['pageSize'] = page_size unless page_size.nil?
783
+ command.query['pageToken'] = page_token unless page_token.nil?
784
+ command.query['fields'] = fields unless fields.nil?
785
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
786
+ execute_or_queue_command(command, &block)
787
+ end
788
+
789
+ # Updates the specified firewall rule.
790
+ # @param [String] apps_id
791
+ # Part of `name`. Name of the Firewall resource to update. Example: apps/myapp/
792
+ # firewall/ingressRules/100.
793
+ # @param [String] ingress_rules_id
794
+ # Part of `name`. See documentation of `appsId`.
795
+ # @param [Google::Apis::AppengineV1::FirewallRule] firewall_rule_object
796
+ # @param [String] update_mask
797
+ # Standard field mask for the set of fields to be updated.
798
+ # @param [String] fields
799
+ # Selector specifying which fields to include in a partial response.
800
+ # @param [String] quota_user
801
+ # Available to use for quota purposes for server-side applications. Can be any
802
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
803
+ # @param [Google::Apis::RequestOptions] options
804
+ # Request-specific options
805
+ #
806
+ # @yield [result, err] Result & error if block supplied
807
+ # @yieldparam result [Google::Apis::AppengineV1::FirewallRule] parsed result object
808
+ # @yieldparam err [StandardError] error object if request failed
809
+ #
810
+ # @return [Google::Apis::AppengineV1::FirewallRule]
811
+ #
812
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
813
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
814
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
815
+ def patch_app_firewall_ingress_rule(apps_id, ingress_rules_id, firewall_rule_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
816
+ command = make_simple_command(:patch, 'v1/apps/{appsId}/firewall/ingressRules/{ingressRulesId}', options)
817
+ command.request_representation = Google::Apis::AppengineV1::FirewallRule::Representation
818
+ command.request_object = firewall_rule_object
819
+ command.response_representation = Google::Apis::AppengineV1::FirewallRule::Representation
820
+ command.response_class = Google::Apis::AppengineV1::FirewallRule
821
+ command.params['appsId'] = apps_id unless apps_id.nil?
822
+ command.params['ingressRulesId'] = ingress_rules_id unless ingress_rules_id.nil?
823
+ command.query['updateMask'] = update_mask unless update_mask.nil?
824
+ command.query['fields'] = fields unless fields.nil?
825
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
826
+ execute_or_queue_command(command, &block)
827
+ end
828
+
829
+ # Gets information about a location.
830
+ # @param [String] apps_id
831
+ # Part of `name`. Resource name for the location.
832
+ # @param [String] locations_id
833
+ # Part of `name`. See documentation of `appsId`.
834
+ # @param [String] fields
835
+ # Selector specifying which fields to include in a partial response.
836
+ # @param [String] quota_user
837
+ # Available to use for quota purposes for server-side applications. Can be any
838
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
839
+ # @param [Google::Apis::RequestOptions] options
840
+ # Request-specific options
841
+ #
842
+ # @yield [result, err] Result & error if block supplied
843
+ # @yieldparam result [Google::Apis::AppengineV1::Location] parsed result object
844
+ # @yieldparam err [StandardError] error object if request failed
845
+ #
846
+ # @return [Google::Apis::AppengineV1::Location]
847
+ #
848
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
849
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
850
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
851
+ def get_app_location(apps_id, locations_id, fields: nil, quota_user: nil, options: nil, &block)
852
+ command = make_simple_command(:get, 'v1/apps/{appsId}/locations/{locationsId}', options)
853
+ command.response_representation = Google::Apis::AppengineV1::Location::Representation
854
+ command.response_class = Google::Apis::AppengineV1::Location
855
+ command.params['appsId'] = apps_id unless apps_id.nil?
856
+ command.params['locationsId'] = locations_id unless locations_id.nil?
857
+ command.query['fields'] = fields unless fields.nil?
858
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
859
+ execute_or_queue_command(command, &block)
860
+ end
861
+
862
+ # Lists information about the supported locations for this service.
863
+ # @param [String] apps_id
864
+ # Part of `name`. The resource that owns the locations collection, if applicable.
865
+ # @param [String] filter
866
+ # The standard list filter.
867
+ # @param [Fixnum] page_size
868
+ # The standard list page size.
869
+ # @param [String] page_token
870
+ # The standard list page token.
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::AppengineV1::ListLocationsResponse] parsed result object
881
+ # @yieldparam err [StandardError] error object if request failed
882
+ #
883
+ # @return [Google::Apis::AppengineV1::ListLocationsResponse]
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 list_app_locations(apps_id, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
889
+ command = make_simple_command(:get, 'v1/apps/{appsId}/locations', options)
890
+ command.response_representation = Google::Apis::AppengineV1::ListLocationsResponse::Representation
891
+ command.response_class = Google::Apis::AppengineV1::ListLocationsResponse
892
+ command.params['appsId'] = apps_id unless apps_id.nil?
893
+ command.query['filter'] = filter unless filter.nil?
894
+ command.query['pageSize'] = page_size unless page_size.nil?
895
+ command.query['pageToken'] = page_token unless page_token.nil?
896
+ command.query['fields'] = fields unless fields.nil?
897
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
898
+ execute_or_queue_command(command, &block)
899
+ end
900
+
901
+ # Gets the latest state of a long-running operation. Clients can use this method
902
+ # to poll the operation result at intervals as recommended by the API service.
903
+ # @param [String] apps_id
904
+ # Part of `name`. The name of the operation resource.
905
+ # @param [String] operations_id
906
+ # Part of `name`. See documentation of `appsId`.
907
+ # @param [String] fields
908
+ # Selector specifying which fields to include in a partial response.
909
+ # @param [String] quota_user
910
+ # Available to use for quota purposes for server-side applications. Can be any
911
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
912
+ # @param [Google::Apis::RequestOptions] options
913
+ # Request-specific options
914
+ #
915
+ # @yield [result, err] Result & error if block supplied
916
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
917
+ # @yieldparam err [StandardError] error object if request failed
918
+ #
919
+ # @return [Google::Apis::AppengineV1::Operation]
920
+ #
921
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
922
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
923
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
924
+ def get_app_operation(apps_id, operations_id, fields: nil, quota_user: nil, options: nil, &block)
925
+ command = make_simple_command(:get, 'v1/apps/{appsId}/operations/{operationsId}', options)
926
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
927
+ command.response_class = Google::Apis::AppengineV1::Operation
928
+ command.params['appsId'] = apps_id unless apps_id.nil?
929
+ command.params['operationsId'] = operations_id unless operations_id.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
+ # Lists operations that match the specified filter in the request. If the server
936
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
937
+ # allows API services to override the binding to use different resource name
938
+ # schemes, such as users/*/operations. To override the binding, API services can
939
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
940
+ # configuration. For backwards compatibility, the default name includes the
941
+ # operations collection id, however overriding users must ensure the name
942
+ # binding is the parent resource, without the operations collection id.
943
+ # @param [String] apps_id
944
+ # Part of `name`. The name of the operation's parent resource.
945
+ # @param [String] filter
946
+ # The standard list filter.
947
+ # @param [Fixnum] page_size
948
+ # The standard list page size.
949
+ # @param [String] page_token
950
+ # The standard list page token.
951
+ # @param [String] fields
952
+ # Selector specifying which fields to include in a partial response.
953
+ # @param [String] quota_user
954
+ # Available to use for quota purposes for server-side applications. Can be any
955
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
956
+ # @param [Google::Apis::RequestOptions] options
957
+ # Request-specific options
958
+ #
959
+ # @yield [result, err] Result & error if block supplied
960
+ # @yieldparam result [Google::Apis::AppengineV1::ListOperationsResponse] parsed result object
961
+ # @yieldparam err [StandardError] error object if request failed
962
+ #
963
+ # @return [Google::Apis::AppengineV1::ListOperationsResponse]
964
+ #
965
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
966
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
967
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
968
+ def list_app_operations(apps_id, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
969
+ command = make_simple_command(:get, 'v1/apps/{appsId}/operations', options)
970
+ command.response_representation = Google::Apis::AppengineV1::ListOperationsResponse::Representation
971
+ command.response_class = Google::Apis::AppengineV1::ListOperationsResponse
972
+ command.params['appsId'] = apps_id unless apps_id.nil?
973
+ command.query['filter'] = filter unless filter.nil?
974
+ command.query['pageSize'] = page_size unless page_size.nil?
975
+ command.query['pageToken'] = page_token unless page_token.nil?
976
+ command.query['fields'] = fields unless fields.nil?
977
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
978
+ execute_or_queue_command(command, &block)
979
+ end
980
+
981
+ # Deletes the specified service and all enclosed versions.
982
+ # @param [String] apps_id
983
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/services/
984
+ # default.
985
+ # @param [String] services_id
986
+ # Part of `name`. See documentation of `appsId`.
987
+ # @param [String] fields
988
+ # Selector specifying which fields to include in a partial response.
989
+ # @param [String] quota_user
990
+ # Available to use for quota purposes for server-side applications. Can be any
991
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
992
+ # @param [Google::Apis::RequestOptions] options
993
+ # Request-specific options
994
+ #
995
+ # @yield [result, err] Result & error if block supplied
996
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
997
+ # @yieldparam err [StandardError] error object if request failed
998
+ #
999
+ # @return [Google::Apis::AppengineV1::Operation]
1000
+ #
1001
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1002
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1003
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1004
+ def delete_app_service(apps_id, services_id, fields: nil, quota_user: nil, options: nil, &block)
1005
+ command = make_simple_command(:delete, 'v1/apps/{appsId}/services/{servicesId}', options)
1006
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
1007
+ command.response_class = Google::Apis::AppengineV1::Operation
1008
+ command.params['appsId'] = apps_id unless apps_id.nil?
1009
+ command.params['servicesId'] = services_id unless services_id.nil?
1010
+ command.query['fields'] = fields unless fields.nil?
1011
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1012
+ execute_or_queue_command(command, &block)
1013
+ end
1014
+
1015
+ # Gets the current configuration of the specified service.
1016
+ # @param [String] apps_id
1017
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/services/
1018
+ # default.
1019
+ # @param [String] services_id
1020
+ # Part of `name`. See documentation of `appsId`.
1021
+ # @param [String] fields
1022
+ # Selector specifying which fields to include in a partial response.
1023
+ # @param [String] quota_user
1024
+ # Available to use for quota purposes for server-side applications. Can be any
1025
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1026
+ # @param [Google::Apis::RequestOptions] options
1027
+ # Request-specific options
1028
+ #
1029
+ # @yield [result, err] Result & error if block supplied
1030
+ # @yieldparam result [Google::Apis::AppengineV1::Service] parsed result object
1031
+ # @yieldparam err [StandardError] error object if request failed
1032
+ #
1033
+ # @return [Google::Apis::AppengineV1::Service]
1034
+ #
1035
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1036
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1037
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1038
+ def get_app_service(apps_id, services_id, fields: nil, quota_user: nil, options: nil, &block)
1039
+ command = make_simple_command(:get, 'v1/apps/{appsId}/services/{servicesId}', options)
1040
+ command.response_representation = Google::Apis::AppengineV1::Service::Representation
1041
+ command.response_class = Google::Apis::AppengineV1::Service
1042
+ command.params['appsId'] = apps_id unless apps_id.nil?
1043
+ command.params['servicesId'] = services_id unless services_id.nil?
1044
+ command.query['fields'] = fields unless fields.nil?
1045
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1046
+ execute_or_queue_command(command, &block)
1047
+ end
1048
+
1049
+ # Lists all the services in the application.
1050
+ # @param [String] apps_id
1051
+ # Part of `parent`. Name of the parent Application resource. Example: apps/myapp.
1052
+ # @param [Fixnum] page_size
1053
+ # Maximum results to return per page.
1054
+ # @param [String] page_token
1055
+ # Continuation token for fetching the next page of results.
1056
+ # @param [String] fields
1057
+ # Selector specifying which fields to include in a partial response.
1058
+ # @param [String] quota_user
1059
+ # Available to use for quota purposes for server-side applications. Can be any
1060
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1061
+ # @param [Google::Apis::RequestOptions] options
1062
+ # Request-specific options
1063
+ #
1064
+ # @yield [result, err] Result & error if block supplied
1065
+ # @yieldparam result [Google::Apis::AppengineV1::ListServicesResponse] parsed result object
1066
+ # @yieldparam err [StandardError] error object if request failed
1067
+ #
1068
+ # @return [Google::Apis::AppengineV1::ListServicesResponse]
1069
+ #
1070
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1071
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1072
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1073
+ def list_app_services(apps_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1074
+ command = make_simple_command(:get, 'v1/apps/{appsId}/services', options)
1075
+ command.response_representation = Google::Apis::AppengineV1::ListServicesResponse::Representation
1076
+ command.response_class = Google::Apis::AppengineV1::ListServicesResponse
1077
+ command.params['appsId'] = apps_id unless apps_id.nil?
1078
+ command.query['pageSize'] = page_size unless page_size.nil?
1079
+ command.query['pageToken'] = page_token unless page_token.nil?
1080
+ command.query['fields'] = fields unless fields.nil?
1081
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1082
+ execute_or_queue_command(command, &block)
1083
+ end
1084
+
1085
+ # Updates the configuration of the specified service.
1086
+ # @param [String] apps_id
1087
+ # Part of `name`. Name of the resource to update. Example: apps/myapp/services/
1088
+ # default.
1089
+ # @param [String] services_id
1090
+ # Part of `name`. See documentation of `appsId`.
1091
+ # @param [Google::Apis::AppengineV1::Service] service_object
1092
+ # @param [Boolean] migrate_traffic
1093
+ # Set to true to gradually shift traffic to one or more versions that you
1094
+ # specify. By default, traffic is shifted immediately. For gradual traffic
1095
+ # migration, the target versions must be located within instances that are
1096
+ # configured for both warmup requests (https://cloud.google.com/appengine/docs/
1097
+ # admin-api/reference/rest/v1/apps.services.versions#InboundServiceType) and
1098
+ # automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/
1099
+ # rest/v1/apps.services.versions#AutomaticScaling). You must specify the shardBy
1100
+ # (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.
1101
+ # services#ShardBy) field in the Service resource. Gradual traffic migration is
1102
+ # not supported in the App Engine flexible environment. For examples, see
1103
+ # Migrating and Splitting Traffic (https://cloud.google.com/appengine/docs/admin-
1104
+ # api/migrating-splitting-traffic).
1105
+ # @param [String] update_mask
1106
+ # Standard field mask for the set of fields to be updated.
1107
+ # @param [String] fields
1108
+ # Selector specifying which fields to include in a partial response.
1109
+ # @param [String] quota_user
1110
+ # Available to use for quota purposes for server-side applications. Can be any
1111
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1112
+ # @param [Google::Apis::RequestOptions] options
1113
+ # Request-specific options
1114
+ #
1115
+ # @yield [result, err] Result & error if block supplied
1116
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
1117
+ # @yieldparam err [StandardError] error object if request failed
1118
+ #
1119
+ # @return [Google::Apis::AppengineV1::Operation]
1120
+ #
1121
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1122
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1123
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1124
+ def patch_app_service(apps_id, services_id, service_object = nil, migrate_traffic: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1125
+ command = make_simple_command(:patch, 'v1/apps/{appsId}/services/{servicesId}', options)
1126
+ command.request_representation = Google::Apis::AppengineV1::Service::Representation
1127
+ command.request_object = service_object
1128
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
1129
+ command.response_class = Google::Apis::AppengineV1::Operation
1130
+ command.params['appsId'] = apps_id unless apps_id.nil?
1131
+ command.params['servicesId'] = services_id unless services_id.nil?
1132
+ command.query['migrateTraffic'] = migrate_traffic unless migrate_traffic.nil?
1133
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1134
+ command.query['fields'] = fields unless fields.nil?
1135
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1136
+ execute_or_queue_command(command, &block)
1137
+ end
1138
+
1139
+ # Deploys code and resource files to a new version.
1140
+ # @param [String] apps_id
1141
+ # Part of `parent`. Name of the parent resource to create this version under.
1142
+ # Example: apps/myapp/services/default.
1143
+ # @param [String] services_id
1144
+ # Part of `parent`. See documentation of `appsId`.
1145
+ # @param [Google::Apis::AppengineV1::Version] version_object
1146
+ # @param [String] fields
1147
+ # Selector specifying which fields to include in a partial response.
1148
+ # @param [String] quota_user
1149
+ # Available to use for quota purposes for server-side applications. Can be any
1150
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1151
+ # @param [Google::Apis::RequestOptions] options
1152
+ # Request-specific options
1153
+ #
1154
+ # @yield [result, err] Result & error if block supplied
1155
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
1156
+ # @yieldparam err [StandardError] error object if request failed
1157
+ #
1158
+ # @return [Google::Apis::AppengineV1::Operation]
1159
+ #
1160
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1161
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1162
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1163
+ def create_app_service_version(apps_id, services_id, version_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1164
+ command = make_simple_command(:post, 'v1/apps/{appsId}/services/{servicesId}/versions', options)
1165
+ command.request_representation = Google::Apis::AppengineV1::Version::Representation
1166
+ command.request_object = version_object
1167
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
1168
+ command.response_class = Google::Apis::AppengineV1::Operation
1169
+ command.params['appsId'] = apps_id unless apps_id.nil?
1170
+ command.params['servicesId'] = services_id unless services_id.nil?
1171
+ command.query['fields'] = fields unless fields.nil?
1172
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1173
+ execute_or_queue_command(command, &block)
1174
+ end
1175
+
1176
+ # Deletes an existing Version resource.
1177
+ # @param [String] apps_id
1178
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/services/
1179
+ # default/versions/v1.
1180
+ # @param [String] services_id
1181
+ # Part of `name`. See documentation of `appsId`.
1182
+ # @param [String] versions_id
1183
+ # Part of `name`. See documentation of `appsId`.
1184
+ # @param [String] fields
1185
+ # Selector specifying which fields to include in a partial response.
1186
+ # @param [String] quota_user
1187
+ # Available to use for quota purposes for server-side applications. Can be any
1188
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1189
+ # @param [Google::Apis::RequestOptions] options
1190
+ # Request-specific options
1191
+ #
1192
+ # @yield [result, err] Result & error if block supplied
1193
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
1194
+ # @yieldparam err [StandardError] error object if request failed
1195
+ #
1196
+ # @return [Google::Apis::AppengineV1::Operation]
1197
+ #
1198
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1199
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1200
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1201
+ def delete_app_service_version(apps_id, services_id, versions_id, fields: nil, quota_user: nil, options: nil, &block)
1202
+ command = make_simple_command(:delete, 'v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}', options)
1203
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
1204
+ command.response_class = Google::Apis::AppengineV1::Operation
1205
+ command.params['appsId'] = apps_id unless apps_id.nil?
1206
+ command.params['servicesId'] = services_id unless services_id.nil?
1207
+ command.params['versionsId'] = versions_id unless versions_id.nil?
1208
+ command.query['fields'] = fields unless fields.nil?
1209
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1210
+ execute_or_queue_command(command, &block)
1211
+ end
1212
+
1213
+ # Gets the specified Version resource. By default, only a BASIC_VIEW will be
1214
+ # returned. Specify the FULL_VIEW parameter to get the full resource.
1215
+ # @param [String] apps_id
1216
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/services/
1217
+ # default/versions/v1.
1218
+ # @param [String] services_id
1219
+ # Part of `name`. See documentation of `appsId`.
1220
+ # @param [String] versions_id
1221
+ # Part of `name`. See documentation of `appsId`.
1222
+ # @param [String] view
1223
+ # Controls the set of fields returned in the Get response.
1224
+ # @param [String] fields
1225
+ # Selector specifying which fields to include in a partial response.
1226
+ # @param [String] quota_user
1227
+ # Available to use for quota purposes for server-side applications. Can be any
1228
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1229
+ # @param [Google::Apis::RequestOptions] options
1230
+ # Request-specific options
1231
+ #
1232
+ # @yield [result, err] Result & error if block supplied
1233
+ # @yieldparam result [Google::Apis::AppengineV1::Version] parsed result object
1234
+ # @yieldparam err [StandardError] error object if request failed
1235
+ #
1236
+ # @return [Google::Apis::AppengineV1::Version]
1237
+ #
1238
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1239
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1240
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1241
+ def get_app_service_version(apps_id, services_id, versions_id, view: nil, fields: nil, quota_user: nil, options: nil, &block)
1242
+ command = make_simple_command(:get, 'v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}', options)
1243
+ command.response_representation = Google::Apis::AppengineV1::Version::Representation
1244
+ command.response_class = Google::Apis::AppengineV1::Version
1245
+ command.params['appsId'] = apps_id unless apps_id.nil?
1246
+ command.params['servicesId'] = services_id unless services_id.nil?
1247
+ command.params['versionsId'] = versions_id unless versions_id.nil?
1248
+ command.query['view'] = view unless view.nil?
1249
+ command.query['fields'] = fields unless fields.nil?
1250
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1251
+ execute_or_queue_command(command, &block)
1252
+ end
1253
+
1254
+ # Lists the versions of a service.
1255
+ # @param [String] apps_id
1256
+ # Part of `parent`. Name of the parent Service resource. Example: apps/myapp/
1257
+ # services/default.
1258
+ # @param [String] services_id
1259
+ # Part of `parent`. See documentation of `appsId`.
1260
+ # @param [Fixnum] page_size
1261
+ # Maximum results to return per page.
1262
+ # @param [String] page_token
1263
+ # Continuation token for fetching the next page of results.
1264
+ # @param [String] view
1265
+ # Controls the set of fields returned in the List response.
1266
+ # @param [String] fields
1267
+ # Selector specifying which fields to include in a partial response.
1268
+ # @param [String] quota_user
1269
+ # Available to use for quota purposes for server-side applications. Can be any
1270
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1271
+ # @param [Google::Apis::RequestOptions] options
1272
+ # Request-specific options
1273
+ #
1274
+ # @yield [result, err] Result & error if block supplied
1275
+ # @yieldparam result [Google::Apis::AppengineV1::ListVersionsResponse] parsed result object
1276
+ # @yieldparam err [StandardError] error object if request failed
1277
+ #
1278
+ # @return [Google::Apis::AppengineV1::ListVersionsResponse]
1279
+ #
1280
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1281
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1282
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1283
+ def list_app_service_versions(apps_id, services_id, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
1284
+ command = make_simple_command(:get, 'v1/apps/{appsId}/services/{servicesId}/versions', options)
1285
+ command.response_representation = Google::Apis::AppengineV1::ListVersionsResponse::Representation
1286
+ command.response_class = Google::Apis::AppengineV1::ListVersionsResponse
1287
+ command.params['appsId'] = apps_id unless apps_id.nil?
1288
+ command.params['servicesId'] = services_id unless services_id.nil?
1289
+ command.query['pageSize'] = page_size unless page_size.nil?
1290
+ command.query['pageToken'] = page_token unless page_token.nil?
1291
+ command.query['view'] = view unless view.nil?
1292
+ command.query['fields'] = fields unless fields.nil?
1293
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1294
+ execute_or_queue_command(command, &block)
1295
+ end
1296
+
1297
+ # Updates the specified Version resource. You can specify the following fields
1298
+ # depending on the App Engine environment and type of scaling that the version
1299
+ # resource uses:Standard environment instance_class (https://cloud.google.com/
1300
+ # appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.
1301
+ # FIELDS.instance_class)automatic scaling in the standard environment:
1302
+ # automatic_scaling.min_idle_instances (https://cloud.google.com/appengine/docs/
1303
+ # admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.
1304
+ # automatic_scaling) automatic_scaling.max_idle_instances (https://cloud.google.
1305
+ # com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.
1306
+ # FIELDS.automatic_scaling) automaticScaling.standard_scheduler_settings.
1307
+ # max_instances (https://cloud.google.com/appengine/docs/admin-api/reference/
1308
+ # rest/v1/apps.services.versions#StandardSchedulerSettings) automaticScaling.
1309
+ # standard_scheduler_settings.min_instances (https://cloud.google.com/appengine/
1310
+ # docs/admin-api/reference/rest/v1/apps.services.versions#
1311
+ # StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.
1312
+ # target_cpu_utilization (https://cloud.google.com/appengine/docs/admin-api/
1313
+ # reference/rest/v1/apps.services.versions#StandardSchedulerSettings)
1314
+ # automaticScaling.standard_scheduler_settings.target_throughput_utilization (
1315
+ # https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.
1316
+ # services.versions#StandardSchedulerSettings)basic scaling or manual scaling in
1317
+ # the standard environment: serving_status (https://cloud.google.com/appengine/
1318
+ # docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.
1319
+ # serving_status) manual_scaling.instances (https://cloud.google.com/appengine/
1320
+ # docs/admin-api/reference/rest/v1/apps.services.versions#manualscaling)Flexible
1321
+ # environment serving_status (https://cloud.google.com/appengine/docs/admin-api/
1322
+ # reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status)
1323
+ # automatic scaling in the flexible environment: automatic_scaling.
1324
+ # min_total_instances (https://cloud.google.com/appengine/docs/admin-api/
1325
+ # reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling)
1326
+ # automatic_scaling.max_total_instances (https://cloud.google.com/appengine/docs/
1327
+ # admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.
1328
+ # automatic_scaling) automatic_scaling.cool_down_period_sec (https://cloud.
1329
+ # google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#
1330
+ # Version.FIELDS.automatic_scaling) automatic_scaling.cpu_utilization.
1331
+ # target_utilization (https://cloud.google.com/appengine/docs/admin-api/
1332
+ # reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling)
1333
+ # manual scaling in the flexible environment: manual_scaling.instances (https://
1334
+ # cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.
1335
+ # versions#manualscaling)
1336
+ # @param [String] apps_id
1337
+ # Part of `name`. Name of the resource to update. Example: apps/myapp/services/
1338
+ # default/versions/1.
1339
+ # @param [String] services_id
1340
+ # Part of `name`. See documentation of `appsId`.
1341
+ # @param [String] versions_id
1342
+ # Part of `name`. See documentation of `appsId`.
1343
+ # @param [Google::Apis::AppengineV1::Version] version_object
1344
+ # @param [String] update_mask
1345
+ # Standard field mask for the set of fields to be updated.
1346
+ # @param [String] fields
1347
+ # Selector specifying which fields to include in a partial response.
1348
+ # @param [String] quota_user
1349
+ # Available to use for quota purposes for server-side applications. Can be any
1350
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1351
+ # @param [Google::Apis::RequestOptions] options
1352
+ # Request-specific options
1353
+ #
1354
+ # @yield [result, err] Result & error if block supplied
1355
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
1356
+ # @yieldparam err [StandardError] error object if request failed
1357
+ #
1358
+ # @return [Google::Apis::AppengineV1::Operation]
1359
+ #
1360
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1361
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1362
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1363
+ def patch_app_service_version(apps_id, services_id, versions_id, version_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1364
+ command = make_simple_command(:patch, 'v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}', options)
1365
+ command.request_representation = Google::Apis::AppengineV1::Version::Representation
1366
+ command.request_object = version_object
1367
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
1368
+ command.response_class = Google::Apis::AppengineV1::Operation
1369
+ command.params['appsId'] = apps_id unless apps_id.nil?
1370
+ command.params['servicesId'] = services_id unless services_id.nil?
1371
+ command.params['versionsId'] = versions_id unless versions_id.nil?
1372
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1373
+ command.query['fields'] = fields unless fields.nil?
1374
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1375
+ execute_or_queue_command(command, &block)
1376
+ end
1377
+
1378
+ # Enables debugging on a VM instance. This allows you to use the SSH command to
1379
+ # connect to the virtual machine where the instance lives. While in "debug mode",
1380
+ # the instance continues to serve live traffic. You should delete the instance
1381
+ # when you are done debugging and then allow the system to take over and
1382
+ # determine if another instance should be started.Only applicable for instances
1383
+ # in App Engine flexible environment.
1384
+ # @param [String] apps_id
1385
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/services/
1386
+ # default/versions/v1/instances/instance-1.
1387
+ # @param [String] services_id
1388
+ # Part of `name`. See documentation of `appsId`.
1389
+ # @param [String] versions_id
1390
+ # Part of `name`. See documentation of `appsId`.
1391
+ # @param [String] instances_id
1392
+ # Part of `name`. See documentation of `appsId`.
1393
+ # @param [Google::Apis::AppengineV1::DebugInstanceRequest] debug_instance_request_object
1394
+ # @param [String] fields
1395
+ # Selector specifying which fields to include in a partial response.
1396
+ # @param [String] quota_user
1397
+ # Available to use for quota purposes for server-side applications. Can be any
1398
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1399
+ # @param [Google::Apis::RequestOptions] options
1400
+ # Request-specific options
1401
+ #
1402
+ # @yield [result, err] Result & error if block supplied
1403
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
1404
+ # @yieldparam err [StandardError] error object if request failed
1405
+ #
1406
+ # @return [Google::Apis::AppengineV1::Operation]
1407
+ #
1408
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1409
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1410
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1411
+ def debug_instance(apps_id, services_id, versions_id, instances_id, debug_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1412
+ command = make_simple_command(:post, 'v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}:debug', options)
1413
+ command.request_representation = Google::Apis::AppengineV1::DebugInstanceRequest::Representation
1414
+ command.request_object = debug_instance_request_object
1415
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
1416
+ command.response_class = Google::Apis::AppengineV1::Operation
1417
+ command.params['appsId'] = apps_id unless apps_id.nil?
1418
+ command.params['servicesId'] = services_id unless services_id.nil?
1419
+ command.params['versionsId'] = versions_id unless versions_id.nil?
1420
+ command.params['instancesId'] = instances_id unless instances_id.nil?
1421
+ command.query['fields'] = fields unless fields.nil?
1422
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1423
+ execute_or_queue_command(command, &block)
1424
+ end
1425
+
1426
+ # Stops a running instance.The instance might be automatically recreated based
1427
+ # on the scaling settings of the version. For more information, see "How
1428
+ # Instances are Managed" (standard environment (https://cloud.google.com/
1429
+ # appengine/docs/standard/python/how-instances-are-managed) | flexible
1430
+ # environment (https://cloud.google.com/appengine/docs/flexible/python/how-
1431
+ # instances-are-managed)).To ensure that instances are not re-created and avoid
1432
+ # getting billed, you can stop all instances within the target version by
1433
+ # changing the serving status of the version to STOPPED with the apps.services.
1434
+ # versions.patch (https://cloud.google.com/appengine/docs/admin-api/reference/
1435
+ # rest/v1/apps.services.versions/patch) method.
1436
+ # @param [String] apps_id
1437
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/services/
1438
+ # default/versions/v1/instances/instance-1.
1439
+ # @param [String] services_id
1440
+ # Part of `name`. See documentation of `appsId`.
1441
+ # @param [String] versions_id
1442
+ # Part of `name`. See documentation of `appsId`.
1443
+ # @param [String] instances_id
1444
+ # Part of `name`. See documentation of `appsId`.
1445
+ # @param [String] fields
1446
+ # Selector specifying which fields to include in a partial response.
1447
+ # @param [String] quota_user
1448
+ # Available to use for quota purposes for server-side applications. Can be any
1449
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1450
+ # @param [Google::Apis::RequestOptions] options
1451
+ # Request-specific options
1452
+ #
1453
+ # @yield [result, err] Result & error if block supplied
1454
+ # @yieldparam result [Google::Apis::AppengineV1::Operation] parsed result object
1455
+ # @yieldparam err [StandardError] error object if request failed
1456
+ #
1457
+ # @return [Google::Apis::AppengineV1::Operation]
1458
+ #
1459
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1460
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1461
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1462
+ def delete_app_service_version_instance(apps_id, services_id, versions_id, instances_id, fields: nil, quota_user: nil, options: nil, &block)
1463
+ command = make_simple_command(:delete, 'v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}', options)
1464
+ command.response_representation = Google::Apis::AppengineV1::Operation::Representation
1465
+ command.response_class = Google::Apis::AppengineV1::Operation
1466
+ command.params['appsId'] = apps_id unless apps_id.nil?
1467
+ command.params['servicesId'] = services_id unless services_id.nil?
1468
+ command.params['versionsId'] = versions_id unless versions_id.nil?
1469
+ command.params['instancesId'] = instances_id unless instances_id.nil?
1470
+ command.query['fields'] = fields unless fields.nil?
1471
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1472
+ execute_or_queue_command(command, &block)
1473
+ end
1474
+
1475
+ # Gets instance information.
1476
+ # @param [String] apps_id
1477
+ # Part of `name`. Name of the resource requested. Example: apps/myapp/services/
1478
+ # default/versions/v1/instances/instance-1.
1479
+ # @param [String] services_id
1480
+ # Part of `name`. See documentation of `appsId`.
1481
+ # @param [String] versions_id
1482
+ # Part of `name`. See documentation of `appsId`.
1483
+ # @param [String] instances_id
1484
+ # Part of `name`. See documentation of `appsId`.
1485
+ # @param [String] fields
1486
+ # Selector specifying which fields to include in a partial response.
1487
+ # @param [String] quota_user
1488
+ # Available to use for quota purposes for server-side applications. Can be any
1489
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1490
+ # @param [Google::Apis::RequestOptions] options
1491
+ # Request-specific options
1492
+ #
1493
+ # @yield [result, err] Result & error if block supplied
1494
+ # @yieldparam result [Google::Apis::AppengineV1::Instance] parsed result object
1495
+ # @yieldparam err [StandardError] error object if request failed
1496
+ #
1497
+ # @return [Google::Apis::AppengineV1::Instance]
1498
+ #
1499
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1500
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1501
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1502
+ def get_app_service_version_instance(apps_id, services_id, versions_id, instances_id, fields: nil, quota_user: nil, options: nil, &block)
1503
+ command = make_simple_command(:get, 'v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}', options)
1504
+ command.response_representation = Google::Apis::AppengineV1::Instance::Representation
1505
+ command.response_class = Google::Apis::AppengineV1::Instance
1506
+ command.params['appsId'] = apps_id unless apps_id.nil?
1507
+ command.params['servicesId'] = services_id unless services_id.nil?
1508
+ command.params['versionsId'] = versions_id unless versions_id.nil?
1509
+ command.params['instancesId'] = instances_id unless instances_id.nil?
1510
+ command.query['fields'] = fields unless fields.nil?
1511
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1512
+ execute_or_queue_command(command, &block)
1513
+ end
1514
+
1515
+ # Lists the instances of a version.Tip: To aggregate details about instances
1516
+ # over time, see the Stackdriver Monitoring API (https://cloud.google.com/
1517
+ # monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
1518
+ # @param [String] apps_id
1519
+ # Part of `parent`. Name of the parent Version resource. Example: apps/myapp/
1520
+ # services/default/versions/v1.
1521
+ # @param [String] services_id
1522
+ # Part of `parent`. See documentation of `appsId`.
1523
+ # @param [String] versions_id
1524
+ # Part of `parent`. See documentation of `appsId`.
1525
+ # @param [Fixnum] page_size
1526
+ # Maximum results to return per page.
1527
+ # @param [String] page_token
1528
+ # Continuation token for fetching the next page of results.
1529
+ # @param [String] fields
1530
+ # Selector specifying which fields to include in a partial response.
1531
+ # @param [String] quota_user
1532
+ # Available to use for quota purposes for server-side applications. Can be any
1533
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1534
+ # @param [Google::Apis::RequestOptions] options
1535
+ # Request-specific options
1536
+ #
1537
+ # @yield [result, err] Result & error if block supplied
1538
+ # @yieldparam result [Google::Apis::AppengineV1::ListInstancesResponse] parsed result object
1539
+ # @yieldparam err [StandardError] error object if request failed
1540
+ #
1541
+ # @return [Google::Apis::AppengineV1::ListInstancesResponse]
1542
+ #
1543
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1544
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1545
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1546
+ def list_app_service_version_instances(apps_id, services_id, versions_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1547
+ command = make_simple_command(:get, 'v1/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances', options)
1548
+ command.response_representation = Google::Apis::AppengineV1::ListInstancesResponse::Representation
1549
+ command.response_class = Google::Apis::AppengineV1::ListInstancesResponse
1550
+ command.params['appsId'] = apps_id unless apps_id.nil?
1551
+ command.params['servicesId'] = services_id unless services_id.nil?
1552
+ command.params['versionsId'] = versions_id unless versions_id.nil?
1553
+ command.query['pageSize'] = page_size unless page_size.nil?
1554
+ command.query['pageToken'] = page_token unless page_token.nil?
1555
+ command.query['fields'] = fields unless fields.nil?
1556
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1557
+ execute_or_queue_command(command, &block)
1558
+ end
1559
+
1560
+ protected
1561
+
1562
+ def apply_command_defaults(command)
1563
+ command.query['key'] = key unless key.nil?
1564
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1565
+ end
1566
+ end
1567
+ end
1568
+ end
1569
+ end