기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Lightsail 객체 스토리지 버킷에 파일을 업로드합니다.
<a name="amazon-lightsail-uploading-files-to-a-bucket"></a>

Amazon Lightsail 객체 스토리지 서비스의 버킷에 파일을 업로드하면 해당 파일이 객체로 저장됩니다. 객체는 파일 데이터 및 객체를 설명하는 메타데이터로 구성됩니다. 버킷에 저장할 수 있는 객체 수에는 제한이 없습니다.

이미지, 백업, 데이터, 동영상 등 모든 유형의 파일을 버킷에 업로드할 수 있습니다. Lightsail 콘솔을 사용하여 업로드할 수 있는 최대 파일 크기는 2GB입니다. 더 큰 파일을 업로드하려면 Lightsail API, AWS Command Line Interface (AWS CLI) 또는 AWS SDKs 사용합니다.

Lightsail에서는 업로드할 파일의 크기에 따라 다음 옵션을 제공합니다.
+ **Lightsail 콘솔을 사용하여 최대 2GB 크기의 객체 업로드** - Lightsail 콘솔로 최대 2GB 크기의 단일 객체를 업로드할 수 있습니다. 자세한 내용은 가이드 후반부의 [Lightsail 콘솔을 사용하여 버킷에 파일 업로드](#uploading-files-to-a-bucket-lightsail-console)를 참조하세요.
+ ** AWS SDKs, REST API 또는를 사용하는 단일 작업으로 최대 5GB 크기의 객체 업로드 AWS CLI** - 단일 PUT 작업으로 최대 5GB 크기의 단일 객체를 업로드할 수 있습니다. 자세한 내용은 가이드 후반부의 [AWS CLI를 사용하여 버킷에 파일 업로드](#uploading-files-to-a-bucket-aws-cli)를 참조하세요.
+ ** AWS SDKs, REST API 또는 - 멀티파트 업로드 API를 사용하여 AWS CLI**5MB\$150TB 크기의 큰 객체 하나를 업로드할 수 있습니다. 멀티파트 업로드 API는 대용량 객체의 업로드 경험을 개선하기 위해 디자인되었습니다. 객체를 부분별로 업로드할 수 있습니다. 이러한 객체 부분은 임의의 순서로 독립적으로, 그리고 병렬적으로 업로드할 수 있습니다. 자세한 내용은 [멀티파트 업로드를 사용하여 버킷으로 파일 업로드](amazon-lightsail-uploading-files-to-a-bucket-using-multipart-upload.md)를 참조하세요.

버킷에 대한 자세한 내용은 [객체 스토리지](buckets-in-amazon-lightsail.md)를 참조하세요.

## 객체 키 이름 및 버전 관리
<a name="uploading-files-to-a-bucket-object-key-names"></a>

Lightsail 콘솔을 사용하여 파일을 업로드하면 파일 이름이 객체 키 이름으로 사용됩니다. 객체 키(또는 키 이름)는 버킷에 저장된 객체를 고유하게 식별합니다. 파일이 업로드되는 폴더(있는 경우)가 키 이름 접두사로 사용됩니다. 예를 들어, `sailbot.jpg` 파일을 `images` 버킷의 폴더에 업로드하면 전체 객체 키 이름과 접두사가 `images/sailbot.jpg`가 됩니다. 그러나 콘솔에는 해당 객체가 `sailbot.jpg` 폴더의 `images`로 표시됩니다. 객체 키 이름에 대한 자세한 내용은 [객체 스토리지 버킷의 키 이름](understanding-bucket-object-key-names-in-amazon-lightsail.md)을 참조하세요.

Lightsail 콘솔을 사용하여 디렉터리를 업로드하면 디렉터리의 모든 파일과 하위 폴더가 버킷에 업로드됩니다. 그런 다음 Lightsail이 업로드된 각 파일 이름과 폴더 이름의 조합인 객체 키 이름을 할당합니다. 예를 들어, `sample1.jpg` 및 `sample2.jpg`라는 2개의 파일이 들어 있는 `images` 폴더를 업로드하는 경우 Lightsail에서 파일을 업로드한 다음 해당 키 이름인 `images/sample1.jpg` 및 `images/sample2.jpg`를 할당합니다. 객체는 콘솔에 `images` 폴더의 `sample1.jpg` 및 `sample2.jpg`로 표시됩니다.

이미 존재하는 키 이름으로 파일을 업로드하고 버킷에 *버전 관리를 활성화하지 않으면* 새로 업로드된 객체가 이전 객체를 대체합니다. 그러나 버킷에서 *버전 관리를 활성화한* 경우 Lightsail에서는 기존 객체를 교체하지 않고 새 버전의 객체를 생성합니다. 자세한 내용은 [버킷의 객체 버전 사용 설정 및 사용 중지](amazon-lightsail-managing-bucket-object-versioning.md)를 참조하세요.

## Lightsail 콘솔을 사용하여 버킷에 파일 업로드
<a name="uploading-files-to-a-bucket-lightsail-console"></a>

Lightsail 콘솔을 사용하여 파일 및 디렉터리를 업로드하려면 다음 절차를 완료하세요.

1. [Lightsail 콘솔](https://lightsail.aws.amazon.com/)에 로그인합니다.

1. 왼쪽 탐색 창에서 **스토리지**를 선택합니다.

1. 파일 및 폴더를 업로드하려는 버킷의 이름을 선택합니다.

1. **객체(Objects)** 탭에서 다음 작업 중 하나를 수행합니다.
   + 파일 및 폴더를 **객체(Objects)** 페이지로 끌어다 놓습니다.
   + **업로드(Upload)**와 **파일(File)**을 차례로 선택하여 개별 파일을 업로드하거나 **디렉터리(Directory)**를 선택하여 폴더와 폴더의 모든 콘텐츠를 업로드합니다.
**참고**  
**새 폴더 생성(Create new folder)**을 선택하여 폴더를 생성할 수도 있습니다. 그런 다음 새 폴더를 찾아 파일을 업로드할 수 있습니다.

   업로드가 완료되면 **업로드 성공** 메시지가 표시됩니다.

## 를 사용하여 버킷에 파일 업로드 AWS CLI
<a name="uploading-files-to-a-bucket-aws-cli"></a>

 AWS Command Line Interface (AWS CLI)를 사용하여 버킷에 파일과 폴더를 업로드하려면 다음 절차를 완료하세요. `put-object` 명령을 사용하여 이 작업을 수행할 수 있습니다. 자세한 내용은 *AWS CLI 명령 레퍼런스*의 [put-object](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-object.html)를 참조하세요.

**참고**  
이 절차를 계속하기 전에 AWS CLI 및 Amazon S3에 대해 Lightsail를 설치하고 구성해야 합니다. 자세한 내용은 [에서 작동 AWS CLI 하도록 구성을 Lightsail](lightsail-how-to-set-up-and-configure-aws-cli.md)참조하세요.

1. 터미널 또는 명령 프롬프트 창을 엽니다.

1. 다음 명령을 입력하여 버킷에 파일을 업로드합니다.

   ```
   aws s3api put-object --bucket BucketName --key ObjectKey --body LocalDirectory --acl bucket-owner-full-control
   ```

   명령에서 아래 예 텍스트를 사용자의 값으로 대체합니다.
   + *BucketName*을 파일을 업로드하려는 버킷의 이름으로 바꿉니다.
   + *ObjectKey*를 버킷에 있는 객체의 전체 객체 키로 바꿉니다.
   + *LocalDirectory*를 업로드할 파일의 컴퓨터에 있는 로컬 디렉터리 폴더 경로로 바꿉니다.

   예제:
   + Linux 또는 Unix 컴퓨터:

     ```
     aws s3api put-object --bucket amzn-s3-demo-bucket --key images/sailbot.jpg --body home/user/Pictures/sailbot.jpg --acl bucket-owner-full-control
     ```
   + Windows 컴퓨터:

     ```
     aws s3api put-object --bucket amzn-s3-demo-bucket --key images/sailbot.jpg --body "C:\Users\user\Pictures\sailbot.jpg" --acl bucket-owner-full-control
     ```

   다음 예와 비슷한 결과가 나타나야 합니다.  
![\[AWS CLI put-object 명령의 결과\]](http://docs.aws.amazon.com/ko_kr/lightsail/latest/userguide/images/amazon-lightsail-s3api-put-object-result.png)

## IPv6 전용 요청에 대한 AWS CLI 구성
<a name="uploading-files-over-ipv6-only"></a>

Amazon S3는 IPv6를 통한 버킷 액세스를 지원합니다. 듀얼 스택 엔드포인트를 사용하여 IPv6을 통해 Amazon S3 API 호출로 요청합니다. 이 섹션에서는 IPv6를 넘어 듀얼 스택 엔드포인트에 요청하는 데 사용되는 방법을 보여 줍니다. 자세한 내용은 *Amazon S3 사용 설명서*의 [Amazon S3 듀얼 스택 엔드포인트 사용](https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html)을 참조하세요. 설정 지침은 [에서 작동 AWS Command Line Interface 하도록 구성을 Amazon Lightsail](lightsail-how-to-set-up-and-configure-aws-cli.md) AWS CLI참조하세요.

**중요**  
버킷에 액세스하는 클라이언트와 네트워크가 IPv6을 사용하도록 설정되어 있어야 합니다. 자세한 내용은 [IPv6 도달 가능성](amazon-lightsail-ipv6-reachability.md)을 참조하세요.

IPv6 전용 인스턴스에서 S3를 요청하는 방법에는 두 가지가 있습니다. 모든 Amazon S3 요청을 지정된의 듀얼 스택 엔드포인트로 전달 AWS CLI 하도록를 구성할 수 있습니다 AWS 리전. 또는 지정된 AWS CLI 명령에만 듀얼 스택 엔드포인트를 사용하려는 경우(모든 명령이 아님) 모든 명령에 S3 듀얼 스택 엔드포인트를 추가할 수 있습니다.

구성 AWS CLI  
AWS Config 파일의 프로파일에서 구성 값을 `use_dualstack_endpoint``true`로 설정하여 Amazon S3 및 s3api AWS CLI 명령으로 이루어진 모든 Amazon S3 요청을 지정된 리전의 듀얼 스택 엔드포인트로 보냅니다. config 파일 또는 AWS CLI --region 옵션을 사용하여 명령에서 리전을 지정합니다.  
다음 명령을 입력하여 AWS CLI를 구성합니다.  

```
aws configure set default.s3.use_dualstack_endpoint true
```

```
aws configure set default.s3.addressing_style virtual
```

특정 명령에 이중 스택 엔드포인트 추가  
아무 s3 또는 s3api 명령에 대해 `--endpoint-url` 파라미터를 `https://s3.dualstack.aws-region.amazonaws.com` 또는 `http://s3.dualstack.aws-region.amazonaws.com`으로 설정하여 명령별로 이중 스택 엔드포인트를 사용할 수 있습니다. 아래 예제에서 *bucketname*과 *aws-region*을 버킷 및 AWS 리전의 이름으로 바꿉니다.  

```
aws s3api list-objects --bucket bucketname --endpoint-url https://s3.dualstack.aws-region.amazonaws.com
```

## Lightsail에서 버킷 및 객체 관리
<a name="uploading-files-managing-buckets-and-objects"></a>

다음은 Lightsail 객체 스토리지 버킷을 관리하는 일반적인 단계입니다.

1. Amazon Lightsail 객체 스토리지 서비스의 객체와 버킷에 대해 알아보세요. 자세한 내용은 [Amazon Lightsail의 객체 스토리지](buckets-in-amazon-lightsail.md)를 참조하세요.

1. Amazon Lightsail에서 버킷에 지정할 수 있는 이름에 대해 알아봅니다. 자세한 내용은 [Amazon Lightsail의 버킷 이름 지정 규칙](bucket-naming-rules-in-amazon-lightsail.md)을 참조하세요.

1. 버킷을 생성하여 Lightsail 객체 스토리지 서비스를 시작합니다. 자세한 내용은 [Amazon Lightsail에서 버킷 생성](amazon-lightsail-creating-buckets.md)을 참조하세요.

1. 버킷의 보안 모범 사례와 버킷에 구성할 수 있는 액세스 권한에 대해 알아봅니다. 버킷의 모든 객체를 공개 또는 비공개로 설정하거나 개별 객체를 공개로 설정하도록 선택할 수 있습니다. 액세스 키를 생성하고, 버킷에 인스턴스를 연결하고, 다른 AWS 계정에 액세스 권한을 부여하여 버킷에 대한 액세스 권한을 부여할 수도 있습니다. 자세한 내용은 [Amazon Lightsail 객체 스토리지에 대한 보안 모범 사례](amazon-lightsail-bucket-security-best-practices.md) 및 [Amazon Lightsail의 버킷 권한 이해](amazon-lightsail-understanding-bucket-permissions.md)를 참조하세요.

   버킷 액세스 권한에 대해 알아본 후 다음 가이드를 참조하여 버킷에 대한 액세스 권한을 부여합니다.
   + [Amazon Lightsail의 버킷에 대한 퍼블릭 액세스 차단](amazon-lightsail-block-public-access-for-buckets.md)
   + [Amazon Lightsail에서 버킷 액세스 권한 구성](amazon-lightsail-configuring-bucket-permissions.md)
   + [Amazon Lightsail에서 버킷의 개별 객체에 대한 액세스 권한 구성](amazon-lightsail-configuring-individual-object-access.md)
   + [Amazon Lightsail에서 버킷의 액세스 키 생성](amazon-lightsail-creating-bucket-access-keys.md)
   + [Amazon Lightsail에서 버킷에 대한 리소스 액세스 구성](amazon-lightsail-configuring-bucket-resource-access.md)
   + [Amazon Lightsail에서 버킷의 크로스 계정 액세스 구성](amazon-lightsail-configuring-bucket-cross-account-access.md)

1. 버킷에 대한 액세스 로깅을 활성화하는 방법과 액세스 로그를 사용하여 버킷의 보안을 감사하는 방법에 대해 알아봅니다. 자세한 내용은 다음 안내서를 참조하세요.
   + [Amazon Lightsail 객체 스토리지 서비스의 버킷에 대한 액세스 로깅](amazon-lightsail-bucket-access-logs.md)
   + [Amazon Lightsail 객체 스토리지 서비스에서 버킷에 대한 액세스 로그 형식](amazon-lightsail-bucket-access-log-format.md)
   + [Amazon Lightsail 객체 스토리지 서비스에서 버킷에 대한 액세스 로깅 활성화](amazon-lightsail-enabling-bucket-access-logs.md)
   + [Amazon Lightsail에서 버킷에 대한 액세스 로그 사용하여 요청을 식별](amazon-lightsail-using-bucket-access-logs.md)

1. Lightsail에서 버킷을 관리할 수 있는 기능을 사용자에게 부여하는 IAM 정책을 생성합니다. 자세한 내용은 [Amazon Lightsail에서 버킷을 관리하기 위한 IAM 정책](amazon-lightsail-bucket-management-policies.md)을 참조하세요.

1. 버킷의 객체에 라벨을 지정하고 식별하는 방식에 대해 알아봅니다. 자세한 내용은 [Amazon Lightsail에서 객체 키 이름 이해](understanding-bucket-object-key-names-in-amazon-lightsail.md)를 참조하세요.

1. 파일을 업로드하고 버킷의 객체를 관리하는 방법에 대해 알아봅니다. 자세한 내용은 다음 안내서를 참조하세요.
   + [Amazon Lightsail에서 버킷으로 파일 업로드](#amazon-lightsail-uploading-files-to-a-bucket)
   + [멀티파트 업로드를 사용하여 Amazon Lightsail에서 버킷으로 파일 업로드](amazon-lightsail-uploading-files-to-a-bucket-using-multipart-upload.md)
   + [Amazon Lightsail에서 버킷의 객체 확인](amazon-lightsail-viewing-objects-in-a-bucket.md)
   + [Amazon Lightsail에서 버킷의 객체 복사 또는 이동](amazon-lightsail-copying-moving-bucket-objects.md)
   + [Amazon Lightsail에서 버킷의 객체 다운로드](amazon-lightsail-downloading-bucket-objects.md)
   + [Amazon Lightsail에서 버킷의 객체 필터링](amazon-lightsail-filtering-bucket-objects.md)
   + [Amazon Lightsail에서 버킷의 객체 태그 지정](amazon-lightsail-tagging-bucket-objects.md)
   + [Amazon Lightsail에서 버킷의 객체 삭제](amazon-lightsail-deleting-bucket-objects.md)

1. 객체 버전 관리를 활성화하면 버킷에 저장된 모든 버전의 객체를 모두 보존, 검색 및 복원할 수 있습니다. 자세한 내용은 [Amazon Lightsail에서 버킷의 객체 버전 사용 설정 및 사용 중지](amazon-lightsail-managing-bucket-object-versioning.md)를 참조하세요.

1. 객체 버전 관리를 활성화한 후 버킷에 있는 객체의 이전 버전을 복원할 수 있습니다. 자세한 내용은 [Amazon Lightsail에서 버킷의 이전 객체 버전 복원](amazon-lightsail-restoring-bucket-object-versions.md)을 참조하세요.

1. 버킷 사용률을 모니터링합니다. 자세한 내용은 [Amazon Lightsail에서 버킷에 대한 지표 보기](amazon-lightsail-viewing-bucket-metrics.md)를 참조하세요.

1. 버킷 사용률이 임곗값을 초과할 때 알림을 받도록 버킷 지표에 대한 경보를 구성합니다. 자세한 내용은 [Amazon Lightsail에서 버킷 지표 경보 생성](amazon-lightsail-adding-bucket-metric-alarms.md)을 참조하세요.

1. 스토리지 및 네트워크 전송이 부족한 경우 버킷의 스토리지 플랜을 변경합니다. 자세한 내용은 [Amazon Lightsail에서 버킷 플랜 변경](amazon-lightsail-changing-bucket-plans.md)을 참조하세요.

1. 버킷을 다른 리소스에 연결하는 방법에 대해 알아봅니다. 자세한 내용은 다음 자습서를 참조하세요.
   + [자습서: WordPress 인스턴스를 Amazon Lightsail 버킷에 연결](amazon-lightsail-connecting-buckets-to-wordpress.md)
   + [자습서: Lightsail 콘텐츠 전송 네트워크 배포와 함께 Amazon Lightsail 버킷 사용](amazon-lightsail-using-distributions-with-buckets.md)

1. 버킷을 더 이상 사용하지 않는 경우 삭제할 수 있습니다. 자세한 내용은 [Amazon Lightsail에서 버킷 삭제](amazon-lightsail-deleting-buckets.md)를 참조하세요.