Api-Roll 51: 2017-07-10

generated/googleapis/lib/cloudresourcemanager/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.cloudresourcemanager.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 416 matching lines @@
 
   /**
    * List all Liens applied to the `parent` resource.
    *
    * Callers of this method will require permission on the `parent` resource.
    * For example, a Lien with a `parent` of `projects/1234` requires permission
    * `resourcemanager.projects.get`.
    *
    * Request parameters:
    *
-   * [pageToken] - The `next_page_token` value returned from a previous List
-   * request, if any.
-   *
    * [pageSize] - The maximum number of items to return. This is a suggestion
    * for the server.
    *
    * [parent] - The name of the resource to list all attached Liens.
    * For example, `projects/1234`.
    *
+   * [pageToken] - The `next_page_token` value returned from a previous List
+   * request, if any.
+   *
    * Completes with a [ListLiensResponse].
    *
    * 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<ListLiensResponse> list({core.String pageToken, core.int pageSize, core.String parent}) {
+  async.Future<ListLiensResponse> list({core.int pageSize, core.String parent, 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 (parent != null) {
       _queryParams["parent"] = [parent];
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
 
     _url = 'v1/liens';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 192 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new OrgPolicy.fromJson(data));
   }
 
   /**
    * 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".
    *
+   * Authorization requires the Google IAM permission
+   * `resourcemanager.organizations.getIamPolicy` on the specified organization
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * requested.
    * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [Policy].
@@ skipping 170 matching lines @@
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListOrgPoliciesResponse.fromJson(data));
   }
 
   /**
    * Searches 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
    * results.
    *
+   * Search will only return organizations on which the user has the permission
+   * `resourcemanager.organizations.get`
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * Completes with a [SearchOrganizationsResponse].
    *
    * 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 21 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new SearchOrganizationsResponse.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".
    *
+   * Authorization requires the Google IAM permission
+   * `resourcemanager.organizations.setIamPolicy` on the specified organization
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * specified.
    * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [Policy].
@@ skipping 78 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new OrgPolicy.fromJson(data));
   }
 
   /**
    * Returns permissions that a caller has on the specified Organization.
    * The `resource` field should be the organization's resource name,
    * e.g. "organizations/123".
    *
+   * There are no permissions required for making this API call.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
    * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [TestIamPermissionsResponse].
@@ skipping 88 matching lines @@
   /**
    * Request that a new Project be created. The result is an Operation which
    * can be used to track the creation process. It is automatically deleted
    * after a few hours, so there is no need to call DeleteOperation.
    *
    * Our SLO permits Project creation to take up to 30 seconds at the 90th
    * percentile. As of 2016-08-29, we are observing 6 seconds 50th percentile
    * latency. 95th percentile latency is around 11 seconds. We recommend
    * polling at the 5th second with an exponential backoff.
    *
+   * Authorization requires the Google IAM permission
+   * `resourcemanager.projects.create` on the specified parent for the new
+   * 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,
@@ skipping 225 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new OrgPolicy.fromJson(data));
   }
 
   /**
    * Returns the IAM access control policy for the specified Project.
    * Permission is denied if the policy or the resource does not exist.
    *
+   * Authorization requires the Google IAM permission
+   * `resourcemanager.projects.getIamPolicy` on the project
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * requested.
    * See the operation documentation for the appropriate value for this field.
    *
    * Completes with a [Policy].
    *
@@ skipping 80 matching lines @@
     return _response.then((data) => new OrgPolicy.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:how*|The project's name starts with "how".|
    * |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;labels.size:big|The project's label `color` has the
    * value `red` and its label `size` has the value `big`.
    *
+   * If you specify a filter that has both `parent.type` and `parent.id`, then
+   * the `resourcemanager.projects.list` permission is checked on the parent.
+   * If the user has this permission, all projects under the parent will be
+   * returned after remaining filters have been applied. If the user lacks this
+   * permission, then all projects for which the user has the
+   * `resourcemanager.projects.get` permission will be returned after remaining
+   * filters have been applied. If no filter is specified, the call will return
+   * projects for which the user has `resourcemanager.projects.get` permissions.
+   *
+   * 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 = 'v1/projects';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 124 matching lines @@
    * IAM policies will be rejected until the lack of a ToS-accepting owner is
    * rectified.
    *
    * + Calling this method requires enabling the App Engine Admin API.
    *
    * Note: Removing service accounts from policies or changing their roles
    * can render services completely inoperable. It is important to understand
    * how the service account is being used before removing or updating its
    * roles.
    *
+   * Authorization requires the Google IAM permission
+   * `resourcemanager.projects.setIamPolicy` on the project
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * specified.
    * See the operation documentation for the appropriate value for this field.
    *
    * Completes with a [Policy].
    *
@@ skipping 75 matching lines @@
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new OrgPolicy.fromJson(data));
   }
 
   /**
    * Returns permissions that a caller has on the specified Project.
    *
+   * There are no permissions required for making this API call.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
    * See the operation documentation for the appropriate value for this field.
    *
    * Completes with a [TestIamPermissionsResponse].
    *
@@ skipping 2341 matching lines @@
   UndeleteProjectRequest();
 
   UndeleteProjectRequest.fromJson(core.Map _json) {
   }
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     return _json;
   }
 }