• Scalable File Service

sfs
  1. Help Center
  2. Scalable File Service
  3. API Reference(cli)
  4. API Description
  5. Quota Management
  6. Querying a Quota

Querying a Quota

Function

This interface is used to query quota information.

NOTE:

SFS supports querying quotas of only tenants.

Command

  • Usage
    manila quota-show [--tenant <tenant-id>] [--user <user-id>]
  • Parameter description

    Name

    Mandatory

    Type

    Description

    tenant-id

    No

    string

    Specifies the UUID of the tenant whose quota is to be queried. This parameter is used by Administrator to query quotas of other tenants. For a common tenant, this parameter is unnecessary because only the tenant's own quota can be queried by default.

    user-id

    No

    string

    User ID

    NOTE:

    SFS supports querying quotas of only tenants. Therefore, setting this parameter for user quota query is meaningless.

  • Example command
    manila quota-show

Response

  • Parameter description

    Name

    Mandatory

    Type

    Description

    gigabytes

    Yes

    integer

    Specifies the capacity in gigabytes allowed for each tenant. If the value is -1, there is no quota limit.

    snapshot_gigabytes

    Yes

    integer

    Specifies the snapshot capacity in gigabytes allowed for each tenant. If the value is -1, there is no quota limit.

    NOTICE:

    Currently, snapshot is not supported. This parameter is reserved and the default value is -1.

    snapshots

    Yes

    integer

    Specifies the number of snapshots allowed for each tenant. If the value is -1, there is no quota limit.

    NOTICE:

    Currently, snapshot is not supported. This parameter is reserved and the default value is -1.

    shares

    Yes

    integer

    Specifies the number of shared file systems allowed for each tenant. If the value is -1, there is no quota limit.

    id

    No

    sting

    Specifies the ID of the tenant whose quota is to be queried.

    NOTICE:

    The ID of the tenant to be queried is displayed only when the version of python-manilaclient is 1.12.0 or later.

    share_networks

    Yes

    integer

    Specifies the number of share networks for each tenant. If the value is -1, there is no quota limit.

    NOTICE:

    Currently, share networks cannot be configured. This parameter is reserved and the default value is 10.

  • Example response
    +--------------------+----------------------------------+
    | Property           | Value                            |
    +--------------------+----------------------------------+
    | gigabytes          | 31200                            |
    | snapshots          | -1                               |
    | snapshot_gigabytes | -1                               |
    | shares             | 3                                | 
    | id                 | 703fdd5a62c84cbfb1385c212881f695 |
    | share_networks     | 10                               |
    +--------------------+----------------------------------+

    The ID is displayed only when the version of python-manilaclient is 1.12.0 or later.