Api-Roll 51: 2017-07-10

generated/googleapis/lib/dataproc/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.dataproc.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 260 matching lines @@
    * Lists all regions/{region}/clusters in a project.
    *
    * Request parameters:
    *
    * [projectId] - Required. The ID of the Google Cloud Platform project that
    * the cluster belongs to.
    *
    * [region] - Required. The Cloud Dataproc region in which to handle the
    * request.
    *
+   * [pageToken] - Optional. The standard List page token.
+   *
+   * [pageSize] - Optional. The standard List page size.
+   *
    * [filter] - Optional. A filter constraining the clusters to list. Filters
    * are case-sensitive and have the following syntax:field = value AND field =
    * value ...where field is one of status.state, clusterName, or labels.[KEY],
    * and [KEY] is a label key. value can be * to match all values. status.state
    * can be one of the following: ACTIVE, INACTIVE, CREATING, RUNNING, ERROR,
    * DELETING, or UPDATING. ACTIVE contains the CREATING, UPDATING, and RUNNING
    * states. INACTIVE contains the DELETING and ERROR states. clusterName is the
    * name of the cluster provided at creation time. Only the logical AND
    * operator is supported; space-separated items are treated as having an
    * implicit AND operator.Example filter:status.state = ACTIVE AND clusterName
    * = mycluster AND labels.env = staging AND labels.starred = *
    *
