Autogenerated update (2020-02-23)

Update:
- dataflow_v1b3
- logging_v2
This commit is contained in:
Google APIs 2020-02-23 00:37:39 +00:00
parent 86a9b70834
commit a63e40b7e3
7 changed files with 855 additions and 2 deletions

View File

@ -25,7 +25,7 @@ module Google
# @see https://cloud.google.com/dataflow
module DataflowV1b3
VERSION = 'V1b3'
REVISION = '20191230'
REVISION = '20200215'
# View and manage your data across Google Cloud Platform services
AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

View File

@ -3623,6 +3623,36 @@ module Google
end
end
# Defines a SDK harness container for executing Dataflow pipelines.
class SdkHarnessContainerImage
include Google::Apis::Core::Hashable
# A docker container image that resides in Google Container Registry.
# Corresponds to the JSON property `containerImage`
# @return [String]
attr_accessor :container_image
# If true, recommends the Dataflow service to use only one core per SDK
# container instance with this image. If false (or unset) recommends using
# more than one core per SDK container instance with this image for
# efficiency. Note that Dataflow service may choose to override this property
# if needed.
# Corresponds to the JSON property `useSingleCorePerContainer`
# @return [Boolean]
attr_accessor :use_single_core_per_container
alias_method :use_single_core_per_container?, :use_single_core_per_container
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@container_image = args[:container_image] if args.key?(:container_image)
@use_single_core_per_container = args[:use_single_core_per_container] if args.key?(:use_single_core_per_container)
end
end
# The version of the SDK used to run the job.
class SdkVersion
include Google::Apis::Core::Hashable
@ -5886,6 +5916,14 @@ module Google
# @return [Hash<String,Object>]
attr_accessor :pool_args
# Set of SDK harness containers needed to execute this pipeline. This will
# only be set in the Fn API path. For non-cross-language pipelines this
# should have only one entry. Cross-language pipelines will have two or more
# entries.
# Corresponds to the JSON property `sdkHarnessContainerImages`
# @return [Array<Google::Apis::DataflowV1b3::SdkHarnessContainerImage>]
attr_accessor :sdk_harness_container_images
# Subnetwork to which VMs will be assigned, if desired. Expected to be of
# the form "regions/REGION/subnetworks/SUBNETWORK".
# Corresponds to the JSON property `subnetwork`
@ -5917,6 +5955,7 @@ module Google
# Required. Docker container image that executes the Cloud Dataflow worker
# harness, residing in Google Container Registry.
# Deprecated for the Fn API path. Use sdk_harness_container_images instead.
# Corresponds to the JSON property `workerHarnessContainerImage`
# @return [String]
attr_accessor :worker_harness_container_image
@ -5949,6 +5988,7 @@ module Google
@on_host_maintenance = args[:on_host_maintenance] if args.key?(:on_host_maintenance)
@packages = args[:packages] if args.key?(:packages)
@pool_args = args[:pool_args] if args.key?(:pool_args)
@sdk_harness_container_images = args[:sdk_harness_container_images] if args.key?(:sdk_harness_container_images)
@subnetwork = args[:subnetwork] if args.key?(:subnetwork)
@taskrunner_settings = args[:taskrunner_settings] if args.key?(:taskrunner_settings)
@teardown_policy = args[:teardown_policy] if args.key?(:teardown_policy)

View File

@ -544,6 +544,12 @@ module Google
include Google::Apis::Core::JsonObjectSupport
end
class SdkHarnessContainerImage
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class SdkVersion
class Representation < Google::Apis::Core::JsonRepresentation; end
@ -1848,6 +1854,14 @@ module Google
end
end
class SdkHarnessContainerImage
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :container_image, as: 'containerImage'
property :use_single_core_per_container, as: 'useSingleCorePerContainer'
end
end
class SdkVersion
# @private
class Representation < Google::Apis::Core::JsonRepresentation
@ -2453,6 +2467,8 @@ module Google
collection :packages, as: 'packages', class: Google::Apis::DataflowV1b3::Package, decorator: Google::Apis::DataflowV1b3::Package::Representation
hash :pool_args, as: 'poolArgs'
collection :sdk_harness_container_images, as: 'sdkHarnessContainerImages', class: Google::Apis::DataflowV1b3::SdkHarnessContainerImage, decorator: Google::Apis::DataflowV1b3::SdkHarnessContainerImage::Representation
property :subnetwork, as: 'subnetwork'
property :taskrunner_settings, as: 'taskrunnerSettings', class: Google::Apis::DataflowV1b3::TaskRunnerSettings, decorator: Google::Apis::DataflowV1b3::TaskRunnerSettings::Representation

View File

@ -29,7 +29,7 @@ module Google
# @see https://cloud.google.com/logging/docs/
module LoggingV2
VERSION = 'V2'
REVISION = '20200125'
REVISION = '20200221'
# View and manage your data across Google Cloud Platform services
AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

View File

