PowerScale OneFS API Reference

PDF

Quotas resource

Create, modify, delete, or retrieve information about file system quotas.


Operation	Method and URI
Retrieve all quotas.	GET <cluster-ip:port>/platform/14/quota/quotas
Retrieve one quota.	GET <cluster-ip:port>/platform/14/quota/quotas/<QUOTA-ID>
Create a quota.	POST <cluster-ip:port>/platform/14/quota/quotas
Modify a quota.	PUT <cluster-ip:port>/platform/14/quota/quotas/<QUOTA-ID>
Delete all quotas.	DELETE <cluster-ip:port>/platform/14/quota/quotas
Delete a quota.	DELETE <cluster-ip:port>/platform/14/quota/quotas/<QUOTA-ID>
View the detailed JSON schema for this resource, which has information about query parameters and object properties.	GET <cluster-ip:port>/platform/14/quota/quotas?describe
	GET <cluster-ip:port>/platform/14/quota/quotas/<QUOTA-ID>?describe

Example request for retrieve all quotas

List all or matching quotas. It can also be used to retrieve quota state from existing reports. For any query argument not supplied, the default behavior is returned all.

GET /platform/quota/quotas

Example response for retrieve all quotas

"quotas": [ 

        { 

            "container": false, 

            "efficiency_ratio": 0.6644405405460209, 

            "enforced": false, 

            "id": "gAEDAAEAAAAAAAAAAAAAQAEAAAAAAAAA", 

            "include_snapshots": false, 

            "linked": false, 

            "notifications": "default", 

            "path": "/ifs/test", 

            "persona": null, 

            "ready": true, 

            "reduction_ratio": 1.000002479553223, 

            "thresholds": { 

                "advisory": null, 

                "advisory_exceeded": false, 

                "advisory_last_exceeded": null, 

                "hard": null, 

                "hard_exceeded": false, 

                "hard_last_exceeded": null, 

                "percent_advisory": null, 

                "percent_soft": null, 

                "soft": null, 

                "soft_exceeded": false, 

                "soft_grace": null, 

                "soft_last_exceeded": null 

            }, 

            "thresholds_on": "fslogicalsize", 

            "type": "directory", 

            "usage": { 

                "applogical": 10485760, 

                "applogical_ready": true, 

                "fslogical": 10485786, 

                "fslogical_ready": true, 

                "fsphysical": 15781376, 

                "fsphysical_ready": true, 

                "inodes": 2, 

                "inodes_ready": true, 

                "physical": 15781376, 

                "physical_data": 10485760, 

                "physical_data_ready": true, 

                "physical_protection": 5242880, 

                "physical_protection_ready": true, 

                "physical_ready": true, 

                "shadow_refs": 0, 

                "shadow_refs_ready": true 

            } 

        } 

    ], 

    "resume": null 

}