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—a service account or group—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—a service account or group—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; |
} |
} |