-   * [pageToken] - Optional. The standard List page token.
-   *
-   * [pageSize] - Optional. The standard List page size.
-   *
    * Completes with a [ListClustersResponse].
    *
    * 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<ListClustersResponse> list(core.String projectId, core.String region, {core.String filter, core.String pageToken, core.int pageSize}) {
+  async.Future<ListClustersResponse> list(core.String projectId, core.String region, {core.String pageToken, core.int pageSize, core.String filter}) {
     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 (region == null) {
       throw new core.ArgumentError("Parameter region is required.");
     }
-    if (filter != null) {
-      _queryParams["filter"] = [filter];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
+    if (filter != null) {
+      _queryParams["filter"] = [filter];
+    }
 
     _url = 'v1/projects/' + commons.Escaper.ecapeVariable('$projectId') + '/regions/' + commons.Escaper.ecapeVariable('$region') + '/clusters';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 264 matching lines @@
    * Lists regions/{region}/jobs in a project.
    *
    * Request parameters:
    *
    * [projectId] - Required. The ID of the Google Cloud Platform project that
    * the job belongs to.
    *
    * [region] - Required. The Cloud Dataproc region in which to handle the
    * request.
    *
+   * [pageSize] - Optional. The number of results to return in each response.
+   *
+   * [clusterName] - Optional. If set, the returned jobs list includes only jobs
+   * that were submitted to the named cluster.
+   *
    * [filter] - Optional. A filter constraining the jobs to list. Filters are
    * case-sensitive and have the following syntax:field = value AND field =
    * value ...where field is status.state or labels.[KEY], and [KEY] is a label
    * key. value can be * to match all values. status.state can be either ACTIVE
    * or INACTIVE. Only the logical AND operator is supported; space-separated
    * items are treated as having an implicit AND operator.Example
    * filter:status.state = ACTIVE AND labels.env = staging AND labels.starred =
    * *
    *
    * [jobStateMatcher] - Optional. Specifies enumerated categories of jobs to
    * list (default = match ALL jobs).
    * Possible string values are:
    * - "ALL" : A ALL.
    * - "ACTIVE" : A ACTIVE.
    * - "NON_ACTIVE" : A NON_ACTIVE.
    *
    * [pageToken] - Optional. The page token, returned by a previous call, to
    * request the next page of results.
    *
-   * [pageSize] - Optional. The number of results to return in each response.
-   *
-   * [clusterName] - Optional. If set, the returned jobs list includes only jobs
-   * that were submitted to the named cluster.
-   *
    * Completes with a [ListJobsResponse].
    *
    * 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<ListJobsResponse> list(core.String projectId, core.String region, {core.String filter, core.String jobStateMatcher, core.String pageToken, core.int pageSize, core.String clusterName}) {
+  async.Future<ListJobsResponse> list(core.String projectId, core.String region, {core.int pageSize, core.String clusterName, core.String filter, core.String jobStateMatcher, 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 (projectId == null) {
       throw new core.ArgumentError("Parameter projectId is required.");
     }
     if (region == null) {
       throw new core.ArgumentError("Parameter region is required.");
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (clusterName != null) {
+      _queryParams["clusterName"] = [clusterName];
+    }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
     if (jobStateMatcher != null) {
       _queryParams["jobStateMatcher"] = [jobStateMatcher];
     }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
-    if (clusterName != null) {
-      _queryParams["clusterName"] = [clusterName];
-    }
 
     _url = 'v1/projects/' + commons.Escaper.ecapeVariable('$projectId') + '/regions/' + commons.Escaper.ecapeVariable('$region') + '/jobs';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 268 matching lines @@
    * }/operations" to their service configuration. For backwards compatibility,
    * the default name includes the operations collection id, however overriding
    * users must ensure the name binding is the parent resource, without the
    * operations collection id.
    *
    * Request parameters:
    *
    * [name] - The name of the operation's parent resource.
    * Value must have pattern "^projects/[^/]+/regions/[^/]+/operations$".
    *
+   * [filter] - The standard list filter.
+   *
    * [pageToken] - The standard list page token.
    *
    * [pageSize] - The standard list page size.
    *
-   * [filter] - The standard list filter.
-   *
    * 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 name, {core.String pageToken, core.int pageSize, core.String filter}) {
+  async.Future<ListOperationsResponse> list(core.String name, {core.String filter, core.String pageToken, core.int pageSize}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (name == null) {
       throw new core.ArgumentError("Parameter name is required.");
     }
+    if (filter != null) {
+      _queryParams["filter"] = [filter];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (filter != null) {
-      _queryParams["filter"] = [filter];
-    }
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$name');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListOperationsResponse.fromJson(data));
   }
 
 }
 
 
 
 /**
  * Specifies the type and number of accelerator cards attached to the instances
  * of an instance group (see GPUs on Compute Engine).
  */
 class AcceleratorConfig {
   /**
    * The number of the accelerator cards of this type exposed to this instance.
    */
   core.int acceleratorCount;
   /**
-   * Full or partial URI of the accelerator type resource to expose to this
-   * instance. See Google Compute Engine AcceleratorTypes(
-   * /compute/docs/reference/beta/acceleratorTypes)
+   * Full URL, partial URI, or short name of the accelerator type resource to
+   * expose to this instance. See Google Compute Engine AcceleratorTypes(
+   * /compute/docs/reference/beta/acceleratorTypes)Examples *
+   * https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80
+   * * projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80
+   * * nvidia-tesla-k80
    */
   core.String acceleratorTypeUri;
 
   AcceleratorConfig();
 
   AcceleratorConfig.fromJson(core.Map _json) {
     if (_json.containsKey("acceleratorCount")) {
       acceleratorCount = _json["acceleratorCount"];
     }
     if (_json.containsKey("acceleratorTypeUri")) {
@@ skipping 579 matching lines @@
    * The Google Compute Engine metadata entries to add to all instances (see
    * Project and instance metadata
    * (https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)).
    */
   core.Map<core.String, core.String> metadata;
   /**
    * Optional. The Google Compute Engine network to be used for machine
    * communications. Cannot be specified with subnetwork_uri. If neither
    * network_uri nor subnetwork_uri is specified, the "default" network of the
    * project is used, if it exists. Cannot be a "Custom Subnet Network" (see
-   * Using Subnetworks for more information). Example:
-   * https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default.
+   * Using Subnetworks for more information).A full URL, partial URI, or short
+   * name are valid. Examples:
+   * https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default
+   * projects/[project_id]/regions/global/default
+   * default
    */
   core.String networkUri;
   /**
    * Optional. The service account of the instances. Defaults to the default
    * Google Compute Engine service account. Custom service accounts need
    * permissions equivalent to the folloing IAM roles:
    * roles/logging.logWriter
    * roles/storage.objectAdmin(see
    * https://cloud.google.com/compute/docs/access/service-accounts#custom_service_accounts
    * for more information). Example:
    * [account_id]@[project_id].iam.gserviceaccount.com
    */
   core.String serviceAccount;
   /**
    * Optional. The URIs of service account scopes to be included in Google
    * Compute Engine instances. The following base set of scopes is always
    * included:
    * https://www.googleapis.com/auth/cloud.useraccounts.readonly
    * https://www.googleapis.com/auth/devstorage.read_write
    * https://www.googleapis.com/auth/logging.writeIf no scopes are specified,
    * the following defaults are also provided:
    * https://www.googleapis.com/auth/bigquery
    * https://www.googleapis.com/auth/bigtable.admin.table
    * https://www.googleapis.com/auth/bigtable.data
    * https://www.googleapis.com/auth/devstorage.full_control
    */
   core.List<core.String> serviceAccountScopes;
   /**
    * Optional. The Google Compute Engine subnetwork to be used for machine
-   * communications. Cannot be specified with network_uri. Example:
-   * https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0.
+   * communications. Cannot be specified with network_uri.A full URL, partial
+   * URI, or short name are valid. Examples:
+   * https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/sub0
+   * projects/[project_id]/regions/us-east1/sub0
+   * sub0
    */
   core.String subnetworkUri;
   /**
    * The Google Compute Engine tags to add to all instances (see Tagging
    * instances).
    */
   core.List<core.String> tags;
   /**
-   * Required. The zone where the Google Compute Engine cluster will be located.
-   * Example:
-   * https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone].
+   * Optional. The zone where the Google Compute Engine cluster will be located.
+   * On a create request, it is required in the "global" region. If omitted in a
+   * non-global Cloud Dataproc region, the service will pick a zone in the
+   * corresponding GCE region. On a get request, zone will always be present.A
+   * full URL, partial URI, or short name are valid. Examples:
+   * https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]
+   * projects/[project_id]/zones/[zone]
+   * us-central1-f
    */
   core.String zoneUri;
 
   GceClusterConfig();
 
   GceClusterConfig.fromJson(core.Map _json) {
     if (_json.containsKey("internalIpOnly")) {
       internalIpOnly = _json["internalIpOnly"];
     }
     if (_json.containsKey("metadata")) {
@@ skipping 263 matching lines @@
    * cluster_name, num_instances, and the instance group if not set by user
    * (recommended practice is to let Cloud Dataproc derive the name).
    */
   core.List<core.String> instanceNames;
   /**
    * Optional. Specifies that this instance group contains preemptible
    * instances.
    */
   core.bool isPreemptible;
   /**
-   * Required. The Google Compute Engine machine type used for cluster
-   * instances. Example:
-   * https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2.
+   * Optional. The Google Compute Engine machine type used for cluster
+   * instances.A full URL, partial URI, or short name are valid. Examples:
+   * https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2
+   * projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2
+   * n1-standard-2
    */
   core.String machineTypeUri;
   /**
    * Output-only. The config for Google Compute Engine Instance Group Manager
    * that manages this group. This is only used for preemptible instance groups.
    */
   ManagedGroupConfig managedGroupConfig;
   /**
-   * Required. The number of VM instances in the instance group. For master
+   * Optional. The number of VM instances in the instance group. For master
    * instance groups, must be set to 1.
    */
   core.int numInstances;
 
   InstanceGroupConfig();
 
   InstanceGroupConfig.fromJson(core.Map _json) {
     if (_json.containsKey("accelerators")) {
       accelerators = _json["accelerators"].map((value) => new AcceleratorConfig.fromJson(value)).toList();
     }
@@ skipping 1290 matching lines @@
     }
     if (state != null) {
       _json["state"] = state;
     }
     if (trackingUrl != null) {
       _json["trackingUrl"] = trackingUrl;
     }
     return _json;
   }
 }