• Scalable File Service

sfs
  1. Help Center
  2. Scalable File Service
  3. API Reference
  4. SFS APIs
  5. Share Tag
  6. Deleting a Tag from a Share

Deleting a Tag from a Share

Function

This interface is used to delete a tag from a specified share.

NOTE:

If the key to be deleted does not exist in the share, error 404 is returned after interface calling.

URI

  • DELETE /v2/{project_id}/sfs/{share_id}/tags/{key}
  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    string

    Specifies the project ID of the operator.

    share_id

    Yes

    string

    Specifies the share ID.

    key

    Yes

    string

    Specifies the key of the tag. The value can contain a maximum of 36 characters. The key cannot be empty and can only contain letters, digits, hyphens (-), and underscores (_).

    NOTICE:

    When invoking the interface "Deleting a Tag from a Share" to delete a tag, if the tag key contains special characters that are not directly parsed by the URL, the key needs to be escaped.

Request

  • Parameter description

    None

  • Example request

    None

Response

  • Parameter description

    None

  • Example response

    None

Status Codes

  • Normal

    204

  • Abnormal

    Status Code

    Description

    400 Bad Request

    Invalid value.

    401 Unauthorized

    Authentication failed.

    403 Forbidden

    You are forbidden to access the requested page.

    404 Not Found

    The requested resource was not found.

    500 Internal Server Error

    The request is not completed because of a service error.