google-api-client 0.37.0 → 0.38.0

data/generated/google/apis/logging_v2/service.rb

@@ -20,13 +20,12 @@ require 'google/apis/errors'
 module Google
   module Apis
     module LoggingV2
-      # Stackdriver Logging API
+      # Cloud Logging API
       #
-      # Writes log entries and manages your Stackdriver Logging configuration. The
-      #  table entries below are presented in alphabetical order, not in order of
-      #  common use. For explanations of the concepts found in the table entries, read
-      #  the <a href=https://cloud.google.com/logging/docs>Stackdriver Logging
-      #  documentation</a>.
+      # Writes log entries and manages your Cloud Logging configuration. The table
+      #  entries below are presented in alphabetical order, not in order of common use.
+      #  For explanations of the concepts found in the table entries, read the
+      #  documentation at https://cloud.google.com/logging/docs.
       #
       # @example
       #    require 'google/apis/logging_v2'
@@ -51,6 +50,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 +287,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 must be specified, but supplying
+        #   the character - in place of LOCATION_ID will return all buckets.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. The presence of nextPageToken in the response
+        #   indicates that more results might be available.
+        # @param [String] page_token
+        #   Optional. If present, then retrieve the next batch of results from the
+        #   preceding call to this method. pageToken must be the value of nextPageToken
+        #   from the previous response. The values of other method parameters should be
+        #   identical to those in the previous call.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::ListBucketsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::ListBucketsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_billing_account_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
+          command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a bucket. This method replaces the following fields in the existing
+        # bucket with values from the new bucket: retention_periodIf the retention
+        # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
+        # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
+        # FAILED_PRECONDITION will be returned.A buckets region may not be modified
+        # after it is created. 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 +1234,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 must be specified, but supplying
+        #   the character - in place of LOCATION_ID will return all buckets.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. The presence of nextPageToken in the response
+        #   indicates that more results might be available.
+        # @param [String] page_token
+        #   Optional. If present, then retrieve the next batch of results from the
+        #   preceding call to this method. pageToken must be the value of nextPageToken
+        #   from the previous response. The values of other method parameters should be
+        #   identical to those in the previous call.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::ListBucketsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::ListBucketsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_folder_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
+          command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a bucket. This method replaces the following fields in the existing
+        # bucket with values from the new bucket: retention_periodIf the retention
+        # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
+        # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
+        # FAILED_PRECONDITION will be returned.A buckets region may not be modified
+        # after it is created. 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 +1749,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 must be specified, but supplying
+        #   the character - in place of LOCATION_ID will return all buckets.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. The presence of nextPageToken in the response
+        #   indicates that more results might be available.
+        # @param [String] page_token
+        #   Optional. If present, then retrieve the next batch of results from the
+        #   preceding call to this method. pageToken must be the value of nextPageToken
+        #   from the previous response. The values of other method parameters should be
+        #   identical to those in the previous call.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::ListBucketsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::ListBucketsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
+          command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a bucket. This method replaces the following fields in the existing
+        # bucket with values from the new bucket: retention_periodIf the retention
+        # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
+        # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
+        # FAILED_PRECONDITION will be returned.A buckets region may not be modified
+        # after it is created. 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 +2302,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 must be specified, but supplying
+        #   the character - in place of LOCATION_ID will return all buckets.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. The presence of nextPageToken in the response
+        #   indicates that more results might be available.
+        # @param [String] page_token
+        #   Optional. If present, then retrieve the next batch of results from the
+        #   preceding call to this method. pageToken must be the value of nextPageToken
+        #   from the previous response. The values of other method parameters should be
+        #   identical to those in the previous call.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::ListBucketsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::ListBucketsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
+          command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a bucket. This method replaces the following fields in the existing
+        # bucket with values from the new bucket: retention_periodIf the retention
+        # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
+        # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
+        # FAILED_PRECONDITION will be returned.A buckets region may not be modified
+        # after it is created. 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 +3018,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 must be specified, but supplying
+        #   the character - in place of LOCATION_ID will return all buckets.
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of results to return from this request. Non-
+        #   positive values are ignored. The presence of nextPageToken in the response
+        #   indicates that more results might be available.
+        # @param [String] page_token
+        #   Optional. If present, then retrieve the next batch of results from the
+        #   preceding call to this method. pageToken must be the value of nextPageToken
+        #   from the previous response. The values of other method parameters should be
+        #   identical to those in the previous call.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::LoggingV2::ListBucketsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::ListBucketsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_location_buckets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+parent}/buckets', options)
+          command.response_representation = Google::Apis::LoggingV2::ListBucketsResponse::Representation
+          command.response_class = Google::Apis::LoggingV2::ListBucketsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a bucket. This method replaces the following fields in the existing
+        # bucket with values from the new bucket: retention_periodIf the retention
+        # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
+        # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
+        # FAILED_PRECONDITION will be returned.A buckets region may not be modified
+        # after it is created. 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
@@ -2563,7 +3242,7 @@ module Google
         
         # Creates a logs-based metric.
         # @param [String] parent
-        #   The resource name of the project in which to create the metric:
+        #   Required. The resource name of the project in which to create the metric:
         #   "projects/[PROJECT_ID]"
         #   The new metric must be provided in the request.
         # @param [Google::Apis::LoggingV2::LogMetric] log_metric_object
@@ -2598,7 +3277,7 @@ module Google
         
         # Deletes a logs-based metric.
         # @param [String] metric_name
-        #   The resource name of the metric to delete:
+        #   Required. The resource name of the metric to delete:
         #   "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2629,7 +3308,7 @@ module Google
         
         # Gets a logs-based metric.
         # @param [String] metric_name
-        #   The resource name of the desired metric:
+        #   Required. The resource name of the desired metric:
         #   "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2702,7 +3381,7 @@ module Google
         
         # Creates or updates a logs-based metric.
         # @param [String] metric_name
-        #   The resource name of the metric to update:
+        #   Required. The resource name of the metric to update:
         #   "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
         #   The updated metric must be provided in the request and it's name field must be
         #   the same as [METRIC_ID] If the metric does not exist in [PROJECT_ID], then a