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

# Amazon S3 작업
<a name="s3"></a>

Amazon Simple Storage Service (Amazon S3)는 확장 가능한 데이터 스토리지 서비스입니다. AWS Toolkit for Visual Studio Code를 사용하면 VS Code에서 직접 Amazon S3 객체 및 리소스를 관리할 수 있습니다.

Amazon S3 서비스에 대한 자세한 내용은 [Amazon DynamoDB](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) 사용 설명서를 참조하세요.

다음 항목에서는 AWS Toolkit for Visual Studio Code에서 Amazon S3 객체 및 리소스 작업을 수행하는 방법을 설명합니다.

**Topics**
+ [S3 리소스 사용](s3-service.md)
+ [객체 작업](s3-service-objects.md)

# Amazon S3 리소스 사용
<a name="s3-service"></a>

AWS Toolkit for Visual Studio Code의 Amazon S3에서 버킷 및 기타 리소스를 보고, 관리하고, 수정할 수 있습니다.

다음 섹션에서는 AWS Toolkit for Visual Studio Code의 Amazon S3 리소스를 활용하는 방법을 설명합니다. AWS Toolkit for Visual Studio Code의 Amazon S3 객체 (예: 폴더 및 파일) 활용에 대한 자세한 내용은 이 사용 설명서의 [S3 객체 활용](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/s3-service-objects.html)을 참조하세요.

## Amazon S3 버킷 생성
<a name="s3-service-resources-bucket"></a>

1. 도구 키트 탐색기에서 **S3** 서비스의 컨텍스트 메뉴를 연 다음(마우스 우클릭) **버킷 생성**을 선택합니다. 또는 **버킷 생성 ** 아이콘을 선택하여 **버킷 생성** 대화 상자를 열 수도 있습니다.

1. **버킷 이름** 필드에 유효한 버킷 이름을 입력합니다.

   **Enter** 키를 눌러 버킷을 생성하고 대화 상자를 닫습니다. 이제 새 버킷이 도구 키트의 S3 서비스 아래에 표시됩니다.
**참고**  
Amazon S3에서 공개 액세스 URL로 버킷을 사용할 수 있기 때문에 선택한 버킷 이름이 전역적으로 고유해야 합니다. 다른 계정이 사용하려는 이름으로 버킷을 생성한 경우 다른 이름을 사용해야 합니다.  
새 버킷을 만들 수 없다면 **Output** 탭에서 **AWS Toolkit Logs**를 확인하세요. 잘못된 버킷 이름을 사용하려고 하면 `BucketAlreadyExists` 오류가 발생합니다.  
자세한 내용은 **Amazon Simple Storage Service 사용 설명서**의 [Bucket restrictions and limitations](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html)을 참조하세요.

## Amazon S3 버킷에 폴더 추가
<a name="s3-service-resources-add-folder"></a>

객체를 폴더로 그룹화하여 S3 버킷 콘텐츠를 정리할 수 있습니다. 폴더 안에 폴더를 만들 수도 있습니다.

1. 도구 키트 탐색기에서 **S3** 서비스를 확장하여 S3 리소스를 확인하세요.

1. **Create Folder icon**(폴더 아이콘 만들기)을 선택하면 **폴더 만들기** 대화 상자가 나타납니다. 버킷 또는 폴더 컨텍스트 메뉴를 연 다음(마우스 우클릭) **폴더 만들기**를 선택합니다.

1. **Folder Name** 필드에 값을 입력하고 **Enter** 키를 누르면 폴더가 생성되고 대화 상자가 닫힙니다. 새 폴더는 도구 키트 메뉴의 해당 S3 리소스 아래에 표시됩니다.

## Amazon S3 버킷 삭제
<a name="s3-service-resources-bucket-delete"></a>

S3 버킷을 삭제하면 S3 버킷에 포함된 폴더와 객체도 삭제됩니다. S3 버킷을 삭제하려고 하면 삭제 의사를 묻는 메시지가 나타납니다.

1. 도구 키트 기본 메뉴에서 **Amazon S3** 서비스를 확장하여 S3 리소스 목록을 확인합니다.

1. 버킷 또는 폴더의 컨텍스트메뉴를 연 다음(마우스 우클릭) **S3 Bucket 삭제**를 선택합니다.

1. 메시지가 나타나면 텍스트 필드에 버킷 이름을 입력한 다음 **Enter** 키를 눌러 버킷을 삭제하고 확인 메시지를 닫으세요.
**참고**  
버킷에 객체가 포함된 경우 삭제되기 전에 객체가 비워집니다. 한 번에 많은 리소스 또는 객체를 삭제하면 삭제 시간이 조금 걸릴 수 있습니다. 삭제되면 성공적으로 삭제되었다는 알림이 표시됩니다.

