Help Center> Scalable File Service> API Reference> SFS APIs> QoS Management> Modifying QoS Parameters
View PDF

Modifying QoS Parameters

Function

This API is used to modify QoS parameters of a specified file system.

URI

  • PUT /v2/{project_id}/shares/{share_id}/metadata
  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Specifies the project ID of the operator. For details about how to obtain the project ID, see Obtaining a Project ID.

    share_id

    Yes

    String

    Specifies the ID of the shared file system.

Request Header

The operation message header is the same as that of a common request. For details, see Table 3.

Request

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    metadata

    Yes

    Object

    Specifies the minimum capacity of a file system.
  • Description of the metadata field

    Parameter

    Mandatory

    Type

    Description

    #sfs_min_capacity

    Yes

    Integer

    Specifies the minimum capacity of a file system committed by the user. The QoS is controlled based on this capacity. A larger value of this parameter corresponds to a larger read and write bandwidth. The value ranges from 40 to 512000 and the unit is GB.
  • Example request 
    {
  "metadata" : {
    "#sfs_min_capacity" : 50
  }
}

Response

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    metadata

    Yes

    Object

    Specifies the minimum capacity of a file system.
  • Example response 
    {
  "metadata" : {
    "#sfs_min_capacity" : 50
  }
}

Status Code

  • Normal

    204

  • Abnormal

    Status Code

    Description

    400 Bad Request

    Invalid value.

    401 Unauthorized

    Authentication failed.

    403 Forbidden

    Access to the requested page is forbidden.

    404 Not Found

    The requested resource was not found.

    500 Internal Server Error

    The request is not completed because of a service error.
Parent topic: QoS Management