Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(2)

Unified Diff: generated/googleapis/lib/appengine/v1.dart

Issue 2226653002: Api-roll 40: 2016-08-08 (Closed) Base URL: git@github.com:dart-lang/googleapis.git@master
Patch Set: Addressed review comments Created 4 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « generated/googleapis/lib/androidpublisher/v2.dart ('k') | generated/googleapis/lib/bigquery/v2.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: generated/googleapis/lib/appengine/v1.dart
diff --git a/generated/googleapis_beta/lib/appengine/v1beta5.dart b/generated/googleapis/lib/appengine/v1.dart
similarity index 73%
copy from generated/googleapis_beta/lib/appengine/v1beta5.dart
copy to generated/googleapis/lib/appengine/v1.dart
index 189c8b44538e1d33ac53dac8005febb1a99a5c8d..fa4d0d53907dd6526f37aebc7abbf4b9b0a6c04a 100644
--- a/generated/googleapis_beta/lib/appengine/v1beta5.dart
+++ b/generated/googleapis/lib/appengine/v1.dart
@@ -1,6 +1,6 @@
// This is a generated file (see the discoveryapis_generator project).
-library googleapis_beta.appengine.v1beta5;
+library googleapis.appengine.v1;
import 'dart:core' as core;
import 'dart:async' as async;
@@ -12,7 +12,7 @@ import 'package:http/http.dart' as http;
export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
ApiRequestError, DetailedApiRequestError;
-const core.String USER_AGENT = 'dart-api-client appengine/v1beta5';
+const core.String USER_AGENT = 'dart-api-client appengine/v1';
/** Provisions and manages App Engine applications. */
class AppengineApi {
@@ -40,17 +40,14 @@ class AppsResourceApi {
_requester = client;
/**
- * Creates an App Engine application for a Google Cloud Platform project. This
- * requires a project that excludes an App Engine application. For details
- * about creating a project without an application, see the [Google Cloud
- * Resource Manager create project
- * topic](https://cloud.google.com/resource-manager/docs/creating-project).
- *
- * [request] - The metadata request object.
+ * Gets information about an application.
*
* Request parameters:
*
- * Completes with a [Operation].
+ * [appsId] - Part of `name`. Name of the Application resource to get.
+ * Example: `apps/myapp`.
+ *
+ * Completes with a [Application].
*
* Completes with a [commons.ApiRequestError] if the API endpoint returned an
* error.
@@ -58,7 +55,7 @@ class AppsResourceApi {
* If the used [http.Client] completes with an error when making a REST call,
* this method will complete with the same error.
*/
- async.Future<Operation> create(Application request) {
+ async.Future<Application> get(core.String appsId) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -66,38 +63,36 @@ class AppsResourceApi {
var _downloadOptions = commons.DownloadOptions.Metadata;
var _body = null;
- if (request != null) {
- _body = convert.JSON.encode((request).toJson());
+ if (appsId == null) {
+ throw new core.ArgumentError("Parameter appsId is required.");
}
- _url = 'v1beta5/apps';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId');
var _response = _requester.request(_url,
- "POST",
+ "GET",
body: _body,
queryParams: _queryParams,
uploadOptions: _uploadOptions,
uploadMedia: _uploadMedia,
downloadOptions: _downloadOptions);
- return _response.then((data) => new Operation.fromJson(data));
+ return _response.then((data) => new Application.fromJson(data));
}
/**
- * Gets information about an application.
+ * Recreates the required App Engine features for the application in your
+ * project, for example a Cloud Storage bucket or App Engine service account.
+ * Use this method if you receive an error message about a missing feature,
+ * for example "*Error retrieving the App Engine service account*".
*
- * Request parameters:
+ * [request] - The metadata request object.
*
- * [appsId] - Part of `name`. Name of the application to get. For example:
- * "apps/myapp".
+ * Request parameters:
*
- * [ensureResourcesExist] - Certain resources associated with an application
- * are created on-demand. Controls whether these resources should be created
- * when performing the `GET` operation. If specified and any resources could
- * not be created, the request will fail with an error code. Additionally,
- * this parameter can cause the request to take longer to complete. Note: This
- * parameter will be deprecated in a future version of the API.
+ * [appsId] - Part of `name`. Name of the application to repair. Example:
+ * `apps/myapp`
*
- * Completes with a [Application].
+ * Completes with a [Operation].
*
* Completes with a [commons.ApiRequestError] if the API endpoint returned an
* error.
@@ -105,7 +100,7 @@ class AppsResourceApi {
* If the used [http.Client] completes with an error when making a REST call,
* this method will complete with the same error.
*/
- async.Future<Application> get(core.String appsId, {core.bool ensureResourcesExist}) {
+ async.Future<Operation> repair(RepairApplicationRequest request, core.String appsId) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -113,23 +108,23 @@ class AppsResourceApi {
var _downloadOptions = commons.DownloadOptions.Metadata;
var _body = null;
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
if (appsId == null) {
throw new core.ArgumentError("Parameter appsId is required.");
}
- if (ensureResourcesExist != null) {
- _queryParams["ensureResourcesExist"] = ["${ensureResourcesExist}"];
- }
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + ':repair';
var _response = _requester.request(_url,
- "GET",
+ "POST",
body: _body,
queryParams: _queryParams,
uploadOptions: _uploadOptions,
uploadMedia: _uploadMedia,
downloadOptions: _downloadOptions);
- return _response.then((data) => new Application.fromJson(data));
+ return _response.then((data) => new Operation.fromJson(data));
}
}
@@ -173,7 +168,7 @@ class AppsLocationsResourceApi {
throw new core.ArgumentError("Parameter locationsId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/locations/' + commons.Escaper.ecapeVariable('$locationsId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/locations/' + commons.Escaper.ecapeVariable('$locationsId');
var _response = _requester.request(_url,
"GET",
@@ -228,7 +223,7 @@ class AppsLocationsResourceApi {
_queryParams["pageToken"] = [pageToken];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/locations';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/locations';
var _response = _requester.request(_url,
"GET",
@@ -283,7 +278,7 @@ class AppsOperationsResourceApi {
throw new core.ArgumentError("Parameter operationsId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations/' + commons.Escaper.ecapeVariable('$operationsId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations/' + commons.Escaper.ecapeVariable('$operationsId');
var _response = _requester.request(_url,
"GET",
@@ -340,7 +335,7 @@ class AppsOperationsResourceApi {
_queryParams["pageToken"] = [pageToken];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations';
var _response = _requester.request(_url,
"GET",
@@ -364,12 +359,12 @@ class AppsServicesResourceApi {
_requester = client;
/**
- * Deletes a service and all enclosed versions.
+ * Deletes the specified service and all enclosed versions.
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default".
+ * [appsId] - Part of `name`. Name of the resource requested. Example:
+ * `apps/myapp/services/default`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
@@ -396,7 +391,7 @@ class AppsServicesResourceApi {
throw new core.ArgumentError("Parameter servicesId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
var _response = _requester.request(_url,
"DELETE",
@@ -409,12 +404,12 @@ class AppsServicesResourceApi {
}
/**
- * Gets the current configuration of the service.
+ * Gets the current configuration of the specified service.
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default".
+ * [appsId] - Part of `name`. Name of the resource requested. Example:
+ * `apps/myapp/services/default`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
@@ -441,7 +436,7 @@ class AppsServicesResourceApi {
throw new core.ArgumentError("Parameter servicesId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
var _response = _requester.request(_url,
"GET",
@@ -458,8 +453,8 @@ class AppsServicesResourceApi {
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp".
+ * [appsId] - Part of `parent`. Name of the parent Application resource.
+ * Example: `apps/myapp`.
*
* [pageSize] - Maximum results to return per page.
*
@@ -491,7 +486,7 @@ class AppsServicesResourceApi {
_queryParams["pageToken"] = [pageToken];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services';
var _response = _requester.request(_url,
"GET",
@@ -510,16 +505,26 @@ class AppsServicesResourceApi {
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource to update. For example:
- * "apps/myapp/services/default".
+ * [appsId] - Part of `name`. Name of the resource to update. Example:
+ * `apps/myapp/services/default`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
- * [mask] - Standard field mask for the set of fields to be updated.
- *
- * [migrateTraffic] - Whether to use Traffic Migration to shift traffic
- * gradually. Traffic can only be migrated from a single version to another
- * single version.
+ * [updateMask] - Standard field mask for the set of fields to be updated.
+ *
+ * [migrateTraffic] - Set to `true` to gradually shift traffic from one
+ * version to another single version. By default, traffic is shifted
+ * immediately. For gradual traffic migration, the target version must be
+ * located within instances that are configured for both [warmup
+ * requests](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#inboundservicetype)
+ * and [automatic
+ * scaling](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling).
+ * You must specify the
+ * [`shardBy`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services#shardby)
+ * field in the Service resource. Gradual traffic migration is not supported
+ * in the App Engine flexible environment. For examples, see [Migrating and
+ * Splitting
+ * Traffic](https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
*
* Completes with a [Operation].
*
@@ -529,7 +534,7 @@ class AppsServicesResourceApi {
* If the used [http.Client] completes with an error when making a REST call,
* this method will complete with the same error.
*/
- async.Future<Operation> patch(Service request, core.String appsId, core.String servicesId, {core.String mask, core.bool migrateTraffic}) {
+ async.Future<Operation> patch(Service request, core.String appsId, core.String servicesId, {core.String updateMask, core.bool migrateTraffic}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -546,14 +551,14 @@ class AppsServicesResourceApi {
if (servicesId == null) {
throw new core.ArgumentError("Parameter servicesId is required.");
}
- if (mask != null) {
- _queryParams["mask"] = [mask];
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
}
if (migrateTraffic != null) {
_queryParams["migrateTraffic"] = ["${migrateTraffic}"];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
var _response = _requester.request(_url,
"PATCH",
@@ -577,16 +582,16 @@ class AppsServicesVersionsResourceApi {
_requester = client;
/**
- * Deploys new code and resource files to a version.
+ * Deploys code and resource files to a new version.
*
* [request] - The metadata request object.
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource to update. For example:
- * "apps/myapp/services/default".
+ * [appsId] - Part of `parent`. Name of the parent resource to create this
+ * version under. Example: `apps/myapp/services/default`.
*
- * [servicesId] - Part of `name`. See documentation of `appsId`.
+ * [servicesId] - Part of `parent`. See documentation of `appsId`.
*
* Completes with a [Operation].
*
@@ -614,7 +619,7 @@ class AppsServicesVersionsResourceApi {
throw new core.ArgumentError("Parameter servicesId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions';
var _response = _requester.request(_url,
"POST",
@@ -627,12 +632,12 @@ class AppsServicesVersionsResourceApi {
}
/**
- * Deletes an existing version.
+ * Deletes an existing Version resource.
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default/versions/v1".
+ * [appsId] - Part of `name`. Name of the resource requested. Example:
+ * `apps/myapp/services/default/versions/v1`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
@@ -664,7 +669,7 @@ class AppsServicesVersionsResourceApi {
throw new core.ArgumentError("Parameter versionsId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId');
var _response = _requester.request(_url,
"DELETE",
@@ -677,12 +682,13 @@ class AppsServicesVersionsResourceApi {
}
/**
- * Gets application deployment information.
+ * Gets the specified Version resource. By default, only a `BASIC_VIEW` will
+ * be returned. Specify the `FULL_VIEW` parameter to get the full resource.
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default/versions/v1".
+ * [appsId] - Part of `name`. Name of the resource requested. Example:
+ * `apps/myapp/services/default/versions/v1`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
@@ -722,7 +728,7 @@ class AppsServicesVersionsResourceApi {
_queryParams["view"] = [view];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId');
var _response = _requester.request(_url,
"GET",
@@ -739,10 +745,10 @@ class AppsServicesVersionsResourceApi {
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default".
+ * [appsId] - Part of `parent`. Name of the parent Service resource. Example:
+ * `apps/myapp/services/default`.
*
- * [servicesId] - Part of `name`. See documentation of `appsId`.
+ * [servicesId] - Part of `parent`. See documentation of `appsId`.
*
* [view] - Controls the set of fields returned in the `List` response.
* Possible string values are:
@@ -785,7 +791,7 @@ class AppsServicesVersionsResourceApi {
_queryParams["pageToken"] = [pageToken];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions';
var _response = _requester.request(_url,
"GET",
@@ -801,15 +807,15 @@ class AppsServicesVersionsResourceApi {
* Updates the specified Version resource. You can specify the following
* fields depending on the App Engine environment and type of scaling that the
* version resource uses: *
- * [`serving_status`](/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status):
+ * [`serving_status`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.serving_status):
* For Version resources that use basic scaling, manual scaling, or run in the
* App Engine flexible environment. *
- * [`instance_class`](/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class):
+ * [`instance_class`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.instance_class):
* For Version resources that run in the App Engine standard environment. *
- * [`automatic_scaling.min_idle_instances`](/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling):
+ * [`automatic_scaling.min_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling):
* For Version resources that use automatic scaling and run in the App Engine
* standard environment. *
- * [`automatic_scaling.max_idle_instances`](/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling):
+ * [`automatic_scaling.max_idle_instances`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#Version.FIELDS.automatic_scaling):
* For Version resources that use automatic scaling and run in the App Engine
* standard environment.
*
@@ -817,14 +823,14 @@ class AppsServicesVersionsResourceApi {
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource to update. For example:
- * "apps/myapp/services/default/versions/1".
+ * [appsId] - Part of `name`. Name of the resource to update. Example:
+ * `apps/myapp/services/default/versions/1`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
* [versionsId] - Part of `name`. See documentation of `appsId`.
*
- * [mask] - Standard field mask for the set of fields to be updated.
+ * [updateMask] - Standard field mask for the set of fields to be updated.
*
* Completes with a [Operation].
*
@@ -834,7 +840,7 @@ class AppsServicesVersionsResourceApi {
* If the used [http.Client] completes with an error when making a REST call,
* this method will complete with the same error.
*/
- async.Future<Operation> patch(Version request, core.String appsId, core.String servicesId, core.String versionsId, {core.String mask}) {
+ async.Future<Operation> patch(Version request, core.String appsId, core.String servicesId, core.String versionsId, {core.String updateMask}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -854,11 +860,11 @@ class AppsServicesVersionsResourceApi {
if (versionsId == null) {
throw new core.ArgumentError("Parameter versionsId is required.");
}
- if (mask != null) {
- _queryParams["mask"] = [mask];
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId');
var _response = _requester.request(_url,
"PATCH",
@@ -880,17 +886,19 @@ class AppsServicesVersionsInstancesResourceApi {
_requester = client;
/**
- * Enable debugging of this VM instance. This call allows you to SSH to the
- * VM. While the VM is in debug mode, it continues to serve live traffic.
- * After you're done debugging an instance, delete the instance; the system
- * creates a new instance when needed. You can't debug a non-VM instance.
+ * Enables debugging on a VM instance. This allows you to use the SSH command
+ * to connect to the virtual machine where the instance lives. While in "debug
+ * mode", the instance continues to serve live traffic. You should delete the
+ * instance when you are done debugging and then allow the system to take over
+ * and determine if another instance should be started. Only applicable for
+ * instances in App Engine flexible environment.
*
* [request] - The metadata request object.
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default/versions/v1/instances/instance-1".
+ * [appsId] - Part of `name`. Name of the resource requested. Example:
+ * `apps/myapp/services/default/versions/v1/instances/instance-1`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
@@ -930,7 +938,7 @@ class AppsServicesVersionsInstancesResourceApi {
throw new core.ArgumentError("Parameter instancesId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances/' + commons.Escaper.ecapeVariable('$instancesId') + ':debug';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances/' + commons.Escaper.ecapeVariable('$instancesId') + ':debug';
var _response = _requester.request(_url,
"POST",
@@ -947,8 +955,8 @@ class AppsServicesVersionsInstancesResourceApi {
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default/versions/v1/instances/instance-1".
+ * [appsId] - Part of `name`. Name of the resource requested. Example:
+ * `apps/myapp/services/default/versions/v1/instances/instance-1`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
@@ -985,7 +993,7 @@ class AppsServicesVersionsInstancesResourceApi {
throw new core.ArgumentError("Parameter instancesId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances/' + commons.Escaper.ecapeVariable('$instancesId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances/' + commons.Escaper.ecapeVariable('$instancesId');
var _response = _requester.request(_url,
"DELETE",
@@ -1002,8 +1010,8 @@ class AppsServicesVersionsInstancesResourceApi {
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default/versions/v1/instances/instance-1".
+ * [appsId] - Part of `name`. Name of the resource requested. Example:
+ * `apps/myapp/services/default/versions/v1/instances/instance-1`.
*
* [servicesId] - Part of `name`. See documentation of `appsId`.
*
@@ -1040,7 +1048,7 @@ class AppsServicesVersionsInstancesResourceApi {
throw new core.ArgumentError("Parameter instancesId is required.");
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances/' + commons.Escaper.ecapeVariable('$instancesId');
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances/' + commons.Escaper.ecapeVariable('$instancesId');
var _response = _requester.request(_url,
"GET",
@@ -1057,12 +1065,12 @@ class AppsServicesVersionsInstancesResourceApi {
*
* Request parameters:
*
- * [appsId] - Part of `name`. Name of the resource requested. For example:
- * "apps/myapp/services/default/versions/v1".
+ * [appsId] - Part of `parent`. Name of the parent Version resource. Example:
+ * `apps/myapp/services/default/versions/v1`.
*
- * [servicesId] - Part of `name`. See documentation of `appsId`.
+ * [servicesId] - Part of `parent`. See documentation of `appsId`.
*
- * [versionsId] - Part of `name`. See documentation of `appsId`.
+ * [versionsId] - Part of `parent`. See documentation of `appsId`.
*
* [pageSize] - Maximum results to return per page.
*
@@ -1100,7 +1108,7 @@ class AppsServicesVersionsInstancesResourceApi {
_queryParams["pageToken"] = [pageToken];
}
- _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances';
+ _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances';
var _response = _requester.request(_url,
"GET",
@@ -1116,11 +1124,15 @@ class AppsServicesVersionsInstancesResourceApi {
-/** API Serving configuration for Cloud Endpoints. */
+/**
+ * [Google Cloud
+ * Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/)
+ * configuration for API handlers.
+ */
class ApiConfigHandler {
/**
- * For users not logged in, how to handle access to resources with required
- * login. Defaults to "redirect".
+ * Action to take when users access resources that require authentication.
+ * Defaults to `redirect`.
* Possible string values are:
* - "AUTH_FAIL_ACTION_UNSPECIFIED" : A AUTH_FAIL_ACTION_UNSPECIFIED.
* - "AUTH_FAIL_ACTION_REDIRECT" : A AUTH_FAIL_ACTION_REDIRECT.
@@ -1128,8 +1140,7 @@ class ApiConfigHandler {
*/
core.String authFailAction;
/**
- * What level of login is required to access this resource. Default is
- * "optional".
+ * Level of login required to access this resource. Defaults to `optional`.
* Possible string values are:
* - "LOGIN_UNSPECIFIED" : A LOGIN_UNSPECIFIED.
* - "LOGIN_OPTIONAL" : A LOGIN_OPTIONAL.
@@ -1137,10 +1148,10 @@ class ApiConfigHandler {
* - "LOGIN_REQUIRED" : A LOGIN_REQUIRED.
*/
core.String login;
- /** Specifies the path to the script from the application root directory. */
+ /** Path to the script from the application root directory. */
core.String script;
/**
- * Configures whether security (HTTPS) should be enforced for this URL.
+ * Security (HTTPS) enforcement for this URL.
* Possible string values are:
* - "SECURE_UNSPECIFIED" : A SECURE_UNSPECIFIED.
* - "SECURE_DEFAULT" : A SECURE_DEFAULT.
@@ -1193,9 +1204,9 @@ class ApiConfigHandler {
}
}
-/** Use Google Cloud Endpoints to handle requests. */
+/** Uses Google Cloud Endpoints to handle requests. */
class ApiEndpointHandler {
- /** Specifies the path to the script from the application root directory. */
+ /** Path to the script from the application root directory. */
core.String scriptPath;
ApiEndpointHandler();
@@ -1216,58 +1227,56 @@ class ApiEndpointHandler {
}
/**
- * An Application contains the top-level configuration of an App Engine
+ * An Application resource contains the top-level configuration of an App Engine
* application.
*/
class Application {
/**
- * If set, only users from the specified Google Apps authentication domain may
- * access the application. If not set, any Google Account may access the
- * application.
+ * Google Apps authentication domain that controls which users can access this
+ * application. Defaults to open access for any Google Account.
*/
core.String authDomain;
/**
- * A Google Cloud Storage bucket which can be used for storing files
- * associated with an application. This bucket is associated with the
- * application and can be used by the gcloud deployment commands. @OutputOnly
+ * Google Cloud Storage bucket that can be used for storing files associated
+ * with this application. This bucket is associated with the application and
+ * can be used by the gcloud deployment commands. @OutputOnly
*/
core.String codeBucket;
/**
- * A Google Cloud Storage bucket which can be used by the application to store
+ * Google Cloud Storage bucket that can be used by this application to store
* content. @OutputOnly
*/
core.String defaultBucket;
- /**
- * Determines the cookie expiration policy for the application. @OutputOnly
- */
+ /** Cookie expiration policy for this application. @OutputOnly */
core.String defaultCookieExpiration;
/**
- * The hostname used to reach the application, as resolved by App Engine.
+ * Hostname used to reach this application, as resolved by App Engine.
* @OutputOnly
*/
core.String defaultHostname;
/**
- * HTTP path dispatch rules for requests to the app that do not explicitly
- * target a service or version. The rules are order-dependent. @OutputOnly
+ * HTTP path dispatch rules for requests to the application that do not
+ * explicitly target a service or version. Rules are order-dependent.
+ * @OutputOnly
*/
core.List<UrlDispatchRule> dispatchRules;
/**
- * The identifier of the Application resource. This identifier is equivalent
- * to the project ID of the Google Cloud Platform project where you want to
- * deploy your application. Example: "myapp".
+ * Identifier of the Application resource. This identifier is equivalent to
+ * the project ID of the Google Cloud Platform project where you want to
+ * deploy your application. Example: `myapp`.
*/
core.String id;
/**
- * The location from which the application will be run. Application instances
- * will run out of data centers in the chosen location and all of the
- * application's End User Content will be stored at rest. The default is
- * "us-central". Choices are: "us-central" - Central US "europe-west" -
- * Western Europe "us-east1" - Eastern US
+ * Location from which this application will be run. Application instances
+ * will run out of data centers in the chosen location, which is also where
+ * all of the application's end user content is stored. Defaults to
+ * `us-central`. Options are: `us-central` - Central US `europe-west` -
+ * Western Europe `us-east1` - Eastern US
*/
- core.String location;
+ core.String locationId;
/**
- * The full path to the Application resource in the API. Example:
- * "apps/myapp". @OutputOnly
+ * Full path to the Application resource in the API. Example: `apps/myapp`.
+ * @OutputOnly
*/
core.String name;
@@ -1295,8 +1304,8 @@ class Application {
if (_json.containsKey("id")) {
id = _json["id"];
}
- if (_json.containsKey("location")) {
- location = _json["location"];
+ if (_json.containsKey("locationId")) {
+ locationId = _json["locationId"];
}
if (_json.containsKey("name")) {
name = _json["name"];
@@ -1326,8 +1335,8 @@ class Application {
if (id != null) {
_json["id"] = id;
}
- if (location != null) {
- _json["location"] = location;
+ if (locationId != null) {
+ _json["locationId"] = locationId;
}
if (name != null) {
_json["name"] = name;
@@ -1337,16 +1346,15 @@ class Application {
}
/**
- * Automatic scaling is the scaling policy that App Engine has used since its
- * inception. It is based on request rate, response latencies, and other
+ * Automatic scaling is based on request rate, response latencies, and other
* application metrics.
*/
class AutomaticScaling {
/**
- * The amount of time that the
+ * Amount of time that the
* [Autoscaler](https://cloud.google.com/compute/docs/autoscaler/) should wait
- * between changes to the number of virtual machines. Applies only to the VM
- * runtime.
+ * between changes to the number of virtual machines. Only applicable for VM
+ * runtimes.
*/
core.String coolDownPeriod;
/** Target scaling by CPU usage. */
@@ -1354,37 +1362,36 @@ class AutomaticScaling {
/** Target scaling by disk usage. */
DiskUtilization diskUtilization;
/**
- * The number of concurrent requests an automatic scaling instance can accept
- * before the scheduler spawns a new instance. Default value is chosen based
- * on the runtime.
+ * Number of concurrent requests an automatic scaling instance can accept
+ * before the scheduler spawns a new instance. Defaults to a runtime-specific
+ * value.
*/
core.int maxConcurrentRequests;
/**
- * The maximum number of idle instances that App Engine should maintain for
- * this version.
+ * Maximum number of idle instances that should be maintained for this
+ * version.
*/
core.int maxIdleInstances;
/**
- * The maximum amount of time that App Engine should allow a request to wait
- * in the pending queue before starting a new instance to handle it.
+ * Maximum amount of time that a request should wait in the pending queue
+ * before starting a new instance to handle it.
*/
core.String maxPendingLatency;
- /**
- * Max number of instances that App Engine should start to handle requests.
- */
+ /** Maximum number of instances that should be started to handle requests. */
core.int maxTotalInstances;
/**
- * The minimum number of idle instances that App Engine should maintain for
- * this version. Only applies to the default version of a service, since other
- * versions are not expected to receive significant traffic.
+ * Minimum number of idle instances that should be maintained for this
+ * version. Only applicable for the default version of a service.
*/
core.int minIdleInstances;
/**
- * The minimum amount of time that App Engine should allow a request to wait
- * in the pending queue before starting a new instance to handle it.
+ * Minimum amount of time a request should wait in the pending queue before
+ * starting a new instance to handle it.
*/
core.String minPendingLatency;
- /** Minimum number of instances that App Engine should maintain. */
+ /**
+ * Minimum number of instances that should be maintained for this version.
+ */
core.int minTotalInstances;
/** Target scaling by network usage. */
NetworkUtilization networkUtilization;
@@ -1482,13 +1489,11 @@ class AutomaticScaling {
*/
class BasicScaling {
/**
- * The instance will be shut down this amount of time after receiving its last
- * request.
+ * Duration of time after the last request that an instance must wait before
+ * the instance is shut down.
*/
core.String idleTimeout;
- /**
- * The maximum number of instances for App Engine to create for this version.
- */
+ /** Maximum number of instances to create for this version. */
core.int maxInstances;
BasicScaling();
@@ -1515,13 +1520,13 @@ class BasicScaling {
}
/**
- * A Docker (container) image which should be used to start the application.
+ * Docker image that is used to start a VM container for the version you deploy.
*/
class ContainerInfo {
/**
- * Reference to a hosted container image. Must be a URI to a resource in a
- * Docker repository. Must be fully qualified, including tag or digest. e.g.
- * gcr.io/my-project/image:tag or gcr.io/my-project/image@digest
+ * URI to the hosted container image in a Docker repository. The URI must be
+ * fully qualified and include a tag or digest. Examples:
+ * "gcr.io/my-project/image:tag" or "gcr.io/my-project/image@digest"
*/
core.String image;
@@ -1544,9 +1549,12 @@ class ContainerInfo {
/** Target scaling by CPU usage. */
class CpuUtilization {
- /** The period of time over which CPU utilization is calculated. */
+ /** Period of time over which CPU utilization is calculated. */
core.String aggregationWindowLength;
- /** Target (0-1) CPU utilization ratio to maintain when scaling. */
+ /**
+ * Target CPU utilization ratio to maintain when scaling. Must be between 0
+ * and 1.
+ */
core.double targetUtilization;
CpuUtilization();
@@ -1589,22 +1597,18 @@ class DebugInstanceRequest {
/** Code and application artifacts used to deploy a version to App Engine. */
class Deployment {
/**
- * If supplied, a docker (container) image which should be used to start the
- * application. Only applicable to the 'vm' runtime.
+ * A Docker image that App Engine uses to run the version. Only applicable for
+ * instances in App Engine flexible environment.
*/
ContainerInfo container;
/**
- * A manifest of files stored in Google Cloud Storage which should be included
- * as part of this application. All files must be readable using the
- * credentials supplied with this call.
+ * Manifest of the files stored in Google Cloud Storage that are included as
+ * part of this version. All files must be readable using the credentials
+ * supplied with this call.
*/
core.Map<core.String, FileInfo> files;
- /**
- * The origin of the source code for this deployment. There can be more than
- * one source reference per Version if source code is distributed among
- * multiple repositories.
- */
- core.List<SourceReference> sourceReferences;
+ /** The zip file for this deployment, if this is a zip deployment. */
+ ZipInfo zip;
Deployment();
@@ -1615,8 +1619,8 @@ class Deployment {
if (_json.containsKey("files")) {
files = commons.mapMap(_json["files"], (item) => new FileInfo.fromJson(item));
}
- if (_json.containsKey("sourceReferences")) {
- sourceReferences = _json["sourceReferences"].map((value) => new SourceReference.fromJson(value)).toList();
+ if (_json.containsKey("zip")) {
+ zip = new ZipInfo.fromJson(_json["zip"]);
}
}
@@ -1628,63 +1632,63 @@ class Deployment {
if (files != null) {
_json["files"] = commons.mapMap(files, (item) => (item).toJson());
}
- if (sourceReferences != null) {
- _json["sourceReferences"] = sourceReferences.map((value) => (value).toJson()).toList();
+ if (zip != null) {
+ _json["zip"] = (zip).toJson();
}
return _json;
}
}
-/** Target scaling by disk usage (for VM runtimes only). */
+/** Target scaling by disk usage. Only applicable for VM runtimes. */
class DiskUtilization {
- /** Target bytes per second read. */
- core.int targetReadBytesPerSec;
- /** Target ops per second read. */
- core.int targetReadOpsPerSec;
- /** Target bytes per second written. */
- core.int targetWriteBytesPerSec;
- /** Target ops per second written. */
- core.int targetWriteOpsPerSec;
+ /** Target bytes read per second. */
+ core.int targetReadBytesPerSecond;
+ /** Target ops read per seconds. */
+ core.int targetReadOpsPerSecond;
+ /** Target bytes written per second. */
+ core.int targetWriteBytesPerSecond;
+ /** Target ops written per second. */
+ core.int targetWriteOpsPerSecond;
DiskUtilization();
DiskUtilization.fromJson(core.Map _json) {
- if (_json.containsKey("targetReadBytesPerSec")) {
- targetReadBytesPerSec = _json["targetReadBytesPerSec"];
+ if (_json.containsKey("targetReadBytesPerSecond")) {
+ targetReadBytesPerSecond = _json["targetReadBytesPerSecond"];
}
- if (_json.containsKey("targetReadOpsPerSec")) {
- targetReadOpsPerSec = _json["targetReadOpsPerSec"];
+ if (_json.containsKey("targetReadOpsPerSecond")) {
+ targetReadOpsPerSecond = _json["targetReadOpsPerSecond"];
}
- if (_json.containsKey("targetWriteBytesPerSec")) {
- targetWriteBytesPerSec = _json["targetWriteBytesPerSec"];
+ if (_json.containsKey("targetWriteBytesPerSecond")) {
+ targetWriteBytesPerSecond = _json["targetWriteBytesPerSecond"];
}
- if (_json.containsKey("targetWriteOpsPerSec")) {
- targetWriteOpsPerSec = _json["targetWriteOpsPerSec"];
+ if (_json.containsKey("targetWriteOpsPerSecond")) {
+ targetWriteOpsPerSecond = _json["targetWriteOpsPerSecond"];
}
}
core.Map toJson() {
var _json = new core.Map();
- if (targetReadBytesPerSec != null) {
- _json["targetReadBytesPerSec"] = targetReadBytesPerSec;
+ if (targetReadBytesPerSecond != null) {
+ _json["targetReadBytesPerSecond"] = targetReadBytesPerSecond;
}
- if (targetReadOpsPerSec != null) {
- _json["targetReadOpsPerSec"] = targetReadOpsPerSec;
+ if (targetReadOpsPerSecond != null) {
+ _json["targetReadOpsPerSecond"] = targetReadOpsPerSecond;
}
- if (targetWriteBytesPerSec != null) {
- _json["targetWriteBytesPerSec"] = targetWriteBytesPerSec;
+ if (targetWriteBytesPerSecond != null) {
+ _json["targetWriteBytesPerSecond"] = targetWriteBytesPerSecond;
}
- if (targetWriteOpsPerSec != null) {
- _json["targetWriteOpsPerSec"] = targetWriteOpsPerSec;
+ if (targetWriteOpsPerSecond != null) {
+ _json["targetWriteOpsPerSecond"] = targetWriteOpsPerSecond;
}
return _json;
}
}
-/** A custom static error page to be served when an error occurs. */
+/** Custom static error page to be served when an error occurs. */
class ErrorHandler {
/**
- * The error condition this handler applies to.
+ * Error condition this handler applies to.
* Possible string values are:
* - "ERROR_CODE_UNSPECIFIED" : A ERROR_CODE_UNSPECIFIED.
* - "ERROR_CODE_DEFAULT" : A ERROR_CODE_DEFAULT.
@@ -1693,7 +1697,7 @@ class ErrorHandler {
* - "ERROR_CODE_TIMEOUT" : A ERROR_CODE_TIMEOUT.
*/
core.String errorCode;
- /** MIME type of file. If unspecified, "text/html" is assumed. */
+ /** MIME type of file. Defaults to `text/html`. */
core.String mimeType;
/** Static file content to be served for this error. */
core.String staticFile;
@@ -1727,18 +1731,20 @@ class ErrorHandler {
}
}
-/** A single source file which is part of the application to be deployed. */
+/**
+ * Single source file that is part of the version to be deployed. Each source
+ * file that is deployed must be specified separately.
+ */
class FileInfo {
/**
- * The MIME type of the file; if unspecified, the value from Google Cloud
- * Storage will be used.
+ * The MIME type of the file. Defaults to the value from Google Cloud Storage.
*/
core.String mimeType;
- /** The SHA1 (160 bits) hash of the file in hex. */
+ /** The SHA1 hash of the file, in hex. */
core.String sha1Sum;
/**
- * The URL source to use to fetch this file. Must be a URL to a resource in
- * Google Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+ * URL source to use to fetch this file. Must be a URL to a resource in Google
+ * Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
*/
core.String sourceUrl;
@@ -1772,33 +1778,35 @@ class FileInfo {
}
/**
- * Configure health checking for the VM instances. Unhealthy VM instances will
- * be killed and replaced with new instances.
+ * Health checking configuration for VM instances. Unhealthy instances are
+ * killed and replaced with new instances. Only applicable for instances in App
+ * Engine flexible environment.
*/
class HealthCheck {
- /** The interval between health checks. */
+ /** Interval between health checks. */
core.String checkInterval;
/** Whether to explicitly disable health checks for this instance. */
core.bool disableHealthCheck;
/**
- * The number of consecutive successful health checks before receiving
+ * Number of consecutive successful health checks required before receiving
* traffic.
*/
core.int healthyThreshold;
/**
- * The host header to send when performing an HTTP health check (e.g.
- * myapp.appspot.com)
+ * Host header to send when performing an HTTP health check. Example:
+ * "myapp.appspot.com"
*/
core.String host;
/**
- * The number of consecutive failed health checks before an instance is
+ * Number of consecutive failed health checks required before an instance is
* restarted.
*/
core.int restartThreshold;
- /** The amount of time before the health check is considered failed. */
+ /** Time before the health check is considered failed. */
core.String timeout;
/**
- * The number of consecutive failed health checks before removing traffic.
+ * Number of consecutive failed health checks required before removing
+ * traffic.
*/
core.int unhealthyThreshold;
@@ -1856,65 +1864,65 @@ class HealthCheck {
}
/**
- * Instances are the computing units that App Engine uses to automatically scale
- * an application.
+ * An Instance resource is the computing unit that App Engine uses to
+ * automatically scale an application.
*/
class Instance {
- /** The App Engine release the instance is running on. @OutputOnly */
+ /** App Engine release this instance is running on. @OutputOnly */
core.String appEngineRelease;
/**
- * Availability of instance. @OutputOnly
+ * Availability of the instance. @OutputOnly
* Possible string values are:
* - "UNSPECIFIED" : A UNSPECIFIED.
* - "RESIDENT" : A RESIDENT.
* - "DYNAMIC" : A DYNAMIC.
*/
core.String availability;
- /** Latency in milliseconds (averaged over the last minute). @OutputOnly */
+ /** Average latency (ms) over the last minute. @OutputOnly */
core.int averageLatency;
- /** Number of errors since the instance was started. @OutputOnly */
+ /** Number of errors since this instance was started. @OutputOnly */
core.int errors;
/**
- * The relative name/path of the instance within the version. Example:
- * "instance-1" @OutputOnly
+ * Relative name of the instance within the version. Example: `instance-1`.
+ * @OutputOnly
*/
core.String id;
- /** Memory usage (in bytes). @OutputOnly */
+ /** Total memory in use (bytes). @OutputOnly */
core.String memoryUsage;
/**
- * The full path to the Instance resource in the API. Example:
- * "apps/myapp/services/default/versions/v1/instances/instance-1" @OutputOnly
+ * Full path to the Instance resource in the API. Example:
+ * `apps/myapp/services/default/versions/v1/instances/instance-1`. @OutputOnly
*/
core.String name;
- /** QPS for this instance (averaged over the last minute). @OutputOnly */
+ /** Average queries per second (QPS) over the last minute. @OutputOnly */
core.double qps;
- /** Number of requests (since the clone was started). @OutputOnly */
+ /** Number of requests since this instance was started. @OutputOnly */
core.int requests;
- /** Time when instance was started. @OutputOnly */
- core.String startTimestamp;
+ /** Time that this instance was started. @OutputOnly */
+ core.String startTime;
/**
- * For VMEngines instances, the Compute Engine VM ID of the instance.
- * @OutputOnly
+ * Whether this instance is in debug mode. Only applicable for instances in
+ * App Engine flexible environment. @OutputOnly
+ */
+ core.bool vmDebugEnabled;
+ /**
+ * Virtual machine ID of this instance. Only applicable for instances in App
+ * Engine flexible environment. @OutputOnly
*/
core.String vmId;
/**
- * For VMEngines instances, the name of the Compute Engine VM where the
- * instance lives. @OutputOnly
+ * Name of the virtual machine where this instance lives. Only applicable for
+ * instances in App Engine flexible environment. @OutputOnly
*/
core.String vmName;
/**
- * For VMEngines instances, the status of the Compute Engine VM where the
- * instance lives. @OutputOnly
+ * Status of the virtual machine where this instance lives. Only applicable
+ * for instances in App Engine flexible environment. @OutputOnly
*/
core.String vmStatus;
/**
- * For VMEngines instances, whether the instance has been unlocked.
- * @OutputOnly
- */
- core.bool vmUnlocked;
- /**
- * For VMEngines instances, the zone where the Compute Engine VM is located.
- * @OutputOnly
+ * Zone where the virtual machine is located. Only applicable for instances in
+ * App Engine flexible environment. @OutputOnly
*/
core.String vmZoneName;
@@ -1948,8 +1956,11 @@ class Instance {
if (_json.containsKey("requests")) {
requests = _json["requests"];
}
- if (_json.containsKey("startTimestamp")) {
- startTimestamp = _json["startTimestamp"];
+ if (_json.containsKey("startTime")) {
+ startTime = _json["startTime"];
+ }
+ if (_json.containsKey("vmDebugEnabled")) {
+ vmDebugEnabled = _json["vmDebugEnabled"];
}
if (_json.containsKey("vmId")) {
vmId = _json["vmId"];
@@ -1960,9 +1971,6 @@ class Instance {
if (_json.containsKey("vmStatus")) {
vmStatus = _json["vmStatus"];
}
- if (_json.containsKey("vmUnlocked")) {
- vmUnlocked = _json["vmUnlocked"];
- }
if (_json.containsKey("vmZoneName")) {
vmZoneName = _json["vmZoneName"];
}
@@ -1997,8 +2005,11 @@ class Instance {
if (requests != null) {
_json["requests"] = requests;
}
- if (startTimestamp != null) {
- _json["startTimestamp"] = startTimestamp;
+ if (startTime != null) {
+ _json["startTime"] = startTime;
+ }
+ if (vmDebugEnabled != null) {
+ _json["vmDebugEnabled"] = vmDebugEnabled;
}
if (vmId != null) {
_json["vmId"] = vmId;
@@ -2009,9 +2020,6 @@ class Instance {
if (vmStatus != null) {
_json["vmStatus"] = vmStatus;
}
- if (vmUnlocked != null) {
- _json["vmUnlocked"] = vmUnlocked;
- }
if (vmZoneName != null) {
_json["vmZoneName"] = vmZoneName;
}
@@ -2019,11 +2027,11 @@ class Instance {
}
}
-/** A Python runtime third-party library required by the application. */
+/** Third-party Python runtime library that is required by the application. */
class Library {
- /** The name of the library, e.g. "PIL" or "django". */
+ /** Name of the library. Example: "django". */
core.String name;
- /** The version of the library to select, or "latest". */
+ /** Version of the library to select, or "latest". */
core.String version;
Library();
@@ -2173,7 +2181,7 @@ class ListServicesResponse {
class ListVersionsResponse {
/** Continuation token for fetching the next page of results. */
core.String nextPageToken;
- /** The versions belonging to the requested application service. */
+ /** The versions belonging to the requested service. */
core.List<Version> versions;
ListVersionsResponse();
@@ -2206,6 +2214,8 @@ class Location {
* {"cloud.googleapis.com/region": "us-east1"}
*/
core.Map<core.String, core.String> labels;
+ /** The cononical id for this location. For example: `"us-east1"`. */
+ core.String locationId;
/**
* Service-specific metadata. For example the available capacity at the given
* location.
@@ -2215,8 +2225,8 @@ class Location {
*/
core.Map<core.String, core.Object> metadata;
/**
- * Resource name for the location, which may vary between implementations.
- * Example: `"projects/example-project/locations/us-east1"`
+ * Resource name for the location, which may vary between implementations. For
+ * example: `"projects/example-project/locations/us-east1"`
*/
core.String name;
@@ -2226,6 +2236,9 @@ class Location {
if (_json.containsKey("labels")) {
labels = _json["labels"];
}
+ if (_json.containsKey("locationId")) {
+ locationId = _json["locationId"];
+ }
if (_json.containsKey("metadata")) {
metadata = _json["metadata"];
}
@@ -2239,6 +2252,9 @@ class Location {
if (labels != null) {
_json["labels"] = labels;
}
+ if (locationId != null) {
+ _json["locationId"] = locationId;
+ }
if (metadata != null) {
_json["metadata"] = metadata;
}
@@ -2251,14 +2267,36 @@ class Location {
/** Metadata for the given google.cloud.location.Location. */
class LocationMetadata {
+ /**
+ * App Engine Flexible Environment is available in the given location.
+ * @OutputOnly
+ */
+ core.bool flexibleEnvironmentAvailable;
+ /**
+ * App Engine Standard Environment is available in the given location.
+ * @OutputOnly
+ */
+ core.bool standardEnvironmentAvailable;
LocationMetadata();
LocationMetadata.fromJson(core.Map _json) {
+ if (_json.containsKey("flexibleEnvironmentAvailable")) {
+ flexibleEnvironmentAvailable = _json["flexibleEnvironmentAvailable"];
+ }
+ if (_json.containsKey("standardEnvironmentAvailable")) {
+ standardEnvironmentAvailable = _json["standardEnvironmentAvailable"];
+ }
}
core.Map toJson() {
var _json = new core.Map();
+ if (flexibleEnvironmentAvailable != null) {
+ _json["flexibleEnvironmentAvailable"] = flexibleEnvironmentAvailable;
+ }
+ if (standardEnvironmentAvailable != null) {
+ _json["standardEnvironmentAvailable"] = standardEnvironmentAvailable;
+ }
return _json;
}
}
@@ -2269,8 +2307,8 @@ class LocationMetadata {
*/
class ManualScaling {
/**
- * The number of instances to assign to the service at the start. This number
- * can later be altered by using the [Modules
+ * Number of instances to assign to the service at the start. This number can
+ * later be altered by using the [Modules
* API](https://cloud.google.com/appengine/docs/python/modules/functions)
* `set_num_instances()` function.
*/
@@ -2293,19 +2331,18 @@ class ManualScaling {
}
}
-/** Used to specify extra network settings (for VM runtimes only). */
+/** Extra network settings. Only applicable for VM runtimes. */
class Network {
/**
- * A list of ports (or port pairs) to forward from the VM into the app
- * container.
+ * List of ports, or port pairs, to forward from the virtual machine to the
+ * application container.
*/
core.List<core.String> forwardedPorts;
- /** A tag to apply to the VM instance during creation. */
+ /** Tag to apply to the VM instance during creation. */
core.String instanceTag;
/**
- * The Google Compute Engine network where the VMs will be created. If not
- * specified, or empty, the network named "default" will be used. (The short
- * name should be specified, not the resource path.)
+ * Google Cloud Platform network where the virtual machines are created.
+ * Specify the short name, not the resource path. Defaults to `default`.
*/
core.String name;
@@ -2338,47 +2375,47 @@ class Network {
}
}
-/** Target scaling by network usage (for VM runtimes only). */
+/** Target scaling by network usage. Only applicable for VM runtimes. */
class NetworkUtilization {
- /** Target bytes per second received. */
- core.int targetReceivedBytesPerSec;
- /** Target packets per second received. */
- core.int targetReceivedPacketsPerSec;
- /** Target bytes per second sent. */
- core.int targetSentBytesPerSec;
- /** Target packets per second sent. */
- core.int targetSentPacketsPerSec;
+ /** Target bytes received per second. */
+ core.int targetReceivedBytesPerSecond;
+ /** Target packets received per second. */
+ core.int targetReceivedPacketsPerSecond;
+ /** Target bytes sent per second. */
+ core.int targetSentBytesPerSecond;
+ /** Target packets sent per second. */
+ core.int targetSentPacketsPerSecond;
NetworkUtilization();
NetworkUtilization.fromJson(core.Map _json) {
- if (_json.containsKey("targetReceivedBytesPerSec")) {
- targetReceivedBytesPerSec = _json["targetReceivedBytesPerSec"];
+ if (_json.containsKey("targetReceivedBytesPerSecond")) {
+ targetReceivedBytesPerSecond = _json["targetReceivedBytesPerSecond"];
}
- if (_json.containsKey("targetReceivedPacketsPerSec")) {
- targetReceivedPacketsPerSec = _json["targetReceivedPacketsPerSec"];
+ if (_json.containsKey("targetReceivedPacketsPerSecond")) {
+ targetReceivedPacketsPerSecond = _json["targetReceivedPacketsPerSecond"];
}
- if (_json.containsKey("targetSentBytesPerSec")) {
- targetSentBytesPerSec = _json["targetSentBytesPerSec"];
+ if (_json.containsKey("targetSentBytesPerSecond")) {
+ targetSentBytesPerSecond = _json["targetSentBytesPerSecond"];
}
- if (_json.containsKey("targetSentPacketsPerSec")) {
- targetSentPacketsPerSec = _json["targetSentPacketsPerSec"];
+ if (_json.containsKey("targetSentPacketsPerSecond")) {
+ targetSentPacketsPerSecond = _json["targetSentPacketsPerSecond"];
}
}
core.Map toJson() {
var _json = new core.Map();
- if (targetReceivedBytesPerSec != null) {
- _json["targetReceivedBytesPerSec"] = targetReceivedBytesPerSec;
+ if (targetReceivedBytesPerSecond != null) {
+ _json["targetReceivedBytesPerSecond"] = targetReceivedBytesPerSecond;
}
- if (targetReceivedPacketsPerSec != null) {
- _json["targetReceivedPacketsPerSec"] = targetReceivedPacketsPerSec;
+ if (targetReceivedPacketsPerSecond != null) {
+ _json["targetReceivedPacketsPerSecond"] = targetReceivedPacketsPerSecond;
}
- if (targetSentBytesPerSec != null) {
- _json["targetSentBytesPerSec"] = targetSentBytesPerSec;
+ if (targetSentBytesPerSecond != null) {
+ _json["targetSentBytesPerSecond"] = targetSentBytesPerSecond;
}
- if (targetSentPacketsPerSec != null) {
- _json["targetSentPacketsPerSec"] = targetSentPacketsPerSec;
+ if (targetSentPacketsPerSecond != null) {
+ _json["targetSentPacketsPerSecond"] = targetSentPacketsPerSecond;
}
return _json;
}
@@ -2470,29 +2507,26 @@ class Operation {
/** Metadata for the given google.longrunning.Operation. */
class OperationMetadata {
- /**
- * Timestamp that this operation was completed. (Not present if the operation
- * is still in progress.) @OutputOnly
- */
+ /** Timestamp that this operation completed. @OutputOnly */
core.String endTime;
- /** Timestamp that this operation was received. @OutputOnly */
+ /** Timestamp that this operation was created. @OutputOnly */
core.String insertTime;
/**
- * API method name that initiated the operation. Example:
- * "google.appengine.v1beta4.Version.CreateVersion". @OutputOnly
+ * API method that initiated this operation. Example:
+ * `google.appengine.v1beta4.Version.CreateVersion`. @OutputOnly
*/
core.String method;
/**
- * The type of the operation (deprecated, use method field instead). Example:
+ * Type of this operation. Deprecated, use method field instead. Example:
* "create_version". @OutputOnly
*/
core.String operationType;
/**
- * Resource that this operation is acting on. Example:
- * "apps/myapp/modules/default". @OutputOnly
+ * Name of the resource that this operation is acting on. Example:
+ * `apps/myapp/modules/default`. @OutputOnly
*/
core.String target;
- /** The user who requested this operation. @OutputOnly */
+ /** User who requested this operation. @OutputOnly */
core.String user;
OperationMetadata();
@@ -2544,24 +2578,21 @@ class OperationMetadata {
/** Metadata for the given google.longrunning.Operation. */
class OperationMetadataV1 {
- /**
- * Timestamp that this operation was completed. (Not present if the operation
- * is still in progress.) @OutputOnly
- */
+ /** Time that this operation completed. @OutputOnly */
core.String endTime;
- /** Timestamp that this operation was received. @OutputOnly */
+ /** Time that this operation was created. @OutputOnly */
core.String insertTime;
/**
- * API method name that initiated the operation. Example:
- * "google.appengine.v1.Version.CreateVersion". @OutputOnly
+ * API method that initiated this operation. Example:
+ * `google.appengine.v1.Versions.CreateVersion`. @OutputOnly
*/
core.String method;
/**
- * Resource that this operation is acting on. Example:
- * "apps/myapp/services/default". @OutputOnly
+ * Name of the resource that this operation is acting on. Example:
+ * `apps/myapp/services/default`. @OutputOnly
*/
core.String target;
- /** The user who requested this operation. @OutputOnly */
+ /** User who requested this operation. @OutputOnly */
core.String user;
OperationMetadataV1();
@@ -2607,24 +2638,21 @@ class OperationMetadataV1 {
/** Metadata for the given google.longrunning.Operation. */
class OperationMetadataV1Beta5 {
- /**
- * Timestamp that this operation was completed. (Not present if the operation
- * is still in progress.) @OutputOnly
- */
+ /** Timestamp that this operation completed. @OutputOnly */
core.String endTime;
- /** Timestamp that this operation was received. @OutputOnly */
+ /** Timestamp that this operation was created. @OutputOnly */
core.String insertTime;
/**
- * API method name that initiated the operation. Example:
- * "google.appengine.v1beta5.Version.CreateVersion". @OutputOnly
+ * API method name that initiated this operation. Example:
+ * `google.appengine.v1beta5.Version.CreateVersion`. @OutputOnly
*/
core.String method;
/**
- * Resource that this operation is acting on. Example:
- * "apps/myapp/services/default". @OutputOnly
+ * Name of the resource that this operation is acting on. Example:
+ * `apps/myapp/services/default`. @OutputOnly
*/
core.String target;
- /** The user who requested this operation. @OutputOnly */
+ /** User who requested this operation. @OutputOnly */
core.String user;
OperationMetadataV1Beta5();
@@ -2668,12 +2696,26 @@ class OperationMetadataV1Beta5 {
}
}
-/** Target scaling by request utilization (for VM runtimes only). */
+/** Request message for 'Applications.RepairApplication'. */
+class RepairApplicationRequest {
+
+ RepairApplicationRequest();
+
+ RepairApplicationRequest.fromJson(core.Map _json) {
+ }
+
+ core.Map toJson() {
+ var _json = new core.Map();
+ return _json;
+ }
+}
+
+/** Target scaling by request utilization. Only applicable for VM runtimes. */
class RequestUtilization {
/** Target number of concurrent requests. */
core.int targetConcurrentRequests;
/** Target requests per second. */
- core.int targetRequestCountPerSec;
+ core.int targetRequestCountPerSecond;
RequestUtilization();
@@ -2681,8 +2723,8 @@ class RequestUtilization {
if (_json.containsKey("targetConcurrentRequests")) {
targetConcurrentRequests = _json["targetConcurrentRequests"];
}
- if (_json.containsKey("targetRequestCountPerSec")) {
- targetRequestCountPerSec = _json["targetRequestCountPerSec"];
+ if (_json.containsKey("targetRequestCountPerSecond")) {
+ targetRequestCountPerSecond = _json["targetRequestCountPerSecond"];
}
}
@@ -2691,20 +2733,20 @@ class RequestUtilization {
if (targetConcurrentRequests != null) {
_json["targetConcurrentRequests"] = targetConcurrentRequests;
}
- if (targetRequestCountPerSec != null) {
- _json["targetRequestCountPerSec"] = targetRequestCountPerSec;
+ if (targetRequestCountPerSecond != null) {
+ _json["targetRequestCountPerSecond"] = targetRequestCountPerSecond;
}
return _json;
}
}
-/** Used to specify how many machine resources an app version needs. */
+/** Machine resources for a version. */
class Resources {
- /** How many CPU cores an app version needs. */
+ /** Number of CPU cores needed. */
core.double cpu;
- /** How much disk size, in GB, an app version needs. */
+ /** Disk size (GB) needed. */
core.double diskGb;
- /** How much memory, in GB, an app version needs. */
+ /** Memory (GB) needed. */
core.double memoryGb;
Resources();
@@ -2738,7 +2780,7 @@ class Resources {
/** Executes a script to handle the request that matches the URL pattern. */
class ScriptHandler {
- /** Specifies the path to the script from the application root directory. */
+ /** Path to the script from the application root directory. */
core.String scriptPath;
ScriptHandler();
@@ -2759,26 +2801,26 @@ class ScriptHandler {
}
/**
- * A service is a logical component of an application that can share state and
- * communicate in a secure fashion with other services. For example, an
- * application that handles customer requests might include separate services to
- * handle other tasks such as API requests from mobile devices or backend data
- * analysis. Each service has a collection of versions that define a specific
- * set of code used to implement the functionality of that service.
+ * A Service resource is a logical component of an application that can share
+ * state and communicate in a secure fashion with other services. For example,
+ * an application that handles customer requests might include separate services
+ * to handle tasks such as backend data analysis or API requests from mobile
+ * devices. Each service has a collection of versions that define a specific set
+ * of code used to implement the functionality of that service.
*/
class Service {
/**
- * The relative name/path of the service within the application. Example:
- * "default" @OutputOnly
+ * Relative name of the service within the application. Example: `default`.
+ * @OutputOnly
*/
core.String id;
/**
- * The full path to the Service resource in the API. Example:
- * "apps/myapp/services/default" @OutputOnly
+ * Full path to the Service resource in the API. Example:
+ * `apps/myapp/services/default`. @OutputOnly
*/
core.String name;
/**
- * A mapping that defines fractional HTTP traffic diversion to different
+ * Mapping that defines fractional HTTP traffic diversion to different
* versions within the service.
*/
TrafficSplit split;
@@ -2813,46 +2855,6 @@ class Service {
}
/**
- * A reference to a particular snapshot of the source tree used to build and
- * deploy the application.
- */
-class SourceReference {
- /**
- * Optional. A URI string identifying the repository. Example:
- * "https://source.developers.google.com/p/app-123/r/default"
- */
- core.String repository;
- /**
- * The canonical (and persistent) identifier of the deployed revision, i.e.
- * any kind of aliases including tags or branch names are not allowed. Example
- * (git): "2198322f89e0bb2e25021667c2ed489d1fd34e6b"
- */
- core.String revisionId;
-
- SourceReference();
-
- SourceReference.fromJson(core.Map _json) {
- if (_json.containsKey("repository")) {
- repository = _json["repository"];
- }
- if (_json.containsKey("revisionId")) {
- revisionId = _json["revisionId"];
- }
- }
-
- core.Map toJson() {
- var _json = new core.Map();
- if (repository != null) {
- _json["repository"] = repository;
- }
- if (revisionId != null) {
- _json["revisionId"] = revisionId;
- }
- return _json;
- }
-}
-
-/**
* Files served directly to the user for a given URL, such as images, CSS
* stylesheets, or JavaScript source files. Static file handlers describe which
* files in the application directory are static files, and which URLs serve
@@ -2860,40 +2862,39 @@ class SourceReference {
*/
class StaticFilesHandler {
/**
- * By default, files declared in static file handlers are uploaded as static
- * data and are only served to end users, they cannot be read by an
- * application. If this field is set to true, the files are also uploaded as
- * code data so your application can read them. Both uploads are charged
- * against your code and static data storage resource quotas.
+ * Whether files should also be uploaded as code data. By default, files
+ * declared in static file handlers are uploaded as static data and are only
+ * served to end users; they cannot be read by the application. If enabled,
+ * uploads are charged against both your code and static data storage resource
+ * quotas.
*/
core.bool applicationReadable;
/**
- * The length of time a static file served by this handler ought to be cached
- * by web proxies and browsers.
+ * Time a static file served by this handler should be cached by web proxies
+ * and browsers.
*/
core.String expiration;
/** HTTP headers to use for all responses from these URLs. */
core.Map<core.String, core.String> httpHeaders;
/**
- * If specified, all files served by this handler will be served using the
- * specified MIME type. If not specified, the MIME type for a file will be
- * derived from the file's filename extension.
+ * MIME type used to serve all files served by this handler. Defaults to
+ * file-specific MIME types, which are derived from each file's filename
+ * extension.
*/
core.String mimeType;
/**
- * The path to the static files matched by the URL pattern, from the
- * application root directory. The path can refer to text matched in groupings
- * in the URL pattern.
+ * Path to the static files matched by the URL pattern, from the application
+ * root directory. The path can refer to text matched in groupings in the URL
+ * pattern.
*/
core.String path;
/**
- * If true, this UrlMap entry does not match the request unless the file
- * referenced by the handler also exists. If no such file exists, processing
- * will continue with the next UrlMap that matches the requested URL.
+ * Whether this handler should match the request if the file referenced by the
+ * handler does not exist.
*/
core.bool requireMatchingFile;
/**
- * A regular expression that matches the file paths for all files that will be
+ * Regular expression that matches the file paths for all files that should be
* referenced by this handler.
*/
core.String uploadPathRegex;
@@ -3034,27 +3035,24 @@ class Status {
}
/**
- * Configuration for traffic splitting for versions within a single service.
- * Traffic splitting allows traffic directed to the service to be assigned to
- * one of several versions in a fractional way, enabling experiments and
- * canarying new builds, for example.
+ * Traffic routing configuration for versions within a single service. Traffic
+ * splits define how traffic directed to the service is assigned to versions.
*/
class TrafficSplit {
/**
- * Mapping from service version IDs within the service to fractional (0.000,
- * 1] allocations of traffic for that version. Each version may only be
- * specified once, but some versions in the service may not have any traffic
- * allocation. Services that have traffic allocated in this field may not be
- * deleted until the service is deleted, or their traffic allocation is
- * removed. Allocations must sum to 1. Supports precision up to two decimal
- * places for IP-based splits and up to three decimal places for cookie-based
- * splits.
+ * Mapping from version IDs within the service to fractional (0.000, 1]
+ * allocations of traffic for that version. Each version can be specified only
+ * once, but some versions in the service may not have any traffic allocation.
+ * Services that have traffic allocated cannot be deleted until either the
+ * service is deleted or their traffic allocation is removed. Allocations must
+ * sum to 1. Up to two decimal place precision is supported for IP-based
+ * splits and up to three decimal places is supported for cookie-based splits.
*/
core.Map<core.String, core.double> allocations;
/**
- * Which mechanism should be used as a selector when choosing a version to
- * send a request to. The traffic selection algorithm will be stable for
- * either type until allocations are changed.
+ * Mechanism used to determine which version a request is sent to. The traffic
+ * selection algorithm will be stable for either type until allocations are
+ * changed.
* Possible string values are:
* - "UNSPECIFIED" : A UNSPECIFIED.
* - "COOKIE" : A COOKIE.
@@ -3088,20 +3086,19 @@ class TrafficSplit {
/** Rules to match an HTTP request and dispatch that request to a service. */
class UrlDispatchRule {
/**
- * The domain name to match on. Supports '*' (glob) wildcarding on the
- * left-hand side of a '.'. If empty, all domains will be matched (the same as
- * '*').
+ * Domain name to match against. The wildcard "`*`" is supported if specified
+ * before a period: "`*.`". Defaults to matching all domains: "`*`".
*/
core.String domain;
/**
- * The pathname within the host. This must start with a '/'. A single '*'
- * (glob) can be included at the end of the path. The sum of the lengths of
- * the domain and path may not exceed 100 characters.
+ * Pathname within the host. Must start with a "`/`". A single "`*`" can be
+ * included at the end of the path. The sum of the lengths of the domain and
+ * path may not exceed 100 characters.
*/
core.String path;
/**
- * The resource id of a Service in this application that should service the
- * matched request. The Service must already exist. Example: "default".
+ * Resource ID of a service in this application that should serve the matched
+ * request. The service must already exist. Example: `default`.
*/
core.String service;
@@ -3135,16 +3132,16 @@ class UrlDispatchRule {
}
/**
- * A URL pattern and description of how it should be handled. App Engine can
- * handle URLs by executing application code, or by serving static files
- * uploaded with the code, such as images, CSS or JavaScript.
+ * URL pattern and description of how the URL should be handled. App Engine can
+ * handle URLs by executing application code or by serving static files uploaded
+ * with the version, such as images, CSS, or JavaScript.
*/
class UrlMap {
- /** Use API Endpoints to handle requests. */
+ /** Uses API Endpoints to handle requests. */
ApiEndpointHandler apiEndpoint;
/**
- * For users not logged in, how to handle access to resources with required
- * login. Defaults to "redirect".
+ * Action to take when users access resources that require authentication.
+ * Defaults to `redirect`.
* Possible string values are:
* - "AUTH_FAIL_ACTION_UNSPECIFIED" : A AUTH_FAIL_ACTION_UNSPECIFIED.
* - "AUTH_FAIL_ACTION_REDIRECT" : A AUTH_FAIL_ACTION_REDIRECT.
@@ -3152,7 +3149,7 @@ class UrlMap {
*/
core.String authFailAction;
/**
- * What level of login is required to access this resource.
+ * Level of login required to access this resource.
* Possible string values are:
* - "LOGIN_UNSPECIFIED" : A LOGIN_UNSPECIFIED.
* - "LOGIN_OPTIONAL" : A LOGIN_OPTIONAL.
@@ -3161,8 +3158,8 @@ class UrlMap {
*/
core.String login;
/**
- * `30x` code to use when performing redirects for the `secure` field. A `302`
- * is used by default.
+ * `30x` code to use when performing redirects for the `secure` field.
+ * Defaults to `302`.
* Possible string values are:
* - "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED" : A
* REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED.
@@ -3172,10 +3169,10 @@ class UrlMap {
* - "REDIRECT_HTTP_RESPONSE_CODE_307" : A REDIRECT_HTTP_RESPONSE_CODE_307.
*/
core.String redirectHttpResponseCode;
- /** Executes a script to handle the request that matches the URL pattern. */
+ /** Executes a script to handle the request that matches this URL pattern. */
ScriptHandler script;
/**
- * Configures whether security (HTTPS) should be enforced for this URL.
+ * Security (HTTPS) enforcement for this URL.
* Possible string values are:
* - "SECURE_UNSPECIFIED" : A SECURE_UNSPECIFIED.
* - "SECURE_DEFAULT" : A SECURE_DEFAULT.
@@ -3187,11 +3184,10 @@ class UrlMap {
/** Returns the contents of a file, such as an image, as the response. */
StaticFilesHandler staticFiles;
/**
- * A URL prefix. This value uses regular expression syntax (and so regexp
- * special characters must be escaped), but it should not contain groupings.
- * All URLs that begin with this prefix are handled by this handler, using the
- * portion of the URL after the prefix as part of the file path. This is
- * always required.
+ * URL prefix. Uses regular expression syntax, which means regexp special
+ * characters must be escaped, but should not contain groupings. All URLs that
+ * begin with this prefix are handled by this handler, using the portion of
+ * the URL after the prefix as part of the file path.
*/
core.String urlRegex;
@@ -3255,19 +3251,18 @@ class UrlMap {
}
/**
- * A Version is a specific set of source code and configuration files deployed
- * to a service.
+ * A Version resource is a specific set of source code and configuration files
+ * that are deployed into a service.
*/
class Version {
/**
- * Serving configuration for Google Cloud Endpoints. Only returned in `GET`
- * requests if `view=FULL` is set. May only be set on create requests; once
- * created, is immutable.
+ * Serving configuration for [Google Cloud
+ * Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/). Only
+ * returned in `GET` requests if `view=FULL` is set.
*/
ApiConfigHandler apiConfig;
/**
- * Automatic scaling is the scaling policy that App Engine has used since its
- * inception. It is based on request rate, response latencies, and other
+ * Automatic scaling is based on request rate, response latencies, and other
* application metrics.
*/
AutomaticScaling automaticScaling;
@@ -3278,67 +3273,64 @@ class Version {
* user activity.
*/
BasicScaling basicScaling;
- /** Beta settings supplied to the application via metadata. */
- core.Map<core.String, core.String> betaSettings;
/**
- * Creation time of this version. This will be between the start and end times
- * of the operation that creates this version. @OutputOnly
+ * Metadata settings that are supplied to this version to enable beta runtime
+ * features.
*/
- core.String creationTime;
+ core.Map<core.String, core.String> betaSettings;
+ /** Time that this version was created. @OutputOnly */
+ core.String createTime;
+ /** Email address of the user who created this version. @OutputOnly */
+ core.String createdBy;
/**
- * The length of time a static file served by a static file handler ought to
- * be cached by web proxies and browsers, if the handler does not specify its
- * own expiration. Only returned in `GET` requests if `view=FULL` is set. May
- * only be set on create requests; once created, is immutable.
+ * Duration that static files should be cached by web proxies and browsers.
+ * Only applicable if the corresponding
+ * [StaticFilesHandler](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#staticfileshandler)
+ * does not specify its own expiration time. Only returned in `GET` requests
+ * if `view=FULL` is set.
*/
core.String defaultExpiration;
- /** The email address of the user who created this version. @OutputOnly */
- core.String deployer;
/**
* Code and application artifacts that make up this version. Only returned in
- * `GET` requests if `view=FULL` is set. May only be set on create requests;
- * once created, is immutable.
+ * `GET` requests if `view=FULL` is set.
*/
Deployment deployment;
/**
- * Total size of version files hosted on App Engine disk in bytes. @OutputOnly
+ * Total size in bytes of all the files that are included in this version and
+ * curerntly hosted on the App Engine disk. @OutputOnly
*/
core.String diskUsageBytes;
/**
- * The App Engine execution environment to use for this version. Default: "1"
+ * App Engine execution environment for this version. Defaults to `standard`.
*/
core.String env;
/**
- * Environment variables made available to the application. Only returned in
- * `GET` requests if `view=FULL` is set. May only be set on create requests;
- * once created, is immutable.
+ * Environment variables available to the application. Only returned in `GET`
+ * requests if `view=FULL` is set.
*/
core.Map<core.String, core.String> envVariables;
/**
- * Custom static error pages instead of these generic error pages, (limit 10
- * KB/page) Only returned in `GET` requests if `view=FULL` is set. May only be
- * set on create requests; once created, is immutable.
+ * Custom static error pages. Limited to 10KB per page. Only returned in `GET`
+ * requests if `view=FULL` is set.
*/
core.List<ErrorHandler> errorHandlers;
/**
- * An ordered list of URL Matching patterns that should be applied to incoming
- * requests. The first matching URL consumes the request, and subsequent
+ * An ordered list of URL-matching patterns that should be applied to incoming
+ * requests. The first matching URL handles the request and other request
* handlers are not attempted. Only returned in `GET` requests if `view=FULL`
- * is set. May only be set on create requests; once created, is immutable.
+ * is set.
*/
core.List<UrlMap> handlers;
/**
- * Configure health checking for the VM instances. Unhealthy VM instances will
- * be stopped and replaced with new instances. Only returned in `GET` requests
- * if `view=FULL` is set. May only be set on create requests; once created, is
- * immutable.
+ * Configures health checking for VM instances. Unhealthy instances are
+ * stopped and replaced with new instances. Only applicable for VM runtimes.
+ * Only returned in `GET` requests if `view=FULL` is set.
*/
HealthCheck healthCheck;
/**
- * The relative name/path of the Version within the service. Example: "v1".
- * Version specifiers can contain lowercase letters, digits, and hyphens. It
- * cannot begin with the prefix `ah-` and the names `default` and `latest` are
- * reserved and cannot be used.
+ * Relative name of the version within the service. Example: `v1`. Version
+ * names can contain only lowercase letters, numbers, or hyphens. Reserved
+ * names: "default", "latest", and any name with the prefix "ah-".
*/
core.String id;
/**
@@ -3347,16 +3339,15 @@ class Version {
*/
core.List<core.String> inboundServices;
/**
- * The instance class to use to run this app. Valid values for
- * AutomaticScaling are `[F1, F2, F4, F4_1G]`. Valid values for ManualScaling
- * and BasicScaling are `[B1, B2, B4, B8, B4_1G]`. Default: "F1" for
- * AutomaticScaling, "B1" for ManualScaling and BasicScaling
+ * Instance class that is used to run this version. Valid values are: *
+ * AutomaticScaling: `F1`, `F2`, `F4`, `F4_1G` * ManualScaling or
+ * BasicScaling: `B1`, `B2`, `B4`, `B8`, `B4_1G` Defaults to `F1` for
+ * AutomaticScaling and `B1` for ManualScaling or BasicScaling.
*/
core.String instanceClass;
/**
- * Configuration for Python runtime third-party libraries required by the
- * application. Only returned in `GET` requests if `view=FULL` is set. May
- * only be set on create requests; once created, is immutable.
+ * Configuration for third-party Python runtime libraries that are required by
+ * the application. Only returned in `GET` requests if `view=FULL` is set.
*/
core.List<Library> libraries;
/**
@@ -3365,38 +3356,40 @@ class Version {
*/
ManualScaling manualScaling;
/**
- * The full path to the Version resource in the API. Example:
- * "apps/myapp/services/default/versions/v1". @OutputOnly
+ * Full path to the Version resource in the API. Example:
+ * `apps/myapp/services/default/versions/v1`. @OutputOnly
*/
core.String name;
- /** Used to specify extra network settings (for VM runtimes only). */
+ /** Extra network settings. Only applicable for VM runtimes. */
Network network;
/**
- * Go only. Files that match this pattern will not be built into the app. May
- * only be set on create requests.
+ * Files that match this pattern will not be built into this version. Only
+ * applicable for Go runtimes. Only returned in `GET` requests if `view=FULL`
+ * is set.
*/
core.String nobuildFilesRegex;
- /**
- * Used to specify how many machine resources an app version needs (for VM
- * runtimes only).
- */
+ /** Machine resources for this version. Only applicable for VM runtimes. */
Resources resources;
- /** The desired runtime. Values can include python27, java7, go, etc. */
+ /** Desired runtime. Example: `python27`. */
core.String runtime;
/**
- * The current serving status of this version. Only `SERVING` versions will
- * have instances created or billed for. If this field is unset when a version
- * is created, `SERVING` status will be assumed. It is an error to explicitly
- * set this field to `SERVING_STATUS_UNSPECIFIED`.
+ * Current serving status of this version. Only the versions with a `SERVING`
+ * status create instances and can be billed. `SERVING_STATUS_UNSPECIFIED` is
+ * an invalid value. Defaults to `SERVING`.
* Possible string values are:
* - "SERVING_STATUS_UNSPECIFIED" : A SERVING_STATUS_UNSPECIFIED.
* - "SERVING" : A SERVING.
* - "STOPPED" : A STOPPED.
*/
core.String servingStatus;
- /** If true, multiple requests can be dispatched to the app at once. */
+ /** Whether multiple requests can be dispatched to this version at once. */
core.bool threadsafe;
- /** Whether to deploy this app in a VM container. */
+ /**
+ * Serving URL for this version. Example:
+ * "https://myversion-dot-myservice-dot-myapp.appspot.com" @OutputOnly
+ */
+ core.String versionUrl;
+ /** Whether to deploy this version in a container on a virtual machine. */
core.bool vm;
Version();
@@ -3414,15 +3407,15 @@ class Version {
if (_json.containsKey("betaSettings")) {
betaSettings = _json["betaSettings"];
}
- if (_json.containsKey("creationTime")) {
- creationTime = _json["creationTime"];
+ if (_json.containsKey("createTime")) {
+ createTime = _json["createTime"];
+ }
+ if (_json.containsKey("createdBy")) {
+ createdBy = _json["createdBy"];
}
if (_json.containsKey("defaultExpiration")) {
defaultExpiration = _json["defaultExpiration"];
}
- if (_json.containsKey("deployer")) {
- deployer = _json["deployer"];
- }
if (_json.containsKey("deployment")) {
deployment = new Deployment.fromJson(_json["deployment"]);
}
@@ -3480,6 +3473,9 @@ class Version {
if (_json.containsKey("threadsafe")) {
threadsafe = _json["threadsafe"];
}
+ if (_json.containsKey("versionUrl")) {
+ versionUrl = _json["versionUrl"];
+ }
if (_json.containsKey("vm")) {
vm = _json["vm"];
}
@@ -3499,15 +3495,15 @@ class Version {
if (betaSettings != null) {
_json["betaSettings"] = betaSettings;
}
- if (creationTime != null) {
- _json["creationTime"] = creationTime;
+ if (createTime != null) {
+ _json["createTime"] = createTime;
+ }
+ if (createdBy != null) {
+ _json["createdBy"] = createdBy;
}
if (defaultExpiration != null) {
_json["defaultExpiration"] = defaultExpiration;
}
- if (deployer != null) {
- _json["deployer"] = deployer;
- }
if (deployment != null) {
_json["deployment"] = (deployment).toJson();
}
@@ -3565,9 +3561,48 @@ class Version {
if (threadsafe != null) {
_json["threadsafe"] = threadsafe;
}
+ if (versionUrl != null) {
+ _json["versionUrl"] = versionUrl;
+ }
if (vm != null) {
_json["vm"] = vm;
}
return _json;
}
}
+
+class ZipInfo {
+ /**
+ * An estimate of the number of files in a zip for a zip deployment. If set,
+ * must be greater than or equal to the actual number of files. Used for
+ * optimizing performance; if not provided, deployment may be slow.
+ */
+ core.int filesCount;
+ /**
+ * URL of the zip file to deploy from. Must be a URL to a resource in Google
+ * Cloud Storage in the form 'http(s)://storage.googleapis.com/\/\'.
+ */
+ core.String sourceUrl;
+
+ ZipInfo();
+
+ ZipInfo.fromJson(core.Map _json) {
+ if (_json.containsKey("filesCount")) {
+ filesCount = _json["filesCount"];
+ }
+ if (_json.containsKey("sourceUrl")) {
+ sourceUrl = _json["sourceUrl"];
+ }
+ }
+
+ core.Map toJson() {
+ var _json = new core.Map();
+ if (filesCount != null) {
+ _json["filesCount"] = filesCount;
+ }
+ if (sourceUrl != null) {
+ _json["sourceUrl"] = sourceUrl;
+ }
+ return _json;
+ }
+}
« no previous file with comments | « generated/googleapis/lib/androidpublisher/v2.dart ('k') | generated/googleapis/lib/bigquery/v2.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698