You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ozone.apache.org by ch...@apache.org on 2026/10/13 09:18:02 UTC
(ozone-site) branch master updated: HDDS-16384. Document Recon fileSize bin semantics in recon-api.yaml (#553)
This is an automated email from the ASF dual-hosted git repository.
chihsuan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/master by this push:
new 495798cce3 HDDS-16384. Document Recon fileSize bin semantics in recon-api.yaml (#553)
495798cce3 is described below
commit 495798cce3daeeb0b0a0bbceef1418d7e1a984b7
Author: Chi-Hsuan Huang <ch...@gmail.com>
AuthorDate: Tue Oct 13 17:17:56 2026 +0800
HDDS-16384. Document Recon fileSize bin semantics in recon-api.yaml (#553)
---
static/recon-api.yaml | 11 ++++++++---
1 file changed, 8 insertions(+), 3 deletions(-)
diff --git a/static/recon-api.yaml b/static/recon-api.yaml
index 5594245e89..db87aa68e5 100644
--- a/static/recon-api.yaml
+++ b/static/recon-api.yaml
@@ -759,7 +759,7 @@ paths:
get:
tags:
- Utilization
- summary: Returns the file counts within different file ranges with fileSize in the response object being the upper cap for file size range.
+ summary: Returns file counts by size bin, with fileSize representing the bin upper bound.
operationId: getFileCounts
parameters:
- name: volume
@@ -779,12 +779,17 @@ paths:
- name: fileSize
in: query
description: |
- Filters the results based on the given file size.<br>
+ Filters the results by the exact upper bound of a file-size histogram bin, in bytes.<br>
+ It is not an arbitrary file size or a cumulative less-than-or-equal threshold.<br>
+ A positive value that is not a bin upper bound returns an empty result.<br>
+ The first bin has an upper bound of 1024 bytes; for example, the bin with upper bound 2048 contains files larger than 1024 bytes and up to 2048 bytes.<br>
+ This filter can be used independently or together with volume and/or bucket.<br>
The smallest file size being tracked for count is 1 KB i.e. 1024 bytes.
example: 1024
required: false
schema:
- type: number
+ type: integer
+ format: int64
responses:
'200':
description: Successful Operation
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@ozone.apache.org
For additional commands, e-mail: commits-help@ozone.apache.org