HeadObject

Prev Next

Available in Classic and VPC

Get the metadata of an object stored in a Ncloud Storage bucket.

Request

This section describes the request format. The method and URI are as follows:

Method URI
HEAD /{Key}

Request headers

The following describes the request headers.

Note

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage request headers.

Field Required Description
x-amz-server-side-encryption-customer-algorithm Optional User encryption algorithm (AES256)
x-amz-server-side-encryption-customer-key Optional User-provided encryption key
x-amz-server-side-encryption-customer-key-MD5 Optional User-provided encryption key's MD5 value

Request path parameters

You can use the following path parameters with your request:

Field Type Required Description
Key String Required Object name

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
partNumber String Optional Object part number
  • See ListParts.
  • Enter when querying metadata for a part of an object.
versionId String Optional Object version ID
  • See ListObjectVersions.
  • Enter when querying metadata of a specific version of an object from a bucket with version control enabled.

Request example

The request example is as follows:

HEAD /object.csv HTTP/1.1
Host: bucket.kr.ncloudstorage.com

Response

This section describes the response format.

Response headers

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage response headers.

Response status codes

For information about the HTTP status codes common to all Ncloud Storage APIs, see Common Ncloud Storage response status codes.

Response example

The response example is as follows:

HTTP/1.1 200 OK
accept-ranges: bytes
cache-control: no-cache
content-length: 464
content-type: text/csv
etag: 2ecf9f32d**************9aed87829
last-modified: Wed, 23 Apr 2025 01:55:37 GMT
x-amz-id-2: ODcyNGVjZjIyOWE******************************wMDViMDUwZjcwZQ==
x-amz-request-id: 98d0f3d2-****-****-****-e47c1b0b26fa
x-amz-version-id: null
date: Thu, 24 Apr 2025 23:42:13 GMT
server: Ncloud Storage