google-api-ruby-client/generated/google/apis/logging_v1beta3/service.rb

671 lines
40 KiB
Ruby
Raw Normal View History

2015-06-23 23:05:46 +00:00
# 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