google-api-client 0.9.8 → 0.10.2

data/generated/google/apis/logging_v2beta1/service.rb

@@ -20,9 +20,9 @@ require 'google/apis/errors'
 module Google
   module Apis
     module LoggingV2beta1
-      # Google Cloud Logging API
+      # Stackdriver Logging API
       #
-      # Writes log entries and manages your logs, log sinks, and logs-based metrics.
+      # Writes log entries and manages your Stackdriver Logging configuration.
       #
       # @example
       #    require 'google/apis/logging_v2beta1'
@@ -46,11 +46,56 @@ module Google
           super('https://logging.googleapis.com/', '')
         end
         
-        # Deletes a log and all its log entries. The log will reappear if it receives
-        # new entries.
+        # Lists the descriptors for monitored resource types used by Stackdriver Logging.
+        # @param [String] page_token
+        #   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.
+        # @param [Fixnum] page_size
+        #   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.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_monitored_resource_descriptors(page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/monitoredResourceDescriptors', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes all the log entries in a log. The log reappears if it receives new
+        # entries. Log entries written shortly before the delete operation might not be
+        # deleted.
         # @param [String] log_name
-        #   Required. The resource name of the log to delete. Example: `"projects/my-
-        #   project/logs/syslog"`.
+        #   Required. The resource name of the log to delete:
+        #   "projects/[PROJECT_ID]/logs/[LOG_ID]"
+        #   "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+        #   "folders/[FOLDER_ID]/logs/[LOG_ID]"
+        #   [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
+        #   , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
+        #   2Factivity". For more information about log names, see LogEntry.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -68,7 +113,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
+        def delete_organization_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:delete, 'v2beta1/{+logName}', options)
           command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
           command.response_class = Google::Apis::LoggingV2beta1::Empty
@@ -78,20 +123,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists sinks.
-        # @param [String] project_name
-        #   Required. The resource name of the project containing the sinks. Example: `"
-        #   projects/my-logging-project"`.
+        # Lists the logs in projects, organizations, folders, or billing accounts. Only
+        # logs that have entries are listed.
+        # @param [String] parent
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [String] page_token
-        #   Optional. If the `pageToken` parameter is supplied, then the next page of
-        #   results is retrieved. The `pageToken` parameter must be set to the value of
-        #   the `nextPageToken` from the previous response. The value of `projectName`
-        #   must be the same as in the previous request.
+        #   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.
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of results to return from this request. You must
-        #   check for presence of `nextPageToken` to determine if additional results are
-        #   available, which you can retrieve by passing the `nextPageToken` value as the `
-        #   pageToken` parameter in the next request.
+        #   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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -101,19 +149,19 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::ListSinksResponse] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogsResponse] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::ListSinksResponse]
+        # @return [Google::Apis::LoggingV2beta1::ListLogsResponse]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_project_sinks(project_name, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v2beta1/{+projectName}/sinks', options)
-          command.response_representation = Google::Apis::LoggingV2beta1::ListSinksResponse::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::ListSinksResponse
-          command.params['projectName'] = project_name unless project_name.nil?
+        def list_organization_logs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/{+parent}/logs', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::ListLogsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::ListLogsResponse
+          command.params['parent'] = parent unless parent.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -121,10 +169,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a sink.
-        # @param [String] sink_name
-        #   The resource name of the sink to return. Example: `"projects/my-project-id/
-        #   sinks/my-sink-id"`.
+        # Writes log entries to Stackdriver Logging.
+        # @param [Google::Apis::LoggingV2beta1::WriteLogEntriesRequest] write_log_entries_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -134,29 +180,165 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::LogSink]
+        # @return [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_project_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v2beta1/{+sinkName}', options)
-          command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::LogSink
-          command.params['sinkName'] = sink_name unless sink_name.nil?
+        def write_entry_log_entries(write_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v2beta1/entries:write', options)
+          command.request_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesRequest::Representation
+          command.request_object = write_log_entries_request_object
+          command.response_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a sink.
-        # @param [String] project_name
-        #   The resource name of the project in which to create the sink. Example: `"
-        #   projects/my-project-id"`. The new sink must be provided in the request.
+        # Lists log entries. Use this method to retrieve log entries from Stackdriver
+        # Logging. For ways to export log entries, see Exporting Logs.
+        # @param [Google::Apis::LoggingV2beta1::ListLogEntriesRequest] list_log_entries_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogEntriesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2beta1::ListLogEntriesResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_entry_log_entries(list_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v2beta1/entries:list', options)
+          command.request_representation = Google::Apis::LoggingV2beta1::ListLogEntriesRequest::Representation
+          command.request_object = list_log_entries_request_object
+          command.response_representation = Google::Apis::LoggingV2beta1::ListLogEntriesResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::ListLogEntriesResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes all the log entries in a log. The log reappears if it receives new
+        # entries. Log entries written shortly before the delete operation might not be
+        # deleted.
+        # @param [String] log_name
+        #   Required. The resource name of the log to delete:
+        #   "projects/[PROJECT_ID]/logs/[LOG_ID]"
+        #   "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+        #   "folders/[FOLDER_ID]/logs/[LOG_ID]"
+        #   [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
+        #   , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
+        #   2Factivity". For more information about log names, see LogEntry.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2beta1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v2beta1/{+logName}', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::Empty
+          command.params['logName'] = log_name unless log_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the logs in projects, organizations, folders, or billing accounts. Only
+        # logs that have entries are listed.
+        # @param [String] parent
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
+        # @param [String] page_token
+        #   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.
+        # @param [Fixnum] page_size
+        #   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.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2beta1::ListLogsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_logs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/{+parent}/logs', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::ListLogsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::ListLogsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # 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.
+        # @param [String] sink_name
+        #   Required. The full resource name of the sink to update, including the parent
+        #   resource and the sink identifier:
+        #   "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+        #   "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+        #   "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+        #   Example: "projects/my-project-id/sinks/my-sink-id".
         # @param [Google::Apis::LoggingV2beta1::LogSink] log_sink_object
+        # @param [Boolean] unique_writer_identity
+        #   Optional. See sinks.create for a description of this field. When updating a
+        #   sink, the effect of this field on the value of writer_identity in the updated
+        #   sink depends on both the old and new values of this field:
+        #   If the old and new values of this field are both false or both true, then
+        #   there is no change to the sink's writer_identity.
+        #   If the old value is false and the new value is true, then writer_identity is
+        #   changed to a unique service account.
+        #   It is an error if the old value is true and the new value is false.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -174,25 +356,42 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_project_sink(project_name, log_sink_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v2beta1/{+projectName}/sinks', options)
+        def update_project_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'v2beta1/{+sinkName}', options)
           command.request_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
           command.request_object = log_sink_object
           command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
           command.response_class = Google::Apis::LoggingV2beta1::LogSink
