From a63e40b7e3af34642ea39eac19e93ba1c61cd0e5 Mon Sep 17 00:00:00 2001 From: Google APIs Date: Sun, 23 Feb 2020 00:37:39 +0000 Subject: [PATCH] Autogenerated update (2020-02-23) Update: - dataflow_v1b3 - logging_v2 --- generated/google/apis/dataflow_v1b3.rb | 2 +- .../google/apis/dataflow_v1b3/classes.rb | 40 ++ .../apis/dataflow_v1b3/representations.rb | 16 + generated/google/apis/logging_v2.rb | 2 +- generated/google/apis/logging_v2/classes.rb | 84 +++ .../google/apis/logging_v2/representations.rb | 33 + generated/google/apis/logging_v2/service.rb | 680 ++++++++++++++++++ 7 files changed, 855 insertions(+), 2 deletions(-) diff --git a/generated/google/apis/dataflow_v1b3.rb b/generated/google/apis/dataflow_v1b3.rb index 47f497a43..2f9536439 100644 --- a/generated/google/apis/dataflow_v1b3.rb +++ b/generated/google/apis/dataflow_v1b3.rb @@ -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' diff --git a/generated/google/apis/dataflow_v1b3/classes.rb b/generated/google/apis/dataflow_v1b3/classes.rb index e96dbf1d3..0586d2ddc 100644 --- a/generated/google/apis/dataflow_v1b3/classes.rb +++ b/generated/google/apis/dataflow_v1b3/classes.rb @@ -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] 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] + 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) diff --git a/generated/google/apis/dataflow_v1b3/representations.rb b/generated/google/apis/dataflow_v1b3/representations.rb index e8a63530b..f0652a0cc 100644 --- a/generated/google/apis/dataflow_v1b3/representations.rb +++ b/generated/google/apis/dataflow_v1b3/representations.rb @@ -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 diff --git a/generated/google/apis/logging_v2.rb b/generated/google/apis/logging_v2.rb index 2d694a403..cd5cbdce9 100644 --- a/generated/google/apis/logging_v2.rb +++ b/generated/google/apis/logging_v2.rb @@ -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' diff --git a/generated/google/apis/logging_v2/classes.rb b/generated/google/apis/logging_v2/classes.rb index 780891847..a0c6b7ac5 100644 --- a/generated/google/apis/logging_v2/classes.rb +++ b/generated/google/apis/logging_v2/classes.rb @@ -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] + 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 diff --git a/generated/google/apis/logging_v2/representations.rb b/generated/google/apis/logging_v2/representations.rb index 88be716c4..d5a9fc645 100644 --- a/generated/google/apis/logging_v2/representations.rb +++ b/generated/google/apis/logging_v2/representations.rb @@ -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 diff --git a/generated/google/apis/logging_v2/service.rb b/generated/google/apis/logging_v2/service.rb index c10290d94..bde0201d8 100644 --- a/generated/google/apis/logging_v2/service.rb +++ b/generated/google/apis/logging_v2/service.rb @@ -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