Api-roll 42: 2016-11-08

generated/googleapis/lib/appengine/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.appengine.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 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/v1';
 
 /** Provisions and manages App Engine applications. */
 class AppengineApi {
+  /** View and manage your applications deployed on Google App Engine */
+  static const AppengineAdminScope = "https://www.googleapis.com/auth/appengine.admin";
+
   /** View and manage your data across Google Cloud Platform services */
   static const CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform";
 
+  /** View your data across Google Cloud Platform services */
+  static const CloudPlatformReadOnlyScope = "https://www.googleapis.com/auth/cloud-platform.read-only";
+
 
   final commons.ApiRequester _requester;
 
   AppsResourceApi get apps => new AppsResourceApi(_requester);
+  ExperimentalResourceApi get experimental => new ExperimentalResourceApi(_requester);
 
   AppengineApi(http.Client client, {core.String rootUrl: "https://appengine.googleapis.com/", core.String servicePath: ""}) :
       _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
 }
 
 
 class AppsResourceApi {
   final commons.ApiRequester _requester;
 
   AppsLocationsResourceApi get locations => new AppsLocationsResourceApi(_requester);
   AppsOperationsResourceApi get operations => new AppsOperationsResourceApi(_requester);
   AppsServicesResourceApi get services => new AppsServicesResourceApi(_requester);
 
   AppsResourceApi(commons.ApiRequester client) : 
       _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.
+   *
+   * Request parameters:
+   *
+   * Completes with a [Operation].
+   *
+   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * 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) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+
+    _url = 'v1/apps';
+
+    var _response = _requester.request(_url,
+                                       "POST",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Operation.fromJson(data));
+  }
+
+  /**
    * Gets information about an application.
    *
    * Request parameters:
    *
    * [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
@@ skipping 20 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Application.fromJson(data));
   }
 
   /**
+   * Updates application fields.
+   *
+   * [request] - The metadata request object.
+   *
+   * Request parameters:
+   *
+   * [appsId] - Part of `name`. Name of the application to update. Example:
+   * `apps/myapp`.
+   *
+   * [updateMask] - Standard field mask for the set of fields to be updated.
+   *
+   * Completes with a [Operation].
+   *
+   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * 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(Application request, core.String appsId, {core.String updateMask}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    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 (updateMask != null) {
+      _queryParams["updateMask"] = [updateMask];
+    }
+
+    _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId');
+
+    var _response = _requester.request(_url,
+                                       "PATCH",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Operation.fromJson(data));
+  }
+
+  /**
    * 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] - The metadata request object.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. Name of the application to repair. Example:
@@ skipping 1023 matching lines @@
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListInstancesResponse.fromJson(data));
   }
 
 }
 
 
+class ExperimentalResourceApi {
+  final commons.ApiRequester _requester;
+
+  ExperimentalAppsResourceApi get apps => new ExperimentalAppsResourceApi(_requester);
+
+  ExperimentalResourceApi(commons.ApiRequester client) : 
+      _requester = client;
+}
+
+
+class ExperimentalAppsResourceApi {
+  final commons.ApiRequester _requester;
+
+  ExperimentalAppsOperationsResourceApi get operations => new ExperimentalAppsOperationsResourceApi(_requester);
+
+  ExperimentalAppsResourceApi(commons.ApiRequester client) : 
+      _requester = client;
+}
+
+
+class ExperimentalAppsOperationsResourceApi {
+  final commons.ApiRequester _requester;
+
+  ExperimentalAppsOperationsResourceApi(commons.ApiRequester client) : 
+      _requester = client;
+
+  /**
+   * Gets the latest state of a long-running operation. Clients can use this
+   * method to poll the operation result at intervals as recommended by the API
+   * service.
+   *
+   * Request parameters:
+   *
+   * [appsId] - Part of `name`. The name of the operation resource.
+   *
+   * [operationsId] - Part of `name`. See documentation of `appsId`.
+   *
+   * Completes with a [Operation].
+   *
+   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * 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> get(core.String appsId, core.String operationsId) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (appsId == null) {
+      throw new core.ArgumentError("Parameter appsId is required.");
+    }
+    if (operationsId == null) {
+      throw new core.ArgumentError("Parameter operationsId is required.");
+    }
+
+    _url = 'experimental/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations/' + commons.Escaper.ecapeVariable('$operationsId');
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Operation.fromJson(data));
+  }
+
+  /**
+   * Lists operations that match the specified filter in the request. If the
+   * server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the
+   * `name` binding below allows API services to override the binding to use
+   * different resource name schemes, such as `users / * /operations`.
+   *
+   * Request parameters:
+   *
+   * [appsId] - Part of `name`. The name of the operation collection.
+   *
+   * [filter] - The standard list filter.
+   *
+   * [pageSize] - The standard list page size.
+   *
+   * [pageToken] - The standard list page token.
+   *
+   * Completes with a [ListOperationsResponse].
+   *
+   * Completes with a [commons.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * If the used [http.Client] completes with an error when making a REST call,
+   * this method will complete with the same error.
+   */
+  async.Future<ListOperationsResponse> list(core.String appsId, {core.String filter, core.int pageSize, core.String pageToken}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (appsId == null) {
+      throw new core.ArgumentError("Parameter appsId is required.");
+    }
+    if (filter != null) {
+      _queryParams["filter"] = [filter];
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+
+    _url = 'experimental/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new ListOperationsResponse.fromJson(data));
+  }
+
+}
+
+
 
 /**
  * [Google Cloud
  * Endpoints](https://cloud.google.com/appengine/docs/python/endpoints/)
  * configuration for API handlers.
  */
 class ApiConfigHandler {
   /**
    * Action to take when users access resources that require authentication.
    * Defaults to `redirect`.
@@ skipping 439 matching lines @@
     }
     if (targetUtilization != null) {
       _json["targetUtilization"] = targetUtilization;
     }
     return _json;
   }
 }
 
 /** Request message for `Instances.DebugInstance`. */
 class DebugInstanceRequest {
+  /**
+   * Public SSH key to add to the instance. Example: `[USERNAME]:ssh-rsa
+   * KEY_VALUE` or `[USERNAME]:ssh-rsa [KEY_VALUE] google-ssh
+   * {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}` For more information,
+   * see [Adding and Removing SSH
+   * Keys](https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys)
+   */
+  core.String sshKey;
 
   DebugInstanceRequest();
 
   DebugInstanceRequest.fromJson(core.Map _json) {
+    if (_json.containsKey("sshKey")) {
+      sshKey = _json["sshKey"];
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (sshKey != null) {
+      _json["sshKey"] = sshKey;
+    }
     return _json;
   }
 }
 
 /** Code and application artifacts used to deploy a version to App Engine. */
 class Deployment {
   /**
    * A Docker image that App Engine uses to run the version. Only applicable for
    * instances in App Engine flexible environment.
    */
@@ skipping 301 matching lines @@
    * 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;
   /**
+   * The IP address of this instance. Only applicable for instances in App
+   * Engine flexible environment. @OutputOnly
+   */
+  core.String vmIp;
+  /**
    * Name of the virtual machine where this instance lives. Only applicable for
    * instances in App Engine flexible environment. @OutputOnly
    */
   core.String vmName;
   /**
    * Status of the virtual machine where this instance lives. Only applicable
    * for instances in App Engine flexible environment. @OutputOnly
    */
   core.String vmStatus;
   /**
@@ skipping 34 matching lines @@
     }
     if (_json.containsKey("startTime")) {
       startTime = _json["startTime"];
     }
     if (_json.containsKey("vmDebugEnabled")) {
       vmDebugEnabled = _json["vmDebugEnabled"];
     }
     if (_json.containsKey("vmId")) {
       vmId = _json["vmId"];
     }
+    if (_json.containsKey("vmIp")) {
+      vmIp = _json["vmIp"];
+    }
     if (_json.containsKey("vmName")) {
       vmName = _json["vmName"];
     }
     if (_json.containsKey("vmStatus")) {
       vmStatus = _json["vmStatus"];
     }
     if (_json.containsKey("vmZoneName")) {
       vmZoneName = _json["vmZoneName"];
     }
   }
@@ skipping 29 matching lines @@
     }
     if (startTime != null) {
       _json["startTime"] = startTime;
     }
     if (vmDebugEnabled != null) {
       _json["vmDebugEnabled"] = vmDebugEnabled;
     }
     if (vmId != null) {
       _json["vmId"] = vmId;
     }
+    if (vmIp != null) {
+      _json["vmIp"] = vmIp;
+    }
     if (vmName != null) {
       _json["vmName"] = vmName;
     }
     if (vmStatus != null) {
       _json["vmStatus"] = vmStatus;
     }
     if (vmZoneName != null) {
       _json["vmZoneName"] = vmZoneName;
     }
     return _json;
@@ skipping 180 matching lines @@
   }
 }
 
 /** A resource that represents Google Cloud Platform location. */
 class Location {
   /**
    * Cross-service attributes for the location. For example
    * {"cloud.googleapis.com/region": "us-east1"}
    */
   core.Map<core.String, core.String> labels;
-  /** The cononical id for this location. For example: `"us-east1"`. */
+  /** The canonical id for this location. For example: `"us-east1"`. */
   core.String locationId;
   /**
    * Service-specific metadata. For example the available capacity at the given
    * location.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
   core.Map<core.String, core.Object> metadata;
   /**
@@ skipping 197 matching lines @@
  * This resource represents a long-running operation that is the result of a
  * network API call.
  */
 class Operation {
   /**
    * If the value is `false`, it means the operation is still in progress. If
    * true, the operation is completed, and either `error` or `response` is
    * available.
    */
   core.bool done;
-  /** The error result of the operation in case of failure. */
+  /** The error result of the operation in case of failure or cancellation. */
   Status error;
   /**
    * Service-specific metadata associated with the operation. It typically
    * contains progress information and common metadata such as create time. Some
    * services might not provide such metadata. Any method that returns a
    * long-running operation should document the metadata type, if any.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
@@ skipping 124 matching lines @@
       _json["target"] = target;
     }
     if (user != null) {
       _json["user"] = user;
     }
     return _json;
   }
 }
 
 /** Metadata for the given google.longrunning.Operation. */
+class OperationMetadataExperimental {
+  /** Time that this operation completed. @OutputOnly */
+  core.String endTime;
+  /** Time that this operation was created. @OutputOnly */
+  core.String insertTime;
+  /**
+   * API method that initiated this operation. Example:
+   * `google.appengine.experimental.CustomDomains.CreateCustomDomain`.
+   * @OutputOnly
+   */
+  core.String method;
+  /**
+   * Name of the resource that this operation is acting on. Example:
+   * `apps/myapp/customDomains/example.com`. @OutputOnly
+   */
+  core.String target;
+  /** User who requested this operation. @OutputOnly */
+  core.String user;
+
+  OperationMetadataExperimental();
+
+  OperationMetadataExperimental.fromJson(core.Map _json) {
+    if (_json.containsKey("endTime")) {
+      endTime = _json["endTime"];
+    }
+    if (_json.containsKey("insertTime")) {
+      insertTime = _json["insertTime"];
+    }
+    if (_json.containsKey("method")) {
+      method = _json["method"];
+    }
+    if (_json.containsKey("target")) {
+      target = _json["target"];
+    }
+    if (_json.containsKey("user")) {
+      user = _json["user"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (endTime != null) {
+      _json["endTime"] = endTime;
+    }
+    if (insertTime != null) {
+      _json["insertTime"] = insertTime;
+    }
+    if (method != null) {
+      _json["method"] = method;
+    }
+    if (target != null) {
+      _json["target"] = target;
+    }
+    if (user != null) {
+      _json["user"] = user;
+    }
+    return _json;
+  }
+}
+
+/** Metadata for the given google.longrunning.Operation. */
 class OperationMetadataV1 {
   /** Time that this operation completed. @OutputOnly */
   core.String endTime;
   /** Time that this operation was created. @OutputOnly */
   core.String insertTime;
   /**
    * API method that initiated this operation. Example:
    * `google.appengine.v1.Versions.CreateVersion`. @OutputOnly
    */
   core.String method;
@@ skipping 974 matching lines @@
     if (versionUrl != null) {
       _json["versionUrl"] = versionUrl;
     }
     if (vm != null) {
       _json["vm"] = vm;
     }
     return _json;
   }
 }
 
+/** The zip file information for a zip deployment. */
 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/\/\'.
@@ skipping 15 matching lines @@
     var _json = new core.Map();
     if (filesCount != null) {
       _json["filesCount"] = filesCount;
     }
     if (sourceUrl != null) {
       _json["sourceUrl"] = sourceUrl;
     }
     return _json;
   }
 }