-          command.params['projectName'] = project_name unless project_name.nil?
+          command.params['sinkName'] = sink_name unless sink_name.nil?
+          command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates or updates a sink.
-        # @param [String] sink_name
-        #   The resource name of the sink to update. Example: `"projects/my-project-id/
-        #   sinks/my-sink-id"`. The updated sink must be provided in the request and have
-        #   the same name that is specified in `sinkName`. If the sink does not exist, it
-        #   is created.
+        # 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.
+        # @param [String] parent
+        #   Required. The resource in which to create the sink:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
+        #   Examples: "projects/my-logging-project", "organizations/123456789".
         # @param [Google::Apis::LoggingV2beta1::LogSink] log_sink_object
+        # @param [Boolean] unique_writer_identity
+        #   Optional. Determines the kind of IAM identity returned as writer_identity in
+        #   the new sink. If this value is omitted or set to false, and if the sink's
+        #   parent is a project, then the value returned as writer_identity is the same
+        #   group or service account used by Stackdriver Logging before the addition of
+        #   writer identities to this API. The sink's destination must be in the same
+        #   project as the sink itself.If this field is set to true, or if the sink is
+        #   owned by a non-project resource such as an organization, then the value of
+        #   writer_identity will be a unique service account used only for exports from
+        #   the new sink. For more information, see writer_identity in LogSink.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -210,22 +409,29 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_project_sink(sink_name, log_sink_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:put, 'v2beta1/{+sinkName}', options)
+        def create_project_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v2beta1/{+parent}/sinks', options)
           command.request_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
           command.request_object = log_sink_object
           command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
           command.response_class = Google::Apis::LoggingV2beta1::LogSink
-          command.params['sinkName'] = sink_name unless sink_name.nil?
+          command.params['parent'] = parent unless parent.nil?
+          command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a sink.
+        # Deletes a sink. If the sink has a unique writer_identity, then that service
+        # account is also deleted.
         # @param [String] sink_name