@ -432,6 +432,33 @@ module Google
end
end
# The response from ListBuckets (Beta).
class ListBucketsResponse
include Google::Apis::Core::Hashable
# A list of buckets.
# Corresponds to the JSON property `buckets`
# @return [Array<Google::Apis::LoggingV2::LogBucket>]
attr_accessor :buckets
# If there might be more results than appear in this response, then
# nextPageToken is included. To get the next set of results, call the same
# method again using the value of nextPageToken as pageToken.
# Corresponds to the JSON property `nextPageToken`
# @return [String]
attr_accessor :next_page_token
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@buckets = args[:buckets] if args.key?(:buckets)
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
end
end
# Result returned from ListExclusions.
class ListExclusionsResponse
include Google::Apis::Core::Hashable
@ -673,6 +700,63 @@ module Google
end
end
# Describes a repository of logs (Beta).
class LogBucket
include Google::Apis::Core::Hashable
# Output only. The creation timestamp of the bucket. This is not set for any of
# the default buckets.
# Corresponds to the JSON property `createTime`
# @return [String]
attr_accessor :create_time
# Describes this bucket.
# Corresponds to the JSON property `description`
# @return [String]
attr_accessor :description
# The bucket lifecycle state.Output only.
# Corresponds to the JSON property `lifecycleState`
# @return [String]
attr_accessor :lifecycle_state
# The resource name of the bucket. For example: "projects/my-project-id/
# locations/my-location/buckets/my-bucket-id The supported locations are: "
# global" "us-central1"For the location of global it is unspecified where logs
# are actually stored. Once a bucket has been created, the location can not be
# changed.
# Corresponds to the JSON property `name`
# @return [String]
attr_accessor :name
# Logs will be retained by default for this amount of time, after which they
# will automatically be deleted. The minimum retention period is 1 day. If this
# value is set to zero at bucket creation time, the default time of 30 days will
# be used.
# Corresponds to the JSON property `retentionDays`
# @return [Fixnum]
attr_accessor :retention_days
# Output only. The last update timestamp of the bucket.
# Corresponds to the JSON property `updateTime`
# @return [String]
attr_accessor :update_time
def initialize(**args)
update!(**args)
end
# Update properties of this object
def update!(**args)
@create_time = args[:create_time] if args.key?(:create_time)
@description = args[:description] if args.key?(:description)
@lifecycle_state = args[:lifecycle_state] if args.key?(:lifecycle_state)
@name = args[:name] if args.key?(:name)
@retention_days = args[:retention_days] if args.key?(:retention_days)
@update_time = args[:update_time] if args.key?(:update_time)
end
end
# An individual entry in a log.
class LogEntry
include Google::Apis::Core::Hashable

View File

@ -76,6 +76,12 @@ module Google
include Google::Apis::Core::JsonObjectSupport
end
class ListBucketsResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class ListExclusionsResponse
class Representation < Google::Apis::Core::JsonRepresentation; end
@ -118,6 +124,12 @@ module Google
include Google::Apis::Core::JsonObjectSupport
end
class LogBucket
class Representation < Google::Apis::Core::JsonRepresentation; end
include Google::Apis::Core::JsonObjectSupport
end
class LogEntry
class Representation < Google::Apis::Core::JsonRepresentation; end
@ -310,6 +322,15 @@ module Google
end
end
class ListBucketsResponse
# @private
class Representation < Google::Apis::Core::JsonRepresentation
collection :buckets, as: 'buckets', class: Google::Apis::LoggingV2::LogBucket, decorator: Google::Apis::LoggingV2::LogBucket::Representation
property :next_page_token, as: 'nextPageToken'
end
end
class ListExclusionsResponse
# @private
class Representation < Google::Apis::Core::JsonRepresentation
@ -375,6 +396,18 @@ module Google
end
end
class LogBucket
# @private
class Representation < Google::Apis::Core::JsonRepresentation
property :create_time, as: 'createTime'
property :description, as: 'description'
property :lifecycle_state, as: 'lifecycleState'
property :name, as: 'name'
property :retention_days, as: 'retentionDays'
property :update_time, as: 'updateTime'
end
end
class LogEntry
# @private
class Representation < Google::Apis::Core::JsonRepresentation

View File

@ -51,6 +51,42 @@ module Google
@batch_path = 'batch'
end
# Gets a bucket (Beta).
# @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
# 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.
@ -252,6 +288,106 @@ module Google
execute_or_queue_command(command, &block)
end
# Lists buckets (Beta).
# @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 is required, 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. This method is in Beta.
# @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
# Deletes all the log entries in a log. The log reappears if it receives new
# entries. Log entries written shortly before the delete operation might not be
# deleted. Entries received after the delete operation with a timestamp before
@ -1099,6 +1235,142 @@ module Google
execute_or_queue_command(command, &block)
end
# Gets a bucket (Beta).
# @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 (Beta).
# @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 is required, 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. This method is in Beta.
# @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
# Deletes all the log entries in a log. The log reappears if it receives new
# entries. Log entries written shortly before the delete operation might not be
# deleted. Entries received after the delete operation with a timestamp before
@ -1478,6 +1750,142 @@ module Google
execute_or_queue_command(command, &block)
end
# Gets a bucket (Beta).
# @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 (Beta).
# @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 is required, 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. This method is in Beta.
# @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
# Deletes all the log entries in a log. The log reappears if it receives new
# entries. Log entries written shortly before the delete operation might not be
# deleted. Entries received after the delete operation with a timestamp before
@ -1895,6 +2303,142 @@ module Google
execute_or_queue_command(command, &block)
end
# Gets a bucket (Beta).
# @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 (Beta).
# @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 is required, 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. This method is in Beta.
# @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
# Deletes all the log entries in a log. The log reappears if it receives new
# entries. Log entries written shortly before the delete operation might not be
# deleted. Entries received after the delete operation with a timestamp before
@ -2475,6 +3019,142 @@ module Google
execute_or_queue_command(command, &block)
end
# Gets a bucket (Beta).
# @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 (Beta).
# @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 is required, 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. This method is in Beta.
# @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
# Deletes all the log entries in a log. The log reappears if it receives new
# entries. Log entries written shortly before the delete operation might not be
# deleted. Entries received after the delete operation with a timestamp before