AWS S3
AWS S3 버킷과 객체를 관리하는 노드입니다. 파일 업로드, 다운로드, 삭제, 목록 조회 등 S3의 핵심 기능을 워크플로우에서 사용할 수 있습니다.
주요 기능
Bucket (버킷)
Operation | 설명 |
|---|---|
List | 모든 S3 버킷 목록 조회 |
Object (객체)
Operation | 설명 |
|---|---|
Upload | 파일 업로드 |
Download | 파일 다운로드 |
Delete | 파일 삭제 |
List | 버킷 내 객체 목록 조회 |
설정 항목
공통 (Object 리소스)
항목 | 타입 | 설명 |
|---|---|---|
Resource | options | 리소스 유형 (Bucket / Object) |
Bucket Name | string | S3 버킷 이름 (필수) |
Object Key | string | 객체 키 (파일 경로, Upload/Download/Delete 시 필수) |
Upload (업로드)
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Binary Property | string |
| 업로드할 바이너리 데이터 속성 이름 |
업로드 옵션
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
ACL | options |
| 접근 권한 설정 |
Content Type | string | 자동 감지 | MIME 타입 (비어있으면 자동 감지) |
Cache Control | string | - | 캐시 제어 헤더 (예: |
ACL 옵션
값 | 설명 |
|---|---|
| 소유자만 읽기/쓰기 |
| 누구나 읽기 가능 |
| 누구나 읽기/쓰기 (비권장) |
| AWS 인증 사용자만 읽기 |
| 버킷/객체 소유자만 읽기 |
| 버킷 소유자 전체 제어 |
Download (다운로드)
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Binary Property | string |
| 다운로드 데이터를 저장할 속성 이름 |
List (객체 목록)
항목 | 타입 | 기본값 | 설명 |
|---|---|---|---|
Prefix | string | - | 특정 접두사로 시작하는 객체만 조회 |
Max Keys | number |
| 최대 반환 객체 수 (1~1000) |
출력 데이터
Upload 결과
필드 | 설명 |
|---|---|
| 성공 여부 |
| 버킷 이름 |
| 객체 키 |
| 업로드된 파일의 S3 URL |
| 파일 크기 (bytes) |
| 적용된 ACL |
| MIME 타입 |
List 결과
각 객체에 url 필드가 자동으로 추가됩니다.
인증 정보
AWS Access Key ID, Secret Access Key, Region이 필요합니다. 자세한 설정 방법은 AWS S3 API 인증 설정 가이드를 참고하세요.
사용 예시
생성된 이미지/비디오 업로드
NanoBanana 또는 RenderVideo 노드에서 미디어를 생성합니다.
AWS S3 노드에서 Object > Upload를 선택합니다.
Bucket Name과 Object Key를 설정합니다.
ACL을
public-read로 설정하면 외부에서 URL로 접근 가능합니다.
파일 정리 워크플로우
AWS S3에서 Object > List로 특정 Prefix의 파일 목록을 조회합니다.
조건 노드로 오래된 파일을 필터링합니다.
Object > Delete로 불필요한 파일을 삭제합니다.
참고 사항
AWS Signature V4 인증을 내부적으로 처리합니다.
업로드 완료 후 입력 데이터의 바이너리가 자동으로 메모리에서 해제되어 대용량 파일 처리 시 메모리 효율이 좋습니다.
Object Key에
/를 사용하여 폴더 구조를 표현할 수 있습니다 (예:images/2024/photo.jpg).S3 호환 스토리지(MinIO, DigitalOcean Spaces 등)에서도 사용할 수 있습니다 (엔드포인트 설정은 인증 정보에서 변경).