Check If a Bucket Exists and Whether the Requester Has Permission to Access the Bucket
Updated at:2025-11-03
API description
This API checks whether a bucket exists and whether the user has access permissions. If the request returns a 200 OK response, the bucket exists, and the user has access.
Online debugging
Request URI
HEAD /v1/{bucketName}
| Parameter name | Parameter type | Required or not | Description | Example value | Parameter location |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
Parameters of request body
Description of the data structure of request body fields
Response body parameters
Description of the data structure of response body fields
Request example
JSON
1HEAD /v1/bucketName_example
2 <Common request headers>
3{ }
Response example
JSON
1HTTP/1.1 200 OK
2 <Common response headers>
3{ }
Error code
Please refer to the general error codes
