v1

latestSwagger 2.02026-07-13125103.0 KB

File and Directory Operations

Delete File | Delete Directory

Delete the file or directory. This operation supports conditional HTTP requests. For more information, see Specifying Conditional Headers for Blob Service Operations.

delete/{filesystem}/{path}

Query parameters

recursiveboolean

Required and valid only when the resource is a directory. If "true", all paths beneath the directory will be deleted. If "false" and the directory is non-empty, an error occurs.

continuationstring

Optional. When deleting a directory, the number of paths that are deleted with each invocation is limited. If the number of paths to be deleted exceeds this limit, a continuation token is returned in this response header. When a continuation token is returned in the response, it must be specified in a subsequent invocation of the delete operation to continue deleting the directory.

Headers

x-ms-lease-idstring

The lease ID must be specified if there is an active lease.

If-Matchstring

Optional. An ETag value. Specify this header to perform the operation only if the resource's ETag matches the value specified. The ETag must be specified in quotes.

If-None-Matchstring

Optional. An ETag value or the special wildcard ("*") value. Specify this header to perform the operation only if the resource's ETag does not match the value specified. The ETag must be specified in quotes.

If-Modified-Sincestring

Optional. A date and time value. Specify this header to perform the operation only if the resource has been modified since the specified date and time.

If-Unmodified-Sincestring

Optional. A date and time value. Specify this header to perform the operation only if the resource has not been modified since the specified date and time.

Response

The file was deleted.