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 <[email protected]>
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: [email protected]
For additional commands, e-mail: [email protected]
