본 문서에서는 AWS S3 Stroage Connector와 Object Parameter 블록에 대해 설명합니다.
Index
AWS S3 Storage 연결 블록
1) Create
•
Storage를 사용하기 위한 변수를 선언하는 블록입니다.
2) Set to
•
변수에 AWS S3 Storage를 할당합니다.
3) AWS S3 Connector
•
드롭다운 목록에서 AWS S3 Storage를 선택하여 연결합니다.
4) AWS S3 Get Object
•
AWS S3 Storage에서 Data를 가져옵니다.
Parameter | 설명 |
connector | AWS S3 Storage Connector |
key | Bucket에서 조회할 Data의 key |
bucket | Data를 조회할 Bucket을 지정합니다.
기본값(null)일 경우 Storage에서 등록한 AWS S3 Storage의 bucket에서 Data를 조회합니다. |
saveAs | 기본값(null)일 경우 결과를 반환할 뿐 저장은 하지 않습니다.
file 블록을 연결하면 가져온 Data를 로컬 영역의 해당 경로에 file로 저장합니다.
file 블록은 솔루션 공급 방식에 따라 제한적으로 제공됩니다. |
5) AWS S3 Put Object
•
AWS S3 Storage에서 Data를 업로드합니다.
Parameter | 설명 |
connector | AWS S3 Storage Connector |
key | Bucket에서 업로드할 Data의 key |
data | 업로드할 Data로, string / string에 해당하는 변수 / file 블록을 사용할 수 있습니다.
file 블록은 솔루션 공급 방식에 따라 제한적으로 제공됩니다. |
bucket | Data를 업로드할 Bucket을 지정합니다.
기본값(null)일 경우 Storage에서 등록한 AWS S3 Storage의 bucket에서 Data를 조회합니다. |
params | S3 Object Parameter 블록을 붙여 파일에 대한 추가 정보를 설정할 수 있습니다. |
6) AWS S3 Delete Object
•
AWS S3 Storage에서 Data를 삭제합니다.
Parameter | 설명 |
connector | AWS S3 Storage Connector |
key | Bucket에서 삭제할 Data의 key |
bucket | Data를 삭제할 Bucket을 지정합니다.
기본값(null)일 경우 Storage에서 등록한 AWS S3 Storage의 bucket에서 Data를 조회합니다. |
7) AWS S3 List Objects
•
AWS S3 Storage에서 지정된 Bucket의 Data List를 가져옵니다.
Parameter | 설명 |
connector | AWS S3 Storage Connector |
bucket | Data List를 조회할 Bucket을 지정합니다.
기본값(null)일 경우 Storage에서 등록한 AWS S3 Storage의 Bucket에서 Data를 조회합니다. |
max-keys | 1회 요청에 포함할 key의 개수로 pagination 처리에 사용합니다.
기본값 및 최대값은 1000으로 Bucket의 key 개수가 max keys를 초과할 경우, Continutaion Token이 요청 결과에 추가됩니다. |
continuation-token | 기본값은 null로, 가져올 수 있는 키의 갯수가 max-keys를 초과하는 경우, 응답에 Continuation Token이 포함됩니다.
다음 요청시 발급된 Continutaion Token을 대입하여 다음 페이지의 key 목록을 가져옵니다. |
params | S3 Object Parameter 블록을 붙여 파일에 대한 추가 정보를 설정할 수 있습니다. |
AWS S3 Object Parameters
•
S3 Object Parameter 블록을 붙여 파일에 대한 추가 정보를 설정할 수 있습니다.
1) Content Encoding
•
•
디렉티브 기본값은 identity로 인코딩 없이 원본 그대로인 파일임을 의미합니다.
•
선택 목록 이외에, String 블록으로 디렉티브를 명시적으로 지정할 수 있습니다. (ex: base64)
2) Content Type
•
•
Content-Type 블럭으로 MIME-Type을 선택하거나 string 블럭으로 MIME-Type을 명시적으로 지정할 수 있습니다.
•
Content-Type을 지정하지 않고 파일명의 확장자가 알려져 있지 않는 확장자인 경우, 기본값은 application/octet-stream으로 지정됩니다.
Mime-Type 선택 (드롭다운 목록)
String 블록으로 Mime-Type 명시적으로 지정
3) Meta Data
•
전송할 파일에 Key-Value 형태의 meta data를 저장합니다.
4) Storage Class
•
•
지정하지 않은 경우, 기본값은 Standard입니다.
AWS S3 블록 사용 예제
1) Put Object Block Set
•
string data를 Object로 업로드
•
file 블록을 사용하여 로컬(user-storage 하위 폴더) 파일을 업로드
file 블록은 솔루션 공급 방식에 따라 제한적으로 제공됩니다.•
별도의 Bucket을 지정하여 업로드
connector에 정의된 버킷 대신 다른 버킷으로 로컬 파일을 업로드합니다.
•
meta data를 포함하여 업로드
Meta Data 블록에 의해 S3 Key에 meta data가 추가됐습니다.
2) Get Objcect Block Set
•
요청 결과를 변수에 저장하기
saveAs 가 null인 경우, data가 body에 포함되어 있습니다.
•
요청 결과를 로컬(user-storage 하위 폴더) 파일로 저장하기
saveAs 에 file 블록으로 저장 경로를 지정하여 data가 로컬 파일로 저장되었으므로, 결과에 body 필드가 존재하지 않습니다.