google-apis-appengine_v1beta 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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 AppengineV1beta
23
+ # App Engine Admin API
24
+ #
25
+ # Provisions and manages developers' App Engine applications.
26
+ #
27
+ # @example
28
+ # require 'google/apis/appengine_v1beta'
29
+ #
30
+ # Appengine = Google::Apis::AppengineV1beta # 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_v1beta',
48
+ client_version: Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
69
+ # @yieldparam err [StandardError] error object if request failed
70
+ #
71
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps', options)
78
+ command.request_representation = Google::Apis::AppengineV1beta::Application::Representation
79
+ command.request_object = application_object
80
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
81
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Application] parsed result object
100
+ # @yieldparam err [StandardError] error object if request failed
101
+ #
102
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}', options)
109
+ command.response_representation = Google::Apis::AppengineV1beta::Application::Representation
110
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
137
+ # @yieldparam err [StandardError] error object if request failed
138
+ #
139
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}', options)
146
+ command.request_representation = Google::Apis::AppengineV1beta::Application::Representation
147
+ command.request_object = application_object
148
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
149
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
180
+ # @yieldparam err [StandardError] error object if request failed
181
+ #
182
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}:repair', options)
189
+ command.request_representation = Google::Apis::AppengineV1beta::RepairApplicationRequest::Representation
190
+ command.request_object = repair_application_request_object
191
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
192
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::AuthorizedCertificate] parsed result object
213
+ # @yieldparam err [StandardError] error object if request failed
214
+ #
215
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/authorizedCertificates', options)
222
+ command.request_representation = Google::Apis::AppengineV1beta::AuthorizedCertificate::Representation
223
+ command.request_object = authorized_certificate_object
224
+ command.response_representation = Google::Apis::AppengineV1beta::AuthorizedCertificate::Representation
225
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Empty] parsed result object
248
+ # @yieldparam err [StandardError] error object if request failed
249
+ #
250
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}', options)
257
+ command.response_representation = Google::Apis::AppengineV1beta::Empty::Representation
258
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::AuthorizedCertificate] parsed result object
284
+ # @yieldparam err [StandardError] error object if request failed
285
+ #
286
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}', options)
293
+ command.response_representation = Google::Apis::AppengineV1beta::AuthorizedCertificate::Representation
294
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListAuthorizedCertificatesResponse] parsed result object
322
+ # @yieldparam err [StandardError] error object if request failed
323
+ #
324
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/authorizedCertificates', options)
331
+ command.response_representation = Google::Apis::AppengineV1beta::ListAuthorizedCertificatesResponse::Representation
332
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::AuthorizedCertificate] parsed result object
365
+ # @yieldparam err [StandardError] error object if request failed
366
+ #
367
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/authorizedCertificates/{authorizedCertificatesId}', options)
374
+ command.request_representation = Google::Apis::AppengineV1beta::AuthorizedCertificate::Representation
375
+ command.request_object = authorized_certificate_object
376
+ command.response_representation = Google::Apis::AppengineV1beta::AuthorizedCertificate::Representation
377
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListAuthorizedDomainsResponse] parsed result object
403
+ # @yieldparam err [StandardError] error object if request failed
404
+ #
405
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/authorizedDomains', options)
412
+ command.response_representation = Google::Apis::AppengineV1beta::ListAuthorizedDomainsResponse::Representation
413
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
441
+ # @yieldparam err [StandardError] error object if request failed
442
+ #
443
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/domainMappings', options)
450
+ command.request_representation = Google::Apis::AppengineV1beta::DomainMapping::Representation
451
+ command.request_object = domain_mapping_object
452
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
453
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
478
+ # @yieldparam err [StandardError] error object if request failed
479
+ #
480
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/domainMappings/{domainMappingsId}', options)
487
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
488
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::DomainMapping] parsed result object
512
+ # @yieldparam err [StandardError] error object if request failed
513
+ #
514
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/domainMappings/{domainMappingsId}', options)
521
+ command.response_representation = Google::Apis::AppengineV1beta::DomainMapping::Representation
522
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListDomainMappingsResponse] parsed result object
547
+ # @yieldparam err [StandardError] error object if request failed
548
+ #
549
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/domainMappings', options)
556
+ command.response_representation = Google::Apis::AppengineV1beta::ListDomainMappingsResponse::Representation
557
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
588
+ # @yieldparam err [StandardError] error object if request failed
589
+ #
590
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/domainMappings/{domainMappingsId}', options)
597
+ command.request_representation = Google::Apis::AppengineV1beta::DomainMapping::Representation
598
+ command.request_object = domain_mapping_object
599
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
600
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::BatchUpdateIngressRulesResponse] parsed result object
627
+ # @yieldparam err [StandardError] error object if request failed
628
+ #
629
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/firewall/ingressRules:batchUpdate', options)
636
+ command.request_representation = Google::Apis::AppengineV1beta::BatchUpdateIngressRulesRequest::Representation
637
+ command.request_object = batch_update_ingress_rules_request_object
638
+ command.response_representation = Google::Apis::AppengineV1beta::BatchUpdateIngressRulesResponse::Representation
639
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::FirewallRule] parsed result object
661
+ # @yieldparam err [StandardError] error object if request failed
662
+ #
663
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/firewall/ingressRules', options)
670
+ command.request_representation = Google::Apis::AppengineV1beta::FirewallRule::Representation
671
+ command.request_object = firewall_rule_object
672
+ command.response_representation = Google::Apis::AppengineV1beta::FirewallRule::Representation
673
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Empty] parsed result object
696
+ # @yieldparam err [StandardError] error object if request failed
697
+ #
698
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/firewall/ingressRules/{ingressRulesId}', options)
705
+ command.response_representation = Google::Apis::AppengineV1beta::Empty::Representation
706
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::FirewallRule] parsed result object
730
+ # @yieldparam err [StandardError] error object if request failed
731
+ #
732
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/firewall/ingressRules/{ingressRulesId}', options)
739
+ command.response_representation = Google::Apis::AppengineV1beta::FirewallRule::Representation
740
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListIngressRulesResponse] parsed result object
769
+ # @yieldparam err [StandardError] error object if request failed
770
+ #
771
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/firewall/ingressRules', options)
778
+ command.response_representation = Google::Apis::AppengineV1beta::ListIngressRulesResponse::Representation
779
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::FirewallRule] parsed result object
808
+ # @yieldparam err [StandardError] error object if request failed
809
+ #
810
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/firewall/ingressRules/{ingressRulesId}', options)
817
+ command.request_representation = Google::Apis::AppengineV1beta::FirewallRule::Representation
818
+ command.request_object = firewall_rule_object
819
+ command.response_representation = Google::Apis::AppengineV1beta::FirewallRule::Representation
820
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Location] parsed result object
844
+ # @yieldparam err [StandardError] error object if request failed
845
+ #
846
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/locations/{locationsId}', options)
853
+ command.response_representation = Google::Apis::AppengineV1beta::Location::Representation
854
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListLocationsResponse] parsed result object
881
+ # @yieldparam err [StandardError] error object if request failed
882
+ #
883
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/locations', options)
890
+ command.response_representation = Google::Apis::AppengineV1beta::ListLocationsResponse::Representation
891
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
917
+ # @yieldparam err [StandardError] error object if request failed
918
+ #
919
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/operations/{operationsId}', options)
926
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
927
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListOperationsResponse] parsed result object
961
+ # @yieldparam err [StandardError] error object if request failed
962
+ #
963
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/operations', options)
970
+ command.response_representation = Google::Apis::AppengineV1beta::ListOperationsResponse::Representation
971
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
997
+ # @yieldparam err [StandardError] error object if request failed
998
+ #
999
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}', options)
1006
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
1007
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Service] parsed result object
1031
+ # @yieldparam err [StandardError] error object if request failed
1032
+ #
1033
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}', options)
1040
+ command.response_representation = Google::Apis::AppengineV1beta::Service::Representation
1041
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListServicesResponse] parsed result object
1066
+ # @yieldparam err [StandardError] error object if request failed
1067
+ #
1068
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services', options)
1075
+ command.response_representation = Google::Apis::AppengineV1beta::ListServicesResponse::Representation
1076
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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/v1beta/apps.services.versions#InboundServiceType) and
1098
+ # automatic scaling (https://cloud.google.com/appengine/docs/admin-api/reference/
1099
+ # rest/v1beta/apps.services.versions#AutomaticScaling). You must specify the
1100
+ # shardBy (https://cloud.google.com/appengine/docs/admin-api/reference/rest/
1101
+ # v1beta/apps.services#ShardBy) field in the Service resource. Gradual traffic
1102
+ # migration is not supported in the App Engine flexible environment. For
1103
+ # examples, see Migrating and Splitting Traffic (https://cloud.google.com/
1104
+ # appengine/docs/admin-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::AppengineV1beta::Operation] parsed result object
1117
+ # @yieldparam err [StandardError] error object if request failed
1118
+ #
1119
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}', options)
1126
+ command.request_representation = Google::Apis::AppengineV1beta::Service::Representation
1127
+ command.request_object = service_object
1128
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
1129
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
1156
+ # @yieldparam err [StandardError] error object if request failed
1157
+ #
1158
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions', options)
1165
+ command.request_representation = Google::Apis::AppengineV1beta::Version::Representation
1166
+ command.request_object = version_object
1167
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
1168
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
1194
+ # @yieldparam err [StandardError] error object if request failed
1195
+ #
1196
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions/{versionsId}', options)
1203
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
1204
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Version] parsed result object
1234
+ # @yieldparam err [StandardError] error object if request failed
1235
+ #
1236
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions/{versionsId}', options)
1243
+ command.response_representation = Google::Apis::AppengineV1beta::Version::Representation
1244
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListVersionsResponse] parsed result object
1276
+ # @yieldparam err [StandardError] error object if request failed
1277
+ #
1278
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions', options)
1285
+ command.response_representation = Google::Apis::AppengineV1beta::ListVersionsResponse::Representation
1286
+ command.response_class = Google::Apis::AppengineV1beta::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/v1beta/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/v1beta/apps.services.versions#Version.FIELDS.
1304
+ # automatic_scaling) automatic_scaling.max_idle_instances (https://cloud.google.
1305
+ # com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#
1306
+ # Version.FIELDS.automatic_scaling) automaticScaling.standard_scheduler_settings.
1307
+ # max_instances (https://cloud.google.com/appengine/docs/admin-api/reference/
1308
+ # rest/v1beta/apps.services.versions#StandardSchedulerSettings) automaticScaling.
1309
+ # standard_scheduler_settings.min_instances (https://cloud.google.com/appengine/
1310
+ # docs/admin-api/reference/rest/v1beta/apps.services.versions#
1311
+ # StandardSchedulerSettings) automaticScaling.standard_scheduler_settings.
1312
+ # target_cpu_utilization (https://cloud.google.com/appengine/docs/admin-api/
1313
+ # reference/rest/v1beta/apps.services.versions#StandardSchedulerSettings)
1314
+ # automaticScaling.standard_scheduler_settings.target_throughput_utilization (
1315
+ # https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/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/v1beta/apps.services.versions#Version.FIELDS.
1319
+ # serving_status) manual_scaling.instances (https://cloud.google.com/appengine/
1320
+ # docs/admin-api/reference/rest/v1beta/apps.services.versions#manualscaling)
1321
+ # Flexible environment serving_status (https://cloud.google.com/appengine/docs/
1322
+ # admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.
1323
+ # serving_status)automatic scaling in the flexible environment:
1324
+ # automatic_scaling.min_total_instances (https://cloud.google.com/appengine/docs/
1325
+ # admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.
1326
+ # automatic_scaling) automatic_scaling.max_total_instances (https://cloud.google.
1327
+ # com/appengine/docs/admin-api/reference/rest/v1beta/apps.services.versions#
1328
+ # Version.FIELDS.automatic_scaling) automatic_scaling.cool_down_period_sec (
1329
+ # https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta/apps.
1330
+ # services.versions#Version.FIELDS.automatic_scaling) automatic_scaling.
1331
+ # cpu_utilization.target_utilization (https://cloud.google.com/appengine/docs/
1332
+ # admin-api/reference/rest/v1beta/apps.services.versions#Version.FIELDS.
1333
+ # automatic_scaling)manual scaling in the flexible environment: manual_scaling.
1334
+ # instances (https://cloud.google.com/appengine/docs/admin-api/reference/rest/
1335
+ # v1beta/apps.services.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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
1356
+ # @yieldparam err [StandardError] error object if request failed
1357
+ #
1358
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions/{versionsId}', options)
1365
+ command.request_representation = Google::Apis::AppengineV1beta::Version::Representation
1366
+ command.request_object = version_object
1367
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
1368
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
1404
+ # @yieldparam err [StandardError] error object if request failed
1405
+ #
1406
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}:debug', options)
1413
+ command.request_representation = Google::Apis::AppengineV1beta::DebugInstanceRequest::Representation
1414
+ command.request_object = debug_instance_request_object
1415
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
1416
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Operation] parsed result object
1455
+ # @yieldparam err [StandardError] error object if request failed
1456
+ #
1457
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}', options)
1464
+ command.response_representation = Google::Apis::AppengineV1beta::Operation::Representation
1465
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::Instance] parsed result object
1495
+ # @yieldparam err [StandardError] error object if request failed
1496
+ #
1497
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances/{instancesId}', options)
1504
+ command.response_representation = Google::Apis::AppengineV1beta::Instance::Representation
1505
+ command.response_class = Google::Apis::AppengineV1beta::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::AppengineV1beta::ListInstancesResponse] parsed result object
1539
+ # @yieldparam err [StandardError] error object if request failed
1540
+ #
1541
+ # @return [Google::Apis::AppengineV1beta::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, 'v1beta/apps/{appsId}/services/{servicesId}/versions/{versionsId}/instances', options)
1548
+ command.response_representation = Google::Apis::AppengineV1beta::ListInstancesResponse::Representation
1549
+ command.response_class = Google::Apis::AppengineV1beta::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