---
title: "get-object"
slug: "cli-objectstorage-api-level-get-object"
updated: 2026-10-08T05:02:14Z
published: 2026-10-08T05:02:14Z
canonical: "cli.ncloud-docs.com/cli-objectstorage-api-level-get-object"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# get-object

Available in Classic and VPC

Download an object stored in Object Storage.

## Syntax

The `get-object` syntax is as follows:

```
aws s3api get-object \
    --bucket <bucket> \
    --key <key> \
    [--version-id <version-id>] \
    [--range <range>] \
    [--part-number <part-number>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    --endpoint-url <endpoint-url> \
    <outfile>
```

## Options

This section describes the options available when running `get-object`.

### Required options

The following options are required for `get-object`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--bucket` | String | Required | Bucket name |
| `--key` | String | Required | Object name |
| `&lt;outfile&gt;` | String | Required | Name of the downloaded file will be saved as |

### Optional options

These are the optional options for `get-object`. Options that are not specified will use their default values.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--version-id` | String | Optional | Object version ID - When downloading a specific version of an object from a bucket with versioning enabled |
| `--range` | String | Optional | Byte range to download |
| `--part-number` | String | Optional | Part number to download - When downloading only parts of an object |
| `--sse-customer-algorithm` | String | Optional | User encryption algorithm (AES256) |
| `--sse-customer-key` | String | Optional | User-provided encryption key |
| `--sse-customer-key-md5` | String | Optional | User-provided encryption key's MD5 value |

### Common options

For information about the options common to all `aws` subcommands, see [Object Storage options](/docs/en/guide-objectstorage#%EC%98%B5%EC%85%98).

## Examples

If the request to download an object is successful, the object is saved to the specified path, and the object's metadata is returned.

### Command

The command example is as follows:

```
aws s3api get-object --bucket my-test-bucket \
    --key img/image.png \
    --endpoint-url=https://kr.object.ncloudstorage.com \
    image.png
```

The following is an example command for downloading only a specific range of bytes from an object.

```
aws s3api get-object --bucket my-test-bucket \
    --key img/image.png \
    --range bytes=0-31 \
    --endpoint-url=https://kr.object.ncloudstorage.com \
    partial.png
```

The following is an example command for downloading only a specific part of a multipart object.

```
aws s3api get-object --bucket my-test-bucket \
    --key large.bin \
    --part-number 1 \
    --endpoint-url=https://kr.object.ncloudstorage.com \
    part1.bin
```

### Output

The output example is as follows:

```
{
    "AcceptRanges": "bytes",
    "LastModified": "Wed, 02 Sep 2026 06:39:50 GMT",
    "ContentLength": 70,
    "ETag": "\"2cd8bde463f5d82aae0f0cec061d6b8f\"",
    "ContentType": "image/png",
    "Metadata": {},
    "StorageClass": "Standard"
}
```

The following is an example output from downloading a specified byte range. The requested range and the total size are returned via `ContentRange`.

```
{
    "AcceptRanges": "bytes",
    "LastModified": "Wed, 02 Sep 2026 06:39:50 GMT",
    "ContentLength": 32,
    "ETag": "\"2cd8bde463f5d82aae0f0cec061d6b8f\"",
    "ContentRange": "bytes 0-31/70",
    "ContentType": "image/png",
    "Metadata": {},
    "StorageClass": "Standard"
}
```

The following is an example output for downloading only specific parts. The total number of parts in the object is returned as `PartsCount`.

```
{
    "AcceptRanges": "bytes",
    "LastModified": "Wed, 02 Sep 2026 06:39:06 GMT",
    "ContentLength": 5242880,
    "ETag": "\"cad5bfe2c36bcb9a8f19d6122296cc1c-1\"",
    "ContentRange": "bytes 0-5242879/5242880",
    "ContentType": "application/octet-stream",
    "Metadata": {},
    "StorageClass": "Standard",
    "PartsCount": 1
}
```