# Amazon S3 객체 작업
<a name="s3-service-objects"></a>

S3 리소스 버킷에 저장된 파일, 폴더 및 기타 데이터를 S3 객체라고 합니다.

다음 섹션에서 AWS Toolkit for Visual Studio Code에서 Amazon S3 작업을 수행하는 방법을 설명합니다. 에서 Amazon S3 S3 리소스 작업에 대한 자세한 내용은이 사용 설명서의 [ S3 리소스 작업](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/s3-service.html) 주제를 AWS Toolkit for Visual Studio Code참조하세요.

## 객체 페이지 매기기
<a name="s3-service-objects-pagination"></a>

많은 Amazon S3 객체 및 폴더로 작업하는 경우 페이지 매김 기능을 통해 페이지에 표시할 항목 수를 지정할 수 있습니다.

1. VS Code **Activity Bar**로 이동하여 **Extensions**을 선택합니다.

1.  AWS 도구 키트 확장에서 설정 아이콘을 선택한 다음 **확장 설정을** 선택합니다.

1. **Settings** 페이지에서 **AWS > S3: Max Items Per Page** 설정으로 내려갑니다.

1. ‘추가 항목 로드’가 표시되기 전에, 기본값을 표시하려는 S3 항목 수로 변경합니다.
**참고**  
유효한 값은 3과 1,000 사이의 숫자입니다. 이 설정은 한 번에 표시되는 객체 또는 폴더 수에만 적용됩니다. 생성한 모든 버킷이 한 번에 표시됩니다. 기본적으로 AWS 계정 별로 최대 100개의 버킷을 만들 수 있습니다.

1. **Settings** 페이지를 닫고 변경 사항을 확인하세요.

또한 **Settings** 페이지 오른쪽 상단의 **Open Settings (JSON)** 아이콘을 선택하여 JSON 형식 파일의 설정을 업데이트할 수 있습니다.

## Amazon S3에서 객체 업로드 및 다운로드
<a name="s3-service-objects-upload-download"></a>

로컬에 저장된 파일을 Amazon S3 버킷에 업로드하거나 AWS Toolkit for Visual Studio Code에서 로컬 시스템으로 원격 Amazon S3 객체를 다운로드할 수 있습니다.

### 도구 키트를 사용하여 버킷에 파일 업로드
<a name="s3-service-objects-upload-toolkit"></a>

1. 도구 키트 탐색기에서 **Amazon S3** 서비스를 확장하면 S3 리소스 목록이 나타납니다.

1. 버킷 또는 폴더 옆에 있는 **파일 업로드 아이콘**을 선택하여 **파일 업로드 대화 상자**를 엽니다. 또는 컨텍스트 메뉴를 열고(마우스 오른쪽 버튼 클릭) **파일 업로드**를 선택합니다.
**참고**  
객체의 상위 폴더 또는 리소스에 파일을 업로드하려면 S3 객체의 컨텍스트 메뉴를 열고(마우스 오른쪽 버튼 클릭) **상위 폴더에 업로드**를 선택합니다.

1. 시스템의 파일 관리자를 통해 파일을 선택한 다음 **파일 업로드**를 선택하면 대화 상자가 닫히고 파일이 업로드됩니다.

### Command Palette로 파일 업로드
<a name="s3-service-objects-upload-commandpalette"></a>

도구 키트 인터페이스 또는 **Command Palette**를 사용하여 버킷에 파일을 업로드할 수 있습니다.

1. VS Code에서 해당 파일의 탭을 클릭하여 업로드할 파일을 선택합니다.

1. **Ctrl\$1Shift\$1P**를 누르면 **Command Palette**가 나타납니다.

1. **Command Palette** 해당 문구 `upload file`를 입력하면 권장 명령이 나타납니다.

1. **AWS: 파일 업로드**를 선택하여 **AWS: 파일 업로드** 대화 상자를 엽니다.

1. 메시지가 표시되면 업로드할 파일을 선택한 다음 파일을 업로드할 버킷을 선택합니다.

1. 대화 상자를 닫으면 업로드가 시작됩니다. 업로드가 완료되면 객체 크기, 최근 수정 날짜, 경로가 포함된 메타데이터와 함께 도구 키트 메뉴에 객체가 표시됩니다.

### Amazon S3 객체 다운로드
<a name="s3-service-objects-download"></a>

1. 도구 키트 탐색기에서 **S3** 서비스를 확장합니다.

1. 버킷 또는 폴더에서 다운로드하려는 객체의 컨텍스트 (마우스 오른쪽 버튼 클릭) 메뉴를 엽니다. 그런 다음 **Download As**(다른 이름으로 다운로드)를 선택하여 다른 이름으로 다운로드 대화 상자를 엽니다. 또는 개체 옆에 있는 **Download As**(다른 이름으로 다운로드) 아이콘을 선택해도 됩니다.

1. 시스템의 파일 관리자를 사용하여 대상 폴더를 선택하고 파일 이름을 입력한 다음 **다운로드**를 선택하면 대화 상자가 사라지고 다운로드를 시작합니다.

## 원격 객체 편집
<a name="s3-service-edit-objects"></a>

 AWS Toolkit for Visual Studio Code 를 사용하여 원격 Amazon S3 리소스에 저장된 Amazon S3 객체를 편집할 수 있습니다.

1. 도구 키트 탐색기를 확장하면 **S3** 서비스가 나타납니다.

1. 편집할 파일이 포함된 S3 리소스를 확장합니다.

1. **연필 아이콘 (파일 편집)** 을 선택하여 파일을 편집합니다.

1. 읽기 전용 모드로 연 파일을 편집하려면 VS Code 편집기에서 파일을 확인한 다음 UI의 오른쪽 상단에 있는 **연필 아이콘**을 선택합니다.

**참고**  
VS Code를 다시 시작하거나 종료하면 IDE와 S3 리소스 연결이 끊깁니다. 원격 S3 파일 편집 중에 연결이 끊기면 편집이 중단됩니다. VS Code를 다시 시작하여 편집 탭을 열어 편집을 계속할 수 있습니다.
**파일 편집** 버튼은 UI의 오른쪽 상단에 있습니다. 해당 버튼은 VS Code 편집기에서 읽기 전용 파일을 보고 있는 경우에만 표시됩니다.
텍스트가 아닌 파일은 읽기 전용 모드에서 열리지 않습니다. 파일은 편집 모드에서만 열립니다.
편집 전용 모드에서 읽기 전용 모드로 전환할 수는 없으며 반대로는 가능합니다.

## Amazon S3 객체의 경로 복사
<a name="copy-path"></a>

다음은 AWS Toolkit for Visual Studio Code에서 Amazon S3 객체의 경로를 복사하는 방법을 설명합니다.

1. 도구 키트를 확장하면 **S3** 서비스가 나타납니다.

1. 경로 복사하려는 객체가 포함된 리소스 버킷을 확장합니다.

1. 경로를 복사하려는 객체의 컨텍스트 메뉴 (마우스 오른쪽 버튼 클릭)를 연 다음, **경로 복사**를 선택하여 객체 경로를 로컬 클립보드에 복사합니다.

## 미리 서명된 Amazon S3 객체 URL 생성
<a name="presigned-s3-object"></a>

미리 서명된 URL에 다운로드 시간 제한을 부여하여 비공개 Amazon S3 객체를 다른 사용자와 공유할 수 있습니다. 자세한 내용은 [Sharing an object with a presigned URL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html)(미리 서명된 URL로 객체 공유)을 참조하세요.

1. 도구 키트를 확장하면 **S3** 서비스가 나타납니다.

1. 버킷 또는 폴더에서 공유하려는 객체의 컨텍스트 (마우스 오른쪽 버튼 클릭) 메뉴를 엽니다. 그런 다음 **Generate Presigned URL**(미리 서명된 URL 만들기)을 선택하여 **Command palette**를 엽니다.

1. **Command Palette**에서 URL을 통해 객체에 액세스할 수 있는 시간(분)을 입력합니다. 그런 다음 **Enter**를 선택하고 대화 상자를 닫습니다.

1. 미리 서명된 URL이 생성되면 VS 코드 **상태 표시줄**에 로컬 **클립보드**에 복사된 개체의 미리 서명된 URL이 표시됩니다.

## Amazon S3 객체 삭제
<a name="s3-service-delete-object"></a>

버전 관리 대상이 아닌 버킷에 있는 객체를 영구적으로 삭제할 수 있습니다. 하지만 버전 관리를 사용하는 버킷에서 객체를 삭제해도 영구 삭제되지 않습니다. 대신 Amazon S3에서 버킷에 삭제 마커를 삽입하세요. 자세한 내용은 [Deleting object versions](https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html)(객체 버전 삭제)를 참조하세요.

1. 도구 키트 탐색기에서 **S3** 서비스를 확장하여 S3 리소스 목록을 확인합니다.

1. 삭제하려는 객체의 컨텍스트 메뉴 (마우스 오른쪽 버튼 클릭) 를 연 다음, **Delete**를 선택하면 확인 대화 상자가 나타납니다.

1. **Delete. . .**를 선택하면 삭제하려는 S3 객체가 삭제됩니다. 삭제되면 대화 상자를 닫습니다.