Api-roll 22: 2015-08-17

generated/googleapis/lib/container/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.container.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;
@@ skipping 32 matching lines @@
 
 
 class ProjectsZonesResourceApi {
   final commons.ApiRequester _requester;
 
   ProjectsZonesClustersResourceApi get clusters => new ProjectsZonesClustersResourceApi(_requester);
   ProjectsZonesOperationsResourceApi get operations => new ProjectsZonesOperationsResourceApi(_requester);
 
   ProjectsZonesResourceApi(commons.ApiRequester client) : 
       _requester = client;
+
+  /**
+   * Returns configuration info about the Container Engine service.
+   *
+   * Request parameters:
+   *
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
+   *
+   * [zone] - The name of the Google Compute Engine
+   * [zone](/compute/docs/zones#available) to return operations for, or "-" for
+   * all zones.
+   *
+   * Completes with a [ServerConfig].
+   *
+   * 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<ServerConfig> getServerconfig(core.String projectId, core.String zone) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (projectId == null) {
+      throw new core.ArgumentError("Parameter projectId is required.");
+    }
+    if (zone == null) {
+      throw new core.ArgumentError("Parameter zone is required.");
+    }
+
+    _url = 'v1/projects/' + commons.Escaper.ecapeVariable('$projectId') + '/zones/' + commons.Escaper.ecapeVariable('$zone') + '/serverconfig';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new ServerConfig.fromJson(data));
+  }
+
 }
 
 
 class ProjectsZonesClustersResourceApi {
   final commons.ApiRequester _requester;
 
   ProjectsZonesClustersResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Creates a cluster, consisting of the specified number and type of Google
    * Compute Engine instances, plus a Kubernetes master endpoint. By default,
    * the cluster is created in the project's [default
-   * network]('/compute/docs/networking#networks_1'). One firewall is added for
+   * network](/compute/docs/networking#networks_1). One firewall is added for
    * the cluster. After cluster creation, the cluster creates routes for each
    * node to allow the containers on that node to communicate with all other
    * instances in the cluster. Finally, an entry is added to the project's
    * global metadata indicating which CIDR range is being used by the cluster.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [projectId] - The Google Developers Console [project
-   * ID](https://console.developers.google.com/project) or [project
-   * number](https://developers.google.com/console/help/project-number)
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
    *
    * [zone] - The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) in which the cluster resides.
    *
    * 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,
@@ skipping 29 matching lines @@
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
    * Deletes the cluster, including the Kubernetes endpoint and all worker
    * nodes. Firewalls and routes that were configured during cluster creation
    * are also deleted.
    *
    * Request parameters:
    *
-   * [projectId] - The Google Developers Console [project
-   * ID](https://console.developers.google.com/project) or [project
-   * number](https://developers.google.com/console/help/project-number)
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
    *
    * [zone] - The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) in which the cluster resides.
    *
    * [clusterId] - The name of the cluster to delete.
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 29 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
    * Gets a specific cluster.
    *
    * Request parameters:
    *
-   * [projectId] - The Google Developers Console A [project
-   * ID](https://console.developers.google.com/project) or [project
-   * number](https://developers.google.com/console/help/project-number)
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
    *
    * [zone] - The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) in which the cluster resides.
    *
    * [clusterId] - The name of the cluster to retrieve.
    *
    * Completes with a [Cluster].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 30 matching lines @@
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Cluster.fromJson(data));
   }
 
   /**
    * Lists all clusters owned by a project in either the specified zone or all
    * zones.
    *
    * Request parameters:
    *
-   * [projectId] - The Google Developers Console [project
-   * ID](https://console.developers.google.com/project) or [project
-   * number](https://developers.google.com/console/help/project-number)
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
    *
    * [zone] - The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) in which the cluster resides, or "-"
    * for all zones.
    *
    * Completes with a [ListClustersResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 27 matching lines @@
     return _response.then((data) => new ListClustersResponse.fromJson(data));
   }
 
   /**
    * Update settings of a specific cluster.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [projectId] - The Google Developers Console [project
-   * ID](https://console.developers.google.com/project) or [project
-   * number](https://developers.google.com/console/help/project-number)
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
    *
    * [zone] - The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) in which the cluster resides.
    *
    * [clusterId] - The name of the cluster to upgrade.
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 41 matching lines @@
   final commons.ApiRequester _requester;
 
   ProjectsZonesOperationsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Gets the specified operation.
    *
    * Request parameters:
    *
-   * [projectId] - The Google Developers Console [project
-   * ID](https://console.developers.google.com/project) or [project
-   * number](https://developers.google.com/console/help/project-number)
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
    *
    * [zone] - The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) in which the cluster resides.
    *
    * [operationId] - The server-assigned `name` of the operation.
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 29 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
    * Lists all operations in a project in a specific zone or all zones.
    *
    * Request parameters:
    *
-   * [projectId] - The Google Developers Console [project
-   * ID](https://console.developers.google.com/project) or [project
-   * number](https://developers.google.com/console/help/project-number)
+   * [projectId] - The Google Developers Console [project ID or project
+   * number](https://developers.google.com/console/help/new/#projectnumber).
    *
    * [zone] - The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) to return operations for, or "-" for
    * all zones.
    *
    * Completes with a [ListOperationsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 30 matching lines @@
 }
 
 
 
 /** A Google Container Engine cluster. */
 class Cluster {
   /**
    * The IP address range of the container pods in this cluster, in
    * [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
    * notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically
-   * chosen or specify a `/14` block in `10.0.0.0/8` or `172.16.0.0/12`.
+   * chosen or specify a `/14` block in `10.0.0.0/8`.
    */
   core.String clusterIpv4Cidr;
   /**
    * [Output only] The time the cluster was created, in
-   * [RFC3339](href='https://www.ietf.org/rfc/rfc3339.txt) text format.
-   * @OutputOnly.
+   * [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
    */
   core.String createTime;
-  /**
-   * [Output only] The current software version of the master endpoint.
-   * @OutputOnly.
-   */
+  /** [Output only] The current software version of the master endpoint. */
   core.String currentMasterVersion;
   /**
    * [Output only] The current version of the node software components. If they
    * are currently at different versions because they're in the process of being
-   * upgraded, this reflects the minimum version of any of them. @OutputOnly.
+   * upgraded, this reflects the minimum version of any of them.
    */
   core.String currentNodeVersion;
   /** An optional description of this cluster. */
   core.String description;
   /**
    * [Output only] The IP address of this cluster's Kubernetes master endpoint.
    * The endpoint can be accessed from the internet at
-   * `https://username:password@endpoint/`. @OutputOnly. See the `masterAuth`
-   * property of this resource for username and password information.
+   * `https://username:password@endpoint/`. See the `masterAuth` property of
+   * this resource for username and password information.
    */
   core.String endpoint;
   /**
    * [Output only] The software version of Kubernetes master and kubelets used
    * in the cluster when it was first created. The version can be upgraded over
-   * time. @OutputOnly.
+   * time.
    */
   core.String initialClusterVersion;
   /**
    * The number of nodes to create in this cluster. You must ensure that your
    * Compute Engine [resource quota](/compute/docs/resource-quotas) is
    * sufficient for this number of instances. You must also have available
    * firewall and routes quota.
    */
   core.int initialNodeCount;
   /**
    * [Output only] The resource URLs of [instance
    * groups](/compute/docs/instance-groups/) associated with this cluster.
-   * @OutputOnly.
    */
   core.List<core.String> instanceGroupUrls;
   /**
    * The logging service that the cluster should write logs to. Currently
    * available options: * "logging.googleapis.com" - the Google Cloud Logging
    * service * "none" - no logs will be exported from the cluster * "" - default
    * value; the default is "logging.googleapis.com"
    */
   core.String loggingService;
   /** The authentication information for accessing the master. */
@@ skipping 13 matching lines @@
    */
   core.String name;
   /**
    * The name of the Google Compute Engine
    * [network](/compute/docs/networking#networks_1) to which the cluster is
    * connected. If left unspecified, the "default" network will be used.
    */
   core.String network;
   /**
    * Parameters used in creating the cluster's nodes. See the descriptions of
-   * the child properties of `nodeConfig`.
+   * the child properties of `nodeConfig`. If unspecified, the defaults for all
+   * child properties are used.
    */
   NodeConfig nodeConfig;
   /**
    * [Output only] The size of the address space on each node for hosting
    * containers. This is provisioned from within the container_ipv4_cidr range.
-   * @OutputOnly.
    */
   core.int nodeIpv4CidrSize;
-  /** [Output only] Server-defined URL for the resource. @OutputOnly. */
+  /** [Output only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * [Output only] The IP address range of the Kubernetes services in this
    * cluster, in
    * [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
    * notation (e.g. `1.2.3.4/29`). Service addresses are typically put in the
-   * last /16 from the container CIDR. @OutputOnly.
+   * last /16 from the container CIDR.
    */
   core.String servicesIpv4Cidr;
   /**
-   * [Output only] The current status of this cluster. @OutputOnly.
+   * [Output only] The current status of this cluster.
    * Possible string values are:
    * - "STATUS_UNSPECIFIED" : A STATUS_UNSPECIFIED.
    * - "PROVISIONING" : A PROVISIONING.
    * - "RUNNING" : A RUNNING.
    * - "RECONCILING" : A RECONCILING.
    * - "STOPPING" : A STOPPING.
    * - "ERROR" : A ERROR.
    */
   core.String status;
   /**
    * [Output only] Additional information about the current status of this
-   * cluster, if available. @OutputOnly.
+   * cluster, if available.
    */
   core.String statusMessage;
   /**
    * [Output only] The name of the Google Compute Engine
    * [zone](/compute/docs/zones#available) in which the cluster resides.
-   * @OutputOnly.
    */
   core.String zone;
 
   Cluster();
 
   Cluster.fromJson(core.Map _json) {
     if (_json.containsKey("clusterIpv4Cidr")) {
       clusterIpv4Cidr = _json["clusterIpv4Cidr"];
     }
     if (_json.containsKey("createTime")) {
@@ skipping 148 matching lines @@
     if (desiredNodeVersion != null) {
       _json["desiredNodeVersion"] = desiredNodeVersion;
     }
     return _json;
   }
 }
 
 /** CreateClusterRequest creates a cluster. */
 class CreateClusterRequest {
   /**
-   * A [cluster resource](/container-engine/docs/v1/projects/zones/clusters)
+   * A [cluster
+   * resource](/container-engine/reference/rest/v1/projects.zones.clusters)
    */
   Cluster cluster;
 
   CreateClusterRequest();
 
   CreateClusterRequest.fromJson(core.Map _json) {
     if (_json.containsKey("cluster")) {
       cluster = new Cluster.fromJson(_json["cluster"]);
     }
   }
@@ skipping 55 matching lines @@
 }
 
 /**
  * The authentication information for accessing the master endpoint.
  * Authentication can be done using HTTP basic auth or using client
  * certificates.
  */
 class MasterAuth {
   /**
    * [Output only] Base64 encoded public certificate used by clients to
-   * authenticate to the cluster endpoint. @OutputOnly.
+   * authenticate to the cluster endpoint.
    */
   core.String clientCertificate;
   /**
    * [Output only] Base64 encoded private key used by clients to authenticate to
-   * the cluster endpoint. @OutputOnly.
+   * the cluster endpoint.
    */
   core.String clientKey;
   /**
    * [Output only] Base64 encoded public certificate that is the root of trust
-   * for the cluster. @OutputOnly.
+   * for the cluster.
    */
   core.String clusterCaCertificate;
   /**
    * The password to use for HTTP basic authentication when accessing the
    * Kubernetes master endpoint. Because the master endpoint is open to the
    * internet, you should create a strong password.
    */
   core.String password;
   /**
    * The username to use for HTTP basic authentication when accessing the
@@ skipping 39 matching lines @@
       _json["username"] = username;
     }
     return _json;
   }
 }
 
 /** Per-node parameters. */
 class NodeConfig {
   /**
    * Size of the disk attached to each node, specified in GB. The smallest
-   * allowed disk size is 10GB, and the default is 100GB.
+   * allowed disk size is 10GB. If unspecified, the default disk size is 100GB.
    */
   core.int diskSizeGb;
   /**
    * The name of a Google Compute Engine [machine
    * type](/compute/docs/machine-types) (e.g. `n1-standard-1`). If unspecified,
    * the default machine type is `n1-standard-1`.
    */
   core.String machineType;
   /**
    * The set of Google API scopes to be made available on all of the node VMs
-   * under the "default" service account. Currently, the following scopes are
-   * necessary to ensure the correct functioning of the cluster: *
-   * "https://www.googleapis.com/auth/compute" *
-   * "https://www.googleapis.com/auth/devstorage.read_only"
+   * under the "default" service account. The following scopes are recommended,
+   * but not required, and by default are not included: *
+   * `https://www.googleapis.com/auth/compute` is required for mounting
+   * persistent storage on your nodes. *
+   * `https://www.googleapis.com/auth/devstorage.read_only` is required for
+   * communicating with *gcr.io*. If unspecified, no scopes are added.
    */
   core.List<core.String> oauthScopes;
 
   NodeConfig();
 
   NodeConfig.fromJson(core.Map _json) {
     if (_json.containsKey("diskSizeGb")) {
       diskSizeGb = _json["diskSizeGb"];
     }
     if (_json.containsKey("machineType")) {
@@ skipping 14 matching lines @@
     }
     if (oauthScopes != null) {
       _json["oauthScopes"] = oauthScopes;
     }
     return _json;
   }
 }
 
 /** Defines the operation resource. All fields are output only. */
 class Operation {
-  /** The server-assigned ID for the operation. @OutputOnly. */
+  /** The server-assigned ID for the operation. */
   core.String name;
   /**
-   * The operation type. @OutputOnly.
+   * The operation type.
    * Possible string values are:
    * - "TYPE_UNSPECIFIED" : A TYPE_UNSPECIFIED.
    * - "CREATE_CLUSTER" : A CREATE_CLUSTER.
    * - "DELETE_CLUSTER" : A DELETE_CLUSTER.
    * - "UPGRADE_MASTER" : A UPGRADE_MASTER.
    * - "UPGRADE_NODES" : A UPGRADE_NODES.
    * - "REPAIR_CLUSTER" : A REPAIR_CLUSTER.
    */
   core.String operationType;
-  /** Server-defined URL for the resource. @OutputOnly. */
+  /** Server-defined URL for the resource. */
   core.String selfLink;
   /**
-   * The current status of the operation. @OutputOnly.
+   * The current status of the operation.
    * Possible string values are:
    * - "STATUS_UNSPECIFIED" : A STATUS_UNSPECIFIED.
    * - "PENDING" : A PENDING.
    * - "RUNNING" : A RUNNING.
    * - "DONE" : A DONE.
    */
   core.String status;
-  /**
-   * If an error has occurred, a textual description of the error. @OutputOnly.
-   */
+  /** If an error has occurred, a textual description of the error. */
   core.String statusMessage;
-  /** Server-defined URL for the target of the operation. @OutputOnly. */
+  /** Server-defined URL for the target of the operation. */
   core.String targetLink;
   /**
    * The name of the Google Compute Engine [zone](/compute/docs/zones#available)
-   * in which the operation is taking place. @OutputOnly.
+   * in which the operation is taking place.
    */
   core.String zone;
 
   Operation();
 
   Operation.fromJson(core.Map _json) {
     if (_json.containsKey("name")) {
       name = _json["name"];
     }
     if (_json.containsKey("operationType")) {
@@ skipping 36 matching lines @@
     if (targetLink != null) {
       _json["targetLink"] = targetLink;
     }
     if (zone != null) {
       _json["zone"] = zone;
     }
     return _json;
   }
 }
 
+/** Container Engine Server configuration. */
+class ServerConfig {
+  /** What version this server deploys by default. */
+  core.String defaultClusterVersion;
+  /** List of valid node upgrade target versions. */
+  core.List<core.String> validNodeVersions;
+
+  ServerConfig();
+
+  ServerConfig.fromJson(core.Map _json) {
+    if (_json.containsKey("defaultClusterVersion")) {
+      defaultClusterVersion = _json["defaultClusterVersion"];
+    }
+    if (_json.containsKey("validNodeVersions")) {
+      validNodeVersions = _json["validNodeVersions"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (defaultClusterVersion != null) {
+      _json["defaultClusterVersion"] = defaultClusterVersion;
+    }
+    if (validNodeVersions != null) {
+      _json["validNodeVersions"] = validNodeVersions;
+    }
+    return _json;
+  }
+}
+
 /** UpdateClusterRequest updates a cluster. */
 class UpdateClusterRequest {
   /** A description of the update. */
   ClusterUpdate update;
 
   UpdateClusterRequest();
 
   UpdateClusterRequest.fromJson(core.Map _json) {
     if (_json.containsKey("update")) {
       update = new ClusterUpdate.fromJson(_json["update"]);
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (update != null) {
       _json["update"] = (update).toJson();
     }
     return _json;
   }
 }