지원 종료 공지: 2025년 11월 13일에 AWS 는 AWS Elemental MediaStore에 대한 지원을 중단합니다. 2025년 11월 13일 이후에는 더 이상 MediaStore 콘솔 또는 MediaStore 리소스에 액세스할 수 없습니다. 자세한 내용은 이 [블로그 게시물](https://aws.amazon.com/blogs/media/support-for-aws-elemental-mediastore-ending-soon/)을 참조하세요.

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

# 객체 업로드
<a name="objects-upload"></a>

객체를 컨테이너 또는 컨테이너의 폴더로 업로드할 수 있습니다. 폴더에 객체를 업로드하려면 폴더 경로를 지정합니다. 폴더가 이미 있을 경우 AWS Elemental MediaStore는 폴더에 객체를 저장합니다. 폴더가 없으면 폴더를 만든 후 그 폴더에 객체를 저장합니다. 폴더에 대한 자세한 내용은 [AWS Elemental MediaStore의 폴더](folders.md) 섹션을 참조하세요.

MediaStore 콘솔 또는를 사용하여 객체를 업로드 AWS CLI 할 수 있습니다.

MediaStore는 객체의 청크 분할 전송을 지원합니다. 이 기능은 객체를 업로드하는 동안에도 다운로드가 가능하게 만들어 지연 시간을 단축합니다. 이 기능을 사용하려면 객체의 업로드 가용성을 `streaming`으로 설정합니다. [API를 사용하여 객체를 업로드](https://docs.aws.amazon.com/mediastore/latest/apireference/API_objstore_PutObject.html)할 때 이 헤더의 값을 설정할 수 있습니다. 요청에서 이 헤더를 지정하지 않으면 MediaStore가 객체 업로드 가용성으로 기본값 `standard`을 지정합니다.

표준 업로드 가용성에서는 객체 크기가 25MB를 초과할 수 없고 스트리밍 업로드 가용성은 10MB입니다.

**참고**  
객체 파일 이름에는 문자, 숫자, 마침표(.), 밑줄(\_), 물결 기호(\~), 하이픈(-), 등호(=), 콜론(:)만 사용할 수 있습니다.

**객체를 업로드하려면(콘솔)**

1. [https://console.aws.amazon.com/mediastore/](https://console.aws.amazon.com/mediastore/)에서 MediaStore 콘솔을 엽니다.

1. **컨테이너** 페이지에서 컨테이너 이름을 선택합니다. 컨테이너의 세부 정보 창이 나타납니다.

1. **객체 업로드**를 선택합니다.

1. **대상 경로**에 폴더 경로를 입력합니다. 예를 들어 `premium/canada`입니다. 지정한 경로에 폴더가 존재하지 않으면 해당 폴더가 자동으로 생성됩니다.

1. **객체** 섹션에서 **찾아보기**를 선택합니다.

1. 해당 폴더로 이동한 후 업로드할 객체를 하나 선택합니다.

1. **열기**를 선택한 후 **업로드**를 선택합니다.
**참고**  
이름이 같은 파일이 해당 폴더에 이미 있으면, 업로드된 파일이 원래 파일을 겹쳐 씁니다.

**객체를 업로드하려면(AWS CLI)**
+ 에서 `put-object` 명령을 AWS CLI사용합니다. 다음과 같은 파라미터를 포함시킬 수 있습니다. `content-type`, `cache-control`(호출자가 객체의 캐시 동작을 제어하도록 허용), `path`(컨테이너 내에 있는 폴더의 객체 저장).
**참고**  
객체를 업로드한 후에는 `content-type`, `cache-control` 또는 `path`를 변경할 수 없습니다.

  ```
  aws mediastore-data put-object --endpoint {{https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com}} --body {{README.md}} --path {{/folder_name/README.md}} --cache-control "{{max-age=6, public}}" --content-type {{binary/octet-stream}} --region {{us-west-2}}
  ```

  다음 예제는 반환 값을 보여줍니다.

  ```
  {
      "ContentSHA256": "74b5fdb517f423ed750ef214c44adfe2be36e37d861eafe9c842cbe1bf387a9d",
      "StorageClass": "TEMPORAL",
      "ETag": "af3e4731af032167a106015d1f2fe934e68b32ed1aa297a9e325f5c64979277b"
  }
  ```