tencent cloud

Smart Media Hosting

Checking Directory or Album

PDF
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-01-07 14:52:06

Description

Check the status of a directory or album.

Request

Request Example

HEAD /api/v1/directory/`{LibraryId}`/`{SpaceId}`/`{DirPath}`?access_token=`{AccessToken}`&user_id=`{UserId}`

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console. Please refer to Create Media Library
String
Yes
SpaceId
Space ID. If the media library is in single-tenant mode, this parameter is fixed as hyphen (`-`); if the media library is in multi-tenant mode, you must specify this parameter. For retrieval, please refer to Create Tenant Space
String
No
DirPath
Directory path or album name. For multi-level directories, use slash (/) to separate, such as foo/bar; for the root directory, leave this parameter blank.
String
No
AccessToken
Access token. For Public Read Media Library or tenant space, this parameter is not specified, otherwise must specify this parameter. See Generate Access Token
String
No
UserId
User identity recognition. When the access token has admin permission and the user identity recognition during token application is empty, it is used to temporarily specify user identity. For details, see Generate Access Token API
String
No

Request Body

This request does not have a request body.

Response

Response code

The directory or album exists, returning HTTP 200 OK.
The directory or album does not exist, returning HTTP 404 Not Found.

Response Body

This response has no response body.

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan