Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(158)

Issues Search
    My Issues | Starred     Open | Closed | All

Unified Diff: generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart

Issue 3006323002: Api-Roll 54: 2017-09-11 (Closed)
Patch Set: use 2.0.0-dev.infinity sdk constraint in pubspecs Created 3 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « generated/googleapis_beta/lib/cloudmonitoring/v2beta2.dart ('k') | generated/googleapis_beta/lib/clouduseraccounts/beta.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
diff --git a/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart b/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
index aa6ba8b794a17d968df48fd0c53777b3c67ac7ed..f6e230b74a4772cbd29f9cc9b5714e49c2439f99 100644
--- a/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
+++ b/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
@@ -9,60 +9,61 @@ 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;
+export 'package:_discoveryapis_commons/_discoveryapis_commons.dart'
+ show ApiRequestError, DetailedApiRequestError;
const core.String USER_AGENT = 'dart-api-client cloudresourcemanager/v1beta1';
-/**
- * The Google Cloud Resource Manager API provides methods for creating, reading,
- * and updating project metadata.
- */
+/// The Google Cloud Resource Manager API provides methods for creating,
+/// reading, and updating project metadata.
class CloudresourcemanagerApi {
- /** 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";
+ /// 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;
- OrganizationsResourceApi get organizations => new OrganizationsResourceApi(_requester);
+ OrganizationsResourceApi get organizations =>
+ new OrganizationsResourceApi(_requester);
ProjectsResourceApi get projects => new ProjectsResourceApi(_requester);
- CloudresourcemanagerApi(http.Client client, {core.String rootUrl: "https://cloudresourcemanager.googleapis.com/", core.String servicePath: ""}) :
- _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
+ CloudresourcemanagerApi(http.Client client,
+ {core.String rootUrl: "https://cloudresourcemanager.googleapis.com/",
+ core.String servicePath: ""})
+ : _requester =
+ new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
}
-
class OrganizationsResourceApi {
final commons.ApiRequester _requester;
- OrganizationsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Fetches an Organization resource identified by the specified resource name.
- *
- * Request parameters:
- *
- * [name] - The resource name of the Organization to fetch, e.g.
- * "organizations/1234".
- * Value must have pattern "^organizations/[^/]+$".
- *
- * [organizationId] - The id of the Organization resource to fetch.
- * This field is deprecated and will be removed in v1. Use name instead.
- *
- * Completes with a [Organization].
- *
- * 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<Organization> get(core.String name, {core.String organizationId}) {
+ OrganizationsResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Fetches an Organization resource identified by the specified resource
+ /// name.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - The resource name of the Organization to fetch, e.g.
+ /// "organizations/1234".
+ /// Value must have pattern "^organizations/[^/]+$".
+ ///
+ /// [organizationId] - The id of the Organization resource to fetch.
+ /// This field is deprecated and will be removed in v1. Use name instead.
+ ///
+ /// Completes with a [Organization].
+ ///
+ /// 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<Organization> get(core.String name,
+ {core.String organizationId}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -79,39 +80,37 @@ class OrganizationsResourceApi {
_url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$name');
- var _response = _requester.request(_url,
- "GET",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Organization.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".
- *
- * [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].
- *
- * 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) {
+ /// 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.
+ /// 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.
+ async.Future<Policy> getIamPolicy(
+ GetIamPolicyRequest request, core.String resource) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -126,58 +125,61 @@ class OrganizationsResourceApi {
throw new core.ArgumentError("Parameter resource is required.");
}
- _url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$resource') + ':getIamPolicy';
+ _url = 'v1beta1/' +
+ commons.Escaper.ecapeVariableReserved('$resource') +
+ ':getIamPolicy';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
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:
- *
- * [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}) {
+ /// 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:
+ ///
+ /// [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.
+ ///
+ /// [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.
+ ///
+ /// 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 pageToken, core.int pageSize, core.String filter}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -185,51 +187,51 @@ class OrganizationsResourceApi {
var _downloadOptions = commons.DownloadOptions.Metadata;
var _body = null;
- 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 = '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));
+ 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.
- * 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.
- */
- async.Future<Policy> setIamPolicy(SetIamPolicyRequest request, core.String resource) {
+ /// 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.
+ /// 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.
+ async.Future<Policy> setIamPolicy(
+ SetIamPolicyRequest request, core.String resource) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -244,41 +246,41 @@ class OrganizationsResourceApi {
throw new core.ArgumentError("Parameter resource is required.");
}
- _url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$resource') + ':setIamPolicy';
+ _url = 'v1beta1/' +
+ commons.Escaper.ecapeVariableReserved('$resource') +
+ ':setIamPolicy';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Policy.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".
- *
- * [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].
- *
- * 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) {
+ /// 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.
+ /// 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.
+ async.Future<TestIamPermissionsResponse> testIamPermissions(
+ TestIamPermissionsRequest request, core.String resource) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -293,38 +295,39 @@ class OrganizationsResourceApi {
throw new core.ArgumentError("Parameter resource is required.");
}
- _url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$resource') + ':testIamPermissions';
+ _url = 'v1beta1/' +
+ commons.Escaper.ecapeVariableReserved('$resource') +
+ ':testIamPermissions';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
- return _response.then((data) => new TestIamPermissionsResponse.fromJson(data));
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response
+ .then((data) => new TestIamPermissionsResponse.fromJson(data));
}
- /**
- * Updates an Organization resource identified by the specified resource name.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [name] - Output Only. The resource name of the organization. This is the
- * organization's relative path in the API. Its format is
- * "organizations/[organization_id]". For example, "organizations/1234".
- * Value must have pattern "^organizations/[^/]+$".
- *
- * Completes with a [Organization].
- *
- * 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.
- */
+ /// Updates an Organization resource identified by the specified resource
+ /// name.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Output Only. The resource name of the organization. This is the
+ /// organization's relative path in the API. Its format is
+ /// "organizations/[organization_id]". For example, "organizations/1234".
+ /// Value must have pattern "^organizations/[^/]+$".
+ ///
+ /// Completes with a [Organization].
+ ///
+ /// 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<Organization> update(Organization request, core.String name) {
var _url = null;
var _queryParams = new core.Map();
@@ -342,50 +345,44 @@ class OrganizationsResourceApi {
_url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$name');
- var _response = _requester.request(_url,
- "PUT",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "PUT",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Organization.fromJson(data));
}
-
}
-
class ProjectsResourceApi {
final commons.ApiRequester _requester;
- ProjectsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Creates a Project resource.
- *
- * Initially, the Project resource is owned by its creator exclusively.
- * The creator can later grant permission to others to read or update the
- * Project.
- *
- * Several APIs are activated automatically for the Project, including
- * Google Cloud Storage.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [useLegacyStack] - A safety hatch to opt out of the new reliable project
- * creation process.
- *
- * Completes with a [Project].
- *
- * 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.
- */
+ ProjectsResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Creates a Project resource.
+ ///
+ /// Initially, the Project resource is owned by its creator exclusively.
+ /// The creator can later grant permission to others to read or update the
+ /// Project.
+ ///
+ /// Several APIs are activated automatically for the Project, including
+ /// Google Cloud Storage.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [useLegacyStack] - A safety hatch to opt out of the new reliable project
+ /// creation process.
+ ///
+ /// Completes with a [Project].
+ ///
+ /// 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<Project> create(Project request, {core.bool useLegacyStack}) {
var _url = null;
var _queryParams = new core.Map();
@@ -403,56 +400,54 @@ class ProjectsResourceApi {
_url = 'v1beta1/projects';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Project.fromJson(data));
}
- /**
- * Marks the Project identified by the specified
- * `project_id` (for example, `my-project-123`) for deletion.
- * This method will only affect the Project if the following criteria are met:
- *
- * + The Project does not have a billing account associated with it.
- * + The Project has a lifecycle state of
- * ACTIVE.
- *
- * This method changes the Project's lifecycle state from
- * ACTIVE
- * to DELETE_REQUESTED.
- * The deletion starts at an unspecified time, at which point the project is
- * no longer accessible.
- *
- * Until the deletion completes, you can check the lifecycle state
- * checked by retrieving the Project with GetProject,
- * and the Project remains visible to ListProjects.
- * However, you cannot update the project.
- *
- * After the deletion completes, the Project is not retrievable by
- * the GetProject and
- * ListProjects methods.
- *
- * The caller must have modify permissions for this Project.
- *
- * Request parameters:
- *
- * [projectId] - The Project ID (for example, `foo-bar-123`).
- *
- * Required.
- *
- * Completes with a [Empty].
- *
- * 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.
- */
+ /// Marks the Project identified by the specified
+ /// `project_id` (for example, `my-project-123`) for deletion.
+ /// This method will only affect the Project if the following criteria are
+ /// met:
+ ///
+ /// + The Project does not have a billing account associated with it.
+ /// + The Project has a lifecycle state of
+ /// ACTIVE.
+ ///
+ /// This method changes the Project's lifecycle state from
+ /// ACTIVE
+ /// to DELETE_REQUESTED.
+ /// The deletion starts at an unspecified time, at which point the project is
+ /// no longer accessible.
+ ///
+ /// Until the deletion completes, you can check the lifecycle state
+ /// checked by retrieving the Project with GetProject,
+ /// and the Project remains visible to ListProjects.
+ /// However, you cannot update the project.
+ ///
+ /// After the deletion completes, the Project is not retrievable by
+ /// the GetProject and
+ /// ListProjects methods.
+ ///
+ /// The caller must have modify permissions for this Project.
+ ///
+ /// Request parameters:
+ ///
+ /// [projectId] - The Project ID (for example, `foo-bar-123`).
+ ///
+ /// Required.
+ ///
+ /// Completes with a [Empty].
+ ///
+ /// 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<Empty> delete(core.String projectId) {
var _url = null;
var _queryParams = new core.Map();
@@ -467,36 +462,33 @@ class ProjectsResourceApi {
_url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$projectId');
- var _response = _requester.request(_url,
- "DELETE",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "DELETE",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Empty.fromJson(data));
}
- /**
- * Retrieves the Project identified by the specified
- * `project_id` (for example, `my-project-123`).
- *
- * The caller must have read permissions for this Project.
- *
- * Request parameters:
- *
- * [projectId] - The Project ID (for example, `my-project-123`).
- *
- * Required.
- *
- * Completes with a [Project].
- *
- * 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.
- */
+ /// Retrieves the Project identified by the specified
+ /// `project_id` (for example, `my-project-123`).
+ ///
+ /// The caller must have read permissions for this Project.
+ ///
+ /// Request parameters:
+ ///
+ /// [projectId] - The Project ID (for example, `my-project-123`).
+ ///
+ /// Required.
+ ///
+ /// Completes with a [Project].
+ ///
+ /// 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<Project> get(core.String projectId) {
var _url = null;
var _queryParams = new core.Map();
@@ -511,39 +503,37 @@ class ProjectsResourceApi {
_url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$projectId');
- var _response = _requester.request(_url,
- "GET",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Project.fromJson(data));
}
- /**
- * Gets a list of ancestors in the resource hierarchy for the Project
- * identified by the specified `project_id` (for example, `my-project-123`).
- *
- * The caller must have read permissions for this Project.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [projectId] - The Project ID (for example, `my-project-123`).
- *
- * Required.
- *
- * Completes with a [GetAncestryResponse].
- *
- * 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<GetAncestryResponse> getAncestry(GetAncestryRequest request, core.String projectId) {
+ /// Gets a list of ancestors in the resource hierarchy for the Project
+ /// identified by the specified `project_id` (for example, `my-project-123`).
+ ///
+ /// The caller must have read permissions for this Project.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [projectId] - The Project ID (for example, `my-project-123`).
+ ///
+ /// Required.
+ ///
+ /// Completes with a [GetAncestryResponse].
+ ///
+ /// 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<GetAncestryResponse> getAncestry(
+ GetAncestryRequest request, core.String projectId) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -558,39 +548,39 @@ class ProjectsResourceApi {
throw new core.ArgumentError("Parameter projectId is required.");
}
- _url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$projectId') + ':getAncestry';
+ _url = 'v1beta1/projects/' +
+ commons.Escaper.ecapeVariable('$projectId') +
+ ':getAncestry';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new GetAncestryResponse.fromJson(data));
}
- /**
- * 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.
- * 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) {
+ /// 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.
+ /// 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) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -605,78 +595,82 @@ class ProjectsResourceApi {
throw new core.ArgumentError("Parameter resource is required.");
}
- _url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$resource') + ':getIamPolicy';
+ _url = 'v1beta1/projects/' +
+ commons.Escaper.ecapeVariable('$resource') +
+ ':getIamPolicy';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
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: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.
- *
- * 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}) {
+ /// 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:
+ ///
+ /// [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.
+ ///
+ /// [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.
+ ///
+ /// 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 filter, core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -684,85 +678,86 @@ class ProjectsResourceApi {
var _downloadOptions = commons.DownloadOptions.Metadata;
var _body = null;
+ 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 = 'v1beta1/projects';
- var _response = _requester.request(_url,
- "GET",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new ListProjectsResponse.fromJson(data));
}
- /**
- * Sets the IAM access control policy for the specified Project. Replaces
- * any existing policy.
- *
- * The following constraints apply when using `setIamPolicy()`:
- *
- * + Project does not support `allUsers` and `allAuthenticatedUsers` as
- * `members` in a `Binding` of a `Policy`.
- *
- * + The owner role can be granted only to `user` and `serviceAccount`.
- *
- * + Service accounts can be made owners of a project directly
- * without any restrictions. However, to be added as an owner, a user must be
- * invited via Cloud Platform console and must accept the invitation.
- *
- * + A user cannot be granted the owner role using `setIamPolicy()`. The user
- * must be granted the owner role using the Cloud Platform Console and must
- * explicitly accept the invitation.
- *
- * + Invitations to grant the owner role cannot be sent using
- * `setIamPolicy()`; they must be sent only using the Cloud Platform Console.
- *
- * + Membership changes that leave the project without any owners that have
- * accepted the Terms of Service (ToS) will be rejected.
- *
- * + If the project is not part of an organization, there must be at least
- * one owner who has accepted the Terms of Service (ToS) agreement in the
- * policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner
- * from the policy will fail. This restriction also applies to legacy
- * projects that no longer have owners who have accepted the ToS. Edits to
- * 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.
- *
- * [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].
- *
- * 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) {
+ /// Sets the IAM access control policy for the specified Project. Replaces
+ /// any existing policy.
+ ///
+ /// The following constraints apply when using `setIamPolicy()`:
+ ///
+ /// + Project does not support `allUsers` and `allAuthenticatedUsers` as
+ /// `members` in a `Binding` of a `Policy`.
+ ///
+ /// + The owner role can be granted only to `user` and `serviceAccount`.
+ ///
+ /// + Service accounts can be made owners of a project directly
+ /// without any restrictions. However, to be added as an owner, a user must
+ /// be
+ /// invited via Cloud Platform console and must accept the invitation.
+ ///
+ /// + A user cannot be granted the owner role using `setIamPolicy()`. The
+ /// user
+ /// must be granted the owner role using the Cloud Platform Console and must
+ /// explicitly accept the invitation.
+ ///
+ /// + Invitations to grant the owner role cannot be sent using
+ /// `setIamPolicy()`; they must be sent only using the Cloud Platform
+ /// Console.
+ ///
+ /// + Membership changes that leave the project without any owners that have
+ /// accepted the Terms of Service (ToS) will be rejected.
+ ///
+ /// + If the project is not part of an organization, there must be at least
+ /// one owner who has accepted the Terms of Service (ToS) agreement in the
+ /// policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner
+ /// from the policy will fail. This restriction also applies to legacy
+ /// projects that no longer have owners who have accepted the ToS. Edits to
+ /// 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.
+ ///
+ /// [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].
+ ///
+ /// 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) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -777,38 +772,38 @@ class ProjectsResourceApi {
throw new core.ArgumentError("Parameter resource is required.");
}
- _url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$resource') + ':setIamPolicy';
+ _url = 'v1beta1/projects/' +
+ commons.Escaper.ecapeVariable('$resource') +
+ ':setIamPolicy';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Policy.fromJson(data));
}
- /**
- * 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.
- * 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) {
+ /// 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.
+ /// 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) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -823,44 +818,45 @@ class ProjectsResourceApi {
throw new core.ArgumentError("Parameter resource is required.");
}
- _url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$resource') + ':testIamPermissions';
+ _url = 'v1beta1/projects/' +
+ commons.Escaper.ecapeVariable('$resource') +
+ ':testIamPermissions';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
- return _response.then((data) => new TestIamPermissionsResponse.fromJson(data));
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response
+ .then((data) => new TestIamPermissionsResponse.fromJson(data));
}
- /**
- * Restores the Project identified by the specified
- * `project_id` (for example, `my-project-123`).
- * You can only use this method for a Project that has a lifecycle state of
- * DELETE_REQUESTED.
- * After deletion starts, the Project cannot be restored.
- *
- * The caller must have modify permissions for this Project.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [projectId] - The project ID (for example, `foo-bar-123`).
- *
- * Required.
- *
- * Completes with a [Empty].
- *
- * 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<Empty> undelete(UndeleteProjectRequest request, core.String projectId) {
+ /// Restores the Project identified by the specified
+ /// `project_id` (for example, `my-project-123`).
+ /// You can only use this method for a Project that has a lifecycle state of
+ /// DELETE_REQUESTED.
+ /// After deletion starts, the Project cannot be restored.
+ ///
+ /// The caller must have modify permissions for this Project.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [projectId] - The project ID (for example, `foo-bar-123`).
+ ///
+ /// Required.
+ ///
+ /// Completes with a [Empty].
+ ///
+ /// 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<Empty> undelete(
+ UndeleteProjectRequest request, core.String projectId) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -875,40 +871,39 @@ class ProjectsResourceApi {
throw new core.ArgumentError("Parameter projectId is required.");
}
- _url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$projectId') + ':undelete';
+ _url = 'v1beta1/projects/' +
+ commons.Escaper.ecapeVariable('$projectId') +
+ ':undelete';
- var _response = _requester.request(_url,
- "POST",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Empty.fromJson(data));
}
- /**
- * Updates the attributes of the Project identified by the specified
- * `project_id` (for example, `my-project-123`).
- *
- * The caller must have modify permissions for this Project.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [projectId] - The project ID (for example, `my-project-123`).
- *
- * Required.
- *
- * Completes with a [Project].
- *
- * 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.
- */
+ /// Updates the attributes of the Project identified by the specified
+ /// `project_id` (for example, `my-project-123`).
+ ///
+ /// The caller must have modify permissions for this Project.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [projectId] - The project ID (for example, `my-project-123`).
+ ///
+ /// Required.
+ ///
+ /// Completes with a [Project].
+ ///
+ /// 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<Project> update(Project request, core.String projectId) {
var _url = null;
var _queryParams = new core.Map();
@@ -926,23 +921,19 @@ class ProjectsResourceApi {
_url = 'v1beta1/projects/' + commons.Escaper.ecapeVariable('$projectId');
- var _response = _requester.request(_url,
- "PUT",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "PUT",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new Project.fromJson(data));
}
-
}
-
-
-/** Identifying information for a single ancestor of a project. */
+/// Identifying information for a single ancestor of a project.
class Ancestor {
- /** Resource id of the ancestor. */
+ /// Resource id of the ancestor.
ResourceId resourceId;
Ancestor();
@@ -954,7 +945,8 @@ class Ancestor {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (resourceId != null) {
_json["resourceId"] = (resourceId).toJson();
}
@@ -962,77 +954,74 @@ class Ancestor {
}
}
-/**
- * Specifies the audit configuration for a service.
- * The configuration determines which permission types are logged, and what
- * identities, if any, are exempted from logging.
- * An AuditConfig must have one or more AuditLogConfigs.
- *
- * If there are AuditConfigs for both `allServices` and a specific service,
- * the union of the two AuditConfigs is used for that service: the log_types
- * specified in each AuditConfig are enabled, and the exempted_members in each
- * AuditConfig are exempted.
- *
- * Example Policy with multiple AuditConfigs:
- *
- * {
- * "audit_configs": [
- * {
- * "service": "allServices"
- * "audit_log_configs": [
- * {
- * "log_type": "DATA_READ",
- * "exempted_members": [
- * "user:foo@gmail.com"
- * ]
- * },
- * {
- * "log_type": "DATA_WRITE",
- * },
- * {
- * "log_type": "ADMIN_READ",
- * }
- * ]
- * },
- * {
- * "service": "fooservice.googleapis.com"
- * "audit_log_configs": [
- * {
- * "log_type": "DATA_READ",
- * },
- * {
- * "log_type": "DATA_WRITE",
- * "exempted_members": [
- * "user:bar@gmail.com"
- * ]
- * }
- * ]
- * }
- * ]
- * }
- *
- * For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
- * logging. It also exempts foo@gmail.com from DATA_READ logging, and
- * bar@gmail.com from DATA_WRITE logging.
- */
+/// Specifies the audit configuration for a service.
+/// The configuration determines which permission types are logged, and what
+/// identities, if any, are exempted from logging.
+/// An AuditConfig must have one or more AuditLogConfigs.
+///
+/// If there are AuditConfigs for both `allServices` and a specific service,
+/// the union of the two AuditConfigs is used for that service: the log_types
+/// specified in each AuditConfig are enabled, and the exempted_members in each
+/// AuditConfig are exempted.
+///
+/// Example Policy with multiple AuditConfigs:
+///
+/// {
+/// "audit_configs": [
+/// {
+/// "service": "allServices"
+/// "audit_log_configs": [
+/// {
+/// "log_type": "DATA_READ",
+/// "exempted_members": [
+/// "user:foo@gmail.com"
+/// ]
+/// },
+/// {
+/// "log_type": "DATA_WRITE",
+/// },
+/// {
+/// "log_type": "ADMIN_READ",
+/// }
+/// ]
+/// },
+/// {
+/// "service": "fooservice.googleapis.com"
+/// "audit_log_configs": [
+/// {
+/// "log_type": "DATA_READ",
+/// },
+/// {
+/// "log_type": "DATA_WRITE",
+/// "exempted_members": [
+/// "user:bar@gmail.com"
+/// ]
+/// }
+/// ]
+/// }
+/// ]
+/// }
+///
+/// For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+/// logging. It also exempts foo@gmail.com from DATA_READ logging, and
+/// bar@gmail.com from DATA_WRITE logging.
class AuditConfig {
- /**
- * The configuration for logging of each type of permission.
- * Next ID: 4
- */
+ /// The configuration for logging of each type of permission.
+ /// Next ID: 4
core.List<AuditLogConfig> auditLogConfigs;
- /**
- * Specifies a service that will be enabled for audit logging.
- * For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
- * `allServices` is a special value that covers all services.
- */
+
+ /// Specifies a service that will be enabled for audit logging.
+ /// For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+ /// `allServices` is a special value that covers all services.
core.String service;
AuditConfig();
AuditConfig.fromJson(core.Map _json) {
if (_json.containsKey("auditLogConfigs")) {
- auditLogConfigs = _json["auditLogConfigs"].map((value) => new AuditLogConfig.fromJson(value)).toList();
+ auditLogConfigs = _json["auditLogConfigs"]
+ .map((value) => new AuditLogConfig.fromJson(value))
+ .toList();
}
if (_json.containsKey("service")) {
service = _json["service"];
@@ -1040,9 +1029,11 @@ class AuditConfig {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (auditLogConfigs != null) {
- _json["auditLogConfigs"] = auditLogConfigs.map((value) => (value).toJson()).toList();
+ _json["auditLogConfigs"] =
+ auditLogConfigs.map((value) => (value).toJson()).toList();
}
if (service != null) {
_json["service"] = service;
@@ -1051,42 +1042,37 @@ class AuditConfig {
}
}
-/**
- * Provides the configuration for logging a type of permissions.
- * Example:
- *
- * {
- * "audit_log_configs": [
- * {
- * "log_type": "DATA_READ",
- * "exempted_members": [
- * "user:foo@gmail.com"
- * ]
- * },
- * {
- * "log_type": "DATA_WRITE",
- * }
- * ]
- * }
- *
- * This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
- * foo@gmail.com from DATA_READ logging.
- */
+/// Provides the configuration for logging a type of permissions.
+/// Example:
+///
+/// {
+/// "audit_log_configs": [
+/// {
+/// "log_type": "DATA_READ",
+/// "exempted_members": [
+/// "user:foo@gmail.com"
+/// ]
+/// },
+/// {
+/// "log_type": "DATA_WRITE",
+/// }
+/// ]
+/// }
+///
+/// This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+/// foo@gmail.com from DATA_READ logging.
class AuditLogConfig {
- /**
- * Specifies the identities that do not cause logging for this type of
- * permission.
- * Follows the same format of Binding.members.
- */
+ /// Specifies the identities that do not cause logging for this type of
+ /// permission.
+ /// Follows the same format of Binding.members.
core.List<core.String> exemptedMembers;
- /**
- * The log type that this config enables.
- * Possible string values are:
- * - "LOG_TYPE_UNSPECIFIED" : Default case. Should never be this.
- * - "ADMIN_READ" : Admin reads. Example: CloudIAM getIamPolicy
- * - "DATA_WRITE" : Data writes. Example: CloudSQL Users create
- * - "DATA_READ" : Data reads. Example: CloudSQL Users list
- */
+
+ /// The log type that this config enables.
+ /// Possible string values are:
+ /// - "LOG_TYPE_UNSPECIFIED" : Default case. Should never be this.
+ /// - "ADMIN_READ" : Admin reads. Example: CloudIAM getIamPolicy
+ /// - "DATA_WRITE" : Data writes. Example: CloudSQL Users create
+ /// - "DATA_READ" : Data reads. Example: CloudSQL Users list
core.String logType;
AuditLogConfig();
@@ -1101,7 +1087,8 @@ class AuditLogConfig {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (exemptedMembers != null) {
_json["exemptedMembers"] = exemptedMembers;
}
@@ -1112,38 +1099,35 @@ class AuditLogConfig {
}
}
-/** Associates `members` with a `role`. */
+/// Associates `members` with a `role`.
class Binding {
- /**
- * Specifies the identities requesting access for a Cloud Platform resource.
- * `members` can have the following values:
- *
- * * `allUsers`: A special identifier that represents anyone who is
- * on the internet; with or without a Google account.
- *
- * * `allAuthenticatedUsers`: A special identifier that represents anyone
- * who is authenticated with a Google account or a service account.
- *
- * * `user:{emailid}`: An email address that represents a specific Google
- * account. For example, `alice@gmail.com` or `joe@example.com`.
- *
- *
- * * `serviceAccount:{emailid}`: An email address that represents a service
- * account. For example, `my-other-app@appspot.gserviceaccount.com`.
- *
- * * `group:{emailid}`: An email address that represents a Google group.
- * For example, `admins@example.com`.
- *
- *
- * * `domain:{domain}`: A Google Apps domain name that represents all the
- * users of that domain. For example, `google.com` or `example.com`.
- */
+ /// Specifies the identities requesting access for a Cloud Platform resource.
+ /// `members` can have the following values:
+ ///
+ /// * `allUsers`: A special identifier that represents anyone who is
+ /// on the internet; with or without a Google account.
+ ///
+ /// * `allAuthenticatedUsers`: A special identifier that represents anyone
+ /// who is authenticated with a Google account or a service account.
+ ///
+ /// * `user:{emailid}`: An email address that represents a specific Google
+ /// account. For example, `alice@gmail.com` or `joe@example.com`.
+ ///
+ ///
+ /// * `serviceAccount:{emailid}`: An email address that represents a service
+ /// account. For example, `my-other-app@appspot.gserviceaccount.com`.
+ ///
+ /// * `group:{emailid}`: An email address that represents a Google group.
+ /// For example, `admins@example.com`.
+ ///
+ ///
+ /// * `domain:{domain}`: A Google Apps domain name that represents all the
+ /// users of that domain. For example, `google.com` or `example.com`.
core.List<core.String> members;
- /**
- * Role that is assigned to `members`.
- * For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
- * Required
- */
+
+ /// Role that is assigned to `members`.
+ /// For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+ /// Required
core.String role;
Binding();
@@ -1158,7 +1142,8 @@ class Binding {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (members != null) {
_json["members"] = members;
}
@@ -1169,51 +1154,45 @@ class Binding {
}
}
-/**
- * A generic empty message that you can re-use to avoid defining duplicated
- * empty messages in your APIs. A typical example is to use it as the request
- * or the response type of an API method. For instance:
- *
- * service Foo {
- * rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
- * }
- *
- * The JSON representation for `Empty` is empty JSON object `{}`.
- */
+/// A generic empty message that you can re-use to avoid defining duplicated
+/// empty messages in your APIs. A typical example is to use it as the request
+/// or the response type of an API method. For instance:
+///
+/// service Foo {
+/// rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+/// }
+///
+/// The JSON representation for `Empty` is empty JSON object `{}`.
class Empty {
-
Empty();
- Empty.fromJson(core.Map _json) {
- }
+ Empty.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>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
return _json;
}
}
-/** Metadata describing a long running folder operation */
+/// Metadata describing a long running folder operation
class FolderOperation {
- /**
- * The resource name of the folder or organization we are either creating
- * the folder under or moving the folder to.
- */
+ /// The resource name of the folder or organization we are either creating
+ /// the folder under or moving the folder to.
core.String destinationParent;
- /** The display name of the folder. */
+
+ /// The display name of the folder.
core.String displayName;
- /**
- * The type of this operation.
- * Possible string values are:
- * - "OPERATION_TYPE_UNSPECIFIED" : Operation type not specified.
- * - "CREATE" : A create folder operation.
- * - "MOVE" : A move folder operation.
- */
+
+ /// The type of this operation.
+ /// Possible string values are:
+ /// - "OPERATION_TYPE_UNSPECIFIED" : Operation type not specified.
+ /// - "CREATE" : A create folder operation.
+ /// - "MOVE" : A move folder operation.
core.String operationType;
- /**
- * The resource name of the folder's parent.
- * Only applicable when the operation_type is MOVE.
- */
+
+ /// The resource name of the folder's parent.
+ /// Only applicable when the operation_type is MOVE.
core.String sourceParent;
FolderOperation();
@@ -1234,7 +1213,8 @@ class FolderOperation {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (destinationParent != null) {
_json["destinationParent"] = destinationParent;
}
@@ -1251,33 +1231,32 @@ class FolderOperation {
}
}
-/** A classification of the Folder Operation error. */
+/// A classification of the Folder Operation error.
class FolderOperationError {
- /**
- * The type of operation error experienced.
- * Possible string values are:
- * - "ERROR_TYPE_UNSPECIFIED" : The error type was unrecognized or
- * unspecified.
- * - "ACTIVE_FOLDER_HEIGHT_VIOLATION" : The attempted action would violate the
- * max folder depth constraint.
- * - "MAX_CHILD_FOLDERS_VIOLATION" : The attempted action would violate the
- * max child folders constraint.
- * - "FOLDER_NAME_UNIQUENESS_VIOLATION" : The attempted action would violate
- * the locally-unique folder
- * display_name constraint.
- * - "RESOURCE_DELETED_VIOLATION" : The resource being moved has been deleted.
- * - "PARENT_DELETED_VIOLATION" : The resource a folder was being added to has
- * been deleted.
- * - "CYCLE_INTRODUCED_VIOLATION" : The attempted action would introduce cycle
- * in resource path.
- * - "FOLDER_BEING_MOVED_VIOLATION" : The attempted action would move a folder
- * that is already being moved.
- * - "FOLDER_TO_DELETE_NON_EMPTY_VIOLATION" : The folder the caller is trying
- * to delete contains active resources.
- * - "DELETED_FOLDER_HEIGHT_VIOLATION" : The attempted action would violate
- * the max deleted folder depth
- * constraint.
- */
+ /// The type of operation error experienced.
+ /// Possible string values are:
+ /// - "ERROR_TYPE_UNSPECIFIED" : The error type was unrecognized or
+ /// unspecified.
+ /// - "ACTIVE_FOLDER_HEIGHT_VIOLATION" : The attempted action would violate
+ /// the max folder depth constraint.
+ /// - "MAX_CHILD_FOLDERS_VIOLATION" : The attempted action would violate the
+ /// max child folders constraint.
+ /// - "FOLDER_NAME_UNIQUENESS_VIOLATION" : The attempted action would violate
+ /// the locally-unique folder
+ /// display_name constraint.
+ /// - "RESOURCE_DELETED_VIOLATION" : The resource being moved has been
+ /// deleted.
+ /// - "PARENT_DELETED_VIOLATION" : The resource a folder was being added to
+ /// has been deleted.
+ /// - "CYCLE_INTRODUCED_VIOLATION" : The attempted action would introduce
+ /// cycle in resource path.
+ /// - "FOLDER_BEING_MOVED_VIOLATION" : The attempted action would move a
+ /// folder that is already being moved.
+ /// - "FOLDER_TO_DELETE_NON_EMPTY_VIOLATION" : The folder the caller is
+ /// trying to delete contains active resources.
+ /// - "DELETED_FOLDER_HEIGHT_VIOLATION" : The attempted action would violate
+ /// the max deleted folder depth
+ /// constraint.
core.String errorMessageId;
FolderOperationError();
@@ -1289,7 +1268,8 @@ class FolderOperationError {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (errorMessageId != null) {
_json["errorMessageId"] = errorMessageId;
}
@@ -1297,43 +1277,41 @@ class FolderOperationError {
}
}
-/**
- * The request sent to the
- * GetAncestry
- * method.
- */
+/// The request sent to the
+/// GetAncestry
+/// method.
class GetAncestryRequest {
-
GetAncestryRequest();
- GetAncestryRequest.fromJson(core.Map _json) {
- }
+ GetAncestryRequest.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>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
return _json;
}
}
-/** Response from the GetAncestry method. */
+/// Response from the GetAncestry method.
class GetAncestryResponse {
- /**
- * Ancestors are ordered from bottom to top of the resource hierarchy. The
- * first ancestor is the project itself, followed by the project's parent,
- * etc.
- */
+ /// Ancestors are ordered from bottom to top of the resource hierarchy. The
+ /// first ancestor is the project itself, followed by the project's parent,
+ /// etc.
core.List<Ancestor> ancestor;
GetAncestryResponse();
GetAncestryResponse.fromJson(core.Map _json) {
if (_json.containsKey("ancestor")) {
- ancestor = _json["ancestor"].map((value) => new Ancestor.fromJson(value)).toList();
+ ancestor = _json["ancestor"]
+ .map((value) => new Ancestor.fromJson(value))
+ .toList();
}
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (ancestor != null) {
_json["ancestor"] = ancestor.map((value) => (value).toJson()).toList();
}
@@ -1341,33 +1319,32 @@ class GetAncestryResponse {
}
}
-/** Request message for `GetIamPolicy` method. */
+/// Request message for `GetIamPolicy` method.
class GetIamPolicyRequest {
-
GetIamPolicyRequest();
- GetIamPolicyRequest.fromJson(core.Map _json) {
- }
+ GetIamPolicyRequest.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>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
return _json;
}
}
-/** The response returned from the `ListOrganizations` method. */
+/// The response returned from the `ListOrganizations` method.
class ListOrganizationsResponse {
- /**
- * A pagination token to be used to retrieve the next page of results. If the
- * result is too large to fit within the page size specified in the request,
- * this field will be set with a token that can be used to fetch the next page
- * of results. If this field is empty, it indicates that this response
- * contains the last page of results.
- */
+ /// A pagination token to be used to retrieve the next page of results. If
+ /// the
+ /// result is too large to fit within the page size specified in the request,
+ /// this field will be set with a token that can be used to fetch the next
+ /// page
+ /// of results. If this field is empty, it indicates that this response
+ /// contains the last page of results.
core.String nextPageToken;
- /**
- * The list of Organizations that matched the list query, possibly paginated.
- */
+
+ /// The list of Organizations that matched the list query, possibly
+ /// paginated.
core.List<Organization> organizations;
ListOrganizationsResponse();
@@ -1377,50 +1354,50 @@ class ListOrganizationsResponse {
nextPageToken = _json["nextPageToken"];
}
if (_json.containsKey("organizations")) {
- organizations = _json["organizations"].map((value) => new Organization.fromJson(value)).toList();
+ organizations = _json["organizations"]
+ .map((value) => new Organization.fromJson(value))
+ .toList();
}
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (nextPageToken != null) {
_json["nextPageToken"] = nextPageToken;
}
if (organizations != null) {
- _json["organizations"] = organizations.map((value) => (value).toJson()).toList();
+ _json["organizations"] =
+ organizations.map((value) => (value).toJson()).toList();
}
return _json;
}
}
-/**
- * A page of the response received from the
- * ListProjects
- * method.
- *
- * A paginated response where more pages are available has
- * `next_page_token` set. This token can be used in a subsequent request to
- * retrieve the next request page.
- */
+/// A page of the response received from the
+/// ListProjects
+/// method.
+///
+/// A paginated response where more pages are available has
+/// `next_page_token` set. This token can be used in a subsequent request to
+/// retrieve the next request page.
class ListProjectsResponse {
- /**
- * Pagination token.
- *
- * If the result set is too large to fit in a single response, this token
- * is returned. It encodes the position of the current result cursor.
- * Feeding this value into a new list request with the `page_token` parameter
- * gives the next page of the results.
- *
- * When `next_page_token` is not filled in, there is no next page and
- * the list returned is the last page in the result set.
- *
- * Pagination tokens have a limited lifetime.
- */
+ /// Pagination token.
+ ///
+ /// If the result set is too large to fit in a single response, this token
+ /// is returned. It encodes the position of the current result cursor.
+ /// Feeding this value into a new list request with the `page_token`
+ /// parameter
+ /// gives the next page of the results.
+ ///
+ /// When `next_page_token` is not filled in, there is no next page and
+ /// the list returned is the last page in the result set.
+ ///
+ /// Pagination tokens have a limited lifetime.
core.String nextPageToken;
- /**
- * The list of Projects that matched the list filter. This list can
- * be paginated.
- */
+
+ /// The list of Projects that matched the list filter. This list can
+ /// be paginated.
core.List<Project> projects;
ListProjectsResponse();
@@ -1430,12 +1407,15 @@ class ListProjectsResponse {
nextPageToken = _json["nextPageToken"];
}
if (_json.containsKey("projects")) {
- projects = _json["projects"].map((value) => new Project.fromJson(value)).toList();
+ projects = _json["projects"]
+ .map((value) => new Project.fromJson(value))
+ .toList();
}
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (nextPageToken != null) {
_json["nextPageToken"] = nextPageToken;
}
@@ -1446,52 +1426,43 @@ class ListProjectsResponse {
}
}
-/**
- * The root node in the resource hierarchy to which a particular entity's
- * (e.g., company) resources belong.
- */
+/// The root node in the resource hierarchy to which a particular entity's
+/// (e.g., company) resources belong.
class Organization {
- /**
- * Timestamp when the Organization was created. Assigned by the server.
- * @OutputOnly
- */
+ /// 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 primary domain of the G Suite
- * customer that owns the organization.
- * @OutputOnly
- */
+
+ /// A friendly string to be used to refer to the Organization in the UI.
+ /// 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.
- * - "DELETE_REQUESTED" : The organization has been marked for deletion by the
- * user.
- */
+
+ /// 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.
+ /// - "DELETE_REQUESTED" : The organization has been marked for deletion by
+ /// the user.
core.String lifecycleState;
- /**
- * Output Only. The resource name of the organization. This is the
- * organization's relative path in the API. Its format is
- * "organizations/[organization_id]". For example, "organizations/1234".
- */
+
+ /// Output Only. The resource name of the organization. This is the
+ /// organization's relative path in the API. Its format is
+ /// "organizations/[organization_id]". For example, "organizations/1234".
core.String name;
- /**
- * An immutable id for the Organization that is assigned on creation. This
- * should be omitted when creating a new Organization.
- * This field is read-only.
- * This field is deprecated and will be removed in v1. Use name instead.
- */
+
+ /// An immutable id for the Organization that is assigned on creation. This
+ /// should be omitted when creating a new Organization.
+ /// This field is read-only.
+ /// This field is deprecated and will be removed in v1. Use name instead.
core.String organizationId;
- /**
- * The owner of this Organization. The owner should be specified on
- * creation. Once set, it cannot be changed.
- * This field is required.
- */
+
+ /// The owner of this Organization. The owner should be specified on
+ /// creation. Once set, it cannot be changed.
+ /// This field is required.
OrganizationOwner owner;
Organization();
@@ -1518,7 +1489,8 @@ class Organization {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (creationTime != null) {
_json["creationTime"] = creationTime;
}
@@ -1541,14 +1513,13 @@ class Organization {
}
}
-/**
- * The entity that owns an Organization. The lifetime of the Organization and
- * all of its descendants are bound to the `OrganizationOwner`. If the
- * `OrganizationOwner` is deleted, the Organization and all its descendants will
- * be deleted.
- */
+/// The entity that owns an Organization. The lifetime of the Organization and
+/// all of its descendants are bound to the `OrganizationOwner`. If the
+/// `OrganizationOwner` is deleted, the Organization and all its descendants
+/// will
+/// be deleted.
class OrganizationOwner {
- /** The Google for Work customer id used in the Directory API. */
+ /// The Google for Work customer id used in the Directory API.
core.String directoryCustomerId;
OrganizationOwner();
@@ -1560,7 +1531,8 @@ class OrganizationOwner {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (directoryCustomerId != null) {
_json["directoryCustomerId"] = directoryCustomerId;
}
@@ -1568,78 +1540,83 @@ class OrganizationOwner {
}
}
-/**
- * Defines an Identity and Access Management (IAM) policy. It is used to
- * specify access control policies for Cloud Platform resources.
- *
- *
- * A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
- * `members` to a `role`, where the members can be user accounts, Google groups,
- * Google domains, and service accounts. A `role` is a named list of permissions
- * defined by IAM.
- *
- * **Example**
- *
- * {
- * "bindings": [
- * {
- * "role": "roles/owner",
- * "members": [
- * "user:mike@example.com",
- * "group:admins@example.com",
- * "domain:google.com",
- * "serviceAccount:my-other-app@appspot.gserviceaccount.com",
- * ]
- * },
- * {
- * "role": "roles/viewer",
- * "members": ["user:sean@example.com"]
- * }
- * ]
- * }
- *
- * For a description of IAM and its features, see the
- * [IAM developer's guide](https://cloud.google.com/iam).
- */
+/// Defines an Identity and Access Management (IAM) policy. It is used to
+/// specify access control policies for Cloud Platform resources.
+///
+///
+/// A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+/// `members` to a `role`, where the members can be user accounts, Google
+/// groups,
+/// Google domains, and service accounts. A `role` is a named list of
+/// permissions
+/// defined by IAM.
+///
+/// **Example**
+///
+/// {
+/// "bindings": [
+/// {
+/// "role": "roles/owner",
+/// "members": [
+/// "user:mike@example.com",
+/// "group:admins@example.com",
+/// "domain:google.com",
+/// "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+/// ]
+/// },
+/// {
+/// "role": "roles/viewer",
+/// "members": ["user:sean@example.com"]
+/// }
+/// ]
+/// }
+///
+/// For a description of IAM and its features, see the
+/// [IAM developer's guide](https://cloud.google.com/iam).
class Policy {
- /** Specifies cloud audit logging configuration for this policy. */
+ /// Specifies cloud audit logging configuration for this policy.
core.List<AuditConfig> auditConfigs;
- /**
- * Associates a list of `members` to a `role`.
- * `bindings` with no members will result in an error.
- */
+
+ /// Associates a list of `members` to a `role`.
+ /// `bindings` with no members will result in an error.
core.List<Binding> bindings;
- /**
- * `etag` is used for optimistic concurrency control as a way to help
- * prevent simultaneous updates of a policy from overwriting each other.
- * It is strongly suggested that systems make use of the `etag` in the
- * read-modify-write cycle to perform policy updates in order to avoid race
- * conditions: An `etag` is returned in the response to `getIamPolicy`, and
- * systems are expected to put that etag in the request to `setIamPolicy` to
- * ensure that their change will be applied to the same version of the policy.
- *
- * If no `etag` is provided in the call to `setIamPolicy`, then the existing
- * policy is overwritten blindly.
- */
+
+ /// `etag` is used for optimistic concurrency control as a way to help
+ /// prevent simultaneous updates of a policy from overwriting each other.
+ /// It is strongly suggested that systems make use of the `etag` in the
+ /// read-modify-write cycle to perform policy updates in order to avoid race
+ /// conditions: An `etag` is returned in the response to `getIamPolicy`, and
+ /// systems are expected to put that etag in the request to `setIamPolicy` to
+ /// ensure that their change will be applied to the same version of the
+ /// policy.
+ ///
+ /// If no `etag` is provided in the call to `setIamPolicy`, then the existing
+ /// policy is overwritten blindly.
core.String etag;
core.List<core.int> get etagAsBytes {
return convert.BASE64.decode(etag);
}
void set etagAsBytes(core.List<core.int> _bytes) {
- etag = convert.BASE64.encode(_bytes).replaceAll("/", "_").replaceAll("+", "-");
+ etag =
+ convert.BASE64.encode(_bytes).replaceAll("/", "_").replaceAll("+", "-");
}
- /** Version of the `Policy`. The default version is 0. */
+
+ /// Version of the `Policy`. The default version is 0.
core.int version;
Policy();
Policy.fromJson(core.Map _json) {
if (_json.containsKey("auditConfigs")) {
- auditConfigs = _json["auditConfigs"].map((value) => new AuditConfig.fromJson(value)).toList();
+ auditConfigs = _json["auditConfigs"]
+ .map((value) => new AuditConfig.fromJson(value))
+ .toList();
}
if (_json.containsKey("bindings")) {
- bindings = _json["bindings"].map((value) => new Binding.fromJson(value)).toList();
+ bindings = _json["bindings"]
+ .map((value) => new Binding.fromJson(value))
+ .toList();
}
if (_json.containsKey("etag")) {
etag = _json["etag"];
@@ -1650,9 +1627,11 @@ class Policy {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (auditConfigs != null) {
- _json["auditConfigs"] = auditConfigs.map((value) => (value).toJson()).toList();
+ _json["auditConfigs"] =
+ auditConfigs.map((value) => (value).toJson()).toList();
}
if (bindings != null) {
_json["bindings"] = bindings.map((value) => (value).toJson()).toList();
@@ -1667,90 +1646,82 @@ class Policy {
}
}
-/**
- * A Project is a high-level Google Cloud Platform entity. It is a
- * container for ACLs, APIs, App Engine Apps, VMs, and other
- * Google Cloud Platform resources.
- */
+/// A Project is a high-level Google Cloud Platform entity. It is a
+/// container for ACLs, APIs, App Engine Apps, VMs, and other
+/// Google Cloud Platform resources.
class Project {
- /**
- * Creation time.
- *
- * Read-only.
- */
+ /// Creation time.
+ ///
+ /// Read-only.
core.String createTime;
- /**
- * The labels associated with this Project.
- *
- * Label keys must be between 1 and 63 characters long and must conform
- * to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
- *
- * Label values must be between 0 and 63 characters long and must conform
- * to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
- *
- * No more than 256 labels can be associated with a given resource.
- *
- * Clients should store labels in a representation such as JSON that does not
- * depend on specific characters being disallowed.
- *
- * Example: <code>"environment" : "dev"</code>
- * Read-write.
- */
+
+ /// The labels associated with this Project.
+ ///
+ /// Label keys must be between 1 and 63 characters long and must conform
+ /// to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+ ///
+ /// Label values must be between 0 and 63 characters long and must conform
+ /// to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+ ///
+ /// No more than 256 labels can be associated with a given resource.
+ ///
+ /// Clients should store labels in a representation such as JSON that does
+ /// not
+ /// depend on specific characters being disallowed.
+ ///
+ /// Example: <code>"environment" : "dev"</code>
+ /// Read-write.
core.Map<core.String, core.String> labels;
- /**
- * The Project lifecycle state.
- *
- * Read-only.
- * Possible string values are:
- * - "LIFECYCLE_STATE_UNSPECIFIED" : Unspecified state. This is only
- * used/useful for distinguishing
- * unset values.
- * - "ACTIVE" : The normal and active state.
- * - "DELETE_REQUESTED" : The project has been marked for deletion by the user
- * (by invoking DeleteProject)
- * or by the system (Google Cloud Platform).
- * This can generally be reversed by invoking UndeleteProject.
- * - "DELETE_IN_PROGRESS" : This lifecycle state is no longer used and is not
- * returned by the API.
- */
+
+ /// The Project lifecycle state.
+ ///
+ /// Read-only.
+ /// Possible string values are:
+ /// - "LIFECYCLE_STATE_UNSPECIFIED" : Unspecified state. This is only
+ /// used/useful for distinguishing
+ /// unset values.
+ /// - "ACTIVE" : The normal and active state.
+ /// - "DELETE_REQUESTED" : The project has been marked for deletion by the
+ /// user
+ /// (by invoking DeleteProject)
+ /// or by the system (Google Cloud Platform).
+ /// This can generally be reversed by invoking UndeleteProject.
+ /// - "DELETE_IN_PROGRESS" : This lifecycle state is no longer used and is
+ /// not returned by the API.
core.String lifecycleState;
- /**
- * The user-assigned display name of the Project.
- * It must be 4 to 30 characters.
- * Allowed characters are: lowercase and uppercase letters, numbers,
- * hyphen, single-quote, double-quote, space, and exclamation point.
- *
- * Example: <code>My Project</code>
- * Read-write.
- */
+
+ /// The user-assigned display name of the Project.
+ /// It must be 4 to 30 characters.
+ /// Allowed characters are: lowercase and uppercase letters, numbers,
+ /// hyphen, single-quote, double-quote, space, and exclamation point.
+ ///
+ /// Example: <code>My Project</code>
+ /// Read-write.
core.String name;
- /**
- * An optional reference to a parent Resource.
- *
- * The only supported parent type is "organization". Once set, the parent
- * cannot be modified. The `parent` can be set on creation or using the
- * `UpdateProject` method; the end user must have the
- * `resourcemanager.projects.create` permission on the parent.
- *
- * Read-write.
- */
+
+ /// An optional reference to a parent Resource.
+ ///
+ /// The only supported parent type is "organization". Once set, the parent
+ /// cannot be modified. The `parent` can be set on creation or using the
+ /// `UpdateProject` method; the end user must have the
+ /// `resourcemanager.projects.create` permission on the parent.
+ ///
+ /// Read-write.
ResourceId parent;
- /**
- * The unique, user-assigned ID of the Project.
- * It must be 6 to 30 lowercase letters, digits, or hyphens.
- * It must start with a letter.
- * Trailing hyphens are prohibited.
- *
- * Example: <code>tokyo-rain-123</code>
- * Read-only after creation.
- */
+
+ /// The unique, user-assigned ID of the Project.
+ /// It must be 6 to 30 lowercase letters, digits, or hyphens.
+ /// It must start with a letter.
+ /// Trailing hyphens are prohibited.
+ ///
+ /// Example: <code>tokyo-rain-123</code>
+ /// Read-only after creation.
core.String projectId;
- /**
- * The number uniquely identifying the project.
- *
- * Example: <code>415104041262</code>
- * Read-only.
- */
+
+ /// The number uniquely identifying the project.
+ ///
+ /// Example: <code>415104041262</code>
+ /// Read-only.
core.String projectNumber;
Project();
@@ -1780,7 +1751,8 @@ class Project {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (createTime != null) {
_json["createTime"] = createTime;
}
@@ -1806,21 +1778,21 @@ class Project {
}
}
-/**
- * A status object which is used as the `metadata` field for the Operation
- * returned by CreateProject. It provides insight for when significant phases of
- * Project creation have completed.
- */
+/// A status object which is used as the `metadata` field for the Operation
+/// returned by CreateProject. It provides insight for when significant phases
+/// of
+/// Project creation have completed.
class ProjectCreationStatus {
- /** Creation time of the project creation workflow. */
+ /// Creation time of the project creation workflow.
core.String createTime;
- /**
- * True if the project can be retrieved using GetProject. No other operations
- * on the project are guaranteed to work until the project creation is
- * complete.
- */
+
+ /// True if the project can be retrieved using GetProject. No other
+ /// operations
+ /// on the project are guaranteed to work until the project creation is
+ /// complete.
core.bool gettable;
- /** True if the project creation process is complete. */
+
+ /// True if the project creation process is complete.
core.bool ready;
ProjectCreationStatus();
@@ -1838,7 +1810,8 @@ class ProjectCreationStatus {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (createTime != null) {
_json["createTime"] = createTime;
}
@@ -1852,22 +1825,20 @@ class ProjectCreationStatus {
}
}
-/**
- * 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 App Engine app,
- * a Compute Engine instance, a Cloud SQL database, and so on.
- */
+/// 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 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.
- */
+ /// 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.
- * At present, the valid types are "project" and "organization".
- */
+
+ /// Required field representing the resource type this id is for.
+ /// At present, the valid types are "project", "folder", and "organization".
core.String type;
ResourceId();
@@ -1882,7 +1853,8 @@ class ResourceId {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (id != null) {
_json["id"] = id;
}
@@ -1893,22 +1865,21 @@ class ResourceId {
}
}
-/** Request message for `SetIamPolicy` method. */
+/// Request message for `SetIamPolicy` method.
class SetIamPolicyRequest {
- /**
- * REQUIRED: The complete policy to be applied to the `resource`. The size of
- * the policy is limited to a few 10s of KB. An empty policy is a
- * valid policy but certain Cloud Platform services (such as Projects)
- * might reject them.
- */
+ /// REQUIRED: The complete policy to be applied to the `resource`. The size
+ /// of
+ /// the policy is limited to a few 10s of KB. An empty policy is a
+ /// valid policy but certain Cloud Platform services (such as Projects)
+ /// might reject them.
Policy policy;
- /**
- * OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
- * the fields in the mask will be modified. If no mask is provided, the
- * following default mask is used:
- * paths: "bindings, etag"
- * This field is only used by Cloud IAM.
- */
+
+ /// OPTIONAL: A FieldMask specifying which fields of the policy to modify.
+ /// Only
+ /// the fields in the mask will be modified. If no mask is provided, the
+ /// following default mask is used:
+ /// paths: "bindings, etag"
+ /// This field is only used by Cloud IAM.
core.String updateMask;
SetIamPolicyRequest();
@@ -1923,7 +1894,8 @@ class SetIamPolicyRequest {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (policy != null) {
_json["policy"] = (policy).toJson();
}
@@ -1934,14 +1906,12 @@ class SetIamPolicyRequest {
}
}
-/** Request message for `TestIamPermissions` method. */
+/// Request message for `TestIamPermissions` method.
class TestIamPermissionsRequest {
- /**
- * The set of permissions to check for the `resource`. Permissions with
- * wildcards (such as '*' or 'storage.*') are not allowed. For more
- * information see
- * [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
- */
+ /// The set of permissions to check for the `resource`. Permissions with
+ /// wildcards (such as '*' or 'storage.*') are not allowed. For more
+ /// information see
+ /// [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
core.List<core.String> permissions;
TestIamPermissionsRequest();
@@ -1953,7 +1923,8 @@ class TestIamPermissionsRequest {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (permissions != null) {
_json["permissions"] = permissions;
}
@@ -1961,12 +1932,10 @@ class TestIamPermissionsRequest {
}
}
-/** Response message for `TestIamPermissions` method. */
+/// Response message for `TestIamPermissions` method.
class TestIamPermissionsResponse {
- /**
- * A subset of `TestPermissionsRequest.permissions` that the caller is
- * allowed.
- */
+ /// A subset of `TestPermissionsRequest.permissions` that the caller is
+ /// allowed.
core.List<core.String> permissions;
TestIamPermissionsResponse();
@@ -1978,7 +1947,8 @@ class TestIamPermissionsResponse {
}
core.Map<core.String, core.Object> toJson() {
- final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
if (permissions != null) {
_json["permissions"] = permissions;
}
@@ -1986,19 +1956,16 @@ class TestIamPermissionsResponse {
}
}
-/**
- * The request sent to the UndeleteProject
- * method.
- */
+/// The request sent to the UndeleteProject
+/// method.
class UndeleteProjectRequest {
-
UndeleteProjectRequest();
- UndeleteProjectRequest.fromJson(core.Map _json) {
- }
+ 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>();
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
return _json;
}
}
« no previous file with comments | « generated/googleapis_beta/lib/cloudmonitoring/v2beta2.dart ('k') | generated/googleapis_beta/lib/clouduseraccounts/beta.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698