-        #   The resource name of the sink to delete. Example: `"projects/my-project-id/
-        #   sinks/my-sink-id"`.
+        #   Required. The full resource name of the sink to delete, including the parent
+        #   resource and the sink identifier:
+        #   "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+        #   "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+        #   "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+        #   Example: "projects/my-project-id/sinks/my-sink-id".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -253,20 +459,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists logs-based metrics.
-        # @param [String] project_name
-        #   Required. The resource name of the project containing the metrics. Example: `"
-        #   projects/my-project-id"`.
+        # Lists sinks.
+        # @param [String] parent
+        #   Required. The parent resource whose sinks are to be listed:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [String] page_token
-        #   Optional. If the `pageToken` parameter is supplied, then the next page of
-        #   results is retrieved. The `pageToken` parameter must be set to the value of
-        #   the `nextPageToken` from the previous response. The value of `projectName`
-        #   must be the same as in the previous request.
+        #   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.
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of results to return from this request. You must
-        #   check for presence of `nextPageToken` to determine if additional results are
-        #   available, which you can retrieve by passing the `nextPageToken` value as the `
-        #   pageToken` parameter in the next request.
+        #   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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -276,19 +484,19 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogMetricsResponse] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::ListSinksResponse] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::ListLogMetricsResponse]
+        # @return [Google::Apis::LoggingV2beta1::ListSinksResponse]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_project_metrics(project_name, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v2beta1/{+projectName}/metrics', options)
-          command.response_representation = Google::Apis::LoggingV2beta1::ListLogMetricsResponse::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::ListLogMetricsResponse
-          command.params['projectName'] = project_name unless project_name.nil?
+        def list_project_sinks(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/{+parent}/sinks', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::ListSinksResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::ListSinksResponse
+          command.params['parent'] = parent unless parent.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -296,10 +504,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a logs-based metric.
+        # Gets a sink.
+        # @param [String] sink_name
+        #   Required. The resource name of the sink:
+        #   "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+        #   "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+        #   "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+        #   Example: "projects/my-project-id/sinks/my-sink-id".
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2beta1::LogSink] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2beta1::LogSink]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/{+sinkName}', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::LogSink::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::LogSink
+          command.params['sinkName'] = sink_name unless sink_name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a logs-based metric.
         # @param [String] metric_name
-        #   The resource name of the desired metric. Example: `"projects/my-project-id/
-        #   metrics/my-metric-id"`.
+        #   The resource name of the metric to delete:
+        #   "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -309,29 +552,37 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::LogMetric]
+        # @return [Google::Apis::LoggingV2beta1::Empty]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v2beta1/{+metricName}', options)
-          command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::LogMetric
+        def delete_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v2beta1/{+metricName}', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::Empty
           command.params['metricName'] = metric_name unless metric_name.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a logs-based metric.
-        # @param [String] project_name
-        #   The resource name of the project in which to create the metric. Example: `"
-        #   projects/my-project-id"`. The new metric must be provided in the request.
-        # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
+        # Lists logs-based metrics.
+        # @param [String] parent
+        #   Required. The name of the project containing the metrics:
+        #   "projects/[PROJECT_ID]"
+        # @param [String] page_token
+        #   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.
+        # @param [Fixnum] page_size
+        #   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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -341,33 +592,30 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogMetricsResponse] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::LogMetric]
+        # @return [Google::Apis::LoggingV2beta1::ListLogMetricsResponse]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_project_metric(project_name, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v2beta1/{+projectName}/metrics', options)
-          command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
-          command.request_object = log_metric_object
-          command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::LogMetric
-          command.params['projectName'] = project_name unless project_name.nil?
+        def list_project_metrics(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/{+parent}/metrics', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::ListLogMetricsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::ListLogMetricsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Creates or updates a logs-based metric.
+        # Gets a logs-based metric.
         # @param [String] metric_name
-        #   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.
-        # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
+        #   The resource name of the desired metric:
+        #   "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -385,10 +633,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_project_metric(metric_name, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:put, 'v2beta1/{+metricName}', options)
-          command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
-          command.request_object = log_metric_object
+        def get_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/{+metricName}', options)
           command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
           command.response_class = Google::Apis::LoggingV2beta1::LogMetric
           command.params['metricName'] = metric_name unless metric_name.nil?
@@ -397,10 +643,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a logs-based metric.
+        # Creates or updates a logs-based metric.
         # @param [String] metric_name
-        #   The resource name of the metric to delete. Example: `"projects/my-project-id/
-        #   metrics/my-metric-id"`.
+        #   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.
+        # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -410,27 +660,32 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::Empty]
+        # @return [Google::Apis::LoggingV2beta1::LogMetric]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:delete, 'v2beta1/{+metricName}', options)
-          command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::Empty
+        def update_project_metric(metric_name, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'v2beta1/{+metricName}', options)
+          command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
+          command.request_object = log_metric_object
+          command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::LogMetric
           command.params['metricName'] = metric_name unless metric_name.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Writes log entries to Cloud Logging. All log entries in Cloud Logging are
-        # written by this method.
-        # @param [Google::Apis::LoggingV2beta1::WriteLogEntriesRequest] write_log_entries_request_object
+        # Creates a logs-based metric.
+        # @param [String] 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.
+        # @param [Google::Apis::LoggingV2beta1::LogMetric] log_metric_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -440,28 +695,38 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::LogMetric] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::WriteLogEntriesResponse]
+        # @return [Google::Apis::LoggingV2beta1::LogMetric]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def write_entry_log_entries(write_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v2beta1/entries:write', options)
-          command.request_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesRequest::Representation
-          command.request_object = write_log_entries_request_object
-          command.response_representation = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::WriteLogEntriesResponse
+        def create_project_metric(parent, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v2beta1/{+parent}/metrics', options)
+          command.request_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
+          command.request_object = log_metric_object
+          command.response_representation = Google::Apis::LoggingV2beta1::LogMetric::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::LogMetric
+          command.params['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # 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).
-        # @param [Google::Apis::LoggingV2beta1::ListLogEntriesRequest] list_log_entries_request_object
+        # Deletes all the log entries in a log. The log reappears if it receives new
+        # entries. Log entries written shortly before the delete operation might not be
+        # deleted.
+        # @param [String] log_name
+        #   Required. The resource name of the log to delete:
+        #   "projects/[PROJECT_ID]/logs/[LOG_ID]"
+        #   "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+        #   "folders/[FOLDER_ID]/logs/[LOG_ID]"
+        #   [LOG_ID] must be URL-encoded. For example, "projects/my-project-id/logs/syslog"
+        #   , "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%
+        #   2Factivity". For more information about log names, see LogEntry.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -471,35 +736,41 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogEntriesResponse] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::Empty] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::ListLogEntriesResponse]
+        # @return [Google::Apis::LoggingV2beta1::Empty]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_entry_log_entries(list_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v2beta1/entries:list', options)
-          command.request_representation = Google::Apis::LoggingV2beta1::ListLogEntriesRequest::Representation
-          command.request_object = list_log_entries_request_object
-          command.response_representation = Google::Apis::LoggingV2beta1::ListLogEntriesResponse::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::ListLogEntriesResponse
+        def delete_billing_account_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v2beta1/{+logName}', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::Empty::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::Empty
+          command.params['logName'] = log_name unless log_name.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Lists monitored resource descriptors that are used by Cloud Logging.
-        # @param [Fixnum] page_size
-        #   Optional. The maximum number of results to return from this request. You must
-        #   check for presence of `nextPageToken` to determine if additional results are
-        #   available, which you can retrieve by passing the `nextPageToken` value as the `
-        #   pageToken` parameter in the next request.
+        # Lists the logs in projects, organizations, folders, or billing accounts. Only
+        # logs that have entries are listed.
+        # @param [String] parent
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [String] page_token
-        #   Optional. If the `pageToken` parameter is supplied, then the next page of
-        #   results is retrieved. The `pageToken` parameter must be set to the value of
-        #   the `nextPageToken` from the previous response.
+        #   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.
+        # @param [Fixnum] page_size
+        #   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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -509,20 +780,21 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse] parsed result object
+        # @yieldparam result [Google::Apis::LoggingV2beta1::ListLogsResponse] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse]
+        # @return [Google::Apis::LoggingV2beta1::ListLogsResponse]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_monitored_resource_descriptors(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v2beta1/monitoredResourceDescriptors', options)
-          command.response_representation = Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse::Representation
-          command.response_class = Google::Apis::LoggingV2beta1::ListMonitoredResourceDescriptorsResponse
-          command.query['pageSize'] = page_size unless page_size.nil?
+        def list_billing_account_logs(parent, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v2beta1/{+parent}/logs', options)
+          command.response_representation = Google::Apis::LoggingV2beta1::ListLogsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2beta1::ListLogsResponse
+          command.params['parent'] = parent unless parent.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)