Api-roll 43: 2016-12-13

generated/googleapis/lib/logging/v2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.logging.v2;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 18 matching lines @@
   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);
   EntriesResourceApi get entries => new EntriesResourceApi(_requester);
+  FoldersResourceApi get folders => new FoldersResourceApi(_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);
 }
 
 
 class BillingAccountsResourceApi {
   final commons.ApiRequester _requester;
 
   BillingAccountsLogsResourceApi get logs => new BillingAccountsLogsResourceApi(_requester);
   BillingAccountsSinksResourceApi get sinks => new BillingAccountsSinksResourceApi(_requester);
 
   BillingAccountsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 }
 
 
 class BillingAccountsLogsResourceApi {
   final commons.ApiRequester _requester;
 
   BillingAccountsLogsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes a log and all its log entries.
-   * The log will reappear if it receives new entries.
+   * Deletes all the log entries in a log. The log reappears if it receives new
+   * entries.
    *
    * Request parameters:
    *
-   * [logName] - Required. The resource name of the log to delete.  Example:
-   * `"projects/my-project/logs/syslog"`.
+   * [logName] - Required. The resource name of the log to delete:
+   * "projects/[PROJECT_ID]/logs/[LOG_ID]"
+   * "organizations/[ORGANIZATION_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.
    */
@@ skipping 14 matching lines @@
     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 or organizations. Only logs that have entries
+   * are listed.
+   *
+   * Request parameters:
+   *
+   * [parent] - Required. The resource name that owns the logs:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   *
+   * Value must have pattern "^billingAccounts/[^/]+$".
+   *
+   * [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.
+   *
+   * [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.
+   *
+   * 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.int pageSize, core.String pageToken}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (parent == null) {
+      throw new core.ArgumentError("Parameter parent is required.");
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
+
+    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.
+   * 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.
-   * Example: `"projects/my-project-id"`.
-   * The new sink must be provided in the request.
+   * [parent] - Required. The resource in which to create the sink:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^billingAccounts/[^/]+$".
    *
-   * [uniqueWriterIdentity] - Optional. Whether the sink will have a dedicated
-   * service account returned
-   * in the sink's writer_identity. Set this field to be true to export
-   * logs from one project to a different project. This field is ignored for
-   * non-project sinks (e.g. organization sinks) because those sinks are
-   * required to have dedicated service accounts.
+   * [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 cloud-logs@google.com, the same identity
+   * used 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}) {
@@ skipping 20 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
   /**
-   * Deletes a sink.
+   * Deletes a sink. If the sink has a unique writer_identity, then that service
+   * account is also deleted.
    *
    * Request parameters:
    *
-   * [sinkName] - Required. The resource name of the sink to delete, including
-   * the parent
-   * resource and the sink identifier.  Example:
-   * `"projects/my-project-id/sinks/my-sink-id"`.  It is an error if the sink
-   * does not exist.
+   * [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]"
+   * It is an error if the sink does not exist. Example:
+   * "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does
+   * not exist.
    * 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.
    */
@@ skipping 19 matching lines @@
                                        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 to return.
-   * Example: `"projects/my-project-id/sinks/my-sink-id"`.
+   * [sinkName] - Required. The parent resource name of the sink:
+   * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+   * "organizations/[ORGANIZATION_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.
    */
@@ skipping 19 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
   /**
    * Lists sinks.
    *
    * Request parameters:
    *
-   * [parent] - Required. The resource name where this sink was created.
-   * Example: `"projects/my-logging-project"`.
+   * [parent] - Required. The parent resource whose sinks are to be listed.
+   * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^billingAccounts/[^/]+$".
    *
    * [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.
+   * request. Non-positive values are ignored. The presence of nextPageToken in
+   * the response indicates that more results might be available.
    *
    * [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
+   * 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.
    *
    * 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.
    */
@@ skipping 21 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListSinksResponse.fromJson(data));
   }
 
   /**
-   * Updates or creates a sink.
+   * Updates a sink. If the named sink doesn't exist, then this method is
+   * identical to sinks.create. If the named sink does exist, then 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 filter might also have a new writer_identity; see the
+   * unique_writer_identity field.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [sinkName] - Required. The resource name of the sink to update, including
-   * the parent
-   * resource and the sink identifier.  If the sink does not exist, this method
-   * creates the sink.  Example: `"projects/my-project-id/sinks/my-sink-id"`.
+   * [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]"
+   * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^billingAccounts/[^/]+/sinks/[^/]+$".
    *
-   * [uniqueWriterIdentity] - Optional. Whether the sink will have a dedicated
-   * service account returned
-   * in the sink's writer_identity. Set this field to be true to export
-   * logs from one project to a different project. This field is ignored for
-   * non-project sinks (e.g. organization sinks) because those sinks are
-   * required to have dedicated service accounts.
+   * [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 was 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 was true and the new value is 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}) {
+    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 (sinkName == null) {
+      throw new core.ArgumentError("Parameter sinkName is required.");
+    }
+    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);
+    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.
+   */
+  async.Future<ListLogEntriesResponse> list(ListLogEntriesRequest request) {
+    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());
+    }
+
+    _url = 'v2/entries:list';
+
+    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. All log entries are written by
+   * this method.
+   *
+   * [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();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+
+    _url = 'v2/entries:write';
+
+    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;
+
+  FoldersLogsResourceApi get logs => new FoldersLogsResourceApi(_requester);
+  FoldersSinksResourceApi get sinks => new FoldersSinksResourceApi(_requester);
+
+  FoldersResourceApi(commons.ApiRequester client) : 
+      _requester = client;
+}
+
+
+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.
+   *
+   * Request parameters:
+   *
+   * [logName] - Required. The resource name of the log to delete:
+   * "projects/[PROJECT_ID]/logs/[LOG_ID]"
+   * "organizations/[ORGANIZATION_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();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (logName == null) {
+      throw new core.ArgumentError("Parameter logName is required.");
+    }
+
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$logName');
+
+    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 or organizations. Only logs that have entries
+   * are listed.
+   *
+   * Request parameters:
+   *
+   * [parent] - Required. The resource name that owns the logs:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   *
+   * Value must have pattern "^folders/[^/]+$".
+   *
+   * [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.
+   *
+   * [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.
+   *
+   * 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.int pageSize, core.String pageToken}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (parent == null) {
+      throw new core.ArgumentError("Parameter parent is required.");
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
+
+    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]"
+   * 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 cloud-logs@google.com, the same identity
+   * used 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;
+    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.");
+    }
+    if (uniqueWriterIdentity != null) {
+      _queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
+    }
+
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
+
+    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]"
+   * It is an error if the sink does not exist. Example:
+   * "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does
+   * not exist.
+   * 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();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (sinkName == null) {
+      throw new core.ArgumentError("Parameter sinkName is required.");
+    }
+
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
+
+    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 parent resource name of the sink:
+   * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+   * "organizations/[ORGANIZATION_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> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
+  async.Future<LogSink> get(core.String sinkName) {
     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 (sinkName == null) {
       throw new core.ArgumentError("Parameter sinkName is required.");
     }
-    if (uniqueWriterIdentity != null) {
-      _queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
-    }
 
     _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
 
     var _response = _requester.request(_url,
-                                       "PUT",
+                                       "GET",
                                        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 Cloud
-   * Logging.  For ways to export log entries, see
-   * [Exporting Logs](/logging/docs/export).
-   *
-   * [request] - The metadata request object.
+   * Lists sinks.
    *
    * Request parameters:
    *
-   * Completes with a [ListLogEntriesResponse].
+   * [parent] - Required. The parent resource whose sinks are to be listed.
+   * Examples: "projects/my-logging-project", "organizations/123456789".
+   * Value must have pattern "^folders/[^/]+$".
+   *
+   * [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.
+   *
+   * [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.
+   *
+   * 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<ListLogEntriesResponse> list(ListLogEntriesRequest request) {
+  async.Future<ListSinksResponse> list(core.String parent, {core.int pageSize, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
-    if (request != null) {
-      _body = convert.JSON.encode((request).toJson());
+    if (parent == null) {
+      throw new core.ArgumentError("Parameter parent is required.");
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
     }
 
-    _url = 'v2/entries:list';
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
 
     var _response = _requester.request(_url,
-                                       "POST",
+                                       "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
-    return _response.then((data) => new ListLogEntriesResponse.fromJson(data));
+    return _response.then((data) => new ListSinksResponse.fromJson(data));
   }
 
   /**
-   * Writes log entries to Stackdriver Logging.  All log entries are
-   * written by this method.
+   * Updates a sink. If the named sink doesn't exist, then this method is
+   * identical to sinks.create. If the named sink does exist, then 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 filter might also have a new writer_identity; see the
+   * unique_writer_identity field.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * Completes with a [WriteLogEntriesResponse].
+   * [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]"
+   * 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 was 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 was true and the new value is 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<WriteLogEntriesResponse> write(WriteLogEntriesRequest request) {
+  async.Future<LogSink> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
     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 (sinkName == null) {
+      throw new core.ArgumentError("Parameter sinkName is required.");
+    }
+    if (uniqueWriterIdentity != null) {
+      _queryParams["uniqueWriterIdentity"] = ["${uniqueWriterIdentity}"];
+    }
 
-    _url = 'v2/entries:write';
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$sinkName');
 
     var _response = _requester.request(_url,
-                                       "POST",
+                                       "PUT",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
-    return _response.then((data) => new WriteLogEntriesResponse.fromJson(data));
+    return _response.then((data) => new LogSink.fromJson(data));
   }
 
 }
 
 
 class MonitoredResourceDescriptorsResourceApi {
   final commons.ApiRequester _requester;
 
   MonitoredResourceDescriptorsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Lists the monitored resource descriptors used by Stackdriver Logging.
+   * Lists the descriptors for monitored resource types used by Stackdriver
+   * Logging.
    *
    * Request parameters:
    *
    * [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.
+   * request. Non-positive values are ignored. The presence of nextPageToken in
+   * the response indicates that more results might be available.
    *
    * [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
+   * 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.
    *
    * 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.
    */
@@ skipping 38 matching lines @@
 }
 
 
 class OrganizationsLogsResourceApi {
   final commons.ApiRequester _requester;
 
   OrganizationsLogsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes a log and all its log entries.
-   * The log will reappear if it receives new entries.
+   * Deletes all the log entries in a log. The log reappears if it receives new
+   * entries.
    *
    * Request parameters:
    *
-   * [logName] - Required. The resource name of the log to delete.  Example:
-   * `"projects/my-project/logs/syslog"`.
+   * [logName] - Required. The resource name of the log to delete:
+   * "projects/[PROJECT_ID]/logs/[LOG_ID]"
+   * "organizations/[ORGANIZATION_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.
    */
@@ skipping 14 matching lines @@
     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 or organizations. Only logs that have entries
+   * are listed.
+   *
+   * Request parameters:
+   *
+   * [parent] - Required. The resource name that owns the logs:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   *
+   * Value must have pattern "^organizations/[^/]+$".
+   *
+   * [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.
+   *
+   * [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.
+   *
+   * 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.int pageSize, core.String pageToken}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (parent == null) {
+      throw new core.ArgumentError("Parameter parent is required.");
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
+
+    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.
+   * 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.
-   * Example: `"projects/my-project-id"`.
-   * The new sink must be provided in the request.
+   * [parent] - Required. The resource in which to create the sink:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^organizations/[^/]+$".
    *
-   * [uniqueWriterIdentity] - Optional. Whether the sink will have a dedicated
-   * service account returned
-   * in the sink's writer_identity. Set this field to be true to export
-   * logs from one project to a different project. This field is ignored for
-   * non-project sinks (e.g. organization sinks) because those sinks are
-   * required to have dedicated service accounts.
+   * [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 cloud-logs@google.com, the same identity
+   * used 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}) {
@@ skipping 20 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
   /**
-   * Deletes a sink.
+   * Deletes a sink. If the sink has a unique writer_identity, then that service
+   * account is also deleted.
    *
    * Request parameters:
    *
-   * [sinkName] - Required. The resource name of the sink to delete, including
-   * the parent
-   * resource and the sink identifier.  Example:
-   * `"projects/my-project-id/sinks/my-sink-id"`.  It is an error if the sink
-   * does not exist.
+   * [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]"
+   * It is an error if the sink does not exist. Example:
+   * "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does
+   * not exist.
    * 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.
    */
@@ skipping 19 matching lines @@
                                        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 to return.
-   * Example: `"projects/my-project-id/sinks/my-sink-id"`.
+   * [sinkName] - Required. The parent resource name of the sink:
+   * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+   * "organizations/[ORGANIZATION_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.
    */
@@ skipping 19 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
   /**
    * Lists sinks.
    *
    * Request parameters:
    *
-   * [parent] - Required. The resource name where this sink was created.
-   * Example: `"projects/my-logging-project"`.
+   * [parent] - Required. The parent resource whose sinks are to be listed.
+   * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^organizations/[^/]+$".
    *
    * [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.
+   * request. Non-positive values are ignored. The presence of nextPageToken in
+   * the response indicates that more results might be available.
    *
    * [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
+   * 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.
    *
    * 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.
    */
@@ skipping 21 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListSinksResponse.fromJson(data));
   }
 
   /**
-   * Updates or creates a sink.
+   * Updates a sink. If the named sink doesn't exist, then this method is
+   * identical to sinks.create. If the named sink does exist, then 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 filter might also have a new writer_identity; see the
+   * unique_writer_identity field.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [sinkName] - Required. The resource name of the sink to update, including
-   * the parent
-   * resource and the sink identifier.  If the sink does not exist, this method
-   * creates the sink.  Example: `"projects/my-project-id/sinks/my-sink-id"`.
+   * [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]"
+   * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^organizations/[^/]+/sinks/[^/]+$".
    *
-   * [uniqueWriterIdentity] - Optional. Whether the sink will have a dedicated
-   * service account returned
-   * in the sink's writer_identity. Set this field to be true to export
-   * logs from one project to a different project. This field is ignored for
-   * non-project sinks (e.g. organization sinks) because those sinks are
-   * required to have dedicated service accounts.
+   * [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 was 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 was true and the new value is 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}) {
@@ skipping 41 matching lines @@
 }
 
 
 class ProjectsLogsResourceApi {
   final commons.ApiRequester _requester;
 
   ProjectsLogsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes a log and all its log entries.
-   * The log will reappear if it receives new entries.
+   * Deletes all the log entries in a log. The log reappears if it receives new
+   * entries.
    *
    * Request parameters:
    *
-   * [logName] - Required. The resource name of the log to delete.  Example:
-   * `"projects/my-project/logs/syslog"`.
+   * [logName] - Required. The resource name of the log to delete:
+   * "projects/[PROJECT_ID]/logs/[LOG_ID]"
+   * "organizations/[ORGANIZATION_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.
    */
@@ skipping 14 matching lines @@
     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 or organizations. Only logs that have entries
+   * are listed.
+   *
+   * Request parameters:
+   *
+   * [parent] - Required. The resource name that owns the logs:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   *
+   * Value must have pattern "^projects/[^/]+$".
+   *
+   * [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.
+   *
+   * [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.
+   *
+   * 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.int pageSize, core.String pageToken}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (parent == null) {
+      throw new core.ArgumentError("Parameter parent is required.");
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+
+    _url = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
+
+    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.
-   * Example: `"projects/my-project-id"`.
-   *
+   * [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.
@@ skipping 23 matching lines @@
                                        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.
-   * Example: `"projects/my-project-id/metrics/my-metric-id"`.
+   * [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.
    */
@@ skipping 19 matching lines @@
                                        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.
-   * Example: `"projects/my-project-id/metrics/my-metric-id"`.
+   * [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.
    */
@@ skipping 19 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogMetric.fromJson(data));
   }
 
   /**
    * Lists logs-based metrics.
    *
    * Request parameters:
    *
-   * [parent] - Required. The resource name containing the metrics.
-   * Example: `"projects/my-project-id"`.
+   * [parent] - Required. The name of the project containing the metrics:
+   * "projects/[PROJECT_ID]"
+   *
    * Value must have pattern "^projects/[^/]+$".
    *
    * [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.
+   * request. Non-positive values are ignored. The presence of nextPageToken in
+   * the response indicates that more results might be available.
    *
    * [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
+   * 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.
    *
    * 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.
    */
@@ skipping 27 matching lines @@
     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.
-   * Example: `"projects/my-project-id/metrics/my-metric-id"`.
-   *
-   * The updated metric must be provided in the request and have the
-   * same identifier that is specified in `metricName`.
-   * If the metric does not exist, it is created.
+   * [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.
    */
@@ skipping 27 matching lines @@
 }
 
 
 class ProjectsSinksResourceApi {
   final commons.ApiRequester _requester;
 
   ProjectsSinksResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Creates a sink.
+   * 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.
-   * Example: `"projects/my-project-id"`.
-   * The new sink must be provided in the request.
+   * [parent] - Required. The resource in which to create the sink:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^projects/[^/]+$".
    *
-   * [uniqueWriterIdentity] - Optional. Whether the sink will have a dedicated
-   * service account returned
-   * in the sink's writer_identity. Set this field to be true to export
-   * logs from one project to a different project. This field is ignored for
-   * non-project sinks (e.g. organization sinks) because those sinks are
-   * required to have dedicated service accounts.
+   * [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 cloud-logs@google.com, the same identity
+   * used 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}) {
@@ skipping 20 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
   /**
-   * Deletes a sink.
+   * Deletes a sink. If the sink has a unique writer_identity, then that service
+   * account is also deleted.
    *
    * Request parameters:
    *
-   * [sinkName] - Required. The resource name of the sink to delete, including
-   * the parent
-   * resource and the sink identifier.  Example:
-   * `"projects/my-project-id/sinks/my-sink-id"`.  It is an error if the sink
-   * does not exist.
+   * [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]"
+   * It is an error if the sink does not exist. Example:
+   * "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does
+   * not exist.
    * 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.
    */
@@ skipping 19 matching lines @@
                                        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 to return.
-   * Example: `"projects/my-project-id/sinks/my-sink-id"`.
+   * [sinkName] - Required. The parent resource name of the sink:
+   * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+   * "organizations/[ORGANIZATION_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.
    */
@@ skipping 19 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
   /**
    * Lists sinks.
    *
    * Request parameters:
    *
-   * [parent] - Required. The resource name where this sink was created.
-   * Example: `"projects/my-logging-project"`.
+   * [parent] - Required. The parent resource whose sinks are to be listed.
+   * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^projects/[^/]+$".
    *
    * [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.
+   * request. Non-positive values are ignored. The presence of nextPageToken in
+   * the response indicates that more results might be available.
    *
    * [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
+   * 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.
    *
    * 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.
    */
@@ skipping 21 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListSinksResponse.fromJson(data));
   }
 
   /**
-   * Updates or creates a sink.
+   * Updates a sink. If the named sink doesn't exist, then this method is
+   * identical to sinks.create. If the named sink does exist, then 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 filter might also have a new writer_identity; see the
+   * unique_writer_identity field.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [sinkName] - Required. The resource name of the sink to update, including
-   * the parent
-   * resource and the sink identifier.  If the sink does not exist, this method
-   * creates the sink.  Example: `"projects/my-project-id/sinks/my-sink-id"`.
+   * [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]"
+   * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
    *
-   * [uniqueWriterIdentity] - Optional. Whether the sink will have a dedicated
-   * service account returned
-   * in the sink's writer_identity. Set this field to be true to export
-   * logs from one project to a different project. This field is ignored for
-   * non-project sinks (e.g. organization sinks) because those sinks are
-   * required to have dedicated service accounts.
+   * [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 was 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 was true and the new value is 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}) {
@@ skipping 25 matching lines @@
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
 }
 
 
 
 /**
  * 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 `{}`.
+ * 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 toJson() {
     var _json = new core.Map();
     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.
    */
   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. */
   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
+   * 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.
    */
   core.String latency;
   /**
-   * 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.
    */
   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.
    */
   core.String responseSize;
   /**
    * 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();
 
   HttpRequest.fromJson(core.Map _json) {
     if (_json.containsKey("cacheFillBytes")) {
       cacheFillBytes = _json["cacheFillBytes"];
     }
     if (_json.containsKey("cacheHit")) {
@@ skipping 122 matching lines @@
     if (key != null) {
       _json["key"] = key;
     }
     if (valueType != null) {
       _json["valueType"] = valueType;
     }
     return _json;
   }
 }
 
-/** The parameters to `ListLogEntries`. */
+/** The parameters to ListLogEntries. */
 class ListLogEntriesRequest {
   /**
-   * Optional. A filter that chooses which log entries to return.  See [Advanced
-   * Logs Filters](/logging/docs/view/advanced_filters).  Only log entries that
-   * match the filter are returned.  An empty filter matches all log entries.
+   * 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 `LogEntry.insertId`.
+   * 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 LogEntry.insertId.
    */
   core.String orderBy;
   /**
    * Optional. The maximum number of results to return from this request.
-   * Non-positive values are ignored.  The presence of `nextPageToken` in the
+   * Non-positive values are ignored. The presence of nextPageToken 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.  `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.
+   * 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.
    */
   core.String pageToken;
   /**
-   * Deprecated. One or more project identifiers or project numbers from which
-   * to retrieve log entries.  Examples: `"my-project-1A"`, `"1234567890"`. If
-   * present, these project identifiers are converted to resource format and
-   * added to the list of resources in `resourceNames`. Callers should use
-   * `resourceNames` rather than this parameter.
+   * 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. One or more cloud resources from which to retrieve log entries.
-   * Example: `"projects/my-project-1A"`, `"projects/1234567890"`.  Projects
-   * listed in `projectIds` are added to this list.
+   * Required. Names of one or more resources from which to retrieve log
+   * entries:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   * Projects listed in the project_ids field are added to this list.
    */
   core.List<core.String> resourceNames;
 
   ListLogEntriesRequest();
 
   ListLogEntriesRequest.fromJson(core.Map _json) {
     if (_json.containsKey("filter")) {
       filter = _json["filter"];
     }
     if (_json.containsKey("orderBy")) {
@@ skipping 30 matching lines @@
     if (projectIds != null) {
       _json["projectIds"] = projectIds;
     }
     if (resourceNames != null) {
       _json["resourceNames"] = resourceNames;
     }
     return _json;
   }
 }
 
-/** Result returned from `ListLogEntries`. */
+/** Result returned from ListLogEntries. */
 class ListLogEntriesResponse {
   /** A list of log entries. */
   core.List<LogEntry> entries;
   /**
-   * 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 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();
     }
     if (_json.containsKey("nextPageToken")) {
@@ skipping 12 matching lines @@
     return _json;
   }
 }
 
 /** Result returned from ListLogMetrics. */
 class ListLogMetricsResponse {
   /** 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`.
+   * 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();
     }
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (metrics != null) {
       _json["metrics"] = metrics.map((value) => (value).toJson()).toList();
     }
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     return _json;
   }
 }
 
+/** Result returned from ListLogs. */
+class ListLogsResponse {
+  /**
+   * 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.
+   */
+  core.String nextPageToken;
+
+  ListLogsResponse();
+
+  ListLogsResponse.fromJson(core.Map _json) {
+    if (_json.containsKey("logNames")) {
+      logNames = _json["logNames"];
+    }
+    if (_json.containsKey("nextPageToken")) {
+      nextPageToken = _json["nextPageToken"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (logNames != null) {
+      _json["logNames"] = logNames;
+    }
+    if (nextPageToken != null) {
+      _json["nextPageToken"] = nextPageToken;
+    }
+    return _json;
+  }
+}
+
 /** Result returned from ListMonitoredResourceDescriptors. */
 class ListMonitoredResourceDescriptorsResponse {
   /**
-   * 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 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. */
   core.List<MonitoredResourceDescriptor> resourceDescriptors;
 
   ListMonitoredResourceDescriptorsResponse();
 
   ListMonitoredResourceDescriptorsResponse.fromJson(core.Map _json) {
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
     }
     if (_json.containsKey("resourceDescriptors")) {
       resourceDescriptors = _json["resourceDescriptors"].map((value) => new MonitoredResourceDescriptor.fromJson(value)).toList();
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (resourceDescriptors != null) {
       _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`.
+   * 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. */
   core.List<LogSink> sinks;
 
   ListSinksResponse();
 
   ListSinksResponse.fromJson(core.Map _json) {
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
@@ skipping 11 matching lines @@
     if (sinks != null) {
       _json["sinks"] = sinks.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 /** 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 ID for the log entry. If you provide this
-   * field, the logging service considers other log entries in the
-   * same project with the same ID as duplicates which can be removed.  If
-   * omitted, Stackdriver Logging will generate a unique ID for this
-   * log entry.
+   * Optional. A unique ID for the log entry. If you provide this field, the
+   * logging service considers other log entries in the same project with the
+   * same ID as duplicates which can be removed. If omitted, Stackdriver Logging
+   * will generate a unique ID for this log entry.
    */
   core.String insertId;
   /**
-   * The log entry payload, represented as a structure that
-   * is expressed as a JSON object.
+   * 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.
    */
   core.Map<core.String, core.String> labels;
   /**
-   * Required. The resource name of the log to which this log entry
-   * belongs. The format of the name is
-   * `"projects/<project-id>/logs/<log-id>"`.  Examples:
-   * `"projects/my-projectid/logs/syslog"`,
-   * `"projects/my-projectid/logs/library.googleapis.com%2Fbook_log"`.
-   *
-   * The log ID part of resource name must be less than 512 characters
-   * long and can only include the following characters: upper and
-   * lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
-   * characters: forward-slash, underscore, hyphen, and period.
-   * Forward-slash (`/`) characters in the log ID must be URL-encoded.
+   * 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]"
+   * [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.
    */
   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 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;
   /**
-   * 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`.
+   * 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.
+   * 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.
+   */
+  LogEntrySourceLocation sourceLocation;
   /** 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
+   * Optional. The time the event described by the log entry occurred. If
    * omitted, Stackdriver Logging will use the time the log entry is received.
    */
   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
+   */
+  core.String trace;
 
   LogEntry();
 
   LogEntry.fromJson(core.Map _json) {
     if (_json.containsKey("httpRequest")) {
       httpRequest = new HttpRequest.fromJson(_json["httpRequest"]);
     }
     if (_json.containsKey("insertId")) {
       insertId = _json["insertId"];
     }
@@ skipping 11 matching lines @@
     }
     if (_json.containsKey("protoPayload")) {
       protoPayload = _json["protoPayload"];
     }
     if (_json.containsKey("resource")) {
       resource = new MonitoredResource.fromJson(_json["resource"]);
     }
     if (_json.containsKey("severity")) {
       severity = _json["severity"];
     }
+    if (_json.containsKey("sourceLocation")) {
+      sourceLocation = new LogEntrySourceLocation.fromJson(_json["sourceLocation"]);
+    }
     if (_json.containsKey("textPayload")) {
       textPayload = _json["textPayload"];
     }
     if (_json.containsKey("timestamp")) {
       timestamp = _json["timestamp"];
     }
+    if (_json.containsKey("trace")) {
+      trace = _json["trace"];
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (httpRequest != null) {
       _json["httpRequest"] = (httpRequest).toJson();
     }
     if (insertId != null) {
       _json["insertId"] = insertId;
     }
@@ skipping 11 matching lines @@
     }
     if (protoPayload != null) {
       _json["protoPayload"] = protoPayload;
     }
     if (resource != null) {
       _json["resource"] = (resource).toJson();
     }
     if (severity != null) {
       _json["severity"] = severity;
     }
+    if (sourceLocation != null) {
+      _json["sourceLocation"] = (sourceLocation).toJson();
+    }
     if (textPayload != null) {
       _json["textPayload"] = textPayload;
     }
     if (timestamp != null) {
       _json["timestamp"] = timestamp;
     }
+    if (trace != null) {
+      _json["trace"] = trace;
+    }
     return _json;
   }
 }
 
 /**
  * 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.
    */
   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.
    */
   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();
 
   LogEntryOperation.fromJson(core.Map _json) {
     if (_json.containsKey("first")) {
       first = _json["first"];
     }
     if (_json.containsKey("id")) {
@@ skipping 18 matching lines @@
     if (last != null) {
       _json["last"] = last;
     }
     if (producer != null) {
       _json["producer"] = producer;
     }
     return _json;
   }
 }
 
+/**
+ * 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.
+   */
+  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).
+   */
+  core.String function;
+  /**
+   * Optional. Line within the source file. 1-based; 0 indicates no line number
+   * available.
+   */
+  core.String line;
+
+  LogEntrySourceLocation();
+
+  LogEntrySourceLocation.fromJson(core.Map _json) {
+    if (_json.containsKey("file")) {
+      file = _json["file"];
+    }
+    if (_json.containsKey("function")) {
+      function = _json["function"];
+    }
+    if (_json.containsKey("line")) {
+      line = _json["line"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (file != null) {
+      _json["file"] = file;
+    }
+    if (function != null) {
+      _json["function"] = function;
+    }
+    if (line != null) {
+      _json["line"] = line;
+    }
+    return _json;
+  }
+}
+
 /** Application log line emitted while processing a request. */
 class LogLine {
   /** 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.
+   * 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. */
   SourceLocation sourceLocation;
   /** Approximate time when this log entry was made. */
@@ skipping 28 matching lines @@
       _json["sourceLocation"] = (sourceLocation).toJson();
     }
     if (time != null) {
       _json["time"] = time;
     }
     return _json;
   }
 }
 
 /**
- * Describes a logs-based metric.  The value of the metric is the
- * number of log entries that match a logs filter.
+ * 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.
  */
 class LogMetric {
   /**
    * Optional. A description of this metric, which is used in documentation.
    */
   core.String description;
   /**
-   * Required. An [advanced logs filter](/logging/docs/view/advanced_filters).
-   * Example: `"resource.type=gae_app AND severity>=ERROR"`.
+   * 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. Example:
-   * `"severe_errors"`.  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 '%' character
-   * is used to URL encode unsafe and reserved characters and must be
-   * followed by two hexadecimal digits according to RFC 1738.
+   * 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.
-   * The version also dictates the syntax of the filter expression. When a value
-   * for this field is missing, the default value of V2 should be assumed.
+   * Output only. The API version that created or updated this metric. The
+   * version also dictates the syntax of the filter expression. When a value for
+   * this field is missing, the default value of V2 should be assumed.
    * 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("description")) {
@@ skipping 22 matching lines @@
       _json["name"] = name;
     }
     if (version != null) {
       _json["version"] = version;
     }
     return _json;
   }
 }
 
 /**
- * Describes a sink used to export log entries outside of Stackdriver Logging.
- * A logs filter controls which log entries are exported.  Sinks can have a
- * start time and an end time; these can be used to place log entries from an
- * exact time range into a particular destination.  If both `start_time` and
- * `end_time` are present, then `start_time` must be less than `end_time`.
+ * 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 or organization.
  */
 class LogSink {
   /**
-   * Required. The export destination. See
-   * [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-   * Examples:
-   *
-   *     "storage.googleapis.com/my-gcs-bucket"
-   *     "bigquery.googleapis.com/projects/my-project-id/datasets/my-dataset"
-   *     "pubsub.googleapis.com/projects/my-project/topics/my-topic"
+   * 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. Time at which this sink will stop exporting log entries.  If this
-   * value is present, then log entries are exported only if `entry.timestamp` <
-   * `end_time`.
+   * 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.
    */
   core.String endTime;
   /**
-   * Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
-   * Only log entries matching the filter are exported. The filter
-   * must be consistent with the log entry format specified by the
-   * `outputVersionFormat` parameter, regardless of the format of the
-   * log entry that was originally written to Stackdriver Logging.
-   * Example filter (V2 format):
-   *
-   *     logName=projects/my-projectid/logs/syslog 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. 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
    */
   core.String filter;
   /**
-   * Required. The client-assigned sink identifier, unique within the
-   * project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-   * limited to 1000 characters and can include only the following characters:
-   * `A-Z`, `a-z`, `0-9`, and the special characters `_-.`.  The maximum length
-   * of the name is 100 characters.
+   * 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;
   /**
-   * Optional. The log entry version to use for this sink's exported log
-   * entries.  This version does not have to correspond to the version of the
-   * log entry that was written to Stackdriver Logging. If omitted, the
-   * v2 format is used.
+   * Optional. The log entry format to use for this sink's exported log entries.
+   * The v2 format is used by default. The v1 format is deprecated and should be
+   * used only as part of a migration effort to v2. See Migration to the v2 API.
    * Possible string values are:
-   * - "VERSION_FORMAT_UNSPECIFIED" : An unspecified version format will default
-   * to V2.
-   * - "V2" : `LogEntry` version 2 format.
-   * - "V1" : `LogEntry` version 1 format.
+   * - "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.  If
-   * this value is present, then log entries are exported only if `start_time`
-   * <=`entry.timestamp`.
+   * 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.
    */
   core.String startTime;
   /**
-   * Output only. An IAM identity&mdash;a service account or group&mdash;that
-   * will write exported log entries to the destination on behalf of Stackdriver
-   * Logging. You must grant this identity write-access to the destination.
-   * Consult the destination service's documentation to determine the exact role
-   * that must be granted.
+   * Output only. An IAM identity&mdash;a service account or group&mdash;under
+   * which Stackdriver Logging writes the exported log entries to the sink's
+   * destination. This field is set by sinks.create and sinks.update, based on
+   * the setting of unique_writer_identity in those methods.Until you grant this
+   * identity write-access to the destination, log entry exports from this sink
+   * will fail. For more information, see Granting access for a resource.
+   * Consult the destination service's documentation to determine the
+   * appropriate IAM roles to assign to the identity.
    */
   core.String writerIdentity;
 
   LogSink();
 
   LogSink.fromJson(core.Map _json) {
     if (_json.containsKey("destination")) {
       destination = _json["destination"];
     }
     if (_json.containsKey("endTime")) {
@@ skipping 39 matching lines @@
     if (writerIdentity != null) {
       _json["writerIdentity"] = writerIdentity;
     }
     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" }}
+ * 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, Cloud SQL databases use the labels
-   * `"database_id"` and `"zone"`.
+   * "database_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 Cloud SQL database is `"cloudsql_database"`.
+   * Required. The monitored resource type. This field must match the type field
+   * of a MonitoredResourceDescriptor object. For example, the type of a Cloud
+   * SQL database is "cloudsql_database".
    */
   core.String type;
 
   MonitoredResource();
 
   MonitoredResource.fromJson(core.Map _json) {
     if (_json.containsKey("labels")) {
       labels = _json["labels"];
     }
     if (_json.containsKey("type")) {
       type = _json["type"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (labels != null) {
       _json["labels"] = labels;
     }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
 /**
  * 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.
+ * 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.
    */
   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"`.
+   * 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"`.
+   * 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}"`.
+   * "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.
+   * "cloudsql_database" represents databases in Google Cloud SQL. The maximum
+   * length of this value is 256 characters.
    */
   core.String type;
 
   MonitoredResourceDescriptor();
 
   MonitoredResourceDescriptor.fromJson(core.Map _json) {
     if (_json.containsKey("description")) {
       description = _json["description"];
     }
     if (_json.containsKey("displayName")) {
@@ skipping 40 matching lines @@
   core.String appEngineRelease;
   /** Application that handled this request. */
   core.String appId;
   /** An indication of the relative cost of serving this request. */
   core.double cost;
   /** Time when the request finished. */
   core.String endTime;
   /** 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 Cloud Logging, 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. */
   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. */
   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.
    */
   core.int instanceIndex;
   /** Origin IP address. */
   core.String ip;
   /** Latency of the request. */
   core.String latency;
   /**
    * 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. */
   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. */
   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. */
   core.String pendingTime;
   /** 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
+   * 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.
+   * 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. */
   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.
    */
   core.List<SourceReference> sourceReference;
   /** Time when the request started. */
   core.String startTime;
   /** HTTP response status code. Example: 200, 404. */
   core.int status;
   /** 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. */
   core.String taskQueueName;
-  /** Cloud Trace identifier for this request. */
+  /** Stackdriver Trace identifier for this request. */
   core.String traceId;
   /** File or class that handled the request. */
   core.String urlMapEntry;
   /** User agent that made the request. */
   core.String userAgent;
   /** Version of the application that handled this request. */
   core.String versionId;
   /** Whether this was a loading request for the instance. */
   core.bool wasLoadingRequest;
 
@@ skipping 205 matching lines @@
   /**
    * 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).
+   * qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).
    */
   core.String functionName;
   /** Line within the source file. */
   core.String line;
 
   SourceLocation();
 
   SourceLocation.fromJson(core.Map _json) {
     if (_json.containsKey("file")) {
       file = _json["file"];
@@ skipping 20 matching lines @@
     return _json;
   }
 }
 
 /**
  * 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();
 
   SourceReference.fromJson(core.Map _json) {
     if (_json.containsKey("repository")) {
       repository = _json["repository"];
     }
     if (_json.containsKey("revisionId")) {
@@ skipping 10 matching lines @@
       _json["revisionId"] = revisionId;
     }
     return _json;
   }
 }
 
 /** 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
-   * added to those log entries that do not provide their own values for the
-   * fields.
-   *
-   * To improve throughput and to avoid exceeding the
-   * [quota limit](/logging/quota-policy) for calls to `entries.write`,
-   * you should write multiple log entries at once rather than
+   * log_name, resource, and labels in this entries.write request are added to
+   * those log entries that do not provide their own values for the fields.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.
    */
   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`.  Example:
-   * `"projects/my-project/logs/syslog"`.  See
-   * LogEntry.
+   * in entries that do not specify a value for log_name:
+   * "projects/[PROJECT_ID]/logs/[LOG_ID]"
+   * "organizations/[ORGANIZATION_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, the response status will be the error associated
-   * with one of the failed entries and include error details in the form of
+   * entry is not written, the response status will be the error associated with
+   * one of the failed entries and include error details in the form of
    * WriteLogEntriesPartialErrors.
    */
   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" }}
-   *
+   * 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();
     }
@@ skipping 25 matching lines @@
     if (partialSuccess != null) {
       _json["partialSuccess"] = partialSuccess;
     }
     if (resource != null) {
       _json["resource"] = (resource).toJson();
     }
     return _json;
   }
 }
 
-/**
- * Result returned from WriteLogEntries.
- * empty
- */
+/** Result returned from WriteLogEntries. empty */
 class WriteLogEntriesResponse {
 
   WriteLogEntriesResponse();
 
   WriteLogEntriesResponse.fromJson(core.Map _json) {
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     return _json;
   }
 }