객체 키 이름 및 버전 관리 Lightsail 콘솔을 사용하여 버킷에 파일 업로드 AWS CLI를 사용하여 버킷에 파일 업로드 IPv6 전용 요청에 대한 AWS CLI 구성 Lightsail에서 버킷 및 객체 관리

Lightsail 객체 스토리지 버킷에 파일을 업로드합니다.

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

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

Lightsail에서는 업로드할 파일의 크기에 따라 다음 옵션을 제공합니다.

Lightsail 콘솔을 사용하여 최대 2GB 크기의 객체 업로드 - Lightsail 콘솔로 최대 2GB 크기의 단일 객체를 업로드할 수 있습니다. 자세한 내용은 가이드 후반부의 Lightsail 콘솔을 사용하여 버킷에 파일 업로드를 참조하세요.
AWS SDKs, REST API 또는 AWS CLI를 사용하여 단일 작업으로 최대 5GB 크기의 객체 업로드 - 단일 PUT 작업을 통해 최대 5GB 크기의 단일 객체를 업로드할 수 있습니다. 자세한 내용은 가이드 후반부의 AWS CLI를 사용하여 버킷에 파일 업로드를 참조하세요.
AWS SDKs, REST API 또는 AWS CLI를 사용하여 객체 파트 업로드 - 멀티파트 업로드 API를 사용하여 크기가 5MB에서 5TB인 단일 대용량 객체를 업로드할 수 있습니다. 멀티파트 업로드 API는 대용량 객체의 업로드 경험을 개선하기 위해 디자인되었습니다. 객체를 부분별로 업로드할 수 있습니다. 이러한 객체 부분은 임의의 순서로 독립적으로, 그리고 병렬적으로 업로드할 수 있습니다. 자세한 내용은 멀티파트 업로드를 사용하여 버킷으로 파일 업로드를 참조하세요.

버킷에 대한 자세한 내용은 객체 스토리지를 참조하세요.

객체 키 이름 및 버전 관리

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

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

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

Lightsail 콘솔을 사용하여 버킷에 파일 업로드

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

Lightsail 콘솔에 로그인합니다.
왼쪽 탐색 창에서 스토리지를 선택합니다.
파일 및 폴더를 업로드하려는 버킷의 이름을 선택합니다.
객체(Objects) 탭에서 다음 작업 중 하나를 수행합니다.
- 파일 및 폴더를 객체(Objects) 페이지로 끌어다 놓습니다.
- 업로드(Upload)와 파일(File)을 차례로 선택하여 개별 파일을 업로드하거나 디렉터리(Directory)를 선택하여 폴더와 폴더의 모든 콘텐츠를 업로드합니다.
  
  참고
  새 폴더 생성(Create new folder)을 선택하여 폴더를 생성할 수도 있습니다. 그런 다음 새 폴더를 찾아 파일을 업로드할 수 있습니다.
업로드가 완료되면 업로드 성공 메시지가 표시됩니다.

AWS CLI를 사용하여 버킷에 파일 업로드

AWS Command Line Interface (AWS CLI)를 사용하여 버킷에 파일과 폴더를 업로드하려면 다음 절차를 완료하세요. put-object 명령을 사용하여 이 작업을 수행할 수 있습니다. 자세한 내용은 AWS CLI 명령 레퍼런스의 put-object를 참조하세요.

참고

이 절차를 계속하기 전에 AWS CLI를 설치하고 Lightsail 및 Amazon S3에 맞게 구성해야 합니다. 자세한 내용은 AWS CLI가 Lightsail과 함께 작동하도록 구성을 참조하세요.

터미널 또는 명령 프롬프트 창을 엽니다.
다음 명령을 입력하여 버킷에 파일을 업로드합니다.
```
aws s3api put-object --bucket BucketName --key ObjectKey --body LocalDirectory --acl bucket-owner-full-control
```
명령에서 아래 예 텍스트를 사용자의 값으로 대체합니다.
- BucketName을 파일을 업로드하려는 버킷의 이름으로 바꿉니다.
- ObjectKey를 버킷에 있는 객체의 전체 객체 키로 바꿉니다.
- LocalDirectoryFire를 업로드할 파일의 컴퓨터에 있는 로컬 디렉터리 폴더 경로로 바꿉니다.
예시
- 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
```
다음 예와 비슷한 결과가 나타나야 합니다.

IPv6 전용 요청에 대한 AWS CLI 구성

Amazon S3는 IPv6를 통한 버킷 액세스를 지원합니다. 듀얼 스택 엔드포인트를 사용하여 IPv6을 통해 Amazon S3 API 호출로 요청합니다. 이 섹션에서는 IPv6를 넘어 듀얼 스택 엔드포인트에 요청하는 데 사용되는 방법을 보여 줍니다. 자세한 내용은 Amazon S3 사용 설명서의 Amazon S3 듀얼 스택 엔드포인트 사용을 참조하세요. AWS CLI를 설정하는 방법에 대한 지침은 Amazon Lightsail에서 작동하도록 AWS Command Line Interface 구성을 참조하세요.

중요

버킷에 액세스하는 클라이언트와 네트워크가 IPv6을 사용하도록 설정되어 있어야 합니다. 자세한 내용은 IPv6 도달 가능성을 참조하세요.

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

AWS CLI 구성

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

다음 명령을 입력하여 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에서 버킷 및 객체 관리

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

Amazon Lightsail 객체 스토리지 서비스의 객체와 버킷에 대해 알아보세요. 자세한 내용은 Amazon Lightsail의 객체 스토리지를 참조하세요.
Amazon Lightsail에서 버킷에 지정할 수 있는 이름에 대해 알아봅니다. 자세한 내용은 Amazon Lightsail의 버킷 이름 지정 규칙을 참조하세요.
버킷을 생성하여 Lightsail 객체 스토리지 서비스를 시작합니다. 자세한 내용은 Amazon Lightsail에서 버킷 생성을 참조하세요.
버킷의 보안 모범 사례와 버킷에 구성할 수 있는 액세스 권한에 대해 알아봅니다. 버킷의 모든 객체를 공개 또는 비공개로 설정하거나 개별 객체를 공개로 설정하도록 선택할 수 있습니다. 액세스 키를 생성하고, 버킷에 인스턴스를 연결하고, 다른 AWS 계정에 액세스 권한을 부여하여 버킷에 대한 액세스 권한을 부여할 수도 있습니다. 자세한 내용은 Amazon Lightsail 객체 스토리지에 대한 보안 모범 사례 및 Amazon Lightsail의 버킷 권한 이해를 참조하세요.

버킷 액세스 권한에 대해 알아본 후 다음 가이드를 참조하여 버킷에 대한 액세스 권한을 부여합니다.
버킷에 대한 액세스 로깅을 활성화하는 방법과 액세스 로그를 사용하여 버킷의 보안을 감사하는 방법에 대해 알아봅니다. 자세한 내용은 다음 안내서를 참조하세요.
Lightsail에서 버킷을 관리할 수 있는 기능을 사용자에게 부여하는 IAM 정책을 생성합니다. 자세한 내용은 Amazon Lightsail에서 버킷을 관리하기 위한 IAM 정책을 참조하세요.
버킷의 객체에 라벨을 지정하고 식별하는 방식에 대해 알아봅니다. 자세한 내용은 Amazon Lightsail에서 객체 키 이름 이해를 참조하세요.
파일을 업로드하고 버킷의 객체를 관리하는 방법에 대해 알아봅니다. 자세한 내용은 다음 안내서를 참조하세요.
객체 버전 관리를 활성화하면 버킷에 저장된 모든 버전의 객체를 모두 보존, 검색 및 복원할 수 있습니다. 자세한 내용은 Amazon Lightsail에서 버킷의 객체 버전 사용 설정 및 사용 중지를 참조하세요.
객체 버전 관리를 활성화한 후 버킷에 있는 객체의 이전 버전을 복원할 수 있습니다. 자세한 내용은 Amazon Lightsail에서 버킷의 이전 객체 버전 복원을 참조하세요.
버킷 사용률을 모니터링합니다. 자세한 내용은 Amazon Lightsail에서 버킷 지표 확인을 참조하세요.
버킷 사용률이 임곗값을 초과할 때 알림을 받도록 버킷 지표에 대한 경보를 구성합니다. 자세한 내용은 Amazon Lightsail에서 버킷 지표 경보 생성을 참조하세요.
스토리지 및 네트워크 전송이 부족한 경우 버킷의 스토리지 플랜을 변경합니다. 자세한 내용은 Amazon Lightsail에서 버킷 플랜 변경을 참조하세요.
버킷을 다른 리소스에 연결하는 방법에 대해 알아봅니다. 자세한 내용은 다음 자습서를 참조하세요.
- 자습서: WordPress 인스턴스를 Amazon Lightsail 버킷에 연결
- 자습서: Lightsail 콘텐츠 전송 네트워크 배포와 함께 Amazon Lightsail 버킷 사용
버킷을 더 이상 사용하지 않는 경우 삭제할 수 있습니다. 자세한 내용은 Amazon Lightsail에서 버킷 삭제를 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

버킷 권한

컨테이너 서비스 수