Api-roll 46: 2017-03-06

generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.cloudresourcemanager.v1beta1;
 
 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 82 matching lines @@
    * Gets the access control policy for an Organization resource. May be empty
    * if no such policy or resource exists. The `resource` field should be the
    * organization's resource name, e.g. "organizations/123".
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * 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.
    */
@@ skipping 24 matching lines @@
     return _response.then((data) => new Policy.fromJson(data));
   }
 
   /**
    * Lists Organization resources that are visible to the user and satisfy
    * the specified filter. This method returns Organizations in an unspecified
    * order. New Organizations do not necessarily appear at the end of the list.
    *
    * Request parameters:
    *
+   * [pageSize] - The maximum number of Organizations to return in the response.
+   * This field is optional.
+   *
    * [filter] - An optional query string used to filter the Organizations to
    * return in
    * the response. Filter rules are case-insensitive.
    *
    *
    * Organizations may be filtered by `owner.directoryCustomerId` or by
    * `domain`, where the domain is a Google for Work domain, for example:
    *
    * |Filter|Description|
    * |------|-----------|
    * |owner.directorycustomerid:123456789|Organizations with
    * `owner.directory_customer_id` equal to `123456789`.|
    * |domain:google.com|Organizations corresponding to the domain `google.com`.|
    *
    * This field is optional.
    *
    * [pageToken] - A pagination token returned from a previous call to
    * `ListOrganizations`
    * that indicates from where listing should continue.
    * This field is optional.
    *
-   * [pageSize] - The maximum number of Organizations to return in the response.
-   * This field is optional.
-   *
    * Completes with a [ListOrganizationsResponse].
    *
    * 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<ListOrganizationsResponse> list({core.String filter, core.String pageToken, core.int pageSize}) {
+  async.Future<ListOrganizationsResponse> list({core.int pageSize, core.String filter, 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 (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _url = 'v1beta1/organizations';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListOrganizationsResponse.fromJson(data));
   }
 
   /**
    * Sets the access control policy on an Organization resource. Replaces any
    * existing policy. The `resource` field should be the organization's resource
    * name, e.g. "organizations/123".
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * specified.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * 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.
    */
@@ skipping 28 matching lines @@
    * Returns permissions that a caller has on the specified Organization.
    * The `resource` field should be the organization's resource name,
    * e.g. "organizations/123".
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [TestIamPermissionsResponse].
    *
    * 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.
    */
@@ skipping 292 matching lines @@
   /**
    * Returns the IAM access control policy for the specified Project.
    * Permission is denied if the policy or the resource does not exist.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    *
    * Completes with a [Policy].
    *
    * 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<Policy> getIamPolicy(GetIamPolicyRequest request, core.String resource) {
@@ skipping 23 matching lines @@
     return _response.then((data) => new Policy.fromJson(data));
   }
 
   /**
    * Lists Projects that are visible to the user and satisfy the
    * specified filter. This method returns Projects in an unspecified order.
    * New Projects do not necessarily appear at the end of the list.
    *
    * Request parameters:
    *
-   * [pageToken] - A pagination token returned from a previous call to
-   * ListProjects
-   * that indicates from where listing should continue.
-   *
-   * Optional.
-   *
    * [pageSize] - The maximum number of Projects to return in the response.
    * The server can return fewer Projects than requested.
    * If unspecified, server picks an appropriate default.
    *
    * Optional.
    *
    * [filter] - An expression for filtering the results of the request.  Filter
    * rules are
    * case insensitive. The fields eligible for filtering are:
    *
    * + `name`
    * + `id`
    * + <code>labels.<em>key</em></code> where *key* is the name of a label
    *
    * Some examples of using labels as filters:
    *
    * |Filter|Description|
    * |------|-----------|
    * |name:*|The project has a name.|
    * |name:Howl|The project's name is `Howl` or `howl`.|
    * |name:HOWL|Equivalent to above.|
    * |NAME:howl|Equivalent to above.|
    * |labels.color:*|The project has the label `color`.|
    * |labels.color:red|The project's label `color` has the value `red`.|
    * |labels.color:red&nbsp;label.size:big|The project's label `color` has the
    * value `red` and its label `size` has the value `big`.
    *
    * Optional.
    *
+   * [pageToken] - A pagination token returned from a previous call to
+   * ListProjects
+   * that indicates from where listing should continue.
+   *
+   * Optional.
+   *
    * Completes with a [ListProjectsResponse].
    *
    * 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<ListProjectsResponse> list({core.String pageToken, core.int pageSize, core.String filter}) {
+  async.Future<ListProjectsResponse> list({core.int pageSize, core.String filter, 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 (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
 
     _url = 'v1beta1/projects';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 39 matching lines @@
    * can render services completely inoperable. It is important to understand
    * how the service account is being used before removing or updating its
    * roles.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * specified.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    *
    * Completes with a [Policy].
    *
    * 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<Policy> setIamPolicy(SetIamPolicyRequest request, core.String resource) {
@@ skipping 25 matching lines @@
 
   /**
    * Returns permissions that a caller has on the specified Project.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    *
    * Completes with a [TestIamPermissionsResponse].
    *
    * 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<TestIamPermissionsResponse> testIamPermissions(TestIamPermissionsRequest request, core.String resource) {
@@ skipping 485 matching lines @@
  * (e.g., company) resources belong.
  */
 class Organization {
   /**
    * Timestamp when the Organization was created. Assigned by the server.
    * @OutputOnly
    */
   core.String creationTime;
   /**
    * A friendly string to be used to refer to the Organization in the UI.
-   * Assigned by the server, set to the firm name of the Google For Work
-   * customer that owns this organization.
+   * Assigned by the server, set to the primary domain of the G Suite
+   * customer that owns the organization.
    * @OutputOnly
    */
   core.String displayName;
   /**
    * The organization's current lifecycle state. Assigned by the server.
    * @OutputOnly
    * Possible string values are:
    * - "LIFECYCLE_STATE_UNSPECIFIED" : Unspecified state.  This is only useful
    * for distinguishing unset values.
    * - "ACTIVE" : The normal and active state.
@@ skipping 182 matching lines @@
     }
     if (version != null) {
       _json["version"] = version;
     }
     return _json;
   }
 }
 
 /**
  * A Project is a high-level Google Cloud Platform entity.  It is a
- * container for ACLs, APIs, AppEngine Apps, VMs, and other
+ * container for ACLs, APIs, App Engine Apps, VMs, and other
  * Google Cloud Platform resources.
  */
 class Project {
   /**
    * Creation time.
    *
    * Read-only.
    */
   core.String createTime;
   /**
@@ skipping 165 matching lines @@
     if (ready != null) {
       _json["ready"] = ready;
     }
     return _json;
   }
 }
 
 /**
  * A container to reference an id for any resource type. A `resource` in Google
  * Cloud Platform is a generic term for something you (a developer) may want to
- * interact with through one of our API's. Some examples are an AppEngine app,
+ * interact with through one of our API's. Some examples are an App Engine app,
  * a Compute Engine instance, a Cloud SQL database, and so on.
  */
 class ResourceId {
   /**
    * Required field for the type-specific id. This should correspond to the id
    * used in the type-specific API's.
    */
   core.String id;
   /**
    * Required field representing the resource type this id is for.
@@ skipping 112 matching lines @@
   UndeleteProjectRequest();
 
   UndeleteProjectRequest.fromJson(core.Map _json) {
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     return _json;
   }
 }