# Copyright 2015 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

require 'google/apis/core/base_service'
require 'google/apis/core/json_representation'
require 'google/apis/core/hashable'
require 'google/apis/errors'

module Google
  module Apis
    module LoggingV1beta3
      # Google Cloud Logging API
      #
      # Google Cloud Logging API lets you create logs, ingest log entries, and manage
      #  log sinks.
      #
      # @example
      #    require 'google/apis/logging_v1beta3'
      #
      #    Logging = Google::Apis::LoggingV1beta3 # Alias the module
      #    service = Logging::LoggingService.new
      #
      # @see 
      class LoggingService < Google::Apis::Core::BaseService
        # @return [String]
        #  API key. Your API key identifies your project and provides you with API access,
        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
        attr_accessor :key

        # @return [String]
        #  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.
        attr_accessor :quota_user

        def initialize
          super('https://logging.googleapis.com/', '')
        end
        
        # Lists log resources belonging to the specified project.
        # @param [String] projects_id
        #   Part of `projectName`. The project name for which to list the log resources.
        # @param [String] service_name
        #   A service name for which to list logs. Only logs containing entries whose
        #   metadata includes this service name are returned. If `serviceName` and `
        #   serviceIndexPrefix` are both empty, then all log names are returned. To list
        #   all log names, regardless of service, leave both the `serviceName` and `
        #   serviceIndexPrefix` empty. To list log names containing entries with a
        #   particular service name (or explicitly empty service name) set `serviceName`
        #   to the desired value and `serviceIndexPrefix` to `"/"`.
        # @param [String] service_index_prefix
        #   A log service index prefix for which to list logs. Only logs containing
        #   entries whose metadata that includes these label values (associated with index
        #   keys) are returned. The prefix is a slash separated list of values, and need
        #   not specify all index labels. An empty index (or a single slash) matches all
        #   log service indexes.
        # @param [Fixnum] page_size
        #   The maximum number of results to return.
        # @param [String] page_token
        #   An opaque token, returned as `nextPageToken` by a prior `ListLogs` operation.
        #   If `pageToken` is supplied, then the other fields of this request are ignored,
        #   and instead the previous `ListLogs` operation is continued.
        # @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::LoggingV1beta3::ListLogsResponse] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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(projects_id, service_name: nil, service_index_prefix: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs'
          command =  make_simple_command(:get, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::ListLogsResponse::Representation
          command.response_class = Google::Apis::LoggingV1beta3::ListLogsResponse
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.query['serviceName'] = service_name unless service_name.nil?
          command.query['serviceIndexPrefix'] = service_index_prefix unless service_index_prefix.nil?
          command.query['pageSize'] = page_size unless page_size.nil?
          command.query['pageToken'] = page_token unless page_token.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 the specified log resource and all log entries contained in it.
        # @param [String] projects_id
        #   Part of `logName`. The log resource to delete.
        # @param [String] logs_id
        #   Part of `logName`. See documentation of `projectsId`.
        # @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::LoggingV1beta3::Empty] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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(projects_id, logs_id, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs/{logsId}'
          command =  make_simple_command(:delete, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::Empty::Representation
          command.response_class = Google::Apis::LoggingV1beta3::Empty
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logsId'] = logs_id unless logs_id.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 one or more log entries in a log. You must supply a list of `LogEntry`
        # objects, named `entries`. Each `LogEntry` object must contain a payload object
        # and a `LogEntryMetadata` object that describes the entry. You must fill in all
        # the fields of the entry, metadata, and payload. You can also supply a map, `
        # commonLabels`, that supplies default (key, value) data for the `entries[].
        # metadata.labels` maps, saving you the trouble of creating identical copies for
        # each entry.
        # @param [String] projects_id
        #   Part of `logName`. The name of the log resource into which to insert the log
        #   entries.
        # @param [String] logs_id
        #   Part of `logName`. See documentation of `projectsId`.
        # @param [Google::Apis::LoggingV1beta3::WriteLogEntriesRequest] write_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::LoggingV1beta3::WriteLogEntriesResponse] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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 write_log_entries(projects_id, logs_id, write_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs/{logsId}/entries:write'
          command =  make_simple_command(:post, path, options)
          command.request_representation = Google::Apis::LoggingV1beta3::WriteLogEntriesRequest::Representation
          command.request_object = write_log_entries_request_object
          command.response_representation = Google::Apis::LoggingV1beta3::WriteLogEntriesResponse::Representation
          command.response_class = Google::Apis::LoggingV1beta3::WriteLogEntriesResponse
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logsId'] = logs_id unless logs_id.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 sinks associated with the specified log.
        # @param [String] projects_id
        #   Part of `logName`. The log for which to list sinks.
        # @param [String] logs_id
        #   Part of `logName`. See documentation of `projectsId`.
        # @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::LoggingV1beta3::ListLogSinksResponse] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::ListLogSinksResponse]
        #
        # @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_log_sinks(projects_id, logs_id, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs/{logsId}/sinks'
          command =  make_simple_command(:get, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::ListLogSinksResponse::Representation
          command.response_class = Google::Apis::LoggingV1beta3::ListLogSinksResponse
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logsId'] = logs_id unless logs_id.nil?
          command.query['fields'] = fields unless fields.nil?
          command.query['quotaUser'] = quota_user unless quota_user.nil?
          execute_or_queue_command(command, &block)
        end
        
        # Gets the specified log sink resource.
        # @param [String] projects_id
        #   Part of `sinkName`. The name of the sink resource to return.
        # @param [String] logs_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [String] sinks_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @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::LoggingV1beta3::LogSink] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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_log_sink(projects_id, logs_id, sinks_id, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs/{logsId}/sinks/{sinksId}'
          command =  make_simple_command(:get, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.response_class = Google::Apis::LoggingV1beta3::LogSink
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logsId'] = logs_id unless logs_id.nil?
          command.params['sinksId'] = sinks_id unless sinks_id.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 the specified log sink resource.
        # @param [String] projects_id
        #   Part of `logName`. The log in which to create a sink resource.
        # @param [String] logs_id
        #   Part of `logName`. See documentation of `projectsId`.
        # @param [Google::Apis::LoggingV1beta3::LogSink] log_sink_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::LoggingV1beta3::LogSink] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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 create_log_sink(projects_id, logs_id, log_sink_object = nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs/{logsId}/sinks'
          command =  make_simple_command(:post, path, options)
          command.request_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.request_object = log_sink_object
          command.response_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.response_class = Google::Apis::LoggingV1beta3::LogSink
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logsId'] = logs_id unless logs_id.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 the specified log sink resource.
        # @param [String] projects_id
        #   Part of `sinkName`. The name of the sink to update.
        # @param [String] logs_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [String] sinks_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [Google::Apis::LoggingV1beta3::LogSink] log_sink_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::LoggingV1beta3::LogSink] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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 update_log_sink(projects_id, logs_id, sinks_id, log_sink_object = nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs/{logsId}/sinks/{sinksId}'
          command =  make_simple_command(:put, path, options)
          command.request_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.request_object = log_sink_object
          command.response_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.response_class = Google::Apis::LoggingV1beta3::LogSink
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logsId'] = logs_id unless logs_id.nil?
          command.params['sinksId'] = sinks_id unless sinks_id.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 the specified log sink resource.
        # @param [String] projects_id
        #   Part of `sinkName`. The name of the sink to delete.
        # @param [String] logs_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [String] sinks_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @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::LoggingV1beta3::Empty] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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_sink(projects_id, logs_id, sinks_id, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logs/{logsId}/sinks/{sinksId}'
          command =  make_simple_command(:delete, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::Empty::Representation
          command.response_class = Google::Apis::LoggingV1beta3::Empty
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logsId'] = logs_id unless logs_id.nil?
          command.params['sinksId'] = sinks_id unless sinks_id.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 services associated with log entries ingested for a project.
        # @param [String] projects_id
        #   Part of `projectName`. The project resource whose services are to be listed.
        # @param [String] log
        #   The name of the log resource whose services are to be listed. log for which to
        #   list services. When empty, all services are listed.
        # @param [Fixnum] page_size
        #   The maximum number of `LogService` objects to return in one operation.
        # @param [String] page_token
        #   An opaque token, returned as `nextPageToken` by a prior `ListLogServices`
        #   operation. If `pageToken` is supplied, then the other fields of this request
        #   are ignored, and instead the previous `ListLogServices` operation is continued.
        # @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::LoggingV1beta3::ListLogServicesResponse] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::ListLogServicesResponse]
        #
        # @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_log_services(projects_id, log: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logServices'
          command =  make_simple_command(:get, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::ListLogServicesResponse::Representation
          command.response_class = Google::Apis::LoggingV1beta3::ListLogServicesResponse
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.query['log'] = log unless log.nil?
          command.query['pageSize'] = page_size unless page_size.nil?
          command.query['pageToken'] = page_token unless page_token.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 service indexes associated with a log service.
        # @param [String] projects_id
        #   Part of `serviceName`. A log service resource of the form `/projects/*/
        #   logServices/*`. The service indexes of the log service are returned. Example: `
        #   "/projects/myProj/logServices/appengine.googleapis.com"`.
        # @param [String] log_services_id
        #   Part of `serviceName`. See documentation of `projectsId`.
        # @param [String] index_prefix
        #   Restricts the indexes returned to be those with a specified prefix. The prefix
        #   has the form `"/label_value/label_value/..."`, in order corresponding to the [`
        #   LogService indexKeys`][google.logging.v1.LogService.index_keys]. Non-empty
        #   prefixes must begin with `/` . Example prefixes: + `"/myModule/"` retrieves
        #   App Engine versions associated with `myModule`. The trailing slash terminates
        #   the value. + `"/myModule"` retrieves App Engine modules with names beginning
        #   with `myModule`. + `""` retrieves all indexes.
        # @param [Fixnum] depth
        #   A limit to the number of levels of the index hierarchy that are expanded. If `
        #   depth` is 0, it defaults to the level specified by the prefix field (the
        #   number of slash separators). The default empty prefix implies a `depth` of 1.
        #   It is an error for `depth` to be any non-zero value less than the number of
        #   components in `indexPrefix`.
        # @param [String] log
        #   A log resource like `/projects/project_id/logs/log_name`, identifying the log
        #   for which to list service indexes.
        # @param [Fixnum] page_size
        #   The maximum number of log service index resources to return in one operation.
        # @param [String] page_token
        #   An opaque token, returned as `nextPageToken` by a prior `ListLogServiceIndexes`
        #   operation. If `pageToken` is supplied, then the other fields of this request
        #   are ignored, and instead the previous `ListLogServiceIndexes` operation is
        #   continued.
        # @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::LoggingV1beta3::ListLogServiceIndexesResponse] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::ListLogServiceIndexesResponse]
        #
        # @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_log_service_indexes(projects_id, log_services_id, index_prefix: nil, depth: nil, log: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logServices/{logServicesId}/indexes'
          command =  make_simple_command(:get, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::ListLogServiceIndexesResponse::Representation
          command.response_class = Google::Apis::LoggingV1beta3::ListLogServiceIndexesResponse
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logServicesId'] = log_services_id unless log_services_id.nil?
          command.query['indexPrefix'] = index_prefix unless index_prefix.nil?
          command.query['depth'] = depth unless depth.nil?
          command.query['log'] = log unless log.nil?
          command.query['pageSize'] = page_size unless page_size.nil?
          command.query['pageToken'] = page_token unless page_token.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 service sinks associated with the specified service.
        # @param [String] projects_id
        #   Part of `serviceName`. The name of the service for which to list sinks.
        # @param [String] log_services_id
        #   Part of `serviceName`. See documentation of `projectsId`.
        # @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::LoggingV1beta3::ListLogServiceSinksResponse] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::ListLogServiceSinksResponse]
        #
        # @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_log_service_sinks(projects_id, log_services_id, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logServices/{logServicesId}/sinks'
          command =  make_simple_command(:get, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::ListLogServiceSinksResponse::Representation
          command.response_class = Google::Apis::LoggingV1beta3::ListLogServiceSinksResponse
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logServicesId'] = log_services_id unless log_services_id.nil?
          command.query['fields'] = fields unless fields.nil?
          command.query['quotaUser'] = quota_user unless quota_user.nil?
          execute_or_queue_command(command, &block)
        end
        
        # Gets the specified log service sink resource.
        # @param [String] projects_id
        #   Part of `sinkName`. The name of the sink to return.
        # @param [String] log_services_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [String] sinks_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @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::LoggingV1beta3::LogSink] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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_log_service_sink(projects_id, log_services_id, sinks_id, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logServices/{logServicesId}/sinks/{sinksId}'
          command =  make_simple_command(:get, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.response_class = Google::Apis::LoggingV1beta3::LogSink
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logServicesId'] = log_services_id unless log_services_id.nil?
          command.params['sinksId'] = sinks_id unless sinks_id.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 the specified log service sink resource.
        # @param [String] projects_id
        #   Part of `serviceName`. The name of the service in which to create a sink.
        # @param [String] log_services_id
        #   Part of `serviceName`. See documentation of `projectsId`.
        # @param [Google::Apis::LoggingV1beta3::LogSink] log_sink_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::LoggingV1beta3::LogSink] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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 create_log_service_sink(projects_id, log_services_id, log_sink_object = nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logServices/{logServicesId}/sinks'
          command =  make_simple_command(:post, path, options)
          command.request_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.request_object = log_sink_object
          command.response_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.response_class = Google::Apis::LoggingV1beta3::LogSink
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logServicesId'] = log_services_id unless log_services_id.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 update the specified log service sink resource.
        # @param [String] projects_id
        #   Part of `sinkName`. The name of the sink to update.
        # @param [String] log_services_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [String] sinks_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [Google::Apis::LoggingV1beta3::LogSink] log_sink_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::LoggingV1beta3::LogSink] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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 update_log_service_sink(projects_id, log_services_id, sinks_id, log_sink_object = nil, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logServices/{logServicesId}/sinks/{sinksId}'
          command =  make_simple_command(:put, path, options)
          command.request_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.request_object = log_sink_object
          command.response_representation = Google::Apis::LoggingV1beta3::LogSink::Representation
          command.response_class = Google::Apis::LoggingV1beta3::LogSink
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logServicesId'] = log_services_id unless log_services_id.nil?
          command.params['sinksId'] = sinks_id unless sinks_id.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 the specified log service sink.
        # @param [String] projects_id
        #   Part of `sinkName`. The name of the sink to delete.
        # @param [String] log_services_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @param [String] sinks_id
        #   Part of `sinkName`. See documentation of `projectsId`.
        # @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::LoggingV1beta3::Empty] parsed result object
        # @yieldparam err [StandardError] error object if request failed
        #
        # @return [Google::Apis::LoggingV1beta3::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_service_sink(projects_id, log_services_id, sinks_id, fields: nil, quota_user: nil, options: nil, &block)
          path = 'v1beta3/projects/{projectsId}/logServices/{logServicesId}/sinks/{sinksId}'
          command =  make_simple_command(:delete, path, options)
          command.response_representation = Google::Apis::LoggingV1beta3::Empty::Representation
          command.response_class = Google::Apis::LoggingV1beta3::Empty
          command.params['projectsId'] = projects_id unless projects_id.nil?
          command.params['logServicesId'] = log_services_id unless log_services_id.nil?
          command.params['sinksId'] = sinks_id unless sinks_id.nil?
          command.query['fields'] = fields unless fields.nil?
          command.query['quotaUser'] = quota_user unless quota_user.nil?
          execute_or_queue_command(command, &block)
        end

        protected

        def apply_command_defaults(command)
          command.query['key'] = key unless key.nil?
          command.query['quotaUser'] = quota_user unless quota_user.nil?
        end
      end
    end
  end
end