generated/google/apis/logging_v2/service.rb in google-api-client-0.37.0 vs generated/google/apis/logging_v2/service.rb in google-api-client-0.37.1

- old
+ new

@@ -49,10 +49,46 @@ def initialize super('https://logging.googleapis.com/', '') @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. # @param [String] parent # Required. The parent resource in which to create the exclusion: @@ -250,10 +286,110 @@ 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_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 # the operation will be deleted. # @param [String] log_name @@ -1097,10 +1233,146 @@ command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end + # Gets a bucket (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 # the operation will be deleted. # @param [String] log_name @@ -1476,10 +1748,146 @@ command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end + # Gets a bucket (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 # the operation will be deleted. # @param [String] log_name @@ -1893,10 +2301,146 @@ command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end + # Gets a bucket (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 # the operation will be deleted. # @param [String] log_name @@ -2466,9 +3010,145 @@ command = make_simple_command(:patch, 'v2/{+name}', options) command.request_representation = Google::Apis::LoggingV2::LogExclusion::Representation command.request_object = log_exclusion_object command.response_representation = Google::Apis::LoggingV2::LogExclusion::Representation command.response_class = Google::Apis::LoggingV2::LogExclusion + command.params['name'] = name unless name.nil? + command.query['updateMask'] = update_mask unless update_mask.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Gets 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)