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

Unified Diff: generated/googleapis/lib/logging/v2.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/lib/licensing/v1.dart ('k') | generated/googleapis/lib/manufacturers/v1.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: generated/googleapis/lib/logging/v2.dart
diff --git a/generated/googleapis/lib/logging/v2.dart b/generated/googleapis/lib/logging/v2.dart
index e49894e29770c39dad8af7f8c51abe1d270a53a8..13f43b26ca859bf0c3f7dab86196518f3d199eb0 100644
--- a/generated/googleapis/lib/logging/v2.dart
+++ b/generated/googleapis/lib/logging/v2.dart
@@ -9,86 +9,357 @@ 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 logging/v2';
-/** Writes log entries and manages your Stackdriver Logging configuration. */
+/// Writes log entries and manages your Stackdriver Logging configuration.
class LoggingApi {
- /** View and manage your data across Google Cloud Platform services */
- static const CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform";
+ /// 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 your data across Google Cloud Platform services
+ static const CloudPlatformReadOnlyScope =
+ "https://www.googleapis.com/auth/cloud-platform.read-only";
- /** Administrate log data for your projects */
- static const LoggingAdminScope = "https://www.googleapis.com/auth/logging.admin";
+ /// Administrate log data for your projects
+ static const LoggingAdminScope =
+ "https://www.googleapis.com/auth/logging.admin";
- /** View log data for your projects */
- static const LoggingReadScope = "https://www.googleapis.com/auth/logging.read";
-
- /** Submit log data for your projects */
- static const LoggingWriteScope = "https://www.googleapis.com/auth/logging.write";
+ /// View log data for your projects
+ static const LoggingReadScope =
+ "https://www.googleapis.com/auth/logging.read";
+ /// Submit log data for your projects
+ static const LoggingWriteScope =
+ "https://www.googleapis.com/auth/logging.write";
final commons.ApiRequester _requester;
- BillingAccountsResourceApi get billingAccounts => new BillingAccountsResourceApi(_requester);
+ BillingAccountsResourceApi get billingAccounts =>
+ new BillingAccountsResourceApi(_requester);
EntriesResourceApi get entries => new EntriesResourceApi(_requester);
FoldersResourceApi get folders => new FoldersResourceApi(_requester);
- MonitoredResourceDescriptorsResourceApi get monitoredResourceDescriptors => new MonitoredResourceDescriptorsResourceApi(_requester);
- OrganizationsResourceApi get organizations => new OrganizationsResourceApi(_requester);
+ MonitoredResourceDescriptorsResourceApi get monitoredResourceDescriptors =>
+ new MonitoredResourceDescriptorsResourceApi(_requester);
+ OrganizationsResourceApi get organizations =>
+ new OrganizationsResourceApi(_requester);
ProjectsResourceApi get projects => new ProjectsResourceApi(_requester);
- LoggingApi(http.Client client, {core.String rootUrl: "https://logging.googleapis.com/", core.String servicePath: ""}) :
- _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
+ LoggingApi(http.Client client,
+ {core.String rootUrl: "https://logging.googleapis.com/",
+ core.String servicePath: ""})
+ : _requester =
+ new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
}
-
class BillingAccountsResourceApi {
final commons.ApiRequester _requester;
- BillingAccountsLogsResourceApi get logs => new BillingAccountsLogsResourceApi(_requester);
- BillingAccountsSinksResourceApi get sinks => new BillingAccountsSinksResourceApi(_requester);
+ BillingAccountsExclusionsResourceApi get exclusions =>
+ new BillingAccountsExclusionsResourceApi(_requester);
+ BillingAccountsLogsResourceApi get logs =>
+ new BillingAccountsLogsResourceApi(_requester);
+ BillingAccountsSinksResourceApi get sinks =>
+ new BillingAccountsSinksResourceApi(_requester);
- BillingAccountsResourceApi(commons.ApiRequester client) :
- _requester = client;
+ BillingAccountsResourceApi(commons.ApiRequester client) : _requester = client;
}
+class BillingAccountsExclusionsResourceApi {
+ final commons.ApiRequester _requester;
+
+ BillingAccountsExclusionsResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Creates a new exclusion in a specified parent resource. Only log entries
+ /// belonging to that resource can be excluded. You can have up to 10
+ /// exclusions in a resource.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource in which to create the
+ /// exclusion:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^billingAccounts/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> create(LogExclusion request, core.String parent) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Deletes an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion to delete:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^billingAccounts/[^/]+/exclusions/[^/]+$".
+ ///
+ /// 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 name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "DELETE",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new Empty.fromJson(data));
+ }
+
+ /// Gets the description of an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^billingAccounts/[^/]+/exclusions/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> get(core.String name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Lists all the exclusions in a parent resource.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose exclusions are to be
+ /// listed.
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^billingAccounts/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListExclusionsResponse].
+ ///
+ /// 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<ListExclusionsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+ if (pageToken != null) {
+ _queryParams["pageToken"] = [pageToken];
+ }
+ if (pageSize != null) {
+ _queryParams["pageSize"] = ["${pageSize}"];
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new ListExclusionsResponse.fromJson(data));
+ }
+
+ /// Changes one or more properties of an existing exclusion.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of the exclusion to update:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^billingAccounts/[^/]+/exclusions/[^/]+$".
+ ///
+ /// [updateMask] - Required. A nonempty list of fields to change in the
+ /// existing exclusion. New values for the fields are taken from the
+ /// corresponding fields in the LogExclusion included in this request. Fields
+ /// not mentioned in update_mask are not changed and are ignored in the
+ /// request.For example, to change the filter and description of an
+ /// exclusion, specify an update_mask of "filter,description".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> patch(LogExclusion request, core.String name,
+ {core.String updateMask}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+}
class BillingAccountsLogsResourceApi {
final commons.ApiRequester _requester;
- BillingAccountsLogsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Deletes all the log entries in a log. The log reappears if it receives new
- * entries. Log entries written shortly before the delete operation might not
- * be deleted.
- *
- * Request parameters:
- *
- * [logName] - Required. The resource name of the log to delete:
- * "projects/[PROJECT_ID]/logs/[LOG_ID]"
- * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
- * "folders/[FOLDER_ID]/logs/[LOG_ID]"
- * [LOG_ID] must be URL-encoded. For example,
- * "projects/my-project-id/logs/syslog",
- * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
- * For more information about log names, see LogEntry.
- * Value must have pattern "^billingAccounts/[^/]+/logs/[^/]+$".
- *
- * 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.
- */
+ BillingAccountsLogsResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Deletes all the log entries in a log. The log reappears if it receives
+ /// new entries. Log entries written shortly before the delete operation
+ /// might not be deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [logName] - Required. The resource name of the log to delete:
+ /// "projects/[PROJECT_ID]/logs/[LOG_ID]"
+ /// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+ /// "folders/[FOLDER_ID]/logs/[LOG_ID]"
+ /// [LOG_ID] must be URL-encoded. For example,
+ /// "projects/my-project-id/logs/syslog",
+ /// "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
+ /// For more information about log names, see LogEntry.
+ /// Value must have pattern "^billingAccounts/[^/]+/logs/[^/]+$".
+ ///
+ /// 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 logName) {
var _url = null;
var _queryParams = new core.Map();
@@ -103,48 +374,46 @@ class BillingAccountsLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$logName');
- 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));
}
- /**
- * Lists the logs in projects, organizations, folders, or billing accounts.
- * Only logs that have entries are listed.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource name that owns the logs:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^billingAccounts/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListLogsResponse].
- *
- * 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<ListLogsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists the logs in projects, organizations, folders, or billing accounts.
+ /// Only logs that have entries are listed.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource name that owns the logs:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^billingAccounts/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListLogsResponse].
+ ///
+ /// 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<ListLogsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -164,64 +433,59 @@ class BillingAccountsLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
- 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 ListLogsResponse.fromJson(data));
}
-
}
-
class BillingAccountsSinksResourceApi {
final commons.ApiRequester _requester;
- BillingAccountsSinksResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Creates a sink that exports specified log entries to a destination. The
- * export of newly-ingested log entries begins immediately, unless the current
- * time is outside the sink's start and end times or the sink's
- * writer_identity is not permitted to write to the destination. A sink can
- * export log entries only from the resource owning the sink.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource in which to create the sink:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- * Examples: "projects/my-logging-project", "organizations/123456789".
- * Value must have pattern "^billingAccounts/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
- * returned as writer_identity in the new sink. If this value is omitted or
- * set to false, and if the sink's parent is a project, then the value
- * returned as writer_identity is the same group or service account used by
- * Stackdriver Logging before the addition of writer identities to this API.
- * The sink's destination must be in the same project as the sink itself.If
- * this field is set to true, or if the sink is owned by a non-project
- * resource such as an organization, then the value of writer_identity will be
- * a unique service account used only for exports from the new sink. For more
- * information, see writer_identity in LogSink.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> create(LogSink request, core.String parent, {core.bool uniqueWriterIdentity}) {
+ BillingAccountsSinksResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Creates a sink that exports specified log entries to a destination. The
+ /// export of newly-ingested log entries begins immediately, unless the
+ /// sink's writer_identity is not permitted to write to the destination. A
+ /// sink can export log entries only from the resource owning the sink.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource in which to create the sink:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^billingAccounts/[^/]+$".
+ ///
+ /// [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
+ /// returned as writer_identity in the new sink. If this value is omitted or
+ /// set to false, and if the sink's parent is a project, then the value
+ /// returned as writer_identity is the same group or service account used by
+ /// Stackdriver Logging before the addition of writer identities to this API.
+ /// The sink's destination must be in the same project as the sink itself.If
+ /// this field is set to true, or if the sink is owned by a non-project
+ /// resource such as an organization, then the value of writer_identity will
+ /// be a unique service account used only for exports from the new sink. For
+ /// more information, see writer_identity in LogSink.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> create(LogSink request, core.String parent,
+ {core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -241,39 +505,36 @@ class BillingAccountsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 LogSink.fromJson(data));
}
- /**
- * Deletes a sink. If the sink has a unique writer_identity, then that service
- * account is also deleted.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to delete,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
- *
- * 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.
- */
+ /// Deletes a sink. If the sink has a unique writer_identity, then that
+ /// service account is also deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to delete,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
+ ///
+ /// 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 sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -288,37 +549,34 @@ class BillingAccountsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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));
}
- /**
- * Gets a sink.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The resource name of the sink:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
- *
- * Completes with a [LogSink].
- *
- * 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.
- */
+ /// Gets a sink.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The resource name of the sink:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> get(core.String sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -333,47 +591,45 @@ class BillingAccountsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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 LogSink.fromJson(data));
}
- /**
- * Lists sinks.
- *
- * Request parameters:
- *
- * [parent] - Required. The parent resource whose sinks are to be listed:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^billingAccounts/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListSinksResponse].
- *
- * 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<ListSinksResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists sinks.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose sinks are to be listed:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^billingAccounts/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListSinksResponse].
+ ///
+ /// 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<ListSinksResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -393,55 +649,64 @@ class BillingAccountsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 ListSinksResponse.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> patch(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> patch(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -455,61 +720,73 @@ class BillingAccountsSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- var _response = _requester.request(_url,
- "PATCH",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new LogSink.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> update(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -523,47 +800,44 @@ class BillingAccountsSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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 LogSink.fromJson(data));
}
-
}
-
class EntriesResourceApi {
final commons.ApiRequester _requester;
- EntriesResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Lists log entries. Use this method to retrieve log entries from Stackdriver
- * Logging. For ways to export log entries, see Exporting Logs.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * Completes with a [ListLogEntriesResponse].
- *
- * 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.
- */
+ EntriesResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Lists log entries. Use this method to retrieve log entries from
+ /// Stackdriver Logging. For ways to export log entries, see Exporting Logs.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// Completes with a [ListLogEntriesResponse].
+ ///
+ /// 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<ListLogEntriesResponse> list(ListLogEntriesRequest request) {
var _url = null;
var _queryParams = new core.Map();
@@ -578,31 +852,32 @@ class EntriesResourceApi {
_url = 'v2/entries:list';
- 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 ListLogEntriesResponse.fromJson(data));
}
- /**
- * Writes log entries to Stackdriver Logging.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * Completes with a [WriteLogEntriesResponse].
- *
- * 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.
- */
+ /// Log entry resourcesWrites log entries to Stackdriver Logging. This API
+ /// method is the only way to send log entries to Stackdriver Logging. This
+ /// method is used, directly or indirectly, by the Stackdriver Logging agent
+ /// (fluentd) and all logging libraries configured to use Stackdriver
+ /// Logging.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// Completes with a [WriteLogEntriesResponse].
+ ///
+ /// 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<WriteLogEntriesResponse> write(WriteLogEntriesRequest request) {
var _url = null;
var _queryParams = new core.Map();
@@ -617,62 +892,318 @@ class EntriesResourceApi {
_url = 'v2/entries:write';
- 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 WriteLogEntriesResponse.fromJson(data));
}
-
}
-
class FoldersResourceApi {
final commons.ApiRequester _requester;
+ FoldersExclusionsResourceApi get exclusions =>
+ new FoldersExclusionsResourceApi(_requester);
FoldersLogsResourceApi get logs => new FoldersLogsResourceApi(_requester);
FoldersSinksResourceApi get sinks => new FoldersSinksResourceApi(_requester);
- FoldersResourceApi(commons.ApiRequester client) :
- _requester = client;
+ FoldersResourceApi(commons.ApiRequester client) : _requester = client;
}
+class FoldersExclusionsResourceApi {
+ final commons.ApiRequester _requester;
+
+ FoldersExclusionsResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Creates a new exclusion in a specified parent resource. Only log entries
+ /// belonging to that resource can be excluded. You can have up to 10
+ /// exclusions in a resource.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource in which to create the
+ /// exclusion:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^folders/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> create(LogExclusion request, core.String parent) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Deletes an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion to delete:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^folders/[^/]+/exclusions/[^/]+$".
+ ///
+ /// 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 name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "DELETE",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new Empty.fromJson(data));
+ }
+
+ /// Gets the description of an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^folders/[^/]+/exclusions/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> get(core.String name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Lists all the exclusions in a parent resource.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose exclusions are to be
+ /// listed.
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^folders/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListExclusionsResponse].
+ ///
+ /// 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<ListExclusionsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+ if (pageToken != null) {
+ _queryParams["pageToken"] = [pageToken];
+ }
+ if (pageSize != null) {
+ _queryParams["pageSize"] = ["${pageSize}"];
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new ListExclusionsResponse.fromJson(data));
+ }
+
+ /// Changes one or more properties of an existing exclusion.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of the exclusion to update:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^folders/[^/]+/exclusions/[^/]+$".
+ ///
+ /// [updateMask] - Required. A nonempty list of fields to change in the
+ /// existing exclusion. New values for the fields are taken from the
+ /// corresponding fields in the LogExclusion included in this request. Fields
+ /// not mentioned in update_mask are not changed and are ignored in the
+ /// request.For example, to change the filter and description of an
+ /// exclusion, specify an update_mask of "filter,description".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> patch(LogExclusion request, core.String name,
+ {core.String updateMask}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+}
class FoldersLogsResourceApi {
final commons.ApiRequester _requester;
- FoldersLogsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Deletes all the log entries in a log. The log reappears if it receives new
- * entries. Log entries written shortly before the delete operation might not
- * be deleted.
- *
- * Request parameters:
- *
- * [logName] - Required. The resource name of the log to delete:
- * "projects/[PROJECT_ID]/logs/[LOG_ID]"
- * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
- * "folders/[FOLDER_ID]/logs/[LOG_ID]"
- * [LOG_ID] must be URL-encoded. For example,
- * "projects/my-project-id/logs/syslog",
- * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
- * For more information about log names, see LogEntry.
- * Value must have pattern "^folders/[^/]+/logs/[^/]+$".
- *
- * 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.
- */
+ FoldersLogsResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Deletes all the log entries in a log. The log reappears if it receives
+ /// new entries. Log entries written shortly before the delete operation
+ /// might not be deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [logName] - Required. The resource name of the log to delete:
+ /// "projects/[PROJECT_ID]/logs/[LOG_ID]"
+ /// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+ /// "folders/[FOLDER_ID]/logs/[LOG_ID]"
+ /// [LOG_ID] must be URL-encoded. For example,
+ /// "projects/my-project-id/logs/syslog",
+ /// "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
+ /// For more information about log names, see LogEntry.
+ /// Value must have pattern "^folders/[^/]+/logs/[^/]+$".
+ ///
+ /// 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 logName) {
var _url = null;
var _queryParams = new core.Map();
@@ -687,48 +1218,46 @@ class FoldersLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$logName');
- 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));
}
- /**
- * Lists the logs in projects, organizations, folders, or billing accounts.
- * Only logs that have entries are listed.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource name that owns the logs:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^folders/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListLogsResponse].
- *
- * 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<ListLogsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists the logs in projects, organizations, folders, or billing accounts.
+ /// Only logs that have entries are listed.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource name that owns the logs:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^folders/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListLogsResponse].
+ ///
+ /// 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<ListLogsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -748,64 +1277,58 @@ class FoldersLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
- 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 ListLogsResponse.fromJson(data));
}
-
}
-
class FoldersSinksResourceApi {
final commons.ApiRequester _requester;
- FoldersSinksResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Creates a sink that exports specified log entries to a destination. The
- * export of newly-ingested log entries begins immediately, unless the current
- * time is outside the sink's start and end times or the sink's
- * writer_identity is not permitted to write to the destination. A sink can
- * export log entries only from the resource owning the sink.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource in which to create the sink:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- * Examples: "projects/my-logging-project", "organizations/123456789".
- * Value must have pattern "^folders/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
- * returned as writer_identity in the new sink. If this value is omitted or
- * set to false, and if the sink's parent is a project, then the value
- * returned as writer_identity is the same group or service account used by
- * Stackdriver Logging before the addition of writer identities to this API.
- * The sink's destination must be in the same project as the sink itself.If
- * this field is set to true, or if the sink is owned by a non-project
- * resource such as an organization, then the value of writer_identity will be
- * a unique service account used only for exports from the new sink. For more
- * information, see writer_identity in LogSink.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> create(LogSink request, core.String parent, {core.bool uniqueWriterIdentity}) {
+ FoldersSinksResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Creates a sink that exports specified log entries to a destination. The
+ /// export of newly-ingested log entries begins immediately, unless the
+ /// sink's writer_identity is not permitted to write to the destination. A
+ /// sink can export log entries only from the resource owning the sink.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource in which to create the sink:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^folders/[^/]+$".
+ ///
+ /// [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
+ /// returned as writer_identity in the new sink. If this value is omitted or
+ /// set to false, and if the sink's parent is a project, then the value
+ /// returned as writer_identity is the same group or service account used by
+ /// Stackdriver Logging before the addition of writer identities to this API.
+ /// The sink's destination must be in the same project as the sink itself.If
+ /// this field is set to true, or if the sink is owned by a non-project
+ /// resource such as an organization, then the value of writer_identity will
+ /// be a unique service account used only for exports from the new sink. For
+ /// more information, see writer_identity in LogSink.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> create(LogSink request, core.String parent,
+ {core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -825,39 +1348,36 @@ class FoldersSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 LogSink.fromJson(data));
}
- /**
- * Deletes a sink. If the sink has a unique writer_identity, then that service
- * account is also deleted.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to delete,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
- *
- * 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.
- */
+ /// Deletes a sink. If the sink has a unique writer_identity, then that
+ /// service account is also deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to delete,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
+ ///
+ /// 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 sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -872,37 +1392,34 @@ class FoldersSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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));
}
- /**
- * Gets a sink.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The resource name of the sink:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
- *
- * Completes with a [LogSink].
- *
- * 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.
- */
+ /// Gets a sink.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The resource name of the sink:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> get(core.String sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -917,47 +1434,45 @@ class FoldersSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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 LogSink.fromJson(data));
}
- /**
- * Lists sinks.
- *
- * Request parameters:
- *
- * [parent] - Required. The parent resource whose sinks are to be listed:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^folders/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListSinksResponse].
- *
- * 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<ListSinksResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists sinks.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose sinks are to be listed:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^folders/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListSinksResponse].
+ ///
+ /// 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<ListSinksResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -977,55 +1492,64 @@ class FoldersSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 ListSinksResponse.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> patch(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> patch(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1039,61 +1563,73 @@ class FoldersSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- var _response = _requester.request(_url,
- "PATCH",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new LogSink.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^folders/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> update(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1107,55 +1643,54 @@ class FoldersSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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 LogSink.fromJson(data));
}
-
}
-
class MonitoredResourceDescriptorsResourceApi {
final commons.ApiRequester _requester;
- MonitoredResourceDescriptorsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Lists the descriptors for monitored resource types used by Stackdriver
- * Logging.
- *
- * Request parameters:
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListMonitoredResourceDescriptorsResponse].
- *
- * 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<ListMonitoredResourceDescriptorsResponse> list({core.String pageToken, core.int pageSize}) {
+ MonitoredResourceDescriptorsResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Lists the descriptors for monitored resource types used by Stackdriver
+ /// Logging.
+ ///
+ /// Request parameters:
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListMonitoredResourceDescriptorsResponse].
+ ///
+ /// 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<ListMonitoredResourceDescriptorsResponse> list(
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1172,62 +1707,322 @@ class MonitoredResourceDescriptorsResourceApi {
_url = 'v2/monitoredResourceDescriptors';
- var _response = _requester.request(_url,
- "GET",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
- return _response.then((data) => new ListMonitoredResourceDescriptorsResponse.fromJson(data));
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then(
+ (data) => new ListMonitoredResourceDescriptorsResponse.fromJson(data));
}
-
}
-
class OrganizationsResourceApi {
final commons.ApiRequester _requester;
- OrganizationsLogsResourceApi get logs => new OrganizationsLogsResourceApi(_requester);
- OrganizationsSinksResourceApi get sinks => new OrganizationsSinksResourceApi(_requester);
+ OrganizationsExclusionsResourceApi get exclusions =>
+ new OrganizationsExclusionsResourceApi(_requester);
+ OrganizationsLogsResourceApi get logs =>
+ new OrganizationsLogsResourceApi(_requester);
+ OrganizationsSinksResourceApi get sinks =>
+ new OrganizationsSinksResourceApi(_requester);
- OrganizationsResourceApi(commons.ApiRequester client) :
- _requester = client;
+ OrganizationsResourceApi(commons.ApiRequester client) : _requester = client;
}
+class OrganizationsExclusionsResourceApi {
+ final commons.ApiRequester _requester;
+
+ OrganizationsExclusionsResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Creates a new exclusion in a specified parent resource. Only log entries
+ /// belonging to that resource can be excluded. You can have up to 10
+ /// exclusions in a resource.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource in which to create the
+ /// exclusion:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^organizations/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> create(LogExclusion request, core.String parent) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Deletes an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion to delete:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^organizations/[^/]+/exclusions/[^/]+$".
+ ///
+ /// 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 name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "DELETE",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new Empty.fromJson(data));
+ }
+
+ /// Gets the description of an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^organizations/[^/]+/exclusions/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> get(core.String name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Lists all the exclusions in a parent resource.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose exclusions are to be
+ /// listed.
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^organizations/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListExclusionsResponse].
+ ///
+ /// 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<ListExclusionsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+ if (pageToken != null) {
+ _queryParams["pageToken"] = [pageToken];
+ }
+ if (pageSize != null) {
+ _queryParams["pageSize"] = ["${pageSize}"];
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new ListExclusionsResponse.fromJson(data));
+ }
+
+ /// Changes one or more properties of an existing exclusion.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of the exclusion to update:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^organizations/[^/]+/exclusions/[^/]+$".
+ ///
+ /// [updateMask] - Required. A nonempty list of fields to change in the
+ /// existing exclusion. New values for the fields are taken from the
+ /// corresponding fields in the LogExclusion included in this request. Fields
+ /// not mentioned in update_mask are not changed and are ignored in the
+ /// request.For example, to change the filter and description of an
+ /// exclusion, specify an update_mask of "filter,description".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> patch(LogExclusion request, core.String name,
+ {core.String updateMask}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+}
class OrganizationsLogsResourceApi {
final commons.ApiRequester _requester;
- OrganizationsLogsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Deletes all the log entries in a log. The log reappears if it receives new
- * entries. Log entries written shortly before the delete operation might not
- * be deleted.
- *
- * Request parameters:
- *
- * [logName] - Required. The resource name of the log to delete:
- * "projects/[PROJECT_ID]/logs/[LOG_ID]"
- * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
- * "folders/[FOLDER_ID]/logs/[LOG_ID]"
- * [LOG_ID] must be URL-encoded. For example,
- * "projects/my-project-id/logs/syslog",
- * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
- * For more information about log names, see LogEntry.
- * Value must have pattern "^organizations/[^/]+/logs/[^/]+$".
- *
- * 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.
- */
+ OrganizationsLogsResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Deletes all the log entries in a log. The log reappears if it receives
+ /// new entries. Log entries written shortly before the delete operation
+ /// might not be deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [logName] - Required. The resource name of the log to delete:
+ /// "projects/[PROJECT_ID]/logs/[LOG_ID]"
+ /// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+ /// "folders/[FOLDER_ID]/logs/[LOG_ID]"
+ /// [LOG_ID] must be URL-encoded. For example,
+ /// "projects/my-project-id/logs/syslog",
+ /// "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
+ /// For more information about log names, see LogEntry.
+ /// Value must have pattern "^organizations/[^/]+/logs/[^/]+$".
+ ///
+ /// 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 logName) {
var _url = null;
var _queryParams = new core.Map();
@@ -1242,48 +2037,46 @@ class OrganizationsLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$logName');
- 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));
}
- /**
- * Lists the logs in projects, organizations, folders, or billing accounts.
- * Only logs that have entries are listed.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource name that owns the logs:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^organizations/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListLogsResponse].
- *
- * 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<ListLogsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists the logs in projects, organizations, folders, or billing accounts.
+ /// Only logs that have entries are listed.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource name that owns the logs:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^organizations/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListLogsResponse].
+ ///
+ /// 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<ListLogsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1303,64 +2096,59 @@ class OrganizationsLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
- 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 ListLogsResponse.fromJson(data));
}
-
}
-
class OrganizationsSinksResourceApi {
final commons.ApiRequester _requester;
- OrganizationsSinksResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Creates a sink that exports specified log entries to a destination. The
- * export of newly-ingested log entries begins immediately, unless the current
- * time is outside the sink's start and end times or the sink's
- * writer_identity is not permitted to write to the destination. A sink can
- * export log entries only from the resource owning the sink.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource in which to create the sink:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- * Examples: "projects/my-logging-project", "organizations/123456789".
- * Value must have pattern "^organizations/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
- * returned as writer_identity in the new sink. If this value is omitted or
- * set to false, and if the sink's parent is a project, then the value
- * returned as writer_identity is the same group or service account used by
- * Stackdriver Logging before the addition of writer identities to this API.
- * The sink's destination must be in the same project as the sink itself.If
- * this field is set to true, or if the sink is owned by a non-project
- * resource such as an organization, then the value of writer_identity will be
- * a unique service account used only for exports from the new sink. For more
- * information, see writer_identity in LogSink.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> create(LogSink request, core.String parent, {core.bool uniqueWriterIdentity}) {
+ OrganizationsSinksResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Creates a sink that exports specified log entries to a destination. The
+ /// export of newly-ingested log entries begins immediately, unless the
+ /// sink's writer_identity is not permitted to write to the destination. A
+ /// sink can export log entries only from the resource owning the sink.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource in which to create the sink:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^organizations/[^/]+$".
+ ///
+ /// [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
+ /// returned as writer_identity in the new sink. If this value is omitted or
+ /// set to false, and if the sink's parent is a project, then the value
+ /// returned as writer_identity is the same group or service account used by
+ /// Stackdriver Logging before the addition of writer identities to this API.
+ /// The sink's destination must be in the same project as the sink itself.If
+ /// this field is set to true, or if the sink is owned by a non-project
+ /// resource such as an organization, then the value of writer_identity will
+ /// be a unique service account used only for exports from the new sink. For
+ /// more information, see writer_identity in LogSink.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> create(LogSink request, core.String parent,
+ {core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1380,39 +2168,36 @@ class OrganizationsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 LogSink.fromJson(data));
}
- /**
- * Deletes a sink. If the sink has a unique writer_identity, then that service
- * account is also deleted.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to delete,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
- *
- * 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.
- */
+ /// Deletes a sink. If the sink has a unique writer_identity, then that
+ /// service account is also deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to delete,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
+ ///
+ /// 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 sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -1427,37 +2212,34 @@ class OrganizationsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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));
}
- /**
- * Gets a sink.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The resource name of the sink:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
- *
- * Completes with a [LogSink].
- *
- * 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.
- */
+ /// Gets a sink.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The resource name of the sink:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> get(core.String sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -1472,47 +2254,45 @@ class OrganizationsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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 LogSink.fromJson(data));
}
- /**
- * Lists sinks.
- *
- * Request parameters:
- *
- * [parent] - Required. The parent resource whose sinks are to be listed:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^organizations/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListSinksResponse].
- *
- * 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<ListSinksResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists sinks.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose sinks are to be listed:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^organizations/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListSinksResponse].
+ ///
+ /// 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<ListSinksResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1532,55 +2312,64 @@ class OrganizationsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 ListSinksResponse.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> patch(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> patch(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1594,61 +2383,73 @@ class OrganizationsSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- var _response = _requester.request(_url,
- "PATCH",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new LogSink.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> update(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1662,69 +2463,330 @@ class OrganizationsSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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 LogSink.fromJson(data));
}
-
}
-
class ProjectsResourceApi {
final commons.ApiRequester _requester;
+ ProjectsExclusionsResourceApi get exclusions =>
+ new ProjectsExclusionsResourceApi(_requester);
ProjectsLogsResourceApi get logs => new ProjectsLogsResourceApi(_requester);
- ProjectsMetricsResourceApi get metrics => new ProjectsMetricsResourceApi(_requester);
- ProjectsSinksResourceApi get sinks => new ProjectsSinksResourceApi(_requester);
+ ProjectsMetricsResourceApi get metrics =>
+ new ProjectsMetricsResourceApi(_requester);
+ ProjectsSinksResourceApi get sinks =>
+ new ProjectsSinksResourceApi(_requester);
- ProjectsResourceApi(commons.ApiRequester client) :
- _requester = client;
+ ProjectsResourceApi(commons.ApiRequester client) : _requester = client;
}
+class ProjectsExclusionsResourceApi {
+ final commons.ApiRequester _requester;
+
+ ProjectsExclusionsResourceApi(commons.ApiRequester client)
+ : _requester = client;
+
+ /// Creates a new exclusion in a specified parent resource. Only log entries
+ /// belonging to that resource can be excluded. You can have up to 10
+ /// exclusions in a resource.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource in which to create the
+ /// exclusion:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^projects/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> create(LogExclusion request, core.String parent) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "POST",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Deletes an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion to delete:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^projects/[^/]+/exclusions/[^/]+$".
+ ///
+ /// 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 name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "DELETE",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new Empty.fromJson(data));
+ }
+
+ /// Gets the description of an exclusion.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of an existing exclusion:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^projects/[^/]+/exclusions/[^/]+$".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> get(core.String name) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+
+ /// Lists all the exclusions in a parent resource.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose exclusions are to be
+ /// listed.
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^projects/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListExclusionsResponse].
+ ///
+ /// 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<ListExclusionsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (parent == null) {
+ throw new core.ArgumentError("Parameter parent is required.");
+ }
+ if (pageToken != null) {
+ _queryParams["pageToken"] = [pageToken];
+ }
+ if (pageSize != null) {
+ _queryParams["pageSize"] = ["${pageSize}"];
+ }
+
+ _url = 'v2/' +
+ commons.Escaper.ecapeVariableReserved('$parent') +
+ '/exclusions';
+
+ var _response = _requester.request(_url, "GET",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new ListExclusionsResponse.fromJson(data));
+ }
+
+ /// Changes one or more properties of an existing exclusion.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [name] - Required. The resource name of the exclusion to update:
+ /// "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+ /// "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+ /// Example: "projects/my-project-id/exclusions/my-exclusion-id".
+ /// Value must have pattern "^projects/[^/]+/exclusions/[^/]+$".
+ ///
+ /// [updateMask] - Required. A nonempty list of fields to change in the
+ /// existing exclusion. New values for the fields are taken from the
+ /// corresponding fields in the LogExclusion included in this request. Fields
+ /// not mentioned in update_mask are not changed and are ignored in the
+ /// request.For example, to change the filter and description of an
+ /// exclusion, specify an update_mask of "filter,description".
+ ///
+ /// Completes with a [LogExclusion].
+ ///
+ /// 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<LogExclusion> patch(LogExclusion request, core.String name,
+ {core.String updateMask}) {
+ var _url = null;
+ var _queryParams = new core.Map();
+ var _uploadMedia = null;
+ var _uploadOptions = null;
+ var _downloadOptions = commons.DownloadOptions.Metadata;
+ var _body = null;
+
+ if (request != null) {
+ _body = convert.JSON.encode((request).toJson());
+ }
+ if (name == null) {
+ throw new core.ArgumentError("Parameter name is required.");
+ }
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
+
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$name');
+
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogExclusion.fromJson(data));
+ }
+}
class ProjectsLogsResourceApi {
final commons.ApiRequester _requester;
- ProjectsLogsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Deletes all the log entries in a log. The log reappears if it receives new
- * entries. Log entries written shortly before the delete operation might not
- * be deleted.
- *
- * Request parameters:
- *
- * [logName] - Required. The resource name of the log to delete:
- * "projects/[PROJECT_ID]/logs/[LOG_ID]"
- * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
- * "folders/[FOLDER_ID]/logs/[LOG_ID]"
- * [LOG_ID] must be URL-encoded. For example,
- * "projects/my-project-id/logs/syslog",
- * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
- * For more information about log names, see LogEntry.
- * Value must have pattern "^projects/[^/]+/logs/[^/]+$".
- *
- * 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.
- */
+ ProjectsLogsResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Deletes all the log entries in a log. The log reappears if it receives
+ /// new entries. Log entries written shortly before the delete operation
+ /// might not be deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [logName] - Required. The resource name of the log to delete:
+ /// "projects/[PROJECT_ID]/logs/[LOG_ID]"
+ /// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+ /// "folders/[FOLDER_ID]/logs/[LOG_ID]"
+ /// [LOG_ID] must be URL-encoded. For example,
+ /// "projects/my-project-id/logs/syslog",
+ /// "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
+ /// For more information about log names, see LogEntry.
+ /// Value must have pattern "^projects/[^/]+/logs/[^/]+$".
+ ///
+ /// 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 logName) {
var _url = null;
var _queryParams = new core.Map();
@@ -1739,48 +2801,46 @@ class ProjectsLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$logName');
- 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));
}
- /**
- * Lists the logs in projects, organizations, folders, or billing accounts.
- * Only logs that have entries are listed.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource name that owns the logs:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^projects/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListLogsResponse].
- *
- * 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<ListLogsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists the logs in projects, organizations, folders, or billing accounts.
+ /// Only logs that have entries are listed.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource name that owns the logs:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^projects/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListLogsResponse].
+ ///
+ /// 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<ListLogsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1800,45 +2860,40 @@ class ProjectsLogsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
- 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 ListLogsResponse.fromJson(data));
}
-
}
-
class ProjectsMetricsResourceApi {
final commons.ApiRequester _requester;
- ProjectsMetricsResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Creates a logs-based metric.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [parent] - The resource name of the project in which to create the metric:
- * "projects/[PROJECT_ID]"
- * The new metric must be provided in the request.
- * Value must have pattern "^projects/[^/]+$".
- *
- * Completes with a [LogMetric].
- *
- * 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.
- */
+ ProjectsMetricsResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Creates a logs-based metric.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - The resource name of the project in which to create the
+ /// metric:
+ /// "projects/[PROJECT_ID]"
+ /// The new metric must be provided in the request.
+ /// Value must have pattern "^projects/[^/]+$".
+ ///
+ /// Completes with a [LogMetric].
+ ///
+ /// 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<LogMetric> create(LogMetric request, core.String parent) {
var _url = null;
var _queryParams = new core.Map();
@@ -1854,36 +2909,34 @@ class ProjectsMetricsResourceApi {
throw new core.ArgumentError("Parameter parent is required.");
}
- _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/metrics';
+ _url =
+ 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/metrics';
- 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 LogMetric.fromJson(data));
}
- /**
- * Deletes a logs-based metric.
- *
- * Request parameters:
- *
- * [metricName] - The resource name of the metric to delete:
- * "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
- *
- * Value must have pattern "^projects/[^/]+/metrics/[^/]+$".
- *
- * 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.
- */
+ /// Deletes a logs-based metric.
+ ///
+ /// Request parameters:
+ ///
+ /// [metricName] - The resource name of the metric to delete:
+ /// "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+ ///
+ /// Value must have pattern "^projects/[^/]+/metrics/[^/]+$".
+ ///
+ /// 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 metricName) {
var _url = null;
var _queryParams = new core.Map();
@@ -1898,34 +2951,31 @@ class ProjectsMetricsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$metricName');
- 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));
}
- /**
- * Gets a logs-based metric.
- *
- * Request parameters:
- *
- * [metricName] - The resource name of the desired metric:
- * "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
- *
- * Value must have pattern "^projects/[^/]+/metrics/[^/]+$".
- *
- * Completes with a [LogMetric].
- *
- * 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.
- */
+ /// Gets a logs-based metric.
+ ///
+ /// Request parameters:
+ ///
+ /// [metricName] - The resource name of the desired metric:
+ /// "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+ ///
+ /// Value must have pattern "^projects/[^/]+/metrics/[^/]+$".
+ ///
+ /// Completes with a [LogMetric].
+ ///
+ /// 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<LogMetric> get(core.String metricName) {
var _url = null;
var _queryParams = new core.Map();
@@ -1940,44 +2990,42 @@ class ProjectsMetricsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$metricName');
- 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 LogMetric.fromJson(data));
}
- /**
- * Lists logs-based metrics.
- *
- * Request parameters:
- *
- * [parent] - Required. The name of the project containing the metrics:
- * "projects/[PROJECT_ID]"
- *
- * Value must have pattern "^projects/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListLogMetricsResponse].
- *
- * 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<ListLogMetricsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists logs-based metrics.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The name of the project containing the metrics:
+ /// "projects/[PROJECT_ID]"
+ ///
+ /// Value must have pattern "^projects/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListLogMetricsResponse].
+ ///
+ /// 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<ListLogMetricsResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -1995,40 +3043,38 @@ class ProjectsMetricsResourceApi {
_queryParams["pageSize"] = ["${pageSize}"];
}
- _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/metrics';
+ _url =
+ 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/metrics';
- 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 ListLogMetricsResponse.fromJson(data));
}
- /**
- * Creates or updates a logs-based metric.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [metricName] - The resource name of the metric to update:
- * "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
- * The updated metric must be provided in the request and it's name field must
- * be the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID],
- * then a new metric is created.
- * Value must have pattern "^projects/[^/]+/metrics/[^/]+$".
- *
- * Completes with a [LogMetric].
- *
- * 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.
- */
+ /// Creates or updates a logs-based metric.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [metricName] - The resource name of the metric to update:
+ /// "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+ /// The updated metric must be provided in the request and it's name field
+ /// must be the same as [METRIC_ID] If the metric does not exist in
+ /// [PROJECT_ID], then a new metric is created.
+ /// Value must have pattern "^projects/[^/]+/metrics/[^/]+$".
+ ///
+ /// Completes with a [LogMetric].
+ ///
+ /// 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<LogMetric> update(LogMetric request, core.String metricName) {
var _url = null;
var _queryParams = new core.Map();
@@ -2046,64 +3092,58 @@ class ProjectsMetricsResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$metricName');
- 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 LogMetric.fromJson(data));
}
-
}
-
class ProjectsSinksResourceApi {
final commons.ApiRequester _requester;
- ProjectsSinksResourceApi(commons.ApiRequester client) :
- _requester = client;
-
- /**
- * Creates a sink that exports specified log entries to a destination. The
- * export of newly-ingested log entries begins immediately, unless the current
- * time is outside the sink's start and end times or the sink's
- * writer_identity is not permitted to write to the destination. A sink can
- * export log entries only from the resource owning the sink.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [parent] - Required. The resource in which to create the sink:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- * Examples: "projects/my-logging-project", "organizations/123456789".
- * Value must have pattern "^projects/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
- * returned as writer_identity in the new sink. If this value is omitted or
- * set to false, and if the sink's parent is a project, then the value
- * returned as writer_identity is the same group or service account used by
- * Stackdriver Logging before the addition of writer identities to this API.
- * The sink's destination must be in the same project as the sink itself.If
- * this field is set to true, or if the sink is owned by a non-project
- * resource such as an organization, then the value of writer_identity will be
- * a unique service account used only for exports from the new sink. For more
- * information, see writer_identity in LogSink.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> create(LogSink request, core.String parent, {core.bool uniqueWriterIdentity}) {
+ ProjectsSinksResourceApi(commons.ApiRequester client) : _requester = client;
+
+ /// Creates a sink that exports specified log entries to a destination. The
+ /// export of newly-ingested log entries begins immediately, unless the
+ /// sink's writer_identity is not permitted to write to the destination. A
+ /// sink can export log entries only from the resource owning the sink.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The resource in which to create the sink:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Examples: "projects/my-logging-project", "organizations/123456789".
+ /// Value must have pattern "^projects/[^/]+$".
+ ///
+ /// [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
+ /// returned as writer_identity in the new sink. If this value is omitted or
+ /// set to false, and if the sink's parent is a project, then the value
+ /// returned as writer_identity is the same group or service account used by
+ /// Stackdriver Logging before the addition of writer identities to this API.
+ /// The sink's destination must be in the same project as the sink itself.If
+ /// this field is set to true, or if the sink is owned by a non-project
+ /// resource such as an organization, then the value of writer_identity will
+ /// be a unique service account used only for exports from the new sink. For
+ /// more information, see writer_identity in LogSink.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> create(LogSink request, core.String parent,
+ {core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -2123,39 +3163,36 @@ class ProjectsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 LogSink.fromJson(data));
}
- /**
- * Deletes a sink. If the sink has a unique writer_identity, then that service
- * account is also deleted.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to delete,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
- *
- * 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.
- */
+ /// Deletes a sink. If the sink has a unique writer_identity, then that
+ /// service account is also deleted.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to delete,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
+ ///
+ /// 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 sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -2170,37 +3207,34 @@ class ProjectsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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));
}
- /**
- * Gets a sink.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The resource name of the sink:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
- *
- * Completes with a [LogSink].
- *
- * 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.
- */
+ /// Gets a sink.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The resource name of the sink:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> get(core.String sinkName) {
var _url = null;
var _queryParams = new core.Map();
@@ -2215,47 +3249,45 @@ class ProjectsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- 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 LogSink.fromJson(data));
}
- /**
- * Lists sinks.
- *
- * Request parameters:
- *
- * [parent] - Required. The parent resource whose sinks are to be listed:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- *
- * Value must have pattern "^projects/[^/]+$".
- *
- * [pageToken] - Optional. If present, then retrieve the next batch of results
- * from the preceding call to this method. pageToken must be the value of
- * nextPageToken from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- *
- * [pageSize] - Optional. The maximum number of results to return from this
- * request. Non-positive values are ignored. The presence of nextPageToken in
- * the response indicates that more results might be available.
- *
- * Completes with a [ListSinksResponse].
- *
- * 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<ListSinksResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+ /// Lists sinks.
+ ///
+ /// Request parameters:
+ ///
+ /// [parent] - Required. The parent resource whose sinks are to be listed:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ ///
+ /// Value must have pattern "^projects/[^/]+$".
+ ///
+ /// [pageToken] - Optional. If present, then retrieve the next batch of
+ /// results from the preceding call to this method. pageToken must be the
+ /// value of nextPageToken from the previous response. The values of other
+ /// method parameters should be identical to those in the previous call.
+ ///
+ /// [pageSize] - Optional. The maximum number of results to return from this
+ /// request. Non-positive values are ignored. The presence of nextPageToken
+ /// in the response indicates that more results might be available.
+ ///
+ /// Completes with a [ListSinksResponse].
+ ///
+ /// 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<ListSinksResponse> list(core.String parent,
+ {core.String pageToken, core.int pageSize}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -2275,55 +3307,64 @@ class ProjectsSinksResourceApi {
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
- 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 ListSinksResponse.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> patch(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> patch(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -2337,61 +3378,73 @@ class ProjectsSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
_url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
- var _response = _requester.request(_url,
- "PATCH",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
+ var _response = _requester.request(_url, "PATCH",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
return _response.then((data) => new LogSink.fromJson(data));
}
- /**
- * Updates a sink. This method replaces the following fields in the existing
- * sink with values from the new sink: destination, filter,
- * output_version_format, start_time, and end_time. The updated sink might
- * also have a new writer_identity; see the unique_writer_identity field.
- *
- * [request] - The metadata request object.
- *
- * Request parameters:
- *
- * [sinkName] - Required. The full resource name of the sink to update,
- * including the parent resource and the sink identifier:
- * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
- * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
- * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
- * Example: "projects/my-project-id/sinks/my-sink-id".
- * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
- *
- * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
- * this field. When updating a sink, the effect of this field on the value of
- * writer_identity in the updated sink depends on both the old and new values
- * of this field:
- * If the old and new values of this field are both false or both true, then
- * there is no change to the sink's writer_identity.
- * If the old value is false and the new value is true, then writer_identity
- * is changed to a unique service account.
- * It is an error if the old value is true and the new value is set to false
- * or defaulted to false.
- *
- * Completes with a [LogSink].
- *
- * 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<LogSink> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+ /// Updates a sink. This method replaces the following fields in the existing
+ /// sink with values from the new sink: destination, and filter. The updated
+ /// sink might also have a new writer_identity; see the
+ /// unique_writer_identity field.
+ ///
+ /// [request] - The metadata request object.
+ ///
+ /// Request parameters:
+ ///
+ /// [sinkName] - Required. The full resource name of the sink to update,
+ /// including the parent resource and the sink identifier:
+ /// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+ /// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+ /// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+ /// Example: "projects/my-project-id/sinks/my-sink-id".
+ /// Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
+ ///
+ /// [updateMask] - Optional. Field mask that specifies the fields in sink
+ /// that need an update. A sink field will be overwritten if, and only if, it
+ /// is in the update mask. name and output only fields cannot be updated.An
+ /// empty updateMask is temporarily treated as using the following mask for
+ /// backwards compatibility purposes: destination,filter,includeChildren At
+ /// some point in the future, behavior will be removed and specifying an
+ /// empty updateMask will be an error.For a detailed FieldMask definition,
+ /// see
+ /// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmaskExample:
+ /// updateMask=filter.
+ ///
+ /// [uniqueWriterIdentity] - Optional. See sinks.create for a description of
+ /// this field. When updating a sink, the effect of this field on the value
+ /// of writer_identity in the updated sink depends on both the old and new
+ /// values of this field:
+ /// If the old and new values of this field are both false or both true, then
+ /// there is no change to the sink's writer_identity.
+ /// If the old value is false and the new value is true, then writer_identity
+ /// is changed to a unique service account.
+ /// It is an error if the old value is true and the new value is set to false
+ /// or defaulted to false.
+ ///
+ /// Completes with a [LogSink].
+ ///
+ /// 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<LogSink> update(LogSink request, core.String sinkName,
+ {core.String updateMask, core.bool uniqueWriterIdentity}) {
var _url = null;
var _queryParams = new core.Map();
var _uploadMedia = null;
@@ -2405,122 +3458,234 @@ class ProjectsSinksResourceApi {
if (sinkName == null) {
throw new core.ArgumentError("Parameter sinkName is required.");
}
+ if (updateMask != null) {
+ _queryParams["updateMask"] = [updateMask];
+ }
if (uniqueWriterIdentity != null) {
_queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
}
- _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
+ _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
+
+ var _response = _requester.request(_url, "PUT",
+ body: _body,
+ queryParams: _queryParams,
+ uploadOptions: _uploadOptions,
+ uploadMedia: _uploadMedia,
+ downloadOptions: _downloadOptions);
+ return _response.then((data) => new LogSink.fromJson(data));
+ }
+}
+
+/// BucketOptions describes the bucket boundaries used to create a histogram
+/// for the distribution. The buckets can be in a linear sequence, an
+/// exponential sequence, or each bucket can be specified explicitly.
+/// BucketOptions does not include the number of values in each bucket.A bucket
+/// has an inclusive lower bound and exclusive upper bound for the values that
+/// are counted for that bucket. The upper bound of a bucket must be strictly
+/// greater than the lower bound. The sequence of N buckets for a distribution
+/// consists of an underflow bucket (number 0), zero or more finite buckets
+/// (number 1 through N - 2) and an overflow bucket (number N - 1). The buckets
+/// are contiguous: the lower bound of bucket i (i > 0) is the same as the
+/// upper bound of bucket i - 1. The buckets span the whole range of finite
+/// values: lower bound of the underflow bucket is -infinity and the upper
+/// bound of the overflow bucket is +infinity. The finite buckets are so-called
+/// because both bounds are finite.
+class BucketOptions {
+ /// The explicit buckets.
+ Explicit explicitBuckets;
+
+ /// The exponential buckets.
+ Exponential exponentialBuckets;
+
+ /// The linear bucket.
+ Linear linearBuckets;
+
+ BucketOptions();
+
+ BucketOptions.fromJson(core.Map _json) {
+ if (_json.containsKey("explicitBuckets")) {
+ explicitBuckets = new Explicit.fromJson(_json["explicitBuckets"]);
+ }
+ if (_json.containsKey("exponentialBuckets")) {
+ exponentialBuckets =
+ new Exponential.fromJson(_json["exponentialBuckets"]);
+ }
+ if (_json.containsKey("linearBuckets")) {
+ linearBuckets = new Linear.fromJson(_json["linearBuckets"]);
+ }
+ }
+
+ core.Map<core.String, core.Object> toJson() {
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
+ if (explicitBuckets != null) {
+ _json["explicitBuckets"] = (explicitBuckets).toJson();
+ }
+ if (exponentialBuckets != null) {
+ _json["exponentialBuckets"] = (exponentialBuckets).toJson();
+ }
+ if (linearBuckets != null) {
+ _json["linearBuckets"] = (linearBuckets).toJson();
+ }
+ return _json;
+ }
+}
+
+/// 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) {}
+
+ core.Map<core.String, core.Object> toJson() {
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
+ return _json;
+ }
+}
+
+/// Specifies a set of buckets with arbitrary widths.There are size(bounds) + 1
+/// (= N) buckets. Bucket i has the following boundaries:Upper bound (0 <= i <
+/// N-1): boundsi Lower bound (1 <= i < N); boundsi - 1The bounds field must
+/// contain at least one element. If bounds has only one element, then there
+/// are no finite buckets, and that single element is the common boundary of
+/// the overflow and underflow buckets.
+class Explicit {
+ /// The values must be monotonically increasing.
+ core.List<core.double> bounds;
+
+ Explicit();
- var _response = _requester.request(_url,
- "PUT",
- body: _body,
- queryParams: _queryParams,
- uploadOptions: _uploadOptions,
- uploadMedia: _uploadMedia,
- downloadOptions: _downloadOptions);
- return _response.then((data) => new LogSink.fromJson(data));
+ Explicit.fromJson(core.Map _json) {
+ if (_json.containsKey("bounds")) {
+ bounds = _json["bounds"];
+ }
}
+ core.Map<core.String, core.Object> toJson() {
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
+ if (bounds != null) {
+ _json["bounds"] = bounds;
+ }
+ return _json;
+ }
}
+/// Specifies an exponential sequence of buckets that have a width that is
+/// proportional to the value of the lower bound. Each bucket represents a
+/// constant relative uncertainty on a specific value in the bucket.There are
+/// num_finite_buckets + 2 (= N) buckets. Bucket i has the following
+/// boundaries:Upper bound (0 <= i < N-1): scale * (growth_factor ^ i). Lower
+/// bound (1 <= i < N): scale * (growth_factor ^ (i - 1)).
+class Exponential {
+ /// Must be greater than 1.
+ core.double growthFactor;
+ /// Must be greater than 0.
+ core.int numFiniteBuckets;
-/**
- * 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 {
+ /// Must be greater than 0.
+ core.double scale;
- Empty();
+ Exponential();
- Empty.fromJson(core.Map _json) {
+ Exponential.fromJson(core.Map _json) {
+ if (_json.containsKey("growthFactor")) {
+ growthFactor = _json["growthFactor"];
+ }
+ if (_json.containsKey("numFiniteBuckets")) {
+ numFiniteBuckets = _json["numFiniteBuckets"];
+ }
+ if (_json.containsKey("scale")) {
+ scale = _json["scale"];
+ }
}
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 (growthFactor != null) {
+ _json["growthFactor"] = growthFactor;
+ }
+ if (numFiniteBuckets != null) {
+ _json["numFiniteBuckets"] = numFiniteBuckets;
+ }
+ if (scale != null) {
+ _json["scale"] = scale;
+ }
return _json;
}
}
-/**
- * A common proto for logging HTTP requests. Only contains semantics defined by
- * the HTTP specification. Product-specific logging information MUST be defined
- * in a separate message.
- */
+/// A common proto for logging HTTP requests. Only contains semantics defined
+/// by the HTTP specification. Product-specific logging information MUST be
+/// defined in a separate message.
class HttpRequest {
- /**
- * The number of HTTP response bytes inserted into cache. Set only when a
- * cache fill was attempted.
- */
+ /// The number of HTTP response bytes inserted into cache. Set only when a
+ /// cache fill was attempted.
core.String cacheFillBytes;
- /**
- * Whether or not an entity was served from cache (with or without
- * validation).
- */
+
+ /// Whether or not an entity was served from cache (with or without
+ /// validation).
core.bool cacheHit;
- /** Whether or not a cache lookup was attempted. */
+
+ /// Whether or not a cache lookup was attempted.
core.bool cacheLookup;
- /**
- * Whether or not the response was validated with the origin server before
- * being served from cache. This field is only meaningful if cache_hit is
- * True.
- */
+
+ /// Whether or not the response was validated with the origin server before
+ /// being served from cache. This field is only meaningful if cache_hit is
+ /// True.
core.bool cacheValidatedWithOriginServer;
- /**
- * The request processing latency on the server, from the time the request was
- * received until the response was sent.
- */
+
+ /// The request processing latency on the server, from the time the request
+ /// was received until the response was sent.
core.String latency;
- /**
- * Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
- */
+
+ /// Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2",
+ /// "websocket"
core.String protocol;
- /**
- * The referer URL of the request, as defined in HTTP/1.1 Header Field
- * Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
- */
+
+ /// The referer URL of the request, as defined in HTTP/1.1 Header Field
+ /// Definitions (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
core.String referer;
- /**
- * The IP address (IPv4 or IPv6) of the client that issued the HTTP request.
- * Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
- */
+
+ /// The IP address (IPv4 or IPv6) of the client that issued the HTTP request.
+ /// Examples: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
core.String remoteIp;
- /** The request method. Examples: "GET", "HEAD", "PUT", "POST". */
+
+ /// The request method. Examples: "GET", "HEAD", "PUT", "POST".
core.String requestMethod;
- /**
- * The size of the HTTP request message in bytes, including the request
- * headers and the request body.
- */
+
+ /// The size of the HTTP request message in bytes, including the request
+ /// headers and the request body.
core.String requestSize;
- /**
- * The scheme (http, https), the host name, the path and the query portion of
- * the URL that was requested. Example:
- * "http://example.com/some/info?color=red".
- */
+
+ /// The scheme (http, https), the host name, the path and the query portion
+ /// of the URL that was requested. Example:
+ /// "http://example.com/some/info?color=red".
core.String requestUrl;
- /**
- * The size of the HTTP response message sent back to the client, in bytes,
- * including the response headers and the response body.
- */
+
+ /// The size of the HTTP response message sent back to the client, in bytes,
+ /// including the response headers and the response body.
core.String responseSize;
- /**
- * The IP address (IPv4 or IPv6) of the origin server that the request was
- * sent to.
- */
+
+ /// The IP address (IPv4 or IPv6) of the origin server that the request was
+ /// sent to.
core.String serverIp;
- /**
- * The response code indicating the status of response. Examples: 200, 404.
- */
+
+ /// The response code indicating the status of response. Examples: 200, 404.
core.int status;
- /**
- * The user agent sent by the client. Example: "Mozilla/4.0 (compatible; MSIE
- * 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
- */
+
+ /// The user agent sent by the client. Example: "Mozilla/4.0 (compatible;
+ /// MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
core.String userAgent;
HttpRequest();
@@ -2574,7 +3739,8 @@ class HttpRequest {
}
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 (cacheFillBytes != null) {
_json["cacheFillBytes"] = cacheFillBytes;
}
@@ -2624,19 +3790,19 @@ class HttpRequest {
}
}
-/** A description of a label. */
+/// A description of a label.
class LabelDescriptor {
- /** A human-readable description for the label. */
+ /// A human-readable description for the label.
core.String description;
- /** The label key. */
+
+ /// The label key.
core.String key;
- /**
- * The type of data that can be assigned to the label.
- * Possible string values are:
- * - "STRING" : A variable-length string. This is the default.
- * - "BOOL" : Boolean; true or false.
- * - "INT64" : A 64-bit signed integer.
- */
+
+ /// The type of data that can be assigned to the label.
+ /// Possible string values are:
+ /// - "STRING" : A variable-length string. This is the default.
+ /// - "BOOL" : Boolean; true or false.
+ /// - "INT64" : A 64-bit signed integer.
core.String valueType;
LabelDescriptor();
@@ -2654,7 +3820,8 @@ class LabelDescriptor {
}
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 (description != null) {
_json["description"] = description;
}
@@ -2668,55 +3835,132 @@ class LabelDescriptor {
}
}
-/** The parameters to ListLogEntries. */
+/// Specifies a linear sequence of buckets that all have the same width (except
+/// overflow and underflow). Each bucket represents a constant absolute
+/// uncertainty on the specific value in the bucket.There are
+/// num_finite_buckets + 2 (= N) buckets. Bucket i has the following
+/// boundaries:Upper bound (0 <= i < N-1): offset + (width * i). Lower bound
+/// (1 <= i < N): offset + (width * (i - 1)).
+class Linear {
+ /// Must be greater than 0.
+ core.int numFiniteBuckets;
+
+ /// Lower bound of the first bucket.
+ core.double offset;
+
+ /// Must be greater than 0.
+ core.double width;
+
+ Linear();
+
+ Linear.fromJson(core.Map _json) {
+ if (_json.containsKey("numFiniteBuckets")) {
+ numFiniteBuckets = _json["numFiniteBuckets"];
+ }
+ if (_json.containsKey("offset")) {
+ offset = _json["offset"];
+ }
+ if (_json.containsKey("width")) {
+ width = _json["width"];
+ }
+ }
+
+ core.Map<core.String, core.Object> toJson() {
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
+ if (numFiniteBuckets != null) {
+ _json["numFiniteBuckets"] = numFiniteBuckets;
+ }
+ if (offset != null) {
+ _json["offset"] = offset;
+ }
+ if (width != null) {
+ _json["width"] = width;
+ }
+ return _json;
+ }
+}
+
+/// Result returned from ListExclusions.
+class ListExclusionsResponse {
+ /// A list of exclusions.
+ core.List<LogExclusion> exclusions;
+
+ /// If there might be more results than appear in this response, then
+ /// nextPageToken is included. To get the next set of results, call the same
+ /// method again using the value of nextPageToken as pageToken.
+ core.String nextPageToken;
+
+ ListExclusionsResponse();
+
+ ListExclusionsResponse.fromJson(core.Map _json) {
+ if (_json.containsKey("exclusions")) {
+ exclusions = _json["exclusions"]
+ .map((value) => new LogExclusion.fromJson(value))
+ .toList();
+ }
+ if (_json.containsKey("nextPageToken")) {
+ nextPageToken = _json["nextPageToken"];
+ }
+ }
+
+ core.Map<core.String, core.Object> toJson() {
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
+ if (exclusions != null) {
+ _json["exclusions"] =
+ exclusions.map((value) => (value).toJson()).toList();
+ }
+ if (nextPageToken != null) {
+ _json["nextPageToken"] = nextPageToken;
+ }
+ return _json;
+ }
+}
+
+/// The parameters to ListLogEntries.
class ListLogEntriesRequest {
- /**
- * Optional. A filter that chooses which log entries to return. See Advanced
- * Logs Filters. Only log entries that match the filter are returned. An empty
- * filter matches all log entries in the resources listed in resource_names.
- * Referencing a parent resource that is not listed in resource_names will
- * cause the filter to return no results. The maximum length of the filter is
- * 20000 characters.
- */
+ /// Optional. A filter that chooses which log entries to return. See Advanced
+ /// Logs Filters. Only log entries that match the filter are returned. An
+ /// empty filter matches all log entries in the resources listed in
+ /// resource_names. Referencing a parent resource that is not listed in
+ /// resource_names will cause the filter to return no results. The maximum
+ /// length of the filter is 20000 characters.
core.String filter;
- /**
- * Optional. How the results should be sorted. Presently, the only permitted
- * values are "timestamp asc" (default) and "timestamp desc". The first option
- * returns entries in order of increasing values of LogEntry.timestamp (oldest
- * first), and the second option returns entries in order of decreasing
- * timestamps (newest first). Entries with equal timestamps are returned in
- * order of their insert_id values.
- */
+
+ /// Optional. How the results should be sorted. Presently, the only permitted
+ /// values are "timestamp asc" (default) and "timestamp desc". The first
+ /// option returns entries in order of increasing values of
+ /// LogEntry.timestamp (oldest first), and the second option returns entries
+ /// in order of decreasing timestamps (newest first). Entries with equal
+ /// timestamps are returned in order of their insert_id values.
core.String orderBy;
- /**
- * Optional. The maximum number of results to return from this request.
- * Non-positive values are ignored. The presence of next_page_token in the
- * response indicates that more results might be available.
- */
+
+ /// Optional. The maximum number of results to return from this request.
+ /// Non-positive values are ignored. The presence of next_page_token in the
+ /// response indicates that more results might be available.
core.int pageSize;
- /**
- * Optional. If present, then retrieve the next batch of results from the
- * preceding call to this method. page_token must be the value of
- * next_page_token from the previous response. The values of other method
- * parameters should be identical to those in the previous call.
- */
+
+ /// Optional. If present, then retrieve the next batch of results from the
+ /// preceding call to this method. page_token must be the value of
+ /// next_page_token from the previous response. The values of other method
+ /// parameters should be identical to those in the previous call.
core.String pageToken;
- /**
- * Deprecated. Use resource_names instead. One or more project identifiers or
- * project numbers from which to retrieve log entries. Example:
- * "my-project-1A". If present, these project identifiers are converted to
- * resource name format and added to the list of resources in resource_names.
- */
+
+ /// Deprecated. Use resource_names instead. One or more project identifiers
+ /// or project numbers from which to retrieve log entries. Example:
+ /// "my-project-1A". If present, these project identifiers are converted to
+ /// resource name format and added to the list of resources in
+ /// resource_names.
core.List<core.String> projectIds;
- /**
- * Required. Names of one or more parent resources from which to retrieve log
- * entries:
- * "projects/[PROJECT_ID]"
- * "organizations/[ORGANIZATION_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]"
- * "folders/[FOLDER_ID]"
- * Projects listed in the project_ids field are added to this list.
- */
+
+ /// Required. Names of one or more parent resources from which to retrieve
+ /// log entries:
+ /// "projects/[PROJECT_ID]"
+ /// "organizations/[ORGANIZATION_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]"
+ /// "folders/[FOLDER_ID]"
+ /// Projects listed in the project_ids field are added to this list.
core.List<core.String> resourceNames;
ListLogEntriesRequest();
@@ -2743,7 +3987,8 @@ class ListLogEntriesRequest {
}
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 (filter != null) {
_json["filter"] = filter;
}
@@ -2766,28 +4011,31 @@ class ListLogEntriesRequest {
}
}
-/** Result returned from ListLogEntries. */
+/// Result returned from ListLogEntries.
class ListLogEntriesResponse {
- /** A list of log entries. */
+ /// A list of log entries. If entries is empty, nextPageToken may still be
+ /// returned, indicating that more entries may exist. See nextPageToken for
+ /// more information.
core.List<LogEntry> entries;
- /**
- * If there might be more results than those appearing in this response, then
- * nextPageToken is included. To get the next set of results, call this method
- * again using the value of nextPageToken as pageToken.If a value for
- * next_page_token appears and the entries field is empty, it means that the
- * search found no log entries so far but it did not have time to search all
- * the possible log entries. Retry the method with this value for page_token
- * to continue the search. Alternatively, consider speeding up the search by
- * changing your filter to specify a single log name or resource type, or to
- * narrow the time range of the search.
- */
+
+ /// If there might be more results than those appearing in this response,
+ /// then nextPageToken is included. To get the next set of results, call this
+ /// method again using the value of nextPageToken as pageToken.If a value for
+ /// next_page_token appears and the entries field is empty, it means that the
+ /// search found no log entries so far but it did not have time to search all
+ /// the possible log entries. Retry the method with this value for page_token
+ /// to continue the search. Alternatively, consider speeding up the search by
+ /// changing your filter to specify a single log name or resource type, or to
+ /// narrow the time range of the search.
core.String nextPageToken;
ListLogEntriesResponse();
ListLogEntriesResponse.fromJson(core.Map _json) {
if (_json.containsKey("entries")) {
- entries = _json["entries"].map((value) => new LogEntry.fromJson(value)).toList();
+ entries = _json["entries"]
+ .map((value) => new LogEntry.fromJson(value))
+ .toList();
}
if (_json.containsKey("nextPageToken")) {
nextPageToken = _json["nextPageToken"];
@@ -2795,7 +4043,8 @@ class ListLogEntriesResponse {
}
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 (entries != null) {
_json["entries"] = entries.map((value) => (value).toJson()).toList();
}
@@ -2806,22 +4055,23 @@ class ListLogEntriesResponse {
}
}
-/** Result returned from ListLogMetrics. */
+/// Result returned from ListLogMetrics.
class ListLogMetricsResponse {
- /** A list of logs-based metrics. */
+ /// A list of logs-based metrics.
core.List<LogMetric> metrics;
- /**
- * If there might be more results than appear in this response, then
- * nextPageToken is included. To get the next set of results, call this method
- * again using the value of nextPageToken as pageToken.
- */
+
+ /// If there might be more results than appear in this response, then
+ /// nextPageToken is included. To get the next set of results, call this
+ /// method again using the value of nextPageToken as pageToken.
core.String nextPageToken;
ListLogMetricsResponse();
ListLogMetricsResponse.fromJson(core.Map _json) {
if (_json.containsKey("metrics")) {
- metrics = _json["metrics"].map((value) => new LogMetric.fromJson(value)).toList();
+ metrics = _json["metrics"]
+ .map((value) => new LogMetric.fromJson(value))
+ .toList();
}
if (_json.containsKey("nextPageToken")) {
nextPageToken = _json["nextPageToken"];
@@ -2829,7 +4079,8 @@ class ListLogMetricsResponse {
}
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 (metrics != null) {
_json["metrics"] = metrics.map((value) => (value).toJson()).toList();
}
@@ -2840,18 +4091,15 @@ class ListLogMetricsResponse {
}
}
-/** Result returned from ListLogs. */
+/// Result returned from ListLogs.
class ListLogsResponse {
- /**
- * A list of log names. For example, "projects/my-project/syslog" or
- * "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
- */
+ /// A list of log names. For example, "projects/my-project/syslog" or
+ /// "organizations/123/cloudresourcemanager.googleapis.com%2Factivity".
core.List<core.String> logNames;
- /**
- * If there might be more results than those appearing in this response, then
- * nextPageToken is included. To get the next set of results, call this method
- * again using the value of nextPageToken as pageToken.
- */
+
+ /// If there might be more results than those appearing in this response,
+ /// then nextPageToken is included. To get the next set of results, call this
+ /// method again using the value of nextPageToken as pageToken.
core.String nextPageToken;
ListLogsResponse();
@@ -2866,7 +4114,8 @@ class ListLogsResponse {
}
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 (logNames != null) {
_json["logNames"] = logNames;
}
@@ -2877,15 +4126,14 @@ class ListLogsResponse {
}
}
-/** Result returned from ListMonitoredResourceDescriptors. */
+/// Result returned from ListMonitoredResourceDescriptors.
class ListMonitoredResourceDescriptorsResponse {
- /**
- * If there might be more results than those appearing in this response, then
- * nextPageToken is included. To get the next set of results, call this method
- * again using the value of nextPageToken as pageToken.
- */
+ /// If there might be more results than those appearing in this response,
+ /// then nextPageToken is included. To get the next set of results, call this
+ /// method again using the value of nextPageToken as pageToken.
core.String nextPageToken;
- /** A list of resource descriptors. */
+
+ /// A list of resource descriptors.
core.List<MonitoredResourceDescriptor> resourceDescriptors;
ListMonitoredResourceDescriptorsResponse();
@@ -2895,31 +4143,34 @@ class ListMonitoredResourceDescriptorsResponse {
nextPageToken = _json["nextPageToken"];
}
if (_json.containsKey("resourceDescriptors")) {
- resourceDescriptors = _json["resourceDescriptors"].map((value) => new MonitoredResourceDescriptor.fromJson(value)).toList();
+ resourceDescriptors = _json["resourceDescriptors"]
+ .map((value) => new MonitoredResourceDescriptor.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 (resourceDescriptors != null) {
- _json["resourceDescriptors"] = resourceDescriptors.map((value) => (value).toJson()).toList();
+ _json["resourceDescriptors"] =
+ resourceDescriptors.map((value) => (value).toJson()).toList();
}
return _json;
}
}
-/** Result returned from ListSinks. */
+/// Result returned from ListSinks.
class ListSinksResponse {
- /**
- * If there might be more results than appear in this response, then
- * nextPageToken is included. To get the next set of results, call the same
- * method again using the value of nextPageToken as pageToken.
- */
+ /// If there might be more results than appear in this response, then
+ /// nextPageToken is included. To get the next set of results, call the same
+ /// method again using the value of nextPageToken as pageToken.
core.String nextPageToken;
- /** A list of sinks. */
+
+ /// A list of sinks.
core.List<LogSink> sinks;
ListSinksResponse();
@@ -2929,12 +4180,14 @@ class ListSinksResponse {
nextPageToken = _json["nextPageToken"];
}
if (_json.containsKey("sinks")) {
- sinks = _json["sinks"].map((value) => new LogSink.fromJson(value)).toList();
+ sinks =
+ _json["sinks"].map((value) => new LogSink.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;
}
@@ -2945,114 +4198,104 @@ class ListSinksResponse {
}
}
-/** An individual entry in a log. */
+/// An individual entry in a log.
class LogEntry {
- /**
- * Optional. Information about the HTTP request associated with this log
- * entry, if applicable.
- */
+ /// Optional. Information about the HTTP request associated with this log
+ /// entry, if applicable.
HttpRequest httpRequest;
- /**
- * Optional. A unique identifier for the log entry. If you provide a value,
- * then Stackdriver Logging considers other log entries in the same project,
- * with the same timestamp, and with the same insert_id to be duplicates which
- * can be removed. If omitted in new log entries, then Stackdriver Logging
- * will insert its own unique identifier. The insert_id is used to order log
- * entries that have the same timestamp value.
- */
+
+ /// Optional. A unique identifier for the log entry. If you provide a value,
+ /// then Stackdriver Logging considers other log entries in the same project,
+ /// with the same timestamp, and with the same insert_id to be duplicates
+ /// which can be removed. If omitted in new log entries, then Stackdriver
+ /// Logging assigns its own unique identifier. The insert_id is also used to
+ /// order log entries that have the same timestamp value.
core.String insertId;
- /**
- * The log entry payload, represented as a structure that is expressed as a
- * JSON object.
- *
- * The values for Object must be JSON objects. It can consist of `num`,
- * `String`, `bool` and `null` as well as `Map` and `List` values.
- */
+
+ /// The log entry payload, represented as a structure that is expressed as a
+ /// JSON object.
+ ///
+ /// The values for Object must be JSON objects. It can consist of `num`,
+ /// `String`, `bool` and `null` as well as `Map` and `List` values.
core.Map<core.String, core.Object> jsonPayload;
- /**
- * Optional. A set of user-defined (key, value) data that provides additional
- * information about the log entry.
- */
+
+ /// Optional. A set of user-defined (key, value) data that provides
+ /// additional information about the log entry.
core.Map<core.String, core.String> labels;
- /**
- * Required. The resource name of the log to which this log entry belongs:
- * "projects/[PROJECT_ID]/logs/[LOG_ID]"
- * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
- * "folders/[FOLDER_ID]/logs/[LOG_ID]"
- * [LOG_ID] must be URL-encoded within log_name. Example:
- * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
- * [LOG_ID] must be less than 512 characters long and can only include the
- * following characters: upper and lower case alphanumeric characters,
- * forward-slash, underscore, hyphen, and period.For backward compatibility,
- * if log_name begins with a forward-slash, such as /projects/..., then the
- * log entry is ingested as usual but the forward-slash is removed. Listing
- * the log entry will not show the leading slash and filtering for a log name
- * with a leading slash will never return any results.
- */
+
+ /// Required. The resource name of the log to which this log entry belongs:
+ /// "projects/[PROJECT_ID]/logs/[LOG_ID]"
+ /// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+ /// "folders/[FOLDER_ID]/logs/[LOG_ID]"
+ /// [LOG_ID] must be URL-encoded within log_name. Example:
+ /// "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
+ /// [LOG_ID] must be less than 512 characters long and can only include the
+ /// following characters: upper and lower case alphanumeric characters,
+ /// forward-slash, underscore, hyphen, and period.For backward compatibility,
+ /// if log_name begins with a forward-slash, such as /projects/..., then the
+ /// log entry is ingested as usual but the forward-slash is removed. Listing
+ /// the log entry will not show the leading slash and filtering for a log
+ /// name with a leading slash will never return any results.
core.String logName;
- /**
- * Optional. Information about an operation associated with the log entry, if
- * applicable.
- */
+
+ /// Optional. Information about an operation associated with the log entry,
+ /// if applicable.
LogEntryOperation operation;
- /**
- * The log entry payload, represented as a protocol buffer. Some Google Cloud
- * Platform services use this field for their log entry payloads.
- *
- * The values for Object must be JSON objects. It can consist of `num`,
- * `String`, `bool` and `null` as well as `Map` and `List` values.
- */
+
+ /// The log entry payload, represented as a protocol buffer. Some Google
+ /// Cloud Platform services use this field for their log entry payloads.
+ ///
+ /// The values for Object must be JSON objects. It can consist of `num`,
+ /// `String`, `bool` and `null` as well as `Map` and `List` values.
core.Map<core.String, core.Object> protoPayload;
- /**
- * Output only. The time the log entry was received by Stackdriver Logging.
- */
+
+ /// Output only. The time the log entry was received by Stackdriver Logging.
core.String receiveTimestamp;
- /**
- * Required. The monitored resource associated with this log entry. Example: a
- * log entry that reports a database error would be associated with the
- * monitored resource designating the particular database that reported the
- * error.
- */
+
+ /// Required. The monitored resource associated with this log entry. Example:
+ /// a log entry that reports a database error would be associated with the
+ /// monitored resource designating the particular database that reported the
+ /// error.
MonitoredResource resource;
- /**
- * Optional. The severity of the log entry. The default value is
- * LogSeverity.DEFAULT.
- * Possible string values are:
- * - "DEFAULT" : (0) The log entry has no assigned severity level.
- * - "DEBUG" : (100) Debug or trace information.
- * - "INFO" : (200) Routine information, such as ongoing status or
- * performance.
- * - "NOTICE" : (300) Normal but significant events, such as start up, shut
- * down, or a configuration change.
- * - "WARNING" : (400) Warning events might cause problems.
- * - "ERROR" : (500) Error events are likely to cause problems.
- * - "CRITICAL" : (600) Critical events cause more severe problems or outages.
- * - "ALERT" : (700) A person must take an action immediately.
- * - "EMERGENCY" : (800) One or more systems are unusable.
- */
+
+ /// Optional. The severity of the log entry. The default value is
+ /// LogSeverity.DEFAULT.
+ /// Possible string values are:
+ /// - "DEFAULT" : (0) The log entry has no assigned severity level.
+ /// - "DEBUG" : (100) Debug or trace information.
+ /// - "INFO" : (200) Routine information, such as ongoing status or
+ /// performance.
+ /// - "NOTICE" : (300) Normal but significant events, such as start up, shut
+ /// down, or a configuration change.
+ /// - "WARNING" : (400) Warning events might cause problems.
+ /// - "ERROR" : (500) Error events are likely to cause problems.
+ /// - "CRITICAL" : (600) Critical events cause more severe problems or
+ /// outages.
+ /// - "ALERT" : (700) A person must take an action immediately.
+ /// - "EMERGENCY" : (800) One or more systems are unusable.
core.String severity;
- /**
- * Optional. Source code location information associated with the log entry,
- * if any.
- */
+
+ /// Optional. Source code location information associated with the log entry,
+ /// if any.
LogEntrySourceLocation sourceLocation;
- /** The log entry payload, represented as a Unicode string (UTF-8). */
+
+ /// The log entry payload, represented as a Unicode string (UTF-8).
core.String textPayload;
- /**
- * Optional. The time the event described by the log entry occurred. If
- * omitted in a new log entry, Stackdriver Logging will insert the time the
- * log entry is received. Stackdriver Logging might reject log entries whose
- * time stamps are more than a couple of hours in the future. Log entries with
- * time stamps in the past are accepted.
- */
+
+ /// Optional. The time the event described by the log entry occurred. This
+ /// time is used to compute the log entry's age and to enforce the logs
+ /// retention period. If this field is omitted in a new log entry, then
+ /// Stackdriver Logging assigns it the current time.Incoming log entries
+ /// should have timestamps that are no more than the logs retention period in
+ /// the past, and no more than 24 hours in the future. See the entries.write
+ /// API method for more information.
core.String timestamp;
- /**
- * Optional. Resource name of the trace associated with the log entry, if any.
- * If it contains a relative resource name, the name is assumed to be relative
- * to //tracing.googleapis.com. Example:
- * projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
- */
+
+ /// Optional. Resource name of the trace associated with the log entry, if
+ /// any. If it contains a relative resource name, the name is assumed to be
+ /// relative to //tracing.googleapis.com. Example:
+ /// projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
core.String trace;
LogEntry();
@@ -3089,7 +4332,8 @@ class LogEntry {
severity = _json["severity"];
}
if (_json.containsKey("sourceLocation")) {
- sourceLocation = new LogEntrySourceLocation.fromJson(_json["sourceLocation"]);
+ sourceLocation =
+ new LogEntrySourceLocation.fromJson(_json["sourceLocation"]);
}
if (_json.containsKey("textPayload")) {
textPayload = _json["textPayload"];
@@ -3103,7 +4347,8 @@ class LogEntry {
}
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 (httpRequest != null) {
_json["httpRequest"] = (httpRequest).toJson();
}
@@ -3150,29 +4395,24 @@ class LogEntry {
}
}
-/**
- * Additional information about a potentially long-running operation with which
- * a log entry is associated.
- */
+/// Additional information about a potentially long-running operation with
+/// which a log entry is associated.
class LogEntryOperation {
- /**
- * Optional. Set this to True if this is the first log entry in the operation.
- */
+ /// Optional. Set this to True if this is the first log entry in the
+ /// operation.
core.bool first;
- /**
- * Optional. An arbitrary operation identifier. Log entries with the same
- * identifier are assumed to be part of the same operation.
- */
+
+ /// Optional. An arbitrary operation identifier. Log entries with the same
+ /// identifier are assumed to be part of the same operation.
core.String id;
- /**
- * Optional. Set this to True if this is the last log entry in the operation.
- */
+
+ /// Optional. Set this to True if this is the last log entry in the
+ /// operation.
core.bool last;
- /**
- * Optional. An arbitrary producer identifier. The combination of id and
- * producer must be globally unique. Examples for producer:
- * "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
- */
+
+ /// Optional. An arbitrary producer identifier. The combination of id and
+ /// producer must be globally unique. Examples for producer:
+ /// "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
core.String producer;
LogEntryOperation();
@@ -3193,7 +4433,8 @@ class LogEntryOperation {
}
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 (first != null) {
_json["first"] = first;
}
@@ -3210,28 +4451,23 @@ class LogEntryOperation {
}
}
-/**
- * Additional information about the source code location that produced the log
- * entry.
- */
+/// Additional information about the source code location that produced the log
+/// entry.
class LogEntrySourceLocation {
- /**
- * Optional. Source file name. Depending on the runtime environment, this
- * might be a simple name or a fully-qualified name.
- */
+ /// Optional. Source file name. Depending on the runtime environment, this
+ /// might be a simple name or a fully-qualified name.
core.String file;
- /**
- * Optional. Human-readable name of the function or method being invoked, with
- * optional context such as the class or package name. This information may be
- * used in contexts such as the logs viewer, where a file and line number are
- * less meaningful. The format can vary by language. For example:
- * qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).
- */
+
+ /// Optional. Human-readable name of the function or method being invoked,
+ /// with optional context such as the class or package name. This information
+ /// may be used in contexts such as the logs viewer, where a file and line
+ /// number are less meaningful. The format can vary by language. For example:
+ /// qual.if.ied.Class.method (Java), dir/package.func (Go), function
+ /// (Python).
core.String function;
- /**
- * Optional. Line within the source file. 1-based; 0 indicates no line number
- * available.
- */
+
+ /// Optional. Line within the source file. 1-based; 0 indicates no line
+ /// number available.
core.String line;
LogEntrySourceLocation();
@@ -3249,7 +4485,8 @@ class LogEntrySourceLocation {
}
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 (file != null) {
_json["file"] = file;
}
@@ -3263,29 +4500,94 @@ class LogEntrySourceLocation {
}
}
-/** Application log line emitted while processing a request. */
+/// Specifies a set of log entries that are not to be stored in Stackdriver
+/// Logging. If your project receives a large volume of logs, you might be able
+/// to use exclusions to reduce your chargeable logs. Exclusions are processed
+/// after log sinks, so you can export log entries before they are excluded.
+/// Audit log entries and log entries from Amazon Web Services are never
+/// excluded.
+class LogExclusion {
+ /// Optional. A description of this exclusion.
+ core.String description;
+
+ /// Optional. If set to True, then this exclusion is disabled and it does not
+ /// exclude any log entries. You can use exclusions.patch to change the value
+ /// of this field.
+ core.bool disabled;
+
+ /// Required. An advanced logs filter that matches the log entries to be
+ /// excluded. By using the sample function, you can exclude less than 100% of
+ /// the matching log entries. For example, the following filter matches 99%
+ /// of low-severity log entries from load balancers:
+ /// "resource.type=http_load_balancer severity<ERROR sample(insertId, 0.99)"
+ core.String filter;
+
+ /// Required. A client-assigned identifier, such as
+ /// "load-balancer-exclusion". Identifiers are limited to 100 characters and
+ /// can include only letters, digits, underscores, hyphens, and periods.
+ core.String name;
+
+ LogExclusion();
+
+ LogExclusion.fromJson(core.Map _json) {
+ if (_json.containsKey("description")) {
+ description = _json["description"];
+ }
+ if (_json.containsKey("disabled")) {
+ disabled = _json["disabled"];
+ }
+ if (_json.containsKey("filter")) {
+ filter = _json["filter"];
+ }
+ if (_json.containsKey("name")) {
+ name = _json["name"];
+ }
+ }
+
+ core.Map<core.String, core.Object> toJson() {
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
+ if (description != null) {
+ _json["description"] = description;
+ }
+ if (disabled != null) {
+ _json["disabled"] = disabled;
+ }
+ if (filter != null) {
+ _json["filter"] = filter;
+ }
+ if (name != null) {
+ _json["name"] = name;
+ }
+ return _json;
+ }
+}
+
+/// Application log line emitted while processing a request.
class LogLine {
- /** App-provided log message. */
+ /// App-provided log message.
core.String logMessage;
- /**
- * Severity of this log entry.
- * Possible string values are:
- * - "DEFAULT" : (0) The log entry has no assigned severity level.
- * - "DEBUG" : (100) Debug or trace information.
- * - "INFO" : (200) Routine information, such as ongoing status or
- * performance.
- * - "NOTICE" : (300) Normal but significant events, such as start up, shut
- * down, or a configuration change.
- * - "WARNING" : (400) Warning events might cause problems.
- * - "ERROR" : (500) Error events are likely to cause problems.
- * - "CRITICAL" : (600) Critical events cause more severe problems or outages.
- * - "ALERT" : (700) A person must take an action immediately.
- * - "EMERGENCY" : (800) One or more systems are unusable.
- */
+
+ /// Severity of this log entry.
+ /// Possible string values are:
+ /// - "DEFAULT" : (0) The log entry has no assigned severity level.
+ /// - "DEBUG" : (100) Debug or trace information.
+ /// - "INFO" : (200) Routine information, such as ongoing status or
+ /// performance.
+ /// - "NOTICE" : (300) Normal but significant events, such as start up, shut
+ /// down, or a configuration change.
+ /// - "WARNING" : (400) Warning events might cause problems.
+ /// - "ERROR" : (500) Error events are likely to cause problems.
+ /// - "CRITICAL" : (600) Critical events cause more severe problems or
+ /// outages.
+ /// - "ALERT" : (700) A person must take an action immediately.
+ /// - "EMERGENCY" : (800) One or more systems are unusable.
core.String severity;
- /** Where in the source code this log message was written. */
+
+ /// Where in the source code this log message was written.
SourceLocation sourceLocation;
- /** Approximate time when this log entry was made. */
+
+ /// Approximate time when this log entry was made.
core.String time;
LogLine();
@@ -3306,7 +4608,8 @@ class LogLine {
}
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 (logMessage != null) {
_json["logMessage"] = logMessage;
}
@@ -3323,72 +4626,147 @@ class LogLine {
}
}
-/**
- * Describes a logs-based metric. The value of the metric is the number of log
- * entries that match a logs filter in a given time interval.
- */
+/// Describes a logs-based metric. The value of the metric is the number of log
+/// entries that match a logs filter in a given time interval.Logs-based metric
+/// can also be used to extract values from logs and create a a distribution of
+/// the values. The distribution records the statistics of the extracted values
+/// along with an optional histogram of the values as specified by the bucket
+/// options.
class LogMetric {
- /**
- * Optional. A description of this metric, which is used in documentation.
- */
+ /// Optional. The bucket_options are required when the logs-based metric is
+ /// using a DISTRIBUTION value type and it describes the bucket boundaries
+ /// used to create a histogram of the extracted values.
+ BucketOptions bucketOptions;
+
+ /// Optional. A description of this metric, which is used in documentation.
core.String description;
- /**
- * Required. An advanced logs filter which is used to match log entries.
- * Example:
- * "resource.type=gae_app AND severity>=ERROR"
- * The maximum length of the filter is 20000 characters.
- */
+
+ /// Required. An advanced logs filter which is used to match log entries.
+ /// Example:
+ /// "resource.type=gae_app AND severity>=ERROR"
+ /// The maximum length of the filter is 20000 characters.
core.String filter;
- /**
- * Required. The client-assigned metric identifier. Examples: "error_count",
- * "nginx/requests".Metric identifiers are limited to 100 characters and can
- * include only the following characters: A-Z, a-z, 0-9, and the special
- * characters _-.,+!*',()%/. The forward-slash character (/) denotes a
- * hierarchy of name pieces, and it cannot be the first character of the
- * name.The metric identifier in this field must not be URL-encoded
- * (https://en.wikipedia.org/wiki/Percent-encoding). However, when the metric
- * identifier appears as the [METRIC_ID] part of a metric_name API parameter,
- * then the metric identifier must be URL-encoded. Example:
- * "projects/my-project/metrics/nginx%2Frequests".
- */
+
+ /// Optional. A map from a label key string to an extractor expression which
+ /// is used to extract data from a log entry field and assign as the label
+ /// value. Each label key specified in the LabelDescriptor must have an
+ /// associated extractor expression in this map. The syntax of the extractor
+ /// expression is the same as for the value_extractor field.The extracted
+ /// value is converted to the type defined in the label descriptor. If the
+ /// either the extraction or the type conversion fails, the label will have a
+ /// default value. The default value for a string label is an empty string,
+ /// for an integer label its 0, and for a boolean label its false.Note that
+ /// there are upper bounds on the maximum number of labels and the number of
+ /// active time series that are allowed in a project.
+ core.Map<core.String, core.String> labelExtractors;
+
+ /// Optional. The metric descriptor associated with the logs-based metric. If
+ /// unspecified, it uses a default metric descriptor with a DELTA metric
+ /// kind, INT64 value type, with no labels and a unit of "1". Such a metric
+ /// counts the number of log entries matching the filter expression.The name,
+ /// type, and description fields in the metric_descriptor are output only,
+ /// and is constructed using the name and description field in the
+ /// LogMetric.To create a logs-based metric that records a distribution of
+ /// log values, a DELTA metric kind with a DISTRIBUTION value type must be
+ /// used along with a value_extractor expression in the LogMetric.Each label
+ /// in the metric descriptor must have a matching label name as the key and
+ /// an extractor expression as the value in the label_extractors map.The
+ /// metric_kind and value_type fields in the metric_descriptor cannot be
+ /// updated once initially configured. New labels can be added in the
+ /// metric_descriptor, but existing labels cannot be modified except for
+ /// their description.
+ MetricDescriptor metricDescriptor;
+
+ /// Required. The client-assigned metric identifier. Examples: "error_count",
+ /// "nginx/requests".Metric identifiers are limited to 100 characters and can
+ /// include only the following characters: A-Z, a-z, 0-9, and the special
+ /// characters _-.,+!*',()%/. The forward-slash character (/) denotes a
+ /// hierarchy of name pieces, and it cannot be the first character of the
+ /// name.The metric identifier in this field must not be URL-encoded
+ /// (https://en.wikipedia.org/wiki/Percent-encoding). However, when the
+ /// metric identifier appears as the [METRIC_ID] part of a metric_name API
+ /// parameter, then the metric identifier must be URL-encoded. Example:
+ /// "projects/my-project/metrics/nginx%2Frequests".
core.String name;
- /**
- * Output only. The API version that created or updated this metric. This
- * value is currently always set to V2.
- * Possible string values are:
- * - "V2" : Stackdriver Logging API v2.
- * - "V1" : Stackdriver Logging API v1.
- */
+
+ /// Optional. A value_extractor is required when using a distribution
+ /// logs-based metric to extract the values to record from a log entry. Two
+ /// functions are supported for value extraction: EXTRACT(field) or
+ /// REGEXP_EXTRACT(field, regex). The argument are: 1. field: The name of
+ /// the log entry field from which the value is to be extracted. 2. regex:
+ /// A regular expression using the Google RE2 syntax
+ /// (https://github.com/google/re2/wiki/Syntax) with a single capture group
+ /// to extract data from the specified log entry field. The value of the
+ /// field is converted to a string before applying the regex. It is an error
+ /// to specify a regex that does not include exactly one capture group.The
+ /// result of the extraction must be convertible to a double type, as the
+ /// distribution always records double values. If either the extraction or
+ /// the conversion to double fails, then those values are not recorded in the
+ /// distribution.Example: REGEXP_EXTRACT(jsonPayload.request,
+ /// ".*quantity=(\d+).*")
+ core.String valueExtractor;
+
+ /// Deprecated. The API version that created or updated this metric. The v2
+ /// format is used by default and cannot be changed.
+ /// Possible string values are:
+ /// - "V2" : Stackdriver Logging API v2.
+ /// - "V1" : Stackdriver Logging API v1.
core.String version;
LogMetric();
LogMetric.fromJson(core.Map _json) {
+ if (_json.containsKey("bucketOptions")) {
+ bucketOptions = new BucketOptions.fromJson(_json["bucketOptions"]);
+ }
if (_json.containsKey("description")) {
description = _json["description"];
}
if (_json.containsKey("filter")) {
filter = _json["filter"];
}
+ if (_json.containsKey("labelExtractors")) {
+ labelExtractors = _json["labelExtractors"];
+ }
+ if (_json.containsKey("metricDescriptor")) {
+ metricDescriptor =
+ new MetricDescriptor.fromJson(_json["metricDescriptor"]);
+ }
if (_json.containsKey("name")) {
name = _json["name"];
}
+ if (_json.containsKey("valueExtractor")) {
+ valueExtractor = _json["valueExtractor"];
+ }
if (_json.containsKey("version")) {
version = _json["version"];
}
}
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 (bucketOptions != null) {
+ _json["bucketOptions"] = (bucketOptions).toJson();
+ }
if (description != null) {
_json["description"] = description;
}
if (filter != null) {
_json["filter"] = filter;
}
+ if (labelExtractors != null) {
+ _json["labelExtractors"] = labelExtractors;
+ }
+ if (metricDescriptor != null) {
+ _json["metricDescriptor"] = (metricDescriptor).toJson();
+ }
if (name != null) {
_json["name"] = name;
}
+ if (valueExtractor != null) {
+ _json["valueExtractor"] = valueExtractor;
+ }
if (version != null) {
_json["version"] = version;
}
@@ -3396,89 +4774,71 @@ class LogMetric {
}
}
-/**
- * Describes a sink used to export log entries to one of the following
- * destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
- * Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
- * The sink must be created within a project, organization, billing account, or
- * folder.
- */
+/// Describes a sink used to export log entries to one of the following
+/// destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or
+/// a Cloud Pub/Sub topic. A logs filter controls which log entries are
+/// exported. The sink must be created within a project, organization, billing
+/// account, or folder.
class LogSink {
- /**
- * Required. The export destination:
- * "storage.googleapis.com/[GCS_BUCKET]"
- * "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
- * "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
- * The sink's writer_identity, set when the sink is created, must have
- * permission to write to the destination or else the log entries are not
- * exported. For more information, see Exporting Logs With Sinks.
- */
+ /// Required. The export destination:
+ /// "storage.googleapis.com/[GCS_BUCKET]"
+ /// "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+ /// "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+ /// The sink's writer_identity, set when the sink is created, must have
+ /// permission to write to the destination or else the log entries are not
+ /// exported. For more information, see Exporting Logs With Sinks.
core.String destination;
- /**
- * Optional. The time at which this sink will stop exporting log entries. Log
- * entries are exported only if their timestamp is earlier than the end time.
- * If this field is not supplied, there is no end time. If both a start time
- * and an end time are provided, then the end time must be later than the
- * start time.
- */
+
+ /// Deprecated. This field is ignored when creating or updating sinks.
core.String endTime;
- /**
- * Optional. An advanced logs filter. The only exported log entries are those
- * that are in the resource owning the sink and that match the filter. The
- * filter must use the log entry format specified by the output_version_format
- * parameter. For example, in the v2 format:
- * logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
- */
+
+ /// Optional. An advanced logs filter. The only exported log entries are
+ /// those that are in the resource owning the sink and that match the filter.
+ /// For example:
+ /// logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
core.String filter;
- /**
- * Optional. This field applies only to sinks owned by organizations and
- * folders. If the field is false, the default, only the logs owned by the
- * sink's parent resource are available for export. If the field is true, then
- * logs from all the projects, folders, and billing accounts contained in the
- * sink's parent resource are also available for export. Whether a particular
- * log entry from the children is exported depends on the sink's filter
- * expression. For example, if this field is true, then the filter
- * resource.type=gce_instance would export all Compute Engine VM instance log
- * entries from all projects in the sink's parent. To only export entries from
- * certain child projects, filter on the project part of the log name:
- * logName:("projects/test-project1/" OR "projects/test-project2/") AND
- * resource.type=gce_instance
- */
+
+ /// Optional. This field applies only to sinks owned by organizations and
+ /// folders. If the field is false, the default, only the logs owned by the
+ /// sink's parent resource are available for export. If the field is true,
+ /// then logs from all the projects, folders, and billing accounts contained
+ /// in the sink's parent resource are also available for export. Whether a
+ /// particular log entry from the children is exported depends on the sink's
+ /// filter expression. For example, if this field is true, then the filter
+ /// resource.type=gce_instance would export all Compute Engine VM instance
+ /// log entries from all projects in the sink's parent. To only export
+ /// entries from certain child projects, filter on the project part of the
+ /// log name:
+ /// logName:("projects/test-project1/" OR "projects/test-project2/") AND
+ /// resource.type=gce_instance
core.bool includeChildren;
- /**
- * Required. The client-assigned sink identifier, unique within the project.
- * Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
- * characters and can include only the following characters: upper and
- * lower-case alphanumeric characters, underscores, hyphens, and periods.
- */
+
+ /// Required. The client-assigned sink identifier, unique within the project.
+ /// Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to
+ /// 100 characters and can include only the following characters: upper and
+ /// lower-case alphanumeric characters, underscores, hyphens, and periods.
core.String name;
- /**
- * Deprecated. The log entry format to use for this sink's exported log
- * entries. The v2 format is used by default and cannot be changed.
- * Possible string values are:
- * - "VERSION_FORMAT_UNSPECIFIED" : An unspecified format version that will
- * default to V2.
- * - "V2" : LogEntry version 2 format.
- * - "V1" : LogEntry version 1 format.
- */
+
+ /// Deprecated. The log entry format to use for this sink's exported log
+ /// entries. The v2 format is used by default and cannot be changed.
+ /// Possible string values are:
+ /// - "VERSION_FORMAT_UNSPECIFIED" : An unspecified format version that will
+ /// default to V2.
+ /// - "V2" : LogEntry version 2 format.
+ /// - "V1" : LogEntry version 1 format.
core.String outputVersionFormat;
- /**
- * Optional. The time at which this sink will begin exporting log entries. Log
- * entries are exported only if their timestamp is not earlier than the start
- * time. The default value of this field is the time the sink is created or
- * updated.
- */
+
+ /// Deprecated. This field is ignored when creating or updating sinks.
core.String startTime;
- /**
- * Output only. An IAM identity&mdash;a service account or group&mdash;under
- * which Stackdriver Logging writes the exported log entries to the sink's
- * destination. This field is set by sinks.create and sinks.update, based on
- * the setting of unique_writer_identity in those methods.Until you grant this
- * identity write-access to the destination, log entry exports from this sink
- * will fail. For more information, see Granting access for a resource.
- * Consult the destination service's documentation to determine the
- * appropriate IAM roles to assign to the identity.
- */
+
+ /// Output only. An IAM identity&mdash;a service account or group&mdash;under
+ /// which Stackdriver Logging writes the exported log entries to the sink's
+ /// destination. This field is set by sinks.create and sinks.update, based on
+ /// the setting of unique_writer_identity in those methods.Until you grant
+ /// this identity write-access to the destination, log entry exports from
+ /// this sink will fail. For more information, see Granting access for a
+ /// resource. Consult the destination service's documentation to determine
+ /// the appropriate IAM roles to assign to the identity.
core.String writerIdentity;
LogSink();
@@ -3511,7 +4871,8 @@ class LogSink {
}
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 (destination != null) {
_json["destination"] = destination;
}
@@ -3540,32 +4901,200 @@ class LogSink {
}
}
-/**
- * An object representing a resource that can be used for monitoring, logging,
- * billing, or other purposes. Examples include virtual machine instances,
- * databases, and storage devices such as disks. The type field identifies a
- * MonitoredResourceDescriptor object that describes the resource's schema.
- * Information in the labels field identifies the actual resource and its
- * attributes according to the schema. For example, a particular Compute Engine
- * VM instance could be represented by the following object, because the
- * MonitoredResourceDescriptor for "gce_instance" has labels "instance_id" and
- * "zone":
- * { "type": "gce_instance",
- * "labels": { "instance_id": "12345678901234",
- * "zone": "us-central1-a" }}
- */
+/// Defines a metric type and its schema. Once a metric descriptor is created,
+/// deleting or altering it stops data collection and makes the metric type's
+/// existing data unusable.
+class MetricDescriptor {
+ /// A detailed description of the metric, which can be used in documentation.
+ core.String description;
+
+ /// A concise name for the metric, which can be displayed in user interfaces.
+ /// Use sentence case without an ending period, for example "Request count".
+ core.String displayName;
+
+ /// The set of labels that can be used to describe a specific instance of
+ /// this metric type. For example, the
+ /// appengine.googleapis.com/http/server/response_latencies metric type has a
+ /// label for the HTTP response code, response_code, so you can look at
+ /// latencies for successful responses or just for responses that failed.
+ core.List<LabelDescriptor> labels;
+
+ /// Whether the metric records instantaneous values, changes to a value, etc.
+ /// Some combinations of metric_kind and value_type might not be supported.
+ /// Possible string values are:
+ /// - "METRIC_KIND_UNSPECIFIED" : Do not use this default value.
+ /// - "GAUGE" : An instantaneous measurement of a value.
+ /// - "DELTA" : The change in a value during a time interval.
+ /// - "CUMULATIVE" : A value accumulated over a time interval. Cumulative
+ /// measurements in a time series should have the same start time and
+ /// increasing end times, until an event resets the cumulative value to zero
+ /// and sets a new start time for the following points.
+ core.String metricKind;
+
+ /// The resource name of the metric descriptor. Depending on the
+ /// implementation, the name typically includes: (1) the parent resource name
+ /// that defines the scope of the metric type or of its data; and (2) the
+ /// metric's URL-encoded type, which also appears in the type field of this
+ /// descriptor. For example, following is the resource name of a custom
+ /// metric within the GCP project my-project-id:
+ /// "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
+ core.String name;
+
+ /// The metric type, including its DNS name prefix. The type is not
+ /// URL-encoded. All user-defined custom metric types have the DNS name
+ /// custom.googleapis.com. Metric types should use a natural hierarchical
+ /// grouping. For example:
+ /// "custom.googleapis.com/invoice/paid/amount"
+ /// "appengine.googleapis.com/http/server/response_latencies"
+ core.String type;
+
+ /// The unit in which the metric value is reported. It is only applicable if
+ /// the value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are
+ /// a subset of The Unified Code for Units of Measure
+ /// (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
+ /// bit bit
+ /// By byte
+ /// s second
+ /// min minute
+ /// h hour
+ /// d dayPrefixes (PREFIX)
+ /// k kilo (10**3)
+ /// M mega (10**6)
+ /// G giga (10**9)
+ /// T tera (10**12)
+ /// P peta (10**15)
+ /// E exa (10**18)
+ /// Z zetta (10**21)
+ /// Y yotta (10**24)
+ /// m milli (10**-3)
+ /// u micro (10**-6)
+ /// n nano (10**-9)
+ /// p pico (10**-12)
+ /// f femto (10**-15)
+ /// a atto (10**-18)
+ /// z zepto (10**-21)
+ /// y yocto (10**-24)
+ /// Ki kibi (2**10)
+ /// Mi mebi (2**20)
+ /// Gi gibi (2**30)
+ /// Ti tebi (2**40)GrammarThe grammar includes the dimensionless unit 1, such
+ /// as 1/s.The grammar also includes these connectors:
+ /// / division (as an infix operator, e.g. 1/s).
+ /// . multiplication (as an infix operator, e.g. GBy.d)The grammar for a unit
+ /// is as follows:
+ /// Expression = Component { "." Component } { "/" Component } ;
+ ///
+ /// Component = [ PREFIX ] UNIT [ Annotation ]
+ /// | Annotation
+ /// | "1"
+ /// ;
+ ///
+ /// Annotation = "{" NAME "}" ;
+ /// Notes:
+ /// Annotation is just a comment if it follows a UNIT and is equivalent to 1
+ /// if it is used alone. For examples, {requests}/s == 1/s,
+ /// By{transmitted}/s == By/s.
+ /// NAME is a sequence of non-blank printable ASCII characters not
+ /// containing '{' or '}'.
+ core.String unit;
+
+ /// Whether the measurement is an integer, a floating-point number, etc. Some
+ /// combinations of metric_kind and value_type might not be supported.
+ /// Possible string values are:
+ /// - "VALUE_TYPE_UNSPECIFIED" : Do not use this default value.
+ /// - "BOOL" : The value is a boolean. This value type can be used only if
+ /// the metric kind is GAUGE.
+ /// - "INT64" : The value is a signed 64-bit integer.
+ /// - "DOUBLE" : The value is a double precision floating point number.
+ /// - "STRING" : The value is a text string. This value type can be used only
+ /// if the metric kind is GAUGE.
+ /// - "DISTRIBUTION" : The value is a Distribution.
+ /// - "MONEY" : The value is money.
+ core.String valueType;
+
+ MetricDescriptor();
+
+ MetricDescriptor.fromJson(core.Map _json) {
+ if (_json.containsKey("description")) {
+ description = _json["description"];
+ }
+ if (_json.containsKey("displayName")) {
+ displayName = _json["displayName"];
+ }
+ if (_json.containsKey("labels")) {
+ labels = _json["labels"]
+ .map((value) => new LabelDescriptor.fromJson(value))
+ .toList();
+ }
+ if (_json.containsKey("metricKind")) {
+ metricKind = _json["metricKind"];
+ }
+ if (_json.containsKey("name")) {
+ name = _json["name"];
+ }
+ if (_json.containsKey("type")) {
+ type = _json["type"];
+ }
+ if (_json.containsKey("unit")) {
+ unit = _json["unit"];
+ }
+ if (_json.containsKey("valueType")) {
+ valueType = _json["valueType"];
+ }
+ }
+
+ core.Map<core.String, core.Object> toJson() {
+ final core.Map<core.String, core.Object> _json =
+ new core.Map<core.String, core.Object>();
+ if (description != null) {
+ _json["description"] = description;
+ }
+ if (displayName != null) {
+ _json["displayName"] = displayName;
+ }
+ if (labels != null) {
+ _json["labels"] = labels.map((value) => (value).toJson()).toList();
+ }
+ if (metricKind != null) {
+ _json["metricKind"] = metricKind;
+ }
+ if (name != null) {
+ _json["name"] = name;
+ }
+ if (type != null) {
+ _json["type"] = type;
+ }
+ if (unit != null) {
+ _json["unit"] = unit;
+ }
+ if (valueType != null) {
+ _json["valueType"] = valueType;
+ }
+ return _json;
+ }
+}
+
+/// An object representing a resource that can be used for monitoring, logging,
+/// billing, or other purposes. Examples include virtual machine instances,
+/// databases, and storage devices such as disks. The type field identifies a
+/// MonitoredResourceDescriptor object that describes the resource's schema.
+/// Information in the labels field identifies the actual resource and its
+/// attributes according to the schema. For example, a particular Compute
+/// Engine VM instance could be represented by the following object, because
+/// the MonitoredResourceDescriptor for "gce_instance" has labels "instance_id"
+/// and "zone":
+/// { "type": "gce_instance",
+/// "labels": { "instance_id": "12345678901234",
+/// "zone": "us-central1-a" }}
class MonitoredResource {
- /**
- * Required. Values for all of the labels listed in the associated monitored
- * resource descriptor. For example, Compute Engine VM instances use the
- * labels "project_id", "instance_id", and "zone".
- */
+ /// Required. Values for all of the labels listed in the associated monitored
+ /// resource descriptor. For example, Compute Engine VM instances use the
+ /// labels "project_id", "instance_id", and "zone".
core.Map<core.String, core.String> labels;
- /**
- * Required. The monitored resource type. This field must match the type field
- * of a MonitoredResourceDescriptor object. For example, the type of a Compute
- * Engine VM instance is gce_instance.
- */
+
+ /// Required. The monitored resource type. This field must match the type
+ /// field of a MonitoredResourceDescriptor object. For example, the type of a
+ /// Compute Engine VM instance is gce_instance.
core.String type;
MonitoredResource();
@@ -3580,7 +5109,8 @@ class MonitoredResource {
}
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 (labels != null) {
_json["labels"] = labels;
}
@@ -3591,48 +5121,40 @@ class MonitoredResource {
}
}
-/**
- * An object that describes the schema of a MonitoredResource object using a
- * type name and a set of labels. For example, the monitored resource descriptor
- * for Google Compute Engine VM instances has a type of "gce_instance" and
- * specifies the use of the labels "instance_id" and "zone" to identify
- * particular VM instances.Different APIs can support different monitored
- * resource types. APIs generally provide a list method that returns the
- * monitored resource descriptors used by the API.
- */
+/// An object that describes the schema of a MonitoredResource object using a
+/// type name and a set of labels. For example, the monitored resource
+/// descriptor for Google Compute Engine VM instances has a type of
+/// "gce_instance" and specifies the use of the labels "instance_id" and "zone"
+/// to identify particular VM instances.Different APIs can support different
+/// monitored resource types. APIs generally provide a list method that returns
+/// the monitored resource descriptors used by the API.
class MonitoredResourceDescriptor {
- /**
- * Optional. A detailed description of the monitored resource type that might
- * be used in documentation.
- */
+ /// Optional. A detailed description of the monitored resource type that
+ /// might be used in documentation.
core.String description;
- /**
- * Optional. A concise name for the monitored resource type that might be
- * displayed in user interfaces. It should be a Title Cased Noun Phrase,
- * without any article or other determiners. For example, "Google Cloud SQL
- * Database".
- */
+
+ /// Optional. A concise name for the monitored resource type that might be
+ /// displayed in user interfaces. It should be a Title Cased Noun Phrase,
+ /// without any article or other determiners. For example, "Google Cloud SQL
+ /// Database".
core.String displayName;
- /**
- * Required. A set of labels used to describe instances of this monitored
- * resource type. For example, an individual Google Cloud SQL database is
- * identified by values for the labels "database_id" and "zone".
- */
+
+ /// Required. A set of labels used to describe instances of this monitored
+ /// resource type. For example, an individual Google Cloud SQL database is
+ /// identified by values for the labels "database_id" and "zone".
core.List<LabelDescriptor> labels;
- /**
- * Optional. The resource name of the monitored resource descriptor:
- * "projects/{project_id}/monitoredResourceDescriptors/{type}" where {type} is
- * the value of the type field in this object and {project_id} is a project ID
- * that provides API-specific context for accessing the type. APIs that do not
- * use project information can use the resource name format
- * "monitoredResourceDescriptors/{type}".
- */
+
+ /// Optional. The resource name of the monitored resource descriptor:
+ /// "projects/{project_id}/monitoredResourceDescriptors/{type}" where {type}
+ /// is the value of the type field in this object and {project_id} is a
+ /// project ID that provides API-specific context for accessing the type.
+ /// APIs that do not use project information can use the resource name format
+ /// "monitoredResourceDescriptors/{type}".
core.String name;
- /**
- * Required. The monitored resource type. For example, the type
- * "cloudsql_database" represents databases in Google Cloud SQL. The maximum
- * length of this value is 256 characters.
- */
+
+ /// Required. The monitored resource type. For example, the type
+ /// "cloudsql_database" represents databases in Google Cloud SQL. The maximum
+ /// length of this value is 256 characters.
core.String type;
MonitoredResourceDescriptor();
@@ -3645,7 +5167,9 @@ class MonitoredResourceDescriptor {
displayName = _json["displayName"];
}
if (_json.containsKey("labels")) {
- labels = _json["labels"].map((value) => new LabelDescriptor.fromJson(value)).toList();
+ labels = _json["labels"]
+ .map((value) => new LabelDescriptor.fromJson(value))
+ .toList();
}
if (_json.containsKey("name")) {
name = _json["name"];
@@ -3656,7 +5180,8 @@ class MonitoredResourceDescriptor {
}
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 (description != null) {
_json["description"] = description;
}
@@ -3676,104 +5201,120 @@ class MonitoredResourceDescriptor {
}
}
-/**
- * Complete log information about a single HTTP request to an App Engine
- * application.
- */
+/// Complete log information about a single HTTP request to an App Engine
+/// application.
class RequestLog {
- /** App Engine release version. */
+ /// App Engine release version.
core.String appEngineRelease;
- /** Application that handled this request. */
+
+ /// Application that handled this request.
core.String appId;
- /** An indication of the relative cost of serving this request. */
+
+ /// An indication of the relative cost of serving this request.
core.double cost;
- /** Time when the request finished. */
+
+ /// Time when the request finished.
core.String endTime;
- /** Whether this request is finished or active. */
+
+ /// Whether this request is finished or active.
core.bool finished;
- /**
- * Whether this is the first RequestLog entry for this request. If an active
- * request has several RequestLog entries written to Stackdriver Logging, then
- * this field will be set for one of them.
- */
+
+ /// Whether this is the first RequestLog entry for this request. If an active
+ /// request has several RequestLog entries written to Stackdriver Logging,
+ /// then this field will be set for one of them.
core.bool first;
- /** Internet host and port number of the resource being requested. */
+
+ /// Internet host and port number of the resource being requested.
core.String host;
- /** HTTP version of request. Example: "HTTP/1.1". */
+
+ /// HTTP version of request. Example: "HTTP/1.1".
core.String httpVersion;
- /** An identifier for the instance that handled the request. */
+
+ /// An identifier for the instance that handled the request.
core.String instanceId;
- /**
- * If the instance processing this request belongs to a manually scaled
- * module, then this is the 0-based index of the instance. Otherwise, this
- * value is -1.
- */
+
+ /// If the instance processing this request belongs to a manually scaled
+ /// module, then this is the 0-based index of the instance. Otherwise, this
+ /// value is -1.
core.int instanceIndex;
- /** Origin IP address. */
+
+ /// Origin IP address.
core.String ip;
- /** Latency of the request. */
+
+ /// Latency of the request.
core.String latency;
- /**
- * A list of log lines emitted by the application while serving this request.
- */
+
+ /// A list of log lines emitted by the application while serving this
+ /// request.
core.List<LogLine> line;
- /** Number of CPU megacycles used to process request. */
+
+ /// Number of CPU megacycles used to process request.
core.String megaCycles;
- /** Request method. Example: "GET", "HEAD", "PUT", "POST", "DELETE". */
+
+ /// Request method. Example: "GET", "HEAD", "PUT", "POST", "DELETE".
core.String method;
- /** Module of the application that handled this request. */
+
+ /// Module of the application that handled this request.
core.String moduleId;
- /**
- * The logged-in user who made the request.Most likely, this is the part of
- * the user's email before the @ sign. The field value is the same for
- * different requests from the same user, but different users can have similar
- * names. This information is also available to the application via the App
- * Engine Users API.This field will be populated starting with App Engine
- * 1.9.21.
- */
+
+ /// The logged-in user who made the request.Most likely, this is the part of
+ /// the user's email before the @ sign. The field value is the same for
+ /// different requests from the same user, but different users can have
+ /// similar names. This information is also available to the application via
+ /// the App Engine Users API.This field will be populated starting with App
+ /// Engine 1.9.21.
core.String nickname;
- /** Time this request spent in the pending request queue. */
+
+ /// Time this request spent in the pending request queue.
core.String pendingTime;
- /** Referrer URL of request. */
+
+ /// Referrer URL of request.
core.String referrer;
- /**
- * Globally unique identifier for a request, which is based on the request
- * start time. Request IDs for requests which started later will compare
- * greater as strings than those for requests which started earlier.
- */
+
+ /// Globally unique identifier for a request, which is based on the request
+ /// start time. Request IDs for requests which started later will compare
+ /// greater as strings than those for requests which started earlier.
core.String requestId;
- /**
- * Contains the path and query portion of the URL that was requested. For
- * example, if the URL was "http://example.com/app?name=val", the resource
- * would be "/app?name=val". The fragment identifier, which is identified by
- * the # character, is not included.
- */
+
+ /// Contains the path and query portion of the URL that was requested. For
+ /// example, if the URL was "http://example.com/app?name=val", the resource
+ /// would be "/app?name=val". The fragment identifier, which is identified by
+ /// the # character, is not included.
core.String resource;
- /** Size in bytes sent back to client by request. */
+
+ /// Size in bytes sent back to client by request.
core.String responseSize;
- /**
- * Source code for the application that handled this request. There can be
- * more than one source reference per deployed application if source code is
- * distributed among multiple repositories.
- */
+
+ /// Source code for the application that handled this request. There can be
+ /// more than one source reference per deployed application if source code is
+ /// distributed among multiple repositories.
core.List<SourceReference> sourceReference;
- /** Time when the request started. */
+
+ /// Time when the request started.
core.String startTime;
- /** HTTP response status code. Example: 200, 404. */
+
+ /// HTTP response status code. Example: 200, 404.
core.int status;
- /** Task name of the request, in the case of an offline request. */
+
+ /// Task name of the request, in the case of an offline request.
core.String taskName;
- /** Queue name of the request, in the case of an offline request. */
+
+ /// Queue name of the request, in the case of an offline request.
core.String taskQueueName;
- /** Stackdriver Trace identifier for this request. */
+
+ /// Stackdriver Trace identifier for this request.
core.String traceId;
- /** File or class that handled the request. */
+
+ /// File or class that handled the request.
core.String urlMapEntry;
- /** User agent that made the request. */
+
+ /// User agent that made the request.
core.String userAgent;
- /** Version of the application that handled this request. */
+
+ /// Version of the application that handled this request.
core.String versionId;
- /** Whether this was a loading request for the instance. */
+
+ /// Whether this was a loading request for the instance.
core.bool wasLoadingRequest;
RequestLog();
@@ -3846,7 +5387,9 @@ class RequestLog {
responseSize = _json["responseSize"];
}
if (_json.containsKey("sourceReference")) {
- sourceReference = _json["sourceReference"].map((value) => new SourceReference.fromJson(value)).toList();
+ sourceReference = _json["sourceReference"]
+ .map((value) => new SourceReference.fromJson(value))
+ .toList();
}
if (_json.containsKey("startTime")) {
startTime = _json["startTime"];
@@ -3878,7 +5421,8 @@ class RequestLog {
}
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 (appEngineRelease != null) {
_json["appEngineRelease"] = appEngineRelease;
}
@@ -3946,7 +5490,8 @@ class RequestLog {
_json["responseSize"] = responseSize;
}
if (sourceReference != null) {
- _json["sourceReference"] = sourceReference.map((value) => (value).toJson()).toList();
+ _json["sourceReference"] =
+ sourceReference.map((value) => (value).toJson()).toList();
}
if (startTime != null) {
_json["startTime"] = startTime;
@@ -3979,22 +5524,21 @@ class RequestLog {
}
}
-/** Specifies a location in a source code file. */
+/// Specifies a location in a source code file.
class SourceLocation {
- /**
- * Source file name. Depending on the runtime environment, this might be a
- * simple name or a fully-qualified name.
- */
+ /// Source file name. Depending on the runtime environment, this might be a
+ /// simple name or a fully-qualified name.
core.String file;
- /**
- * Human-readable name of the function or method being invoked, with optional
- * context such as the class or package name. This information is used in
- * contexts such as the logs viewer, where a file and line number are less
- * meaningful. The format can vary by language. For example:
- * qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).
- */
+
+ /// Human-readable name of the function or method being invoked, with
+ /// optional context such as the class or package name. This information is
+ /// used in contexts such as the logs viewer, where a file and line number
+ /// are less meaningful. The format can vary by language. For example:
+ /// qual.if.ied.Class.method (Java), dir/package.func (Go), function
+ /// (Python).
core.String functionName;
- /** Line within the source file. */
+
+ /// Line within the source file.
core.String line;
SourceLocation();
@@ -4012,7 +5556,8 @@ class SourceLocation {
}
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 (file != null) {
_json["file"] = file;
}
@@ -4026,20 +5571,15 @@ class SourceLocation {
}
}
-/**
- * A reference to a particular snapshot of the source tree used to build and
- * deploy an application.
- */
+/// A reference to a particular snapshot of the source tree used to build and
+/// deploy an application.
class SourceReference {
- /**
- * Optional. A URI string identifying the repository. Example:
- * "https://github.com/GoogleCloudPlatform/kubernetes.git"
- */
+ /// Optional. A URI string identifying the repository. Example:
+ /// "https://github.com/GoogleCloudPlatform/kubernetes.git"
core.String repository;
- /**
- * The canonical and persistent identifier of the deployed revision. Example
- * (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"
- */
+
+ /// The canonical and persistent identifier of the deployed revision. Example
+ /// (git): "0035781c50ec7aa23385dc841529ce8a4b70db1b"
core.String revisionId;
SourceReference();
@@ -4054,7 +5594,8 @@ class SourceReference {
}
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 (repository != null) {
_json["repository"] = repository;
}
@@ -4065,64 +5606,66 @@ class SourceReference {
}
}
-/** The parameters to WriteLogEntries. */
+/// The parameters to WriteLogEntries.
class WriteLogEntriesRequest {
- /**
- * Required. The log entries to write. Values supplied for the fields
- * log_name, resource, and labels in this entries.write request are inserted
- * into those log entries in this list that do not provide their own
- * values.Stackdriver Logging also creates and inserts values for timestamp
- * and insert_id if the entries do not provide them. The created insert_id for
- * the N'th entry in this list will be greater than earlier entries and less
- * than later entries. Otherwise, the order of log entries in this list does
- * not matter.To improve throughput and to avoid exceeding the quota limit for
- * calls to entries.write, you should write multiple log entries at once
- * rather than calling this method for each individual log entry.
- */
+ /// Required. The log entries to send to Stackdriver Logging. The order of
+ /// log entries in this list does not matter. Values supplied in this
+ /// method's log_name, resource, and labels fields are copied into those log
+ /// entries in this list that do not include values for their corresponding
+ /// fields. For more information, see the LogEntry type.If the timestamp or
+ /// insert_id fields are missing in log entries, then this method supplies
+ /// the current time or a unique identifier, respectively. The supplied
+ /// values are chosen so that, among the log entries that did not supply
+ /// their own values, the entries earlier in the list will sort before the
+ /// entries later in the list. See the entries.list method.Log entries with
+ /// timestamps that are more than the logs retention period in the past or
+ /// more than 24 hours in the future might be discarded. Discarding does not
+ /// return an error.To improve throughput and to avoid exceeding the quota
+ /// limit for calls to entries.write, you should try to include several log
+ /// entries in this list, rather than calling this method for each individual
+ /// log entry.
core.List<LogEntry> entries;
- /**
- * Optional. Default labels that are added to the labels field of all log
- * entries in entries. If a log entry already has a label with the same key as
- * a label in this parameter, then the log entry's label is not changed. See
- * LogEntry.
- */
+
+ /// Optional. Default labels that are added to the labels field of all log
+ /// entries in entries. If a log entry already has a label with the same key
+ /// as a label in this parameter, then the log entry's label is not changed.
+ /// See LogEntry.
core.Map<core.String, core.String> labels;
- /**
- * Optional. A default log resource name that is assigned to all log entries
- * in entries that do not specify a value for log_name:
- * "projects/[PROJECT_ID]/logs/[LOG_ID]"
- * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
- * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
- * "folders/[FOLDER_ID]/logs/[LOG_ID]"
- * [LOG_ID] must be URL-encoded. For example,
- * "projects/my-project-id/logs/syslog" or
- * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
- * For more information about log names, see LogEntry.
- */
+
+ /// Optional. A default log resource name that is assigned to all log entries
+ /// in entries that do not specify a value for log_name:
+ /// "projects/[PROJECT_ID]/logs/[LOG_ID]"
+ /// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+ /// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+ /// "folders/[FOLDER_ID]/logs/[LOG_ID]"
+ /// [LOG_ID] must be URL-encoded. For example,
+ /// "projects/my-project-id/logs/syslog" or
+ /// "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
+ /// For more information about log names, see LogEntry.
core.String logName;
- /**
- * Optional. Whether valid entries should be written even if some other
- * entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
- * entry is not written, then the response status is the error associated with
- * one of the failed entries and the response includes error details keyed by
- * the entries' zero-based index in the entries.write method.
- */
+
+ /// Optional. Whether valid entries should be written even if some other
+ /// entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
+ /// entry is not written, then the response status is the error associated
+ /// with one of the failed entries and the response includes error details
+ /// keyed by the entries' zero-based index in the entries.write method.
core.bool partialSuccess;
- /**
- * Optional. A default monitored resource object that is assigned to all log
- * entries in entries that do not specify a value for resource. Example:
- * { "type": "gce_instance",
- * "labels": {
- * "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
- * See LogEntry.
- */
+
+ /// Optional. A default monitored resource object that is assigned to all log
+ /// entries in entries that do not specify a value for resource. Example:
+ /// { "type": "gce_instance",
+ /// "labels": {
+ /// "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
+ /// See LogEntry.
MonitoredResource resource;
WriteLogEntriesRequest();
WriteLogEntriesRequest.fromJson(core.Map _json) {
if (_json.containsKey("entries")) {
- entries = _json["entries"].map((value) => new LogEntry.fromJson(value)).toList();
+ entries = _json["entries"]
+ .map((value) => new LogEntry.fromJson(value))
+ .toList();
}
if (_json.containsKey("labels")) {
labels = _json["labels"];
@@ -4139,7 +5682,8 @@ class WriteLogEntriesRequest {
}
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 (entries != null) {
_json["entries"] = entries.map((value) => (value).toJson()).toList();
}
@@ -4159,16 +5703,15 @@ class WriteLogEntriesRequest {
}
}
-/** Result returned from WriteLogEntries. empty */
+/// Result returned from WriteLogEntries. empty
class WriteLogEntriesResponse {
-
WriteLogEntriesResponse();
- WriteLogEntriesResponse.fromJson(core.Map _json) {
- }
+ WriteLogEntriesResponse.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/lib/licensing/v1.dart ('k') | generated/googleapis/lib/manufacturers/v1.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698