--- title: "GetObjectAttributes" slug: "ncloudstorage-getobjectattributes" updated: 2026-09-17T10:12:27Z published: 2026-09-17T10:12:27Z canonical: "api.ncloud-docs.com/ncloudstorage-getobjectattributes" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # GetObjectAttributes Available in Classic and VPC Get the metadata (attributes) 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 | | --- | --- | | GET | /{Key}?attributes | ### 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](/docs/en/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94). | Field | Required | Description | | --- | --- | --- | | `x-amz-object-attributes` | Required | List of object attributes to retrieve - Multiple values can be specified, separated by commas (`,`). - `ETag` \| `ObjectSize` \| `StorageClass` \| `Checksum` \| `ObjectParts` | | `x-amz-max-parts` | Optional | Maximum number of parts to include in the response - Applicable when `ObjectParts` is specified in `x-amz-object-attributes` - 0-2,147,483,647 - 1,000 if not entered | | `x-amz-part-number-marker` | Optional | Starting part number for the part query - Queries start from the part following the specified part number. - 0-2,147,483,647 - 0 if not entered | | `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 query parameters You can use the following query parameters with your request: | Field | Type | Required | Description | | --- | --- | --- | --- | | `attributes` | String | Required | Classification of object attribute query request - Specify only the key without the value. | | `versionId` | String | Optional | Version ID of the object to query - Query the latest version if not entered. | ### Request example The request example is as follows: ``` GET /object.csv?attributes HTTP/1.1 Host: {Bucket}.kr.ncloudstorage.com x-amz-object-attributes: ETag,ObjectSize,StorageClass ``` ## Response This section describes the response format. ### Response headers The following describes the response headers. For information about the headers common to all Ncloud Storage APIs, see [Ncloud Storage response headers](/docs/en/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94). | Field | Required | Description | | --- | --- | --- | | `Last-Modified` | - | Last modification date and time of the object | | `x-amz-version-id` | - | Version ID of the object - Displayed when version control is enabled | | `x-amz-delete-marker` | - | Whether it is a deletion marker - Displayed as `true` if the object is a deletion marker | ### Response body The response body includes the following data: Only fields corresponding to the requested attribute (`x-amz-object-attributes`) are included in the response. | Field | Type | Required | Description | | --- | --- | --- | --- | | `GetObjectAttributesResponse` | Object | - | Object attribute query result | | `GetObjectAttributesResponse.ETag` | String | - | Unique object identifier (entity tag) | | `GetObjectAttributesResponse.ObjectSize` | Integer | - | Object size (byte) | | `GetObjectAttributesResponse.StorageClass` | String | - | Storage class - `STANDARD` \| `DEEP_ARCHIVE` - `STANDARD`: Standard Class - `DEEP_ARCHIVE`: Archive Class | | `GetObjectAttributesResponse.Checksum` | Object | - | [Checksum information](/docs/en/ncloudstorage-getobjectattributes#checksum) | | `GetObjectAttributesResponse.ObjectParts` | Object | - | [Part information of multipart object](/docs/en/ncloudstorage-getobjectattributes#objectparts) | #### `Checksum` The following describes `Checksum`. Only the fields corresponding to the checksum algorithm set for the object are displayed. | Field | Type | Required | Description | | --- | --- | --- | --- | | `ChecksumCRC32` | String | - | CRC32 checksum value | | `ChecksumCRC32C` | String | - | CRC32C checksum value | | `ChecksumSHA1` | String | - | SHA1 checksum value | | `ChecksumSHA256` | String | - | SHA256 checksum value | | `ChecksumCRC64NVME` | String | - | CRC64NVME checksum value | | `ChecksumType` | String | - | Checksum type - `FULL_OBJECT` \| `COMPOSITE` | #### `ObjectParts` The following describes `ObjectParts`. This is displayed for objects created via multipart upload. | Field | Type | Required | Description | | --- | --- | --- | --- | | `IsTruncated` | Boolean | - | Whether subsequent parts exist - `true` \| `false` - `true`: They exist. - `false`: They don't exist. | | `MaxParts` | Integer | - | Maximum number of parts included in the response | | `PartNumberMarker` | Integer | - | Starting part number for the part query | | `NextPartNumberMarker` | Integer | - | Starting part number for the next page query - Displayed if `IsTruncated` is `true` | | `PartsCount` | Integer | - | Total number of parts in the object | | `Part` | Array | - | [Part list](/docs/en/ncloudstorage-getobjectattributes#part) | #### `Part` The following describes `Part`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `PartNumber` | Integer | - | Part number | | `Size` | Integer | - | Part size (byte) | ### Response status codes The following describes the response status codes. For information about the HTTP status codes common to all Ncloud Storage APIs, see [Common Ncloud Storage response status codes](/docs/en/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). | Error code | HTTP status code | Description | | --- | --- | --- | | `InvalidRequest` | 400 | The `x-amz-object-attributes` header is missing or empty. - A user encryption header was specified for an object not encrypted with SSE-C. | | `InvalidArgument` | 400 | An invalid attribute name was specified - `x-amz-max-parts` or `x-amz-part-number-marker` values are outside the valid range (0-2,147,483,647). - `versionId` is in an invalid format. | | `AccessDenied` | 403 | No permission to access the object - Invalid SSE-C encryption key | | `NoSuchKey` | 404 | Specified object does not exist. | | `NoSuchVersion` | 404 | Specified version does not exist. | | `MethodNotAllowed` | 405 | Specific version of a delete marker was queried. | ### Response example The following is a sample response when all attributes (`ETag`, `ObjectSize`, `StorageClass`, `Checksum`, `ObjectParts`) are queried. ``` HTTP/1.1 200 OK ****** 1024 STANDARD ****** COMPOSITE false 1000 0 2 1 512 2 512 ```