2021-01-01 03:01:13 +00:00
|
|
|
# Copyright 2020 Google LLC
|
|
|
|
|
#
|
|
|
|
|
# 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 LoggingV2
|
|
|
|
|
# Cloud Logging API
|
|
|
|
|
#
|
|
|
|
|
# Writes log entries and manages your Cloud Logging configuration. The table
|
|
|
|
|
# entries below are presented in alphabetical order, not in order of common use.
|
|
|
|
|
# For explanations of the concepts found in the table entries, read the
|
|
|
|
|
# documentation at https://cloud.google.com/logging/docs.
|
|
|
|
|
#
|
|
|
|
|
# @example
|
|
|
|
|
# require 'google/apis/logging_v2'
|
|
|
|
|
#
|
|
|
|
|
# Logging = Google::Apis::LoggingV2 # Alias the module
|
|
|
|
|
# service = Logging::LoggingService.new
|
|
|
|
|
#
|
|
|
|
|
# @see https://cloud.google.com/logging/docs/
|
|
|
|
|
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
|
2021-01-01 17:40:59 +00:00
|
|
|
super('https://logging.googleapis.com/', '',
|
|
|
|
|
client_name: 'google-apis-logging_v2',
|
|
|
|
|
client_version: Google::Apis::LoggingV2::GEM_VERSION)
|
2021-01-01 03:01:13 +00:00
|
|
|
@batch_path = 'batch'
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Gets a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
|
|
|
|
|
# my-location/buckets/my-bucket-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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a view.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id/views/my-view-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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless 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 new exclusion in a specified parent resource. Only log entries
|
|
|
|
|
# belonging to that resource can be excluded. You can have up to 10 exclusions
|
|
|
|
|
# in a resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource in which to create the exclusion: "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
|
|
|
|
|
# project", "organizations/123456789".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_exclusion(parent, log_exclusion_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# Deletes an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion to delete: "projects/[
|
|
|
|
|
# PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets the description of an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless 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 all the exclusions in a parent resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose exclusions are to be listed. "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListExclusionsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListExclusionsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_exclusions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListExclusionsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListExclusionsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Changes one or more properties of an existing exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. A non-empty list of fields to change in the existing exclusion. New
|
|
|
|
|
# values for the fields are taken from the corresponding fields in the
|
|
|
|
|
# LogExclusion included in this request. Fields not mentioned in update_mask are
|
|
|
|
|
# not changed and are ignored in the request.For example, to change the filter
|
|
|
|
|
# and description of an exclusion, specify an update_mask of "filter,description"
|
|
|
|
|
# .
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_billing_account_exclusion(name, log_exclusion_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 information about a location.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Resource name for the location.
|
|
|
|
|
# @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::LoggingV2::Location] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::Location]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_location(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Location::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Location
|
|
|
|
|
command.params['name'] = name unless 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 information about the supported locations for this service.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# The resource that owns the locations collection, if applicable.
|
|
|
|
|
# @param [String] filter
|
|
|
|
|
# The standard list filter.
|
|
|
|
|
# @param [Fixnum] page_size
|
|
|
|
|
# The standard list page size.
|
|
|
|
|
# @param [String] page_token
|
|
|
|
|
# The standard list page token.
|
|
|
|
|
# @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::LoggingV2::ListLocationsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListLocationsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}/locations', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLocationsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLocationsResponse
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['filter'] = filter unless filter.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
|
|
|
|
|
|
|
|
|
|
# Creates a bucket that can be used to store log entries. Once a bucket has been
|
|
|
|
|
# created, the region cannot be changed.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
|
|
|
|
|
# global"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] bucket_id
|
|
|
|
|
# Required. A client-assigned identifier such as "my-bucket". Identifiers are
|
|
|
|
|
# limited to 100 characters and can include only letters, digits, underscores,
|
|
|
|
|
# hyphens, and periods.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['bucketId'] = bucket_id unless bucket_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 a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
|
|
|
|
|
# the bucket will be purged and all logs in the bucket will be permanently
|
|
|
|
|
# deleted.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to delete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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 buckets.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose buckets are to be listed: "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The
|
|
|
|
|
# locations portion of the resource must be specified, but supplying the
|
|
|
|
|
# character - in place of LOCATION_ID will return all buckets.
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListBucketsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListBucketsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a bucket. This method replaces the following fields in the existing
|
|
|
|
|
# bucket with values from the new bucket: retention_periodIf the retention
|
|
|
|
|
# period is decreased and the bucket is locked, FAILED_PRECONDITION will be
|
|
|
|
|
# returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
|
|
|
|
|
# FAILED_PRECONDITION will be returned.A buckets region may not be modified
|
|
|
|
|
# after it is created.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to update. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id". Also requires
|
|
|
|
|
# permission "resourcemanager.projects.updateLiens" to set the locked property
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. Field mask that specifies the fields in bucket that need an update.
|
|
|
|
|
# A bucket field will be overwritten if, and only if, it is in the update mask.
|
|
|
|
|
# name and output only fields cannot be updated.For a detailed FieldMask
|
|
|
|
|
# definition, see https://developers.google.com/protocol-buffers/docs/reference/
|
|
|
|
|
# google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_billing_account_location_bucket(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Undeletes a bucket. A bucket that has been deleted may be undeleted within the
|
|
|
|
|
# grace period of 7 days.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to undelete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 undelete_billing_account_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+name}:undelete', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation
|
|
|
|
|
command.request_object = undelete_bucket_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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 view over logs in a bucket. A bucket may contain a maximum of 50
|
|
|
|
|
# views.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket in which to create the view "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
|
|
|
|
|
# project/locations/my-location/buckets/my-bucket"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] view_id
|
|
|
|
|
# Required. The id to use for this view.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/views', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['viewId'] = view_id unless view_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 a view from a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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 views on a bucket.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListViewsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListViewsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_billing_account_location_bucket_views(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/views', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListViewsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListViewsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a view. This method replaces the following fields in the existing view
|
|
|
|
|
# with values from the new view: filter.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to update "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in view that need an update. A
|
|
|
|
|
# field will be overwritten if, and only if, it is in the update mask. name and
|
|
|
|
|
# output only fields cannot be updated.For a detailed FieldMask definition, see
|
|
|
|
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
|
|
|
|
|
# google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_billing_account_location_bucket_view(name, log_view_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
feat: Automated regeneration of logging v2 client (#2261)
This PR was generated using Autosynth. :rainbow:
<details><summary>Log from Synthtool</summary>
```
2021-01-09 02:55:52,454 synthtool [DEBUG] > Executing /home/kbuilder/.cache/synthtool/google-api-ruby-client/synth.py.
On branch autosynth-logging-v2
nothing to commit, working tree clean
2021-01-09 02:55:52,520 synthtool [DEBUG] > Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
DEBUG:synthtool:Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
bundle install
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 11.3.0
Installing rake 11.3.0
Fetching concurrent-ruby 1.1.7
Installing concurrent-ruby 1.1.7
Fetching i18n 1.8.7
Installing i18n 1.8.7
Fetching minitest 5.14.3
Installing minitest 5.14.3
Fetching tzinfo 2.0.4
Installing tzinfo 2.0.4
Fetching zeitwerk 2.4.2
Installing zeitwerk 2.4.2
Fetching activesupport 6.1.1
Installing activesupport 6.1.1
Fetching public_suffix 4.0.6
Installing public_suffix 4.0.6
Fetching addressable 2.7.0
Installing addressable 2.7.0
Fetching ast 2.4.1
Installing ast 2.4.1
Using bundler 2.1.4
Fetching byebug 11.1.3
Installing byebug 11.1.3 with native extensions
Fetching coderay 1.1.3
Installing coderay 1.1.3
Fetching json 2.5.1
Installing json 2.5.1 with native extensions
Fetching docile 1.3.4
Installing docile 1.3.4
Fetching simplecov-html 0.10.2
Installing simplecov-html 0.10.2
Fetching simplecov 0.16.1
Installing simplecov 0.16.1
Using sync 0.5.0
Fetching tins 1.26.0
Installing tins 1.26.0
Fetching term-ansicolor 1.7.1
Installing term-ansicolor 1.7.1
Fetching thor 0.20.3
Installing thor 0.20.3
Fetching coveralls 0.8.23
Installing coveralls 0.8.23
Fetching rexml 3.2.4
Installing rexml 3.2.4
Fetching crack 0.4.5
Installing crack 0.4.5
Fetching declarative 0.0.20
Installing declarative 0.0.20
Fetching declarative-option 0.1.0
Installing declarative-option 0.1.0
Fetching diff-lcs 1.4.4
Installing diff-lcs 1.4.4
Fetching dotenv 2.7.6
Installing dotenv 2.7.6
Fetching fakefs 0.20.1
Installing fakefs 0.20.1
Fetching faraday-net_http 1.0.0
Installing faraday-net_http 1.0.0
Fetching multipart-post 2.1.1
Installing multipart-post 2.1.1
Fetching ruby2_keywords 0.0.2
Installing ruby2_keywords 0.0.2
Fetching faraday 1.3.0
Installing faraday 1.3.0
Fetching gems 1.2.0
Installing gems 1.2.0
Fetching github-markup 1.7.0
Installing github-markup 1.7.0
Fetching jwt 2.2.2
Installing jwt 2.2.2
Fetching memoist 0.16.2
Installing memoist 0.16.2
Fetching multi_json 1.15.0
Installing multi_json 1.15.0
Fetching os 0.9.6
Installing os 0.9.6
Fetching signet 0.14.0
Installing signet 0.14.0
Fetching googleauth 0.14.0
Installing googleauth 0.14.0
Fetching httpclient 2.8.3
Installing httpclient 2.8.3
Fetching mini_mime 1.0.2
Installing mini_mime 1.0.2
Fetching uber 0.1.0
Installing uber 0.1.0
Fetching representable 3.0.4
Installing representable 3.0.4
Fetching retriable 3.1.2
Installing retriable 3.1.2
Fetching google-apis-core 0.2.0
Installing google-apis-core 0.2.0
Fetching google-apis-discovery_v1 0.1.0
Installing google-apis-discovery_v1 0.1.0
Using google-apis-generator 0.1.1 from source at `.`
Fetching google-id-token 1.4.2
Installing google-id-token 1.4.2
Fetching hashdiff 1.0.1
Installing hashdiff 1.0.1
Fetching mime-types-data 3.2020.1104
Installing mime-types-data 3.2020.1104
Fetching mime-types 3.3.1
Installing mime-types 3.3.1
Fetching multi_xml 0.6.0
Installing multi_xml 0.6.0
Fetching httparty 0.18.1
Installing httparty 0.18.1
Fetching rspec-support 3.10.1
Installing rspec-support 3.10.1
Fetching rspec-core 3.10.1
Installing rspec-core 3.10.1
Fetching rspec-expectations 3.10.1
Installing rspec-expectations 3.10.1
Fetching rspec-mocks 3.10.1
Installing rspec-mocks 3.10.1
Fetching rspec 3.10.0
Installing rspec 3.10.0
Fetching json_spec 1.1.5
Installing json_spec 1.1.5
Fetching launchy 2.5.0
Installing launchy 2.5.0
Fetching little-plugger 1.1.4
Installing little-plugger 1.1.4
Fetching logging 2.3.0
Installing logging 2.3.0
Fetching method_source 1.0.0
Installing method_source 1.0.0
Fetching opencensus 0.5.0
Installing opencensus 0.5.0
Fetching parallel 1.20.1
Installing parallel 1.20.1
Fetching parser 2.7.2.0
Installing parser 2.7.2.0
Fetching powerpack 0.1.3
Installing powerpack 0.1.3
Fetching pry 0.13.1
Installing pry 0.13.1
Fetching pry-byebug 3.9.0
Installing pry-byebug 3.9.0
Fetching yard 0.9.26
Installing yard 0.9.26
Fetching pry-doc 0.13.5
Installing pry-doc 0.13.5
Fetching rainbow 2.2.2
Installing rainbow 2.2.2 with native extensions
Fetching redcarpet 3.5.1
Installing redcarpet 3.5.1 with native extensions
Fetching redis 3.3.5
Installing redis 3.3.5
Fetching rmail 1.1.4
Installing rmail 1.1.4
Fetching ruby-progressbar 1.11.0
Installing ruby-progressbar 1.11.0
Fetching unicode-display_width 1.7.0
Installing unicode-display_width 1.7.0
Fetching rubocop 0.49.1
Installing rubocop 0.49.1
Fetching webmock 2.3.2
Installing webmock 2.3.2
Bundle complete! 25 Gemfile dependencies, 81 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
Post-install message from i18n:
HEADS UP! i18n 1.1 changed fallbacks to exclude default locale.
But that may break your application.
If you are upgrading your Rails application from an older version of Rails:
Please check your Rails app for 'config.i18n.fallbacks = true'.
If you're using I18n (>= 1.1.0) and Rails (< 5.2.2), this should be
'config.i18n.fallbacks = [I18n.default_locale]'.
If not, fallbacks will be broken in your app by I18n 1.1.x.
If you are starting a NEW Rails application, you can ignore this notice.
For more info see:
https://github.com/svenfuchs/i18n/releases/tag/v1.1.0
Post-install message from httparty:
When you HTTParty, you must party hard!
echo a | bundle exec bin/generate-api gen /workspace/generated --api=logging.v2 --names=/workspace/api_names.yaml --names-out=/workspace/api_names_out.yaml --spot-check
Loading logging, version v2 from https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/logging.v2.json
W, [2021-01-09T10:56:16.069592 #238] WARN -- : Found reserved property 'method'
W, [2021-01-09T10:56:16.069660 #238] WARN -- : Changed to 'method_prop'
conflict google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
<ging_v2/classes.rb? (enter "h" for help) [Ynaqdhm] a
force google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
conflict google-apis-logging_v2/CHANGELOG.md
force google-apis-logging_v2/CHANGELOG.md
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 13.0.3
Installing rake 13.0.3
Using public_suffix 4.0.6
Using addressable 2.7.0
Using bundler 2.1.4
Using declarative 0.0.20
Using declarative-option 0.1.0
Using diff-lcs 1.4.4
Using faraday-net_http 1.0.0
Using multipart-post 2.1.1
Using ruby2_keywords 0.0.2
Using faraday 1.3.0
Using jwt 2.2.2
Using memoist 0.16.2
Using multi_json 1.15.0
Fetching os 1.1.1
Installing os 1.1.1
Using signet 0.14.0
Using googleauth 0.14.0
Using httpclient 2.8.3
Using mini_mime 1.0.2
Using uber 0.1.0
Using representable 3.0.4
Using retriable 3.1.2
Using rexml 3.2.4
Using google-apis-core 0.2.0
Using google-apis-logging_v2 0.2.0 from source at `.`
Using opencensus 0.5.0
Using redcarpet 3.5.1
Using rspec-support 3.10.1
Using rspec-core 3.10.1
Using rspec-expectations 3.10.1
Using rspec-mocks 3.10.1
Using rspec 3.10.0
Using yard 0.9.26
Bundle complete! 8 Gemfile dependencies, 33 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
/root/.rbenv/versions/2.6.6/bin/ruby -I/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/lib:/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-support-3.10.1/lib /root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/exe/rspec --pattern spec/\*\*\{,/\*/\*\*\}/\*_spec.rb
Google::Apis::LoggingV2
should load
Finished in 0.31798 seconds (files took 0.11097 seconds to load)
1 example, 0 failures
Files: 4
Modules: 3 ( 1 undocumented)
Classes: 44 ( 0 undocumented)
Constants: 9 ( 0 undocumented)
Attributes: 136 ( 0 undocumented)
Methods: 229 ( 0 undocumented)
99.76% documented
google-apis-logging_v2 0.2.0 built to pkg/google-apis-logging_v2-0.2.0.gem.
identical /workspace/api_names_out.yaml
2021-01-09 02:56:31,239 synthtool [DEBUG] > Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
DEBUG:synthtool:Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
```
</details>
Full log will be available here:
https://source.cloud.google.com/results/invocations/2fec3e68-c8da-44a7-8bac-3218258fd2a0/targets
- [ ] To automatically regenerate this PR, check this box.
2021-01-09 11:12:02 +00:00
|
|
|
# Deletes all the log entries in a log for the _Default Log Bucket. The log
|
|
|
|
|
# reappears if it receives new entries. Log entries written shortly before the
|
|
|
|
|
# delete operation might not be deleted. Entries received after the delete
|
|
|
|
|
# operation with a timestamp before the operation will be deleted.
|
2021-01-01 03:01:13 +00:00
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+logName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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 [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] 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 [Array<String>, String] resource_names
|
|
|
|
|
# Optional. The resource name that owns the logs: projects/PROJECT_ID/locations/
|
|
|
|
|
# LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID organization/ORGANIZATION_ID/
|
|
|
|
|
# locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID billingAccounts/
|
|
|
|
|
# BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID
|
|
|
|
|
# folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_IDTo
|
|
|
|
|
# support legacy queries, it could also be: "projects/PROJECT_ID" "organizations/
|
|
|
|
|
# ORGANIZATION_ID" "billingAccounts/BILLING_ACCOUNT_ID" "folders/FOLDER_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::LoggingV2::ListLogsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/logs', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLogsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
|
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
|
|
|
command.query['resourceNames'] = resource_names unless resource_names.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 sink that exports specified log entries to a destination. The export
|
|
|
|
|
# of newly-ingested log entries begins immediately, unless the sink's
|
|
|
|
|
# writer_identity is not permitted to write to the destination. A sink can
|
|
|
|
|
# export log entries only from the resource owning the sink.
|
|
|
|
|
# @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::LoggingV2::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 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
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
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. If the sink has a unique writer_identity, then that service
|
|
|
|
|
# account is also deleted.
|
|
|
|
|
# @param [String] sink_name
|
|
|
|
|
# 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
|
|
|
|
|
# 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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# 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 [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] 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 [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::LoggingV2::ListSinksResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_sinks(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListSinksResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a sink. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 patch_billing_account_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_billing_account_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:put, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 that originated
|
|
|
|
|
# from a project/folder/organization/billing account. For ways to export log
|
|
|
|
|
# entries, see Exporting Logs (https://cloud.google.com/logging/docs/export).
|
|
|
|
|
# @param [Google::Apis::LoggingV2::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::LoggingV2::ListLogEntriesResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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, 'v2/entries:list', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::ListLogEntriesRequest::Representation
|
|
|
|
|
command.request_object = list_log_entries_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLogEntriesResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLogEntriesResponse
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Streaming read of log entries as they are ingested. Until the stream is
|
|
|
|
|
# terminated, it will continue reading logs.
|
|
|
|
|
# @param [Google::Apis::LoggingV2::TailLogEntriesRequest] tail_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::LoggingV2::TailLogEntriesResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::TailLogEntriesResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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 tail_entry_log_entries(tail_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/entries:tail', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::TailLogEntriesRequest::Representation
|
|
|
|
|
command.request_object = tail_log_entries_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::TailLogEntriesResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::TailLogEntriesResponse
|
|
|
|
|
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 Logging. This API method is the only way to send log
|
|
|
|
|
# entries to Logging. This method is used, directly or indirectly, by the
|
|
|
|
|
# Logging agent (fluentd) and all logging libraries configured to use Logging. A
|
|
|
|
|
# single request may contain log entries for a maximum of 1000 different
|
|
|
|
|
# resources (projects, organizations, billing accounts or folders)
|
|
|
|
|
# @param [Google::Apis::LoggingV2::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::LoggingV2::WriteLogEntriesResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_entry_log_entries(write_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/entries:write', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::WriteLogEntriesRequest::Representation
|
|
|
|
|
command.request_object = write_log_entries_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::WriteLogEntriesResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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 new exclusion in a specified parent resource. Only log entries
|
|
|
|
|
# belonging to that resource can be excluded. You can have up to 10 exclusions
|
|
|
|
|
# in a resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource in which to create the exclusion: "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
|
|
|
|
|
# project", "organizations/123456789".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_exclusion(parent, log_exclusion_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# Deletes an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion to delete: "projects/[
|
|
|
|
|
# PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets the description of an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless 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 all the exclusions in a parent resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose exclusions are to be listed. "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListExclusionsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListExclusionsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_exclusions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListExclusionsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListExclusionsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Changes one or more properties of an existing exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. A non-empty list of fields to change in the existing exclusion. New
|
|
|
|
|
# values for the fields are taken from the corresponding fields in the
|
|
|
|
|
# LogExclusion included in this request. Fields not mentioned in update_mask are
|
|
|
|
|
# not changed and are ignored in the request.For example, to change the filter
|
|
|
|
|
# and description of an exclusion, specify an update_mask of "filter,description"
|
|
|
|
|
# .
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_exclusion(name, log_exclusion_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 new exclusion in a specified parent resource. Only log entries
|
|
|
|
|
# belonging to that resource can be excluded. You can have up to 10 exclusions
|
|
|
|
|
# in a resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource in which to create the exclusion: "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
|
|
|
|
|
# project", "organizations/123456789".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_exclusion(parent, log_exclusion_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# Deletes an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion to delete: "projects/[
|
|
|
|
|
# PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets the description of an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless 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 all the exclusions in a parent resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose exclusions are to be listed. "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListExclusionsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListExclusionsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_exclusions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListExclusionsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListExclusionsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Changes one or more properties of an existing exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. A non-empty list of fields to change in the existing exclusion. New
|
|
|
|
|
# values for the fields are taken from the corresponding fields in the
|
|
|
|
|
# LogExclusion included in this request. Fields not mentioned in update_mask are
|
|
|
|
|
# not changed and are ignored in the request.For example, to change the filter
|
|
|
|
|
# and description of an exclusion, specify an update_mask of "filter,description"
|
|
|
|
|
# .
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_folder_exclusion(name, log_exclusion_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 information about a location.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Resource name for the location.
|
|
|
|
|
# @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::LoggingV2::Location] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::Location]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_location(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Location::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Location
|
|
|
|
|
command.params['name'] = name unless 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 information about the supported locations for this service.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# The resource that owns the locations collection, if applicable.
|
|
|
|
|
# @param [String] filter
|
|
|
|
|
# The standard list filter.
|
|
|
|
|
# @param [Fixnum] page_size
|
|
|
|
|
# The standard list page size.
|
|
|
|
|
# @param [String] page_token
|
|
|
|
|
# The standard list page token.
|
|
|
|
|
# @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::LoggingV2::ListLocationsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListLocationsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}/locations', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLocationsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLocationsResponse
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['filter'] = filter unless filter.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
|
|
|
|
|
|
|
|
|
|
# Creates a bucket that can be used to store log entries. Once a bucket has been
|
|
|
|
|
# created, the region cannot be changed.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
|
|
|
|
|
# global"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] bucket_id
|
|
|
|
|
# Required. A client-assigned identifier such as "my-bucket". Identifiers are
|
|
|
|
|
# limited to 100 characters and can include only letters, digits, underscores,
|
|
|
|
|
# hyphens, and periods.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['bucketId'] = bucket_id unless bucket_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 a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
|
|
|
|
|
# the bucket will be purged and all logs in the bucket will be permanently
|
|
|
|
|
# deleted.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to delete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
|
|
|
|
|
# my-location/buckets/my-bucket-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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless 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 buckets.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose buckets are to be listed: "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The
|
|
|
|
|
# locations portion of the resource must be specified, but supplying the
|
|
|
|
|
# character - in place of LOCATION_ID will return all buckets.
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListBucketsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListBucketsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a bucket. This method replaces the following fields in the existing
|
|
|
|
|
# bucket with values from the new bucket: retention_periodIf the retention
|
|
|
|
|
# period is decreased and the bucket is locked, FAILED_PRECONDITION will be
|
|
|
|
|
# returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
|
|
|
|
|
# FAILED_PRECONDITION will be returned.A buckets region may not be modified
|
|
|
|
|
# after it is created.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to update. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id". Also requires
|
|
|
|
|
# permission "resourcemanager.projects.updateLiens" to set the locked property
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. Field mask that specifies the fields in bucket that need an update.
|
|
|
|
|
# A bucket field will be overwritten if, and only if, it is in the update mask.
|
|
|
|
|
# name and output only fields cannot be updated.For a detailed FieldMask
|
|
|
|
|
# definition, see https://developers.google.com/protocol-buffers/docs/reference/
|
|
|
|
|
# google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_folder_location_bucket(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Undeletes a bucket. A bucket that has been deleted may be undeleted within the
|
|
|
|
|
# grace period of 7 days.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to undelete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 undelete_folder_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+name}:undelete', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation
|
|
|
|
|
command.request_object = undelete_bucket_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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 view over logs in a bucket. A bucket may contain a maximum of 50
|
|
|
|
|
# views.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket in which to create the view "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
|
|
|
|
|
# project/locations/my-location/buckets/my-bucket"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] view_id
|
|
|
|
|
# Required. The id to use for this view.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/views', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['viewId'] = view_id unless view_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 a view from a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a view.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id/views/my-view-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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless 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 views on a bucket.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListViewsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListViewsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_folder_location_bucket_views(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/views', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListViewsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListViewsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a view. This method replaces the following fields in the existing view
|
|
|
|
|
# with values from the new view: filter.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to update "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in view that need an update. A
|
|
|
|
|
# field will be overwritten if, and only if, it is in the update mask. name and
|
|
|
|
|
# output only fields cannot be updated.For a detailed FieldMask definition, see
|
|
|
|
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
|
|
|
|
|
# google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_folder_location_bucket_view(name, log_view_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
feat: Automated regeneration of logging v2 client (#2261)
This PR was generated using Autosynth. :rainbow:
<details><summary>Log from Synthtool</summary>
```
2021-01-09 02:55:52,454 synthtool [DEBUG] > Executing /home/kbuilder/.cache/synthtool/google-api-ruby-client/synth.py.
On branch autosynth-logging-v2
nothing to commit, working tree clean
2021-01-09 02:55:52,520 synthtool [DEBUG] > Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
DEBUG:synthtool:Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
bundle install
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 11.3.0
Installing rake 11.3.0
Fetching concurrent-ruby 1.1.7
Installing concurrent-ruby 1.1.7
Fetching i18n 1.8.7
Installing i18n 1.8.7
Fetching minitest 5.14.3
Installing minitest 5.14.3
Fetching tzinfo 2.0.4
Installing tzinfo 2.0.4
Fetching zeitwerk 2.4.2
Installing zeitwerk 2.4.2
Fetching activesupport 6.1.1
Installing activesupport 6.1.1
Fetching public_suffix 4.0.6
Installing public_suffix 4.0.6
Fetching addressable 2.7.0
Installing addressable 2.7.0
Fetching ast 2.4.1
Installing ast 2.4.1
Using bundler 2.1.4
Fetching byebug 11.1.3
Installing byebug 11.1.3 with native extensions
Fetching coderay 1.1.3
Installing coderay 1.1.3
Fetching json 2.5.1
Installing json 2.5.1 with native extensions
Fetching docile 1.3.4
Installing docile 1.3.4
Fetching simplecov-html 0.10.2
Installing simplecov-html 0.10.2
Fetching simplecov 0.16.1
Installing simplecov 0.16.1
Using sync 0.5.0
Fetching tins 1.26.0
Installing tins 1.26.0
Fetching term-ansicolor 1.7.1
Installing term-ansicolor 1.7.1
Fetching thor 0.20.3
Installing thor 0.20.3
Fetching coveralls 0.8.23
Installing coveralls 0.8.23
Fetching rexml 3.2.4
Installing rexml 3.2.4
Fetching crack 0.4.5
Installing crack 0.4.5
Fetching declarative 0.0.20
Installing declarative 0.0.20
Fetching declarative-option 0.1.0
Installing declarative-option 0.1.0
Fetching diff-lcs 1.4.4
Installing diff-lcs 1.4.4
Fetching dotenv 2.7.6
Installing dotenv 2.7.6
Fetching fakefs 0.20.1
Installing fakefs 0.20.1
Fetching faraday-net_http 1.0.0
Installing faraday-net_http 1.0.0
Fetching multipart-post 2.1.1
Installing multipart-post 2.1.1
Fetching ruby2_keywords 0.0.2
Installing ruby2_keywords 0.0.2
Fetching faraday 1.3.0
Installing faraday 1.3.0
Fetching gems 1.2.0
Installing gems 1.2.0
Fetching github-markup 1.7.0
Installing github-markup 1.7.0
Fetching jwt 2.2.2
Installing jwt 2.2.2
Fetching memoist 0.16.2
Installing memoist 0.16.2
Fetching multi_json 1.15.0
Installing multi_json 1.15.0
Fetching os 0.9.6
Installing os 0.9.6
Fetching signet 0.14.0
Installing signet 0.14.0
Fetching googleauth 0.14.0
Installing googleauth 0.14.0
Fetching httpclient 2.8.3
Installing httpclient 2.8.3
Fetching mini_mime 1.0.2
Installing mini_mime 1.0.2
Fetching uber 0.1.0
Installing uber 0.1.0
Fetching representable 3.0.4
Installing representable 3.0.4
Fetching retriable 3.1.2
Installing retriable 3.1.2
Fetching google-apis-core 0.2.0
Installing google-apis-core 0.2.0
Fetching google-apis-discovery_v1 0.1.0
Installing google-apis-discovery_v1 0.1.0
Using google-apis-generator 0.1.1 from source at `.`
Fetching google-id-token 1.4.2
Installing google-id-token 1.4.2
Fetching hashdiff 1.0.1
Installing hashdiff 1.0.1
Fetching mime-types-data 3.2020.1104
Installing mime-types-data 3.2020.1104
Fetching mime-types 3.3.1
Installing mime-types 3.3.1
Fetching multi_xml 0.6.0
Installing multi_xml 0.6.0
Fetching httparty 0.18.1
Installing httparty 0.18.1
Fetching rspec-support 3.10.1
Installing rspec-support 3.10.1
Fetching rspec-core 3.10.1
Installing rspec-core 3.10.1
Fetching rspec-expectations 3.10.1
Installing rspec-expectations 3.10.1
Fetching rspec-mocks 3.10.1
Installing rspec-mocks 3.10.1
Fetching rspec 3.10.0
Installing rspec 3.10.0
Fetching json_spec 1.1.5
Installing json_spec 1.1.5
Fetching launchy 2.5.0
Installing launchy 2.5.0
Fetching little-plugger 1.1.4
Installing little-plugger 1.1.4
Fetching logging 2.3.0
Installing logging 2.3.0
Fetching method_source 1.0.0
Installing method_source 1.0.0
Fetching opencensus 0.5.0
Installing opencensus 0.5.0
Fetching parallel 1.20.1
Installing parallel 1.20.1
Fetching parser 2.7.2.0
Installing parser 2.7.2.0
Fetching powerpack 0.1.3
Installing powerpack 0.1.3
Fetching pry 0.13.1
Installing pry 0.13.1
Fetching pry-byebug 3.9.0
Installing pry-byebug 3.9.0
Fetching yard 0.9.26
Installing yard 0.9.26
Fetching pry-doc 0.13.5
Installing pry-doc 0.13.5
Fetching rainbow 2.2.2
Installing rainbow 2.2.2 with native extensions
Fetching redcarpet 3.5.1
Installing redcarpet 3.5.1 with native extensions
Fetching redis 3.3.5
Installing redis 3.3.5
Fetching rmail 1.1.4
Installing rmail 1.1.4
Fetching ruby-progressbar 1.11.0
Installing ruby-progressbar 1.11.0
Fetching unicode-display_width 1.7.0
Installing unicode-display_width 1.7.0
Fetching rubocop 0.49.1
Installing rubocop 0.49.1
Fetching webmock 2.3.2
Installing webmock 2.3.2
Bundle complete! 25 Gemfile dependencies, 81 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
Post-install message from i18n:
HEADS UP! i18n 1.1 changed fallbacks to exclude default locale.
But that may break your application.
If you are upgrading your Rails application from an older version of Rails:
Please check your Rails app for 'config.i18n.fallbacks = true'.
If you're using I18n (>= 1.1.0) and Rails (< 5.2.2), this should be
'config.i18n.fallbacks = [I18n.default_locale]'.
If not, fallbacks will be broken in your app by I18n 1.1.x.
If you are starting a NEW Rails application, you can ignore this notice.
For more info see:
https://github.com/svenfuchs/i18n/releases/tag/v1.1.0
Post-install message from httparty:
When you HTTParty, you must party hard!
echo a | bundle exec bin/generate-api gen /workspace/generated --api=logging.v2 --names=/workspace/api_names.yaml --names-out=/workspace/api_names_out.yaml --spot-check
Loading logging, version v2 from https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/logging.v2.json
W, [2021-01-09T10:56:16.069592 #238] WARN -- : Found reserved property 'method'
W, [2021-01-09T10:56:16.069660 #238] WARN -- : Changed to 'method_prop'
conflict google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
<ging_v2/classes.rb? (enter "h" for help) [Ynaqdhm] a
force google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
conflict google-apis-logging_v2/CHANGELOG.md
force google-apis-logging_v2/CHANGELOG.md
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 13.0.3
Installing rake 13.0.3
Using public_suffix 4.0.6
Using addressable 2.7.0
Using bundler 2.1.4
Using declarative 0.0.20
Using declarative-option 0.1.0
Using diff-lcs 1.4.4
Using faraday-net_http 1.0.0
Using multipart-post 2.1.1
Using ruby2_keywords 0.0.2
Using faraday 1.3.0
Using jwt 2.2.2
Using memoist 0.16.2
Using multi_json 1.15.0
Fetching os 1.1.1
Installing os 1.1.1
Using signet 0.14.0
Using googleauth 0.14.0
Using httpclient 2.8.3
Using mini_mime 1.0.2
Using uber 0.1.0
Using representable 3.0.4
Using retriable 3.1.2
Using rexml 3.2.4
Using google-apis-core 0.2.0
Using google-apis-logging_v2 0.2.0 from source at `.`
Using opencensus 0.5.0
Using redcarpet 3.5.1
Using rspec-support 3.10.1
Using rspec-core 3.10.1
Using rspec-expectations 3.10.1
Using rspec-mocks 3.10.1
Using rspec 3.10.0
Using yard 0.9.26
Bundle complete! 8 Gemfile dependencies, 33 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
/root/.rbenv/versions/2.6.6/bin/ruby -I/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/lib:/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-support-3.10.1/lib /root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/exe/rspec --pattern spec/\*\*\{,/\*/\*\*\}/\*_spec.rb
Google::Apis::LoggingV2
should load
Finished in 0.31798 seconds (files took 0.11097 seconds to load)
1 example, 0 failures
Files: 4
Modules: 3 ( 1 undocumented)
Classes: 44 ( 0 undocumented)
Constants: 9 ( 0 undocumented)
Attributes: 136 ( 0 undocumented)
Methods: 229 ( 0 undocumented)
99.76% documented
google-apis-logging_v2 0.2.0 built to pkg/google-apis-logging_v2-0.2.0.gem.
identical /workspace/api_names_out.yaml
2021-01-09 02:56:31,239 synthtool [DEBUG] > Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
DEBUG:synthtool:Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
```
</details>
Full log will be available here:
https://source.cloud.google.com/results/invocations/2fec3e68-c8da-44a7-8bac-3218258fd2a0/targets
- [ ] To automatically regenerate this PR, check this box.
2021-01-09 11:12:02 +00:00
|
|
|
# Deletes all the log entries in a log for the _Default Log Bucket. The log
|
|
|
|
|
# reappears if it receives new entries. Log entries written shortly before the
|
|
|
|
|
# delete operation might not be deleted. Entries received after the delete
|
|
|
|
|
# operation with a timestamp before the operation will be deleted.
|
2021-01-01 03:01:13 +00:00
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+logName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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 [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] 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 [Array<String>, String] resource_names
|
|
|
|
|
# Optional. The resource name that owns the logs: projects/PROJECT_ID/locations/
|
|
|
|
|
# LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID organization/ORGANIZATION_ID/
|
|
|
|
|
# locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID billingAccounts/
|
|
|
|
|
# BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID
|
|
|
|
|
# folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_IDTo
|
|
|
|
|
# support legacy queries, it could also be: "projects/PROJECT_ID" "organizations/
|
|
|
|
|
# ORGANIZATION_ID" "billingAccounts/BILLING_ACCOUNT_ID" "folders/FOLDER_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::LoggingV2::ListLogsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/logs', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLogsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
|
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
|
|
|
command.query['resourceNames'] = resource_names unless resource_names.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 sink that exports specified log entries to a destination. The export
|
|
|
|
|
# of newly-ingested log entries begins immediately, unless the sink's
|
|
|
|
|
# writer_identity is not permitted to write to the destination. A sink can
|
|
|
|
|
# export log entries only from the resource owning the sink.
|
|
|
|
|
# @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::LoggingV2::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 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
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
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. If the sink has a unique writer_identity, then that service
|
|
|
|
|
# account is also deleted.
|
|
|
|
|
# @param [String] sink_name
|
|
|
|
|
# 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
|
|
|
|
|
# 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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# 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 [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] 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 [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::LoggingV2::ListSinksResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_sinks(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListSinksResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a sink. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 patch_folder_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_folder_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:put, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 information about a location.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Resource name for the location.
|
|
|
|
|
# @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::LoggingV2::Location] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::Location]
|
|
|
|
|
#
|
|
|
|
|
# @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_location(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Location::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Location
|
|
|
|
|
command.params['name'] = name unless 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 information about the supported locations for this service.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# The resource that owns the locations collection, if applicable.
|
|
|
|
|
# @param [String] filter
|
|
|
|
|
# The standard list filter.
|
|
|
|
|
# @param [Fixnum] page_size
|
|
|
|
|
# The standard list page size.
|
|
|
|
|
# @param [String] page_token
|
|
|
|
|
# The standard list page token.
|
|
|
|
|
# @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::LoggingV2::ListLocationsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListLocationsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}/locations', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLocationsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLocationsResponse
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['filter'] = filter unless filter.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
|
|
|
|
|
|
|
|
|
|
# Creates a bucket that can be used to store log entries. Once a bucket has been
|
|
|
|
|
# created, the region cannot be changed.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
|
|
|
|
|
# global"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] bucket_id
|
|
|
|
|
# Required. A client-assigned identifier such as "my-bucket". Identifiers are
|
|
|
|
|
# limited to 100 characters and can include only letters, digits, underscores,
|
|
|
|
|
# hyphens, and periods.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['bucketId'] = bucket_id unless bucket_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 a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
|
|
|
|
|
# the bucket will be purged and all logs in the bucket will be permanently
|
|
|
|
|
# deleted.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to delete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
|
|
|
|
|
# my-location/buckets/my-bucket-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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless 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 buckets.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose buckets are to be listed: "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The
|
|
|
|
|
# locations portion of the resource must be specified, but supplying the
|
|
|
|
|
# character - in place of LOCATION_ID will return all buckets.
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListBucketsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListBucketsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a bucket. This method replaces the following fields in the existing
|
|
|
|
|
# bucket with values from the new bucket: retention_periodIf the retention
|
|
|
|
|
# period is decreased and the bucket is locked, FAILED_PRECONDITION will be
|
|
|
|
|
# returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
|
|
|
|
|
# FAILED_PRECONDITION will be returned.A buckets region may not be modified
|
|
|
|
|
# after it is created.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to update. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id". Also requires
|
|
|
|
|
# permission "resourcemanager.projects.updateLiens" to set the locked property
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. Field mask that specifies the fields in bucket that need an update.
|
|
|
|
|
# A bucket field will be overwritten if, and only if, it is in the update mask.
|
|
|
|
|
# name and output only fields cannot be updated.For a detailed FieldMask
|
|
|
|
|
# definition, see https://developers.google.com/protocol-buffers/docs/reference/
|
|
|
|
|
# google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_location_bucket(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Undeletes a bucket. A bucket that has been deleted may be undeleted within the
|
|
|
|
|
# grace period of 7 days.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to undelete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 undelete_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+name}:undelete', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation
|
|
|
|
|
command.request_object = undelete_bucket_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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 view over logs in a bucket. A bucket may contain a maximum of 50
|
|
|
|
|
# views.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket in which to create the view "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
|
|
|
|
|
# project/locations/my-location/buckets/my-bucket"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] view_id
|
|
|
|
|
# Required. The id to use for this view.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/views', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['viewId'] = view_id unless view_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 a view from a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a view.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id/views/my-view-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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless 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 views on a bucket.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListViewsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListViewsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket_views(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/views', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListViewsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListViewsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a view. This method replaces the following fields in the existing view
|
|
|
|
|
# with values from the new view: filter.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to update "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in view that need an update. A
|
|
|
|
|
# field will be overwritten if, and only if, it is in the update mask. name and
|
|
|
|
|
# output only fields cannot be updated.For a detailed FieldMask definition, see
|
|
|
|
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
|
|
|
|
|
# google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_location_bucket_view(name, log_view_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
feat: Automated regeneration of logging v2 client (#2261)
This PR was generated using Autosynth. :rainbow:
<details><summary>Log from Synthtool</summary>
```
2021-01-09 02:55:52,454 synthtool [DEBUG] > Executing /home/kbuilder/.cache/synthtool/google-api-ruby-client/synth.py.
On branch autosynth-logging-v2
nothing to commit, working tree clean
2021-01-09 02:55:52,520 synthtool [DEBUG] > Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
DEBUG:synthtool:Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
bundle install
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 11.3.0
Installing rake 11.3.0
Fetching concurrent-ruby 1.1.7
Installing concurrent-ruby 1.1.7
Fetching i18n 1.8.7
Installing i18n 1.8.7
Fetching minitest 5.14.3
Installing minitest 5.14.3
Fetching tzinfo 2.0.4
Installing tzinfo 2.0.4
Fetching zeitwerk 2.4.2
Installing zeitwerk 2.4.2
Fetching activesupport 6.1.1
Installing activesupport 6.1.1
Fetching public_suffix 4.0.6
Installing public_suffix 4.0.6
Fetching addressable 2.7.0
Installing addressable 2.7.0
Fetching ast 2.4.1
Installing ast 2.4.1
Using bundler 2.1.4
Fetching byebug 11.1.3
Installing byebug 11.1.3 with native extensions
Fetching coderay 1.1.3
Installing coderay 1.1.3
Fetching json 2.5.1
Installing json 2.5.1 with native extensions
Fetching docile 1.3.4
Installing docile 1.3.4
Fetching simplecov-html 0.10.2
Installing simplecov-html 0.10.2
Fetching simplecov 0.16.1
Installing simplecov 0.16.1
Using sync 0.5.0
Fetching tins 1.26.0
Installing tins 1.26.0
Fetching term-ansicolor 1.7.1
Installing term-ansicolor 1.7.1
Fetching thor 0.20.3
Installing thor 0.20.3
Fetching coveralls 0.8.23
Installing coveralls 0.8.23
Fetching rexml 3.2.4
Installing rexml 3.2.4
Fetching crack 0.4.5
Installing crack 0.4.5
Fetching declarative 0.0.20
Installing declarative 0.0.20
Fetching declarative-option 0.1.0
Installing declarative-option 0.1.0
Fetching diff-lcs 1.4.4
Installing diff-lcs 1.4.4
Fetching dotenv 2.7.6
Installing dotenv 2.7.6
Fetching fakefs 0.20.1
Installing fakefs 0.20.1
Fetching faraday-net_http 1.0.0
Installing faraday-net_http 1.0.0
Fetching multipart-post 2.1.1
Installing multipart-post 2.1.1
Fetching ruby2_keywords 0.0.2
Installing ruby2_keywords 0.0.2
Fetching faraday 1.3.0
Installing faraday 1.3.0
Fetching gems 1.2.0
Installing gems 1.2.0
Fetching github-markup 1.7.0
Installing github-markup 1.7.0
Fetching jwt 2.2.2
Installing jwt 2.2.2
Fetching memoist 0.16.2
Installing memoist 0.16.2
Fetching multi_json 1.15.0
Installing multi_json 1.15.0
Fetching os 0.9.6
Installing os 0.9.6
Fetching signet 0.14.0
Installing signet 0.14.0
Fetching googleauth 0.14.0
Installing googleauth 0.14.0
Fetching httpclient 2.8.3
Installing httpclient 2.8.3
Fetching mini_mime 1.0.2
Installing mini_mime 1.0.2
Fetching uber 0.1.0
Installing uber 0.1.0
Fetching representable 3.0.4
Installing representable 3.0.4
Fetching retriable 3.1.2
Installing retriable 3.1.2
Fetching google-apis-core 0.2.0
Installing google-apis-core 0.2.0
Fetching google-apis-discovery_v1 0.1.0
Installing google-apis-discovery_v1 0.1.0
Using google-apis-generator 0.1.1 from source at `.`
Fetching google-id-token 1.4.2
Installing google-id-token 1.4.2
Fetching hashdiff 1.0.1
Installing hashdiff 1.0.1
Fetching mime-types-data 3.2020.1104
Installing mime-types-data 3.2020.1104
Fetching mime-types 3.3.1
Installing mime-types 3.3.1
Fetching multi_xml 0.6.0
Installing multi_xml 0.6.0
Fetching httparty 0.18.1
Installing httparty 0.18.1
Fetching rspec-support 3.10.1
Installing rspec-support 3.10.1
Fetching rspec-core 3.10.1
Installing rspec-core 3.10.1
Fetching rspec-expectations 3.10.1
Installing rspec-expectations 3.10.1
Fetching rspec-mocks 3.10.1
Installing rspec-mocks 3.10.1
Fetching rspec 3.10.0
Installing rspec 3.10.0
Fetching json_spec 1.1.5
Installing json_spec 1.1.5
Fetching launchy 2.5.0
Installing launchy 2.5.0
Fetching little-plugger 1.1.4
Installing little-plugger 1.1.4
Fetching logging 2.3.0
Installing logging 2.3.0
Fetching method_source 1.0.0
Installing method_source 1.0.0
Fetching opencensus 0.5.0
Installing opencensus 0.5.0
Fetching parallel 1.20.1
Installing parallel 1.20.1
Fetching parser 2.7.2.0
Installing parser 2.7.2.0
Fetching powerpack 0.1.3
Installing powerpack 0.1.3
Fetching pry 0.13.1
Installing pry 0.13.1
Fetching pry-byebug 3.9.0
Installing pry-byebug 3.9.0
Fetching yard 0.9.26
Installing yard 0.9.26
Fetching pry-doc 0.13.5
Installing pry-doc 0.13.5
Fetching rainbow 2.2.2
Installing rainbow 2.2.2 with native extensions
Fetching redcarpet 3.5.1
Installing redcarpet 3.5.1 with native extensions
Fetching redis 3.3.5
Installing redis 3.3.5
Fetching rmail 1.1.4
Installing rmail 1.1.4
Fetching ruby-progressbar 1.11.0
Installing ruby-progressbar 1.11.0
Fetching unicode-display_width 1.7.0
Installing unicode-display_width 1.7.0
Fetching rubocop 0.49.1
Installing rubocop 0.49.1
Fetching webmock 2.3.2
Installing webmock 2.3.2
Bundle complete! 25 Gemfile dependencies, 81 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
Post-install message from i18n:
HEADS UP! i18n 1.1 changed fallbacks to exclude default locale.
But that may break your application.
If you are upgrading your Rails application from an older version of Rails:
Please check your Rails app for 'config.i18n.fallbacks = true'.
If you're using I18n (>= 1.1.0) and Rails (< 5.2.2), this should be
'config.i18n.fallbacks = [I18n.default_locale]'.
If not, fallbacks will be broken in your app by I18n 1.1.x.
If you are starting a NEW Rails application, you can ignore this notice.
For more info see:
https://github.com/svenfuchs/i18n/releases/tag/v1.1.0
Post-install message from httparty:
When you HTTParty, you must party hard!
echo a | bundle exec bin/generate-api gen /workspace/generated --api=logging.v2 --names=/workspace/api_names.yaml --names-out=/workspace/api_names_out.yaml --spot-check
Loading logging, version v2 from https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/logging.v2.json
W, [2021-01-09T10:56:16.069592 #238] WARN -- : Found reserved property 'method'
W, [2021-01-09T10:56:16.069660 #238] WARN -- : Changed to 'method_prop'
conflict google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
<ging_v2/classes.rb? (enter "h" for help) [Ynaqdhm] a
force google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
conflict google-apis-logging_v2/CHANGELOG.md
force google-apis-logging_v2/CHANGELOG.md
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 13.0.3
Installing rake 13.0.3
Using public_suffix 4.0.6
Using addressable 2.7.0
Using bundler 2.1.4
Using declarative 0.0.20
Using declarative-option 0.1.0
Using diff-lcs 1.4.4
Using faraday-net_http 1.0.0
Using multipart-post 2.1.1
Using ruby2_keywords 0.0.2
Using faraday 1.3.0
Using jwt 2.2.2
Using memoist 0.16.2
Using multi_json 1.15.0
Fetching os 1.1.1
Installing os 1.1.1
Using signet 0.14.0
Using googleauth 0.14.0
Using httpclient 2.8.3
Using mini_mime 1.0.2
Using uber 0.1.0
Using representable 3.0.4
Using retriable 3.1.2
Using rexml 3.2.4
Using google-apis-core 0.2.0
Using google-apis-logging_v2 0.2.0 from source at `.`
Using opencensus 0.5.0
Using redcarpet 3.5.1
Using rspec-support 3.10.1
Using rspec-core 3.10.1
Using rspec-expectations 3.10.1
Using rspec-mocks 3.10.1
Using rspec 3.10.0
Using yard 0.9.26
Bundle complete! 8 Gemfile dependencies, 33 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
/root/.rbenv/versions/2.6.6/bin/ruby -I/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/lib:/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-support-3.10.1/lib /root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/exe/rspec --pattern spec/\*\*\{,/\*/\*\*\}/\*_spec.rb
Google::Apis::LoggingV2
should load
Finished in 0.31798 seconds (files took 0.11097 seconds to load)
1 example, 0 failures
Files: 4
Modules: 3 ( 1 undocumented)
Classes: 44 ( 0 undocumented)
Constants: 9 ( 0 undocumented)
Attributes: 136 ( 0 undocumented)
Methods: 229 ( 0 undocumented)
99.76% documented
google-apis-logging_v2 0.2.0 built to pkg/google-apis-logging_v2-0.2.0.gem.
identical /workspace/api_names_out.yaml
2021-01-09 02:56:31,239 synthtool [DEBUG] > Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
DEBUG:synthtool:Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
```
</details>
Full log will be available here:
https://source.cloud.google.com/results/invocations/2fec3e68-c8da-44a7-8bac-3218258fd2a0/targets
- [ ] To automatically regenerate this PR, check this box.
2021-01-09 11:12:02 +00:00
|
|
|
# Deletes all the log entries in a log for the _Default Log Bucket. The log
|
|
|
|
|
# reappears if it receives new entries. Log entries written shortly before the
|
|
|
|
|
# delete operation might not be deleted. Entries received after the delete
|
|
|
|
|
# operation with a timestamp before the operation will be deleted.
|
2021-01-01 03:01:13 +00:00
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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, 'v2/{+logName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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 [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] 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 [Array<String>, String] resource_names
|
|
|
|
|
# Optional. The resource name that owns the logs: projects/PROJECT_ID/locations/
|
|
|
|
|
# LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID organization/ORGANIZATION_ID/
|
|
|
|
|
# locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID billingAccounts/
|
|
|
|
|
# BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID
|
|
|
|
|
# folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_IDTo
|
|
|
|
|
# support legacy queries, it could also be: "projects/PROJECT_ID" "organizations/
|
|
|
|
|
# ORGANIZATION_ID" "billingAccounts/BILLING_ACCOUNT_ID" "folders/FOLDER_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::LoggingV2::ListLogsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/logs', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLogsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
|
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
|
|
|
command.query['resourceNames'] = resource_names unless resource_names.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 descriptors for monitored resource types used by Logging.
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListMonitoredResourceDescriptorsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/monitoredResourceDescriptors', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListMonitoredResourceDescriptorsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListMonitoredResourceDescriptorsResponse
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# Gets the Logs Router CMEK settings for the given resource.Note: CMEK for the
|
|
|
|
|
# Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.See
|
|
|
|
|
# Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/
|
|
|
|
|
# managed-encryption) for more information.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource for which to retrieve CMEK settings. "projects/[
|
|
|
|
|
# PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
|
|
|
|
|
# billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
|
|
|
|
|
# cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
|
|
|
|
|
# Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.
|
|
|
|
|
# @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::LoggingV2::CmekSettings] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::CmekSettings]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_cmek_settings(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}/cmekSettings', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::CmekSettings
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
|
|
|
|
|
# the Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.
|
|
|
|
|
# UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
|
|
|
|
|
# associated service account does not have the required roles/cloudkms.
|
|
|
|
|
# cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
|
|
|
|
|
# is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/
|
|
|
|
|
# logging/docs/routing/managed-encryption) for more information.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name for the CMEK settings to update. "projects/[
|
|
|
|
|
# PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
|
|
|
|
|
# billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
|
|
|
|
|
# cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
|
|
|
|
|
# Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.
|
|
|
|
|
# @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask identifying which fields from cmek_settings should be
|
|
|
|
|
# updated. A field will be overwritten if and only if it is in the update mask.
|
|
|
|
|
# Output only fields cannot be updated.See FieldMask for more information.
|
|
|
|
|
# Example: "updateMask=kmsKeyName"
|
|
|
|
|
# @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::LoggingV2::CmekSettings] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::CmekSettings]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_cmek_settings(name, cmek_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}/cmekSettings', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::CmekSettings::Representation
|
|
|
|
|
command.request_object = cmek_settings_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::CmekSettings
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 new exclusion in a specified parent resource. Only log entries
|
|
|
|
|
# belonging to that resource can be excluded. You can have up to 10 exclusions
|
|
|
|
|
# in a resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource in which to create the exclusion: "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
|
|
|
|
|
# project", "organizations/123456789".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_exclusion(parent, log_exclusion_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# Deletes an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion to delete: "projects/[
|
|
|
|
|
# PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets the description of an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless 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 all the exclusions in a parent resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose exclusions are to be listed. "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListExclusionsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListExclusionsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_exclusions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListExclusionsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListExclusionsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Changes one or more properties of an existing exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. A non-empty list of fields to change in the existing exclusion. New
|
|
|
|
|
# values for the fields are taken from the corresponding fields in the
|
|
|
|
|
# LogExclusion included in this request. Fields not mentioned in update_mask are
|
|
|
|
|
# not changed and are ignored in the request.For example, to change the filter
|
|
|
|
|
# and description of an exclusion, specify an update_mask of "filter,description"
|
|
|
|
|
# .
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_organization_exclusion(name, log_exclusion_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 information about a location.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Resource name for the location.
|
|
|
|
|
# @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::LoggingV2::Location] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::Location]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_location(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Location::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Location
|
|
|
|
|
command.params['name'] = name unless 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 information about the supported locations for this service.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# The resource that owns the locations collection, if applicable.
|
|
|
|
|
# @param [String] filter
|
|
|
|
|
# The standard list filter.
|
|
|
|
|
# @param [Fixnum] page_size
|
|
|
|
|
# The standard list page size.
|
|
|
|
|
# @param [String] page_token
|
|
|
|
|
# The standard list page token.
|
|
|
|
|
# @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::LoggingV2::ListLocationsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListLocationsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}/locations', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLocationsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLocationsResponse
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['filter'] = filter unless filter.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
|
|
|
|
|
|
|
|
|
|
# Creates a bucket that can be used to store log entries. Once a bucket has been
|
|
|
|
|
# created, the region cannot be changed.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
|
|
|
|
|
# global"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] bucket_id
|
|
|
|
|
# Required. A client-assigned identifier such as "my-bucket". Identifiers are
|
|
|
|
|
# limited to 100 characters and can include only letters, digits, underscores,
|
|
|
|
|
# hyphens, and periods.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['bucketId'] = bucket_id unless bucket_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 a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
|
|
|
|
|
# the bucket will be purged and all logs in the bucket will be permanently
|
|
|
|
|
# deleted.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to delete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
|
|
|
|
|
# my-location/buckets/my-bucket-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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless 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 buckets.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose buckets are to be listed: "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The
|
|
|
|
|
# locations portion of the resource must be specified, but supplying the
|
|
|
|
|
# character - in place of LOCATION_ID will return all buckets.
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListBucketsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListBucketsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a bucket. This method replaces the following fields in the existing
|
|
|
|
|
# bucket with values from the new bucket: retention_periodIf the retention
|
|
|
|
|
# period is decreased and the bucket is locked, FAILED_PRECONDITION will be
|
|
|
|
|
# returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
|
|
|
|
|
# FAILED_PRECONDITION will be returned.A buckets region may not be modified
|
|
|
|
|
# after it is created.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to update. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id". Also requires
|
|
|
|
|
# permission "resourcemanager.projects.updateLiens" to set the locked property
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. Field mask that specifies the fields in bucket that need an update.
|
|
|
|
|
# A bucket field will be overwritten if, and only if, it is in the update mask.
|
|
|
|
|
# name and output only fields cannot be updated.For a detailed FieldMask
|
|
|
|
|
# definition, see https://developers.google.com/protocol-buffers/docs/reference/
|
|
|
|
|
# google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_organization_location_bucket(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Undeletes a bucket. A bucket that has been deleted may be undeleted within the
|
|
|
|
|
# grace period of 7 days.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to undelete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 undelete_organization_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+name}:undelete', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation
|
|
|
|
|
command.request_object = undelete_bucket_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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 view over logs in a bucket. A bucket may contain a maximum of 50
|
|
|
|
|
# views.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket in which to create the view "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
|
|
|
|
|
# project/locations/my-location/buckets/my-bucket"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] view_id
|
|
|
|
|
# Required. The id to use for this view.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/views', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['viewId'] = view_id unless view_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 a view from a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a view.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id/views/my-view-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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless 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 views on a bucket.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListViewsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListViewsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_organization_location_bucket_views(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/views', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListViewsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListViewsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a view. This method replaces the following fields in the existing view
|
|
|
|
|
# with values from the new view: filter.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to update "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in view that need an update. A
|
|
|
|
|
# field will be overwritten if, and only if, it is in the update mask. name and
|
|
|
|
|
# output only fields cannot be updated.For a detailed FieldMask definition, see
|
|
|
|
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
|
|
|
|
|
# google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_organization_location_bucket_view(name, log_view_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
feat: Automated regeneration of logging v2 client (#2261)
This PR was generated using Autosynth. :rainbow:
<details><summary>Log from Synthtool</summary>
```
2021-01-09 02:55:52,454 synthtool [DEBUG] > Executing /home/kbuilder/.cache/synthtool/google-api-ruby-client/synth.py.
On branch autosynth-logging-v2
nothing to commit, working tree clean
2021-01-09 02:55:52,520 synthtool [DEBUG] > Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
DEBUG:synthtool:Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
bundle install
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 11.3.0
Installing rake 11.3.0
Fetching concurrent-ruby 1.1.7
Installing concurrent-ruby 1.1.7
Fetching i18n 1.8.7
Installing i18n 1.8.7
Fetching minitest 5.14.3
Installing minitest 5.14.3
Fetching tzinfo 2.0.4
Installing tzinfo 2.0.4
Fetching zeitwerk 2.4.2
Installing zeitwerk 2.4.2
Fetching activesupport 6.1.1
Installing activesupport 6.1.1
Fetching public_suffix 4.0.6
Installing public_suffix 4.0.6
Fetching addressable 2.7.0
Installing addressable 2.7.0
Fetching ast 2.4.1
Installing ast 2.4.1
Using bundler 2.1.4
Fetching byebug 11.1.3
Installing byebug 11.1.3 with native extensions
Fetching coderay 1.1.3
Installing coderay 1.1.3
Fetching json 2.5.1
Installing json 2.5.1 with native extensions
Fetching docile 1.3.4
Installing docile 1.3.4
Fetching simplecov-html 0.10.2
Installing simplecov-html 0.10.2
Fetching simplecov 0.16.1
Installing simplecov 0.16.1
Using sync 0.5.0
Fetching tins 1.26.0
Installing tins 1.26.0
Fetching term-ansicolor 1.7.1
Installing term-ansicolor 1.7.1
Fetching thor 0.20.3
Installing thor 0.20.3
Fetching coveralls 0.8.23
Installing coveralls 0.8.23
Fetching rexml 3.2.4
Installing rexml 3.2.4
Fetching crack 0.4.5
Installing crack 0.4.5
Fetching declarative 0.0.20
Installing declarative 0.0.20
Fetching declarative-option 0.1.0
Installing declarative-option 0.1.0
Fetching diff-lcs 1.4.4
Installing diff-lcs 1.4.4
Fetching dotenv 2.7.6
Installing dotenv 2.7.6
Fetching fakefs 0.20.1
Installing fakefs 0.20.1
Fetching faraday-net_http 1.0.0
Installing faraday-net_http 1.0.0
Fetching multipart-post 2.1.1
Installing multipart-post 2.1.1
Fetching ruby2_keywords 0.0.2
Installing ruby2_keywords 0.0.2
Fetching faraday 1.3.0
Installing faraday 1.3.0
Fetching gems 1.2.0
Installing gems 1.2.0
Fetching github-markup 1.7.0
Installing github-markup 1.7.0
Fetching jwt 2.2.2
Installing jwt 2.2.2
Fetching memoist 0.16.2
Installing memoist 0.16.2
Fetching multi_json 1.15.0
Installing multi_json 1.15.0
Fetching os 0.9.6
Installing os 0.9.6
Fetching signet 0.14.0
Installing signet 0.14.0
Fetching googleauth 0.14.0
Installing googleauth 0.14.0
Fetching httpclient 2.8.3
Installing httpclient 2.8.3
Fetching mini_mime 1.0.2
Installing mini_mime 1.0.2
Fetching uber 0.1.0
Installing uber 0.1.0
Fetching representable 3.0.4
Installing representable 3.0.4
Fetching retriable 3.1.2
Installing retriable 3.1.2
Fetching google-apis-core 0.2.0
Installing google-apis-core 0.2.0
Fetching google-apis-discovery_v1 0.1.0
Installing google-apis-discovery_v1 0.1.0
Using google-apis-generator 0.1.1 from source at `.`
Fetching google-id-token 1.4.2
Installing google-id-token 1.4.2
Fetching hashdiff 1.0.1
Installing hashdiff 1.0.1
Fetching mime-types-data 3.2020.1104
Installing mime-types-data 3.2020.1104
Fetching mime-types 3.3.1
Installing mime-types 3.3.1
Fetching multi_xml 0.6.0
Installing multi_xml 0.6.0
Fetching httparty 0.18.1
Installing httparty 0.18.1
Fetching rspec-support 3.10.1
Installing rspec-support 3.10.1
Fetching rspec-core 3.10.1
Installing rspec-core 3.10.1
Fetching rspec-expectations 3.10.1
Installing rspec-expectations 3.10.1
Fetching rspec-mocks 3.10.1
Installing rspec-mocks 3.10.1
Fetching rspec 3.10.0
Installing rspec 3.10.0
Fetching json_spec 1.1.5
Installing json_spec 1.1.5
Fetching launchy 2.5.0
Installing launchy 2.5.0
Fetching little-plugger 1.1.4
Installing little-plugger 1.1.4
Fetching logging 2.3.0
Installing logging 2.3.0
Fetching method_source 1.0.0
Installing method_source 1.0.0
Fetching opencensus 0.5.0
Installing opencensus 0.5.0
Fetching parallel 1.20.1
Installing parallel 1.20.1
Fetching parser 2.7.2.0
Installing parser 2.7.2.0
Fetching powerpack 0.1.3
Installing powerpack 0.1.3
Fetching pry 0.13.1
Installing pry 0.13.1
Fetching pry-byebug 3.9.0
Installing pry-byebug 3.9.0
Fetching yard 0.9.26
Installing yard 0.9.26
Fetching pry-doc 0.13.5
Installing pry-doc 0.13.5
Fetching rainbow 2.2.2
Installing rainbow 2.2.2 with native extensions
Fetching redcarpet 3.5.1
Installing redcarpet 3.5.1 with native extensions
Fetching redis 3.3.5
Installing redis 3.3.5
Fetching rmail 1.1.4
Installing rmail 1.1.4
Fetching ruby-progressbar 1.11.0
Installing ruby-progressbar 1.11.0
Fetching unicode-display_width 1.7.0
Installing unicode-display_width 1.7.0
Fetching rubocop 0.49.1
Installing rubocop 0.49.1
Fetching webmock 2.3.2
Installing webmock 2.3.2
Bundle complete! 25 Gemfile dependencies, 81 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
Post-install message from i18n:
HEADS UP! i18n 1.1 changed fallbacks to exclude default locale.
But that may break your application.
If you are upgrading your Rails application from an older version of Rails:
Please check your Rails app for 'config.i18n.fallbacks = true'.
If you're using I18n (>= 1.1.0) and Rails (< 5.2.2), this should be
'config.i18n.fallbacks = [I18n.default_locale]'.
If not, fallbacks will be broken in your app by I18n 1.1.x.
If you are starting a NEW Rails application, you can ignore this notice.
For more info see:
https://github.com/svenfuchs/i18n/releases/tag/v1.1.0
Post-install message from httparty:
When you HTTParty, you must party hard!
echo a | bundle exec bin/generate-api gen /workspace/generated --api=logging.v2 --names=/workspace/api_names.yaml --names-out=/workspace/api_names_out.yaml --spot-check
Loading logging, version v2 from https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/logging.v2.json
W, [2021-01-09T10:56:16.069592 #238] WARN -- : Found reserved property 'method'
W, [2021-01-09T10:56:16.069660 #238] WARN -- : Changed to 'method_prop'
conflict google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
<ging_v2/classes.rb? (enter "h" for help) [Ynaqdhm] a
force google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
conflict google-apis-logging_v2/CHANGELOG.md
force google-apis-logging_v2/CHANGELOG.md
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 13.0.3
Installing rake 13.0.3
Using public_suffix 4.0.6
Using addressable 2.7.0
Using bundler 2.1.4
Using declarative 0.0.20
Using declarative-option 0.1.0
Using diff-lcs 1.4.4
Using faraday-net_http 1.0.0
Using multipart-post 2.1.1
Using ruby2_keywords 0.0.2
Using faraday 1.3.0
Using jwt 2.2.2
Using memoist 0.16.2
Using multi_json 1.15.0
Fetching os 1.1.1
Installing os 1.1.1
Using signet 0.14.0
Using googleauth 0.14.0
Using httpclient 2.8.3
Using mini_mime 1.0.2
Using uber 0.1.0
Using representable 3.0.4
Using retriable 3.1.2
Using rexml 3.2.4
Using google-apis-core 0.2.0
Using google-apis-logging_v2 0.2.0 from source at `.`
Using opencensus 0.5.0
Using redcarpet 3.5.1
Using rspec-support 3.10.1
Using rspec-core 3.10.1
Using rspec-expectations 3.10.1
Using rspec-mocks 3.10.1
Using rspec 3.10.0
Using yard 0.9.26
Bundle complete! 8 Gemfile dependencies, 33 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
/root/.rbenv/versions/2.6.6/bin/ruby -I/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/lib:/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-support-3.10.1/lib /root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/exe/rspec --pattern spec/\*\*\{,/\*/\*\*\}/\*_spec.rb
Google::Apis::LoggingV2
should load
Finished in 0.31798 seconds (files took 0.11097 seconds to load)
1 example, 0 failures
Files: 4
Modules: 3 ( 1 undocumented)
Classes: 44 ( 0 undocumented)
Constants: 9 ( 0 undocumented)
Attributes: 136 ( 0 undocumented)
Methods: 229 ( 0 undocumented)
99.76% documented
google-apis-logging_v2 0.2.0 built to pkg/google-apis-logging_v2-0.2.0.gem.
identical /workspace/api_names_out.yaml
2021-01-09 02:56:31,239 synthtool [DEBUG] > Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
DEBUG:synthtool:Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
```
</details>
Full log will be available here:
https://source.cloud.google.com/results/invocations/2fec3e68-c8da-44a7-8bac-3218258fd2a0/targets
- [ ] To automatically regenerate this PR, check this box.
2021-01-09 11:12:02 +00:00
|
|
|
# Deletes all the log entries in a log for the _Default Log Bucket. The log
|
|
|
|
|
# reappears if it receives new entries. Log entries written shortly before the
|
|
|
|
|
# delete operation might not be deleted. Entries received after the delete
|
|
|
|
|
# operation with a timestamp before the operation will be deleted.
|
2021-01-01 03:01:13 +00:00
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+logName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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 [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] 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 [Array<String>, String] resource_names
|
|
|
|
|
# Optional. The resource name that owns the logs: projects/PROJECT_ID/locations/
|
|
|
|
|
# LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID organization/ORGANIZATION_ID/
|
|
|
|
|
# locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID billingAccounts/
|
|
|
|
|
# BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID
|
|
|
|
|
# folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_IDTo
|
|
|
|
|
# support legacy queries, it could also be: "projects/PROJECT_ID" "organizations/
|
|
|
|
|
# ORGANIZATION_ID" "billingAccounts/BILLING_ACCOUNT_ID" "folders/FOLDER_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::LoggingV2::ListLogsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/logs', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLogsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
|
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
|
|
|
command.query['resourceNames'] = resource_names unless resource_names.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 sink that exports specified log entries to a destination. The export
|
|
|
|
|
# of newly-ingested log entries begins immediately, unless the sink's
|
|
|
|
|
# writer_identity is not permitted to write to the destination. A sink can
|
|
|
|
|
# export log entries only from the resource owning the sink.
|
|
|
|
|
# @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::LoggingV2::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 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
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
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. If the sink has a unique writer_identity, then that service
|
|
|
|
|
# account is also deleted.
|
|
|
|
|
# @param [String] sink_name
|
|
|
|
|
# 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
|
|
|
|
|
# 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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# 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 [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] 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 [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::LoggingV2::ListSinksResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_sinks(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListSinksResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a sink. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 patch_organization_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_organization_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:put, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 new exclusion in a specified parent resource. Only log entries
|
|
|
|
|
# belonging to that resource can be excluded. You can have up to 10 exclusions
|
|
|
|
|
# in a resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource in which to create the exclusion: "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
|
|
|
|
|
# project", "organizations/123456789".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_exclusion(parent, log_exclusion_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# Deletes an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion to delete: "projects/[
|
|
|
|
|
# PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets the description of an exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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_exclusion(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless 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 all the exclusions in a parent resource.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose exclusions are to be listed. "projects/[
|
|
|
|
|
# PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
|
|
|
|
|
# BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListExclusionsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListExclusionsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_exclusions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/exclusions', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListExclusionsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListExclusionsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Changes one or more properties of an existing exclusion.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
|
|
|
|
|
# exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
|
|
|
|
|
# EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
|
|
|
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
|
|
|
|
|
# id/exclusions/my-exclusion-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. A non-empty list of fields to change in the existing exclusion. New
|
|
|
|
|
# values for the fields are taken from the corresponding fields in the
|
|
|
|
|
# LogExclusion included in this request. Fields not mentioned in update_mask are
|
|
|
|
|
# not changed and are ignored in the request.For example, to change the filter
|
|
|
|
|
# and description of an exclusion, specify an update_mask of "filter,description"
|
|
|
|
|
# .
|
|
|
|
|
# @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::LoggingV2::LogExclusion] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogExclusion]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_project_exclusion(name, log_exclusion_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.request_object = log_exclusion_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogExclusion
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 information about a location.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Resource name for the location.
|
|
|
|
|
# @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::LoggingV2::Location] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::Location]
|
|
|
|
|
#
|
|
|
|
|
# @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_location(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Location::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Location
|
|
|
|
|
command.params['name'] = name unless 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 information about the supported locations for this service.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# The resource that owns the locations collection, if applicable.
|
|
|
|
|
# @param [String] filter
|
|
|
|
|
# The standard list filter.
|
|
|
|
|
# @param [Fixnum] page_size
|
|
|
|
|
# The standard list page size.
|
|
|
|
|
# @param [String] page_token
|
|
|
|
|
# The standard list page token.
|
|
|
|
|
# @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::LoggingV2::ListLocationsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListLocationsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}/locations', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLocationsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLocationsResponse
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['filter'] = filter unless filter.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
|
|
|
|
|
|
|
|
|
|
# Creates a bucket that can be used to store log entries. Once a bucket has been
|
|
|
|
|
# created, the region cannot be changed.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
|
|
|
|
|
# global"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] bucket_id
|
|
|
|
|
# Required. A client-assigned identifier such as "my-bucket". Identifiers are
|
|
|
|
|
# limited to 100 characters and can include only letters, digits, underscores,
|
|
|
|
|
# hyphens, and periods.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket(parent, log_bucket_object = nil, bucket_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['bucketId'] = bucket_id unless bucket_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 a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
|
|
|
|
|
# the bucket will be purged and all logs in the bucket will be permanently
|
|
|
|
|
# deleted.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to delete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
|
|
|
|
|
# my-location/buckets/my-bucket-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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless 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 buckets.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The parent resource whose buckets are to be listed: "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]" "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The
|
|
|
|
|
# locations portion of the resource must be specified, but supplying the
|
|
|
|
|
# character - in place of LOCATION_ID will return all buckets.
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListBucketsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListBucketsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a bucket. This method replaces the following fields in the existing
|
|
|
|
|
# bucket with values from the new bucket: retention_periodIf the retention
|
|
|
|
|
# period is decreased and the bucket is locked, FAILED_PRECONDITION will be
|
|
|
|
|
# returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
|
|
|
|
|
# FAILED_PRECONDITION will be returned.A buckets region may not be modified
|
|
|
|
|
# after it is created.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to update. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id". Also requires
|
|
|
|
|
# permission "resourcemanager.projects.updateLiens" to set the locked property
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Required. Field mask that specifies the fields in bucket that need an update.
|
|
|
|
|
# A bucket field will be overwritten if, and only if, it is in the update mask.
|
|
|
|
|
# name and output only fields cannot be updated.For a detailed FieldMask
|
|
|
|
|
# definition, see https://developers.google.com/protocol-buffers/docs/reference/
|
|
|
|
|
# google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
|
|
|
|
|
# @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::LoggingV2::LogBucket] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogBucket]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_project_location_bucket(name, log_bucket_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.request_object = log_bucket_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogBucket::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogBucket
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Undeletes a bucket. A bucket that has been deleted may be undeleted within the
|
|
|
|
|
# grace period of 7 days.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the bucket to undelete. "projects/[
|
|
|
|
|
# PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
|
|
|
|
|
# ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
|
|
|
|
|
# [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
|
|
|
|
|
# FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 undelete_project_location_bucket(name, undelete_bucket_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+name}:undelete', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::UndeleteBucketRequest::Representation
|
|
|
|
|
command.request_object = undelete_bucket_request_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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 view over logs in a bucket. A bucket may contain a maximum of 50
|
|
|
|
|
# views.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket in which to create the view "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
|
|
|
|
|
# project/locations/my-location/buckets/my-bucket"
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] view_id
|
|
|
|
|
# Required. The id to use for this view.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket_view(parent, log_view_object = nil, view_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/views', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['viewId'] = view_id unless view_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 a view from a bucket.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Gets a view.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
|
|
|
|
|
# LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
|
|
|
|
|
# project-id/locations/my-location/buckets/my-bucket-id/views/my-view-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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket_view(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless 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 views on a bucket.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListViewsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::ListViewsResponse]
|
|
|
|
|
#
|
|
|
|
|
# @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_location_bucket_views(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/views', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListViewsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListViewsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a view. This method replaces the following fields in the existing view
|
|
|
|
|
# with values from the new view: filter.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The full resource name of the view to update "projects/[PROJECT_ID]/
|
|
|
|
|
# locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
|
|
|
|
|
# projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
|
|
|
|
|
# view-id".
|
|
|
|
|
# @param [Google::Apis::LoggingV2::LogView] log_view_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in view that need an update. A
|
|
|
|
|
# field will be overwritten if, and only if, it is in the update mask. name and
|
|
|
|
|
# output only fields cannot be updated.For a detailed FieldMask definition, see
|
|
|
|
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
|
|
|
|
|
# google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogView] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::LogView]
|
|
|
|
|
#
|
|
|
|
|
# @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 patch_project_location_bucket_view(name, log_view_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.request_object = log_view_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogView::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogView
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
|
|
|
command.query['fields'] = fields unless fields.nil?
|
|
|
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
|
|
|
execute_or_queue_command(command, &block)
|
|
|
|
|
end
|
|
|
|
|
|
feat: Automated regeneration of logging v2 client (#2261)
This PR was generated using Autosynth. :rainbow:
<details><summary>Log from Synthtool</summary>
```
2021-01-09 02:55:52,454 synthtool [DEBUG] > Executing /home/kbuilder/.cache/synthtool/google-api-ruby-client/synth.py.
On branch autosynth-logging-v2
nothing to commit, working tree clean
2021-01-09 02:55:52,520 synthtool [DEBUG] > Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
DEBUG:synthtool:Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth logging v2
bundle install
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 11.3.0
Installing rake 11.3.0
Fetching concurrent-ruby 1.1.7
Installing concurrent-ruby 1.1.7
Fetching i18n 1.8.7
Installing i18n 1.8.7
Fetching minitest 5.14.3
Installing minitest 5.14.3
Fetching tzinfo 2.0.4
Installing tzinfo 2.0.4
Fetching zeitwerk 2.4.2
Installing zeitwerk 2.4.2
Fetching activesupport 6.1.1
Installing activesupport 6.1.1
Fetching public_suffix 4.0.6
Installing public_suffix 4.0.6
Fetching addressable 2.7.0
Installing addressable 2.7.0
Fetching ast 2.4.1
Installing ast 2.4.1
Using bundler 2.1.4
Fetching byebug 11.1.3
Installing byebug 11.1.3 with native extensions
Fetching coderay 1.1.3
Installing coderay 1.1.3
Fetching json 2.5.1
Installing json 2.5.1 with native extensions
Fetching docile 1.3.4
Installing docile 1.3.4
Fetching simplecov-html 0.10.2
Installing simplecov-html 0.10.2
Fetching simplecov 0.16.1
Installing simplecov 0.16.1
Using sync 0.5.0
Fetching tins 1.26.0
Installing tins 1.26.0
Fetching term-ansicolor 1.7.1
Installing term-ansicolor 1.7.1
Fetching thor 0.20.3
Installing thor 0.20.3
Fetching coveralls 0.8.23
Installing coveralls 0.8.23
Fetching rexml 3.2.4
Installing rexml 3.2.4
Fetching crack 0.4.5
Installing crack 0.4.5
Fetching declarative 0.0.20
Installing declarative 0.0.20
Fetching declarative-option 0.1.0
Installing declarative-option 0.1.0
Fetching diff-lcs 1.4.4
Installing diff-lcs 1.4.4
Fetching dotenv 2.7.6
Installing dotenv 2.7.6
Fetching fakefs 0.20.1
Installing fakefs 0.20.1
Fetching faraday-net_http 1.0.0
Installing faraday-net_http 1.0.0
Fetching multipart-post 2.1.1
Installing multipart-post 2.1.1
Fetching ruby2_keywords 0.0.2
Installing ruby2_keywords 0.0.2
Fetching faraday 1.3.0
Installing faraday 1.3.0
Fetching gems 1.2.0
Installing gems 1.2.0
Fetching github-markup 1.7.0
Installing github-markup 1.7.0
Fetching jwt 2.2.2
Installing jwt 2.2.2
Fetching memoist 0.16.2
Installing memoist 0.16.2
Fetching multi_json 1.15.0
Installing multi_json 1.15.0
Fetching os 0.9.6
Installing os 0.9.6
Fetching signet 0.14.0
Installing signet 0.14.0
Fetching googleauth 0.14.0
Installing googleauth 0.14.0
Fetching httpclient 2.8.3
Installing httpclient 2.8.3
Fetching mini_mime 1.0.2
Installing mini_mime 1.0.2
Fetching uber 0.1.0
Installing uber 0.1.0
Fetching representable 3.0.4
Installing representable 3.0.4
Fetching retriable 3.1.2
Installing retriable 3.1.2
Fetching google-apis-core 0.2.0
Installing google-apis-core 0.2.0
Fetching google-apis-discovery_v1 0.1.0
Installing google-apis-discovery_v1 0.1.0
Using google-apis-generator 0.1.1 from source at `.`
Fetching google-id-token 1.4.2
Installing google-id-token 1.4.2
Fetching hashdiff 1.0.1
Installing hashdiff 1.0.1
Fetching mime-types-data 3.2020.1104
Installing mime-types-data 3.2020.1104
Fetching mime-types 3.3.1
Installing mime-types 3.3.1
Fetching multi_xml 0.6.0
Installing multi_xml 0.6.0
Fetching httparty 0.18.1
Installing httparty 0.18.1
Fetching rspec-support 3.10.1
Installing rspec-support 3.10.1
Fetching rspec-core 3.10.1
Installing rspec-core 3.10.1
Fetching rspec-expectations 3.10.1
Installing rspec-expectations 3.10.1
Fetching rspec-mocks 3.10.1
Installing rspec-mocks 3.10.1
Fetching rspec 3.10.0
Installing rspec 3.10.0
Fetching json_spec 1.1.5
Installing json_spec 1.1.5
Fetching launchy 2.5.0
Installing launchy 2.5.0
Fetching little-plugger 1.1.4
Installing little-plugger 1.1.4
Fetching logging 2.3.0
Installing logging 2.3.0
Fetching method_source 1.0.0
Installing method_source 1.0.0
Fetching opencensus 0.5.0
Installing opencensus 0.5.0
Fetching parallel 1.20.1
Installing parallel 1.20.1
Fetching parser 2.7.2.0
Installing parser 2.7.2.0
Fetching powerpack 0.1.3
Installing powerpack 0.1.3
Fetching pry 0.13.1
Installing pry 0.13.1
Fetching pry-byebug 3.9.0
Installing pry-byebug 3.9.0
Fetching yard 0.9.26
Installing yard 0.9.26
Fetching pry-doc 0.13.5
Installing pry-doc 0.13.5
Fetching rainbow 2.2.2
Installing rainbow 2.2.2 with native extensions
Fetching redcarpet 3.5.1
Installing redcarpet 3.5.1 with native extensions
Fetching redis 3.3.5
Installing redis 3.3.5
Fetching rmail 1.1.4
Installing rmail 1.1.4
Fetching ruby-progressbar 1.11.0
Installing ruby-progressbar 1.11.0
Fetching unicode-display_width 1.7.0
Installing unicode-display_width 1.7.0
Fetching rubocop 0.49.1
Installing rubocop 0.49.1
Fetching webmock 2.3.2
Installing webmock 2.3.2
Bundle complete! 25 Gemfile dependencies, 81 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
Post-install message from i18n:
HEADS UP! i18n 1.1 changed fallbacks to exclude default locale.
But that may break your application.
If you are upgrading your Rails application from an older version of Rails:
Please check your Rails app for 'config.i18n.fallbacks = true'.
If you're using I18n (>= 1.1.0) and Rails (< 5.2.2), this should be
'config.i18n.fallbacks = [I18n.default_locale]'.
If not, fallbacks will be broken in your app by I18n 1.1.x.
If you are starting a NEW Rails application, you can ignore this notice.
For more info see:
https://github.com/svenfuchs/i18n/releases/tag/v1.1.0
Post-install message from httparty:
When you HTTParty, you must party hard!
echo a | bundle exec bin/generate-api gen /workspace/generated --api=logging.v2 --names=/workspace/api_names.yaml --names-out=/workspace/api_names_out.yaml --spot-check
Loading logging, version v2 from https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/logging.v2.json
W, [2021-01-09T10:56:16.069592 #238] WARN -- : Found reserved property 'method'
W, [2021-01-09T10:56:16.069660 #238] WARN -- : Changed to 'method_prop'
conflict google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
<ging_v2/classes.rb? (enter "h" for help) [Ynaqdhm] a
force google-apis-logging_v2/lib/google/apis/logging_v2/classes.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/service.rb
conflict google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
force google-apis-logging_v2/lib/google/apis/logging_v2/gem_version.rb
conflict google-apis-logging_v2/CHANGELOG.md
force google-apis-logging_v2/CHANGELOG.md
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 13.0.3
Installing rake 13.0.3
Using public_suffix 4.0.6
Using addressable 2.7.0
Using bundler 2.1.4
Using declarative 0.0.20
Using declarative-option 0.1.0
Using diff-lcs 1.4.4
Using faraday-net_http 1.0.0
Using multipart-post 2.1.1
Using ruby2_keywords 0.0.2
Using faraday 1.3.0
Using jwt 2.2.2
Using memoist 0.16.2
Using multi_json 1.15.0
Fetching os 1.1.1
Installing os 1.1.1
Using signet 0.14.0
Using googleauth 0.14.0
Using httpclient 2.8.3
Using mini_mime 1.0.2
Using uber 0.1.0
Using representable 3.0.4
Using retriable 3.1.2
Using rexml 3.2.4
Using google-apis-core 0.2.0
Using google-apis-logging_v2 0.2.0 from source at `.`
Using opencensus 0.5.0
Using redcarpet 3.5.1
Using rspec-support 3.10.1
Using rspec-core 3.10.1
Using rspec-expectations 3.10.1
Using rspec-mocks 3.10.1
Using rspec 3.10.0
Using yard 0.9.26
Bundle complete! 8 Gemfile dependencies, 33 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
/root/.rbenv/versions/2.6.6/bin/ruby -I/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/lib:/root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-support-3.10.1/lib /root/.rbenv/versions/2.6.6/lib/ruby/gems/2.6.0/gems/rspec-core-3.10.1/exe/rspec --pattern spec/\*\*\{,/\*/\*\*\}/\*_spec.rb
Google::Apis::LoggingV2
should load
Finished in 0.31798 seconds (files took 0.11097 seconds to load)
1 example, 0 failures
Files: 4
Modules: 3 ( 1 undocumented)
Classes: 44 ( 0 undocumented)
Constants: 9 ( 0 undocumented)
Attributes: 136 ( 0 undocumented)
Methods: 229 ( 0 undocumented)
99.76% documented
google-apis-logging_v2 0.2.0 built to pkg/google-apis-logging_v2-0.2.0.gem.
identical /workspace/api_names_out.yaml
2021-01-09 02:56:31,239 synthtool [DEBUG] > Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
DEBUG:synthtool:Wrote metadata to generated/google-apis-logging_v2/synth.metadata.
```
</details>
Full log will be available here:
https://source.cloud.google.com/results/invocations/2fec3e68-c8da-44a7-8bac-3218258fd2a0/targets
- [ ] To automatically regenerate this PR, check this box.
2021-01-09 11:12:02 +00:00
|
|
|
# Deletes all the log entries in a log for the _Default Log Bucket. The log
|
|
|
|
|
# reappears if it receives new entries. Log entries written shortly before the
|
|
|
|
|
# delete operation might not be deleted. Entries received after the delete
|
|
|
|
|
# operation with a timestamp before the operation will be deleted.
|
2021-01-01 03:01:13 +00:00
|
|
|
# @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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_log(log_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+logName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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 [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] 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 [Array<String>, String] resource_names
|
|
|
|
|
# Optional. The resource name that owns the logs: projects/PROJECT_ID/locations/
|
|
|
|
|
# LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID organization/ORGANIZATION_ID/
|
|
|
|
|
# locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID billingAccounts/
|
|
|
|
|
# BILLING_ACCOUNT_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_ID
|
|
|
|
|
# folders/FOLDER_ID/locations/LOCATION_ID/buckets/BUCKET_ID/views/VIEW_IDTo
|
|
|
|
|
# support legacy queries, it could also be: "projects/PROJECT_ID" "organizations/
|
|
|
|
|
# ORGANIZATION_ID" "billingAccounts/BILLING_ACCOUNT_ID" "folders/FOLDER_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::LoggingV2::ListLogsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/logs', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLogsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.nil?
|
|
|
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
|
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
|
|
|
command.query['resourceNames'] = resource_names unless resource_names.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] parent
|
|
|
|
|
# Required. 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::LoggingV2::LogMetric] log_metric_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::LoggingV2::LogMetric] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 create_project_metric(parent, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/metrics', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogMetric::Representation
|
|
|
|
|
command.request_object = log_metric_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogMetric::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# Deletes a logs-based metric.
|
|
|
|
|
# @param [String] metric_name
|
|
|
|
|
# Required. 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
|
|
|
|
|
# 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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+metricName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# Gets a logs-based metric.
|
|
|
|
|
# @param [String] metric_name
|
|
|
|
|
# Required. 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
|
|
|
|
|
# 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::LoggingV2::LogMetric] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 get_project_metric(metric_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+metricName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogMetric::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# Lists logs-based metrics.
|
|
|
|
|
# @param [String] parent
|
|
|
|
|
# Required. The name of the project containing the metrics: "projects/[
|
|
|
|
|
# PROJECT_ID]"
|
|
|
|
|
# @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] 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 [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::LoggingV2::ListLogMetricsResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 list_project_metrics(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/metrics', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListLogMetricsResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListLogMetricsResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Creates or updates a logs-based metric.
|
|
|
|
|
# @param [String] metric_name
|
|
|
|
|
# Required. 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::LoggingV2::LogMetric] log_metric_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::LoggingV2::LogMetric] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 update_project_metric(metric_name, log_metric_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:put, 'v2/{+metricName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogMetric::Representation
|
|
|
|
|
command.request_object = log_metric_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogMetric::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# Creates a sink that exports specified log entries to a destination. The export
|
|
|
|
|
# of newly-ingested log entries begins immediately, unless the sink's
|
|
|
|
|
# writer_identity is not permitted to write to the destination. A sink can
|
|
|
|
|
# export log entries only from the resource owning the sink.
|
|
|
|
|
# @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::LoggingV2::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 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
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
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. If the sink has a unique writer_identity, then that service
|
|
|
|
|
# account is also deleted.
|
|
|
|
|
# @param [String] sink_name
|
|
|
|
|
# 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
|
|
|
|
|
# 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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# 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 [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] 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 [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::LoggingV2::ListSinksResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_sinks(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListSinksResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a sink. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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 patch_project_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_project_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:put, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 sink that exports specified log entries to a destination. The export
|
|
|
|
|
# of newly-ingested log entries begins immediately, unless the sink's
|
|
|
|
|
# writer_identity is not permitted to write to the destination. A sink can
|
|
|
|
|
# export log entries only from the resource owning the sink.
|
|
|
|
|
# @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::LoggingV2::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 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
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_sink(parent, log_sink_object = nil, unique_writer_identity: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:post, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
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. If the sink has a unique writer_identity, then that service
|
|
|
|
|
# account is also deleted.
|
|
|
|
|
# @param [String] sink_name
|
|
|
|
|
# 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
|
|
|
|
|
# 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::LoggingV2::Empty] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:delete, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::Empty::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::Empty
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
# 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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_sink(sink_name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+sinkName}', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::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
|
|
|
|
|
|
|
|
|
|
# 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 [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] 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 [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::LoggingV2::ListSinksResponse] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_sinks(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+parent}/sinks', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::ListSinksResponse::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::ListSinksResponse
|
|
|
|
|
command.params['parent'] = parent unless parent.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
|
|
|
|
|
|
|
|
|
|
# Updates a sink. This method replaces the following fields in the existing sink
|
|
|
|
|
# with values from the new sink: destination, and filter.The updated sink might
|
|
|
|
|
# also have a new writer_identity; see the unique_writer_identity field.
|
|
|
|
|
# @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::LoggingV2::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 set to false or defaulted
|
|
|
|
|
# to false.
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask that specifies the fields in sink that need an update. A
|
|
|
|
|
# sink field will be overwritten if, and only if, it is in the update mask. name
|
|
|
|
|
# and output only fields cannot be updated.An empty updateMask is temporarily
|
|
|
|
|
# treated as using the following mask for backwards compatibility purposes:
|
|
|
|
|
# destination,filter,includeChildren At some point in the future, behavior will
|
|
|
|
|
# be removed and specifying an empty updateMask will be an error.For a detailed
|
|
|
|
|
# FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
|
|
|
|
|
# reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
|
|
|
|
|
# @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::LoggingV2::LogSink] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::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_sink(sink_name, log_sink_object = nil, unique_writer_identity: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:put, 'v2/{+sinkName}', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.request_object = log_sink_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::LogSink::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::LogSink
|
|
|
|
|
command.params['sinkName'] = sink_name unless sink_name.nil?
|
|
|
|
|
command.query['uniqueWriterIdentity'] = unique_writer_identity unless unique_writer_identity.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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 Logs Router CMEK settings for the given resource.Note: CMEK for the
|
|
|
|
|
# Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.See
|
|
|
|
|
# Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/
|
|
|
|
|
# managed-encryption) for more information.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource for which to retrieve CMEK settings. "projects/[
|
|
|
|
|
# PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
|
|
|
|
|
# billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
|
|
|
|
|
# cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
|
|
|
|
|
# Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.
|
|
|
|
|
# @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::LoggingV2::CmekSettings] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::CmekSettings]
|
|
|
|
|
#
|
|
|
|
|
# @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_cmek_settings(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:get, 'v2/{+name}/cmekSettings', options)
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::CmekSettings
|
|
|
|
|
command.params['name'] = name unless 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
|
|
|
|
|
|
|
|
|
|
# Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
|
|
|
|
|
# the Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.
|
|
|
|
|
# UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
|
|
|
|
|
# associated service account does not have the required roles/cloudkms.
|
|
|
|
|
# cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
|
|
|
|
|
# is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/
|
|
|
|
|
# logging/docs/routing/managed-encryption) for more information.
|
|
|
|
|
# @param [String] name
|
|
|
|
|
# Required. The resource name for the CMEK settings to update. "projects/[
|
|
|
|
|
# PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
|
|
|
|
|
# billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
|
|
|
|
|
# cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
|
|
|
|
|
# Logs Router can currently only be configured for GCP organizations. Once
|
|
|
|
|
# configured, it applies to all projects and folders in the GCP organization.
|
|
|
|
|
# @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
|
|
|
|
|
# @param [String] update_mask
|
|
|
|
|
# Optional. Field mask identifying which fields from cmek_settings should be
|
|
|
|
|
# updated. A field will be overwritten if and only if it is in the update mask.
|
|
|
|
|
# Output only fields cannot be updated.See FieldMask for more information.
|
|
|
|
|
# Example: "updateMask=kmsKeyName"
|
|
|
|
|
# @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::LoggingV2::CmekSettings] parsed result object
|
|
|
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
|
|
|
#
|
|
|
|
|
# @return [Google::Apis::LoggingV2::CmekSettings]
|
|
|
|
|
#
|
|
|
|
|
# @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_cmek_settings(name, cmek_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
|
|
|
command = make_simple_command(:patch, 'v2/{+name}/cmekSettings', options)
|
|
|
|
|
command.request_representation = Google::Apis::LoggingV2::CmekSettings::Representation
|
|
|
|
|
command.request_object = cmek_settings_object
|
|
|
|
|
command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
|
|
|
|
|
command.response_class = Google::Apis::LoggingV2::CmekSettings
|
|
|
|
|
command.params['name'] = name unless name.nil?
|
|
|
|
|
command.query['updateMask'] = update_mask unless update_mask.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
|
