jojochuang commented on code in PR #149: URL: https://github.com/apache/ozone-site/pull/149#discussion_r2718528175
########## docs/03-core-concepts/01-namespace/01-volumes/03-quotas.md: ########## @@ -0,0 +1,32 @@ +--- +sidebar_label: Quotas +--- + +# Volume Quotas + + +## Quota Management + +Quotas provide a mechanism to control resource utilization at the volume level: + +- **Space Quotas**: Limit the total amount of storage (in bytes) a volume can use +- **Namespace Quotas**: Limit the total number of objects that can be stored within a volume +- **Hierarchical Enforcement**: Volume quotas apply to the aggregate of all contained buckets +- **Visibility**: Quota usage and limits can be monitored through the CLI and management interfaces +- **Enforcement**: When a quota is reached, write operations fail with a descriptive error message + Review Comment: We can add a few notes: 1. By default, the volume quota is unlimited. 2. the total quota of the buckets, cannot exceed the volume quota. 3. Volume quota has no effect if bucket quota is not set. 4. Volume having linked bucket do not consume space quota for keys within linked bucket. Linked bucket keys will consume space quota of source volume and source bucket. ########## docs/03-core-concepts/01-namespace/01-volumes/03-quotas.md: ########## @@ -0,0 +1,32 @@ +--- +sidebar_label: Quotas +--- + +# Volume Quotas + + +## Quota Management Review Comment: Ozone defines two types of quota: namespace quota and storage space quota. A namespace quota limits the number of objects in a volume. A storage space quota limits the maximum used space of a volume. ########## docs/03-core-concepts/01-namespace/01-volumes/03-quotas.md: ########## @@ -0,0 +1,32 @@ +--- +sidebar_label: Quotas +--- + +# Volume Quotas + + +## Quota Management + +Quotas provide a mechanism to control resource utilization at the volume level: + +- **Space Quotas**: Limit the total amount of storage (in bytes) a volume can use +- **Namespace Quotas**: Limit the total number of objects that can be stored within a volume +- **Hierarchical Enforcement**: Volume quotas apply to the aggregate of all contained buckets +- **Visibility**: Quota usage and limits can be monitored through the CLI and management interfaces +- **Enforcement**: When a quota is reached, write operations fail with a descriptive error message + +### Quota Commands + +```bash +# Set both space (1TB) and namespace (1 million objects) quotas simultaneously +ozone sh volume setquota --space=1TB --count=1000000 /marketing + +# Check current quota settings and usage +ozone sh volume info /marketing + +# Clear the space quota (set space limit to unlimited) +ozone sh volume clrquota --space /marketing + +# Clear the namespace quota (set object count limit to unlimited) +ozone sh volume clrquota --count /marketing Review Comment: ```suggestion ozone sh volume clrquota --namespace-quota /marketing ``` ########## docs/03-core-concepts/01-namespace/01-volumes/03-quotas.md: ########## @@ -0,0 +1,32 @@ +--- +sidebar_label: Quotas +--- + +# Volume Quotas + + +## Quota Management + +Quotas provide a mechanism to control resource utilization at the volume level: + +- **Space Quotas**: Limit the total amount of storage (in bytes) a volume can use +- **Namespace Quotas**: Limit the total number of objects that can be stored within a volume +- **Hierarchical Enforcement**: Volume quotas apply to the aggregate of all contained buckets +- **Visibility**: Quota usage and limits can be monitored through the CLI and management interfaces +- **Enforcement**: When a quota is reached, write operations fail with a descriptive error message + +### Quota Commands + +```bash +# Set both space (1TB) and namespace (1 million objects) quotas simultaneously +ozone sh volume setquota --space=1TB --count=1000000 /marketing + +# Check current quota settings and usage +ozone sh volume info /marketing + +# Clear the space quota (set space limit to unlimited) +ozone sh volume clrquota --space /marketing Review Comment: ```suggestion ozone sh volume clrquota --space-quota /marketing ``` ########## docs/03-core-concepts/01-namespace/01-volumes/03-quotas.md: ########## @@ -0,0 +1,32 @@ +--- +sidebar_label: Quotas +--- + +# Volume Quotas + + +## Quota Management + +Quotas provide a mechanism to control resource utilization at the volume level: + +- **Space Quotas**: Limit the total amount of storage (in bytes) a volume can use +- **Namespace Quotas**: Limit the total number of objects that can be stored within a volume +- **Hierarchical Enforcement**: Volume quotas apply to the aggregate of all contained buckets +- **Visibility**: Quota usage and limits can be monitored through the CLI and management interfaces +- **Enforcement**: When a quota is reached, write operations fail with a descriptive error message + Review Comment: We can add a few notes: 1. By default, the volume quota is unlimited. 2. the total quota of the buckets, cannot exceed the volume quota. 3. Volume quota has no effect if bucket quota is not set. 4. Volume having linked bucket do not consume space quota for keys within linked bucket. Linked bucket keys will consume space quota of source volume and source bucket. 5. files in trash still occupies storage space and namespace. They are only decremented when trash is purged. ########## docs/03-core-concepts/01-namespace/01-volumes/03-quotas.md: ########## @@ -0,0 +1,32 @@ +--- +sidebar_label: Quotas +--- + +# Volume Quotas + + +## Quota Management + +Quotas provide a mechanism to control resource utilization at the volume level: + +- **Space Quotas**: Limit the total amount of storage (in bytes) a volume can use +- **Namespace Quotas**: Limit the total number of objects that can be stored within a volume +- **Hierarchical Enforcement**: Volume quotas apply to the aggregate of all contained buckets +- **Visibility**: Quota usage and limits can be monitored through the CLI and management interfaces +- **Enforcement**: When a quota is reached, write operations fail with a descriptive error message + +### Quota Commands + +```bash +# Set both space (1TB) and namespace (1 million objects) quotas simultaneously +ozone sh volume setquota --space=1TB --count=1000000 /marketing Review Comment: ```suggestion bin/ozone sh volume setquota --namespace-quota 1000000 /marketing ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
