Skip to main content

AWS S3

쿼리 추가​

페이지 목록에서 워크플로우를 추가하여 쿼리 스텝을 추가할 수 있습니다.
워크플로우 스텝 사이드바에서 AWS S3 데이터 소스를 선택하면 쿼리 입력 창이 나타납니다.
데이터 소스 추가 방법은 AWS S3 데이터 소스 가이드를 참고해주세요.

aws-s3

액션​

ListObjects​

버킷 내의 객체 목록을 조회합니다. 자세한 내용은 AWS S3 공식 문서를 참고해주세요.

list-objects

파라미터​

이름타입설명
Bucket (bucket)string객체 목록을 조회할 버킷 이름
Start After (startAfter)string조회할 객체 목록의 시작 위치
Prefix (prefix)string특정 파일 이름으로 시작하는 객체 목록을 조회하기 위한 접두사
Max Keys (maxKeys)string최대 조회할 객체 수

쿼리 결과값​

서명된 URL 생성 액션을 실행하면 결과값이 아래와 같은 구조로 반환됩니다.

interface Content {
  ChecksumAlgorithm: string | null;
  ETag: string;
  Key: string;
  LastModified: string;
  Size: number;
  StorageClass: string;
}

interface Result {
  Contents: Content[];
  ContinuationToken: string | null;
  KeyCount: number;
  MaxKeys: number;
  Name: string;
  StartAfter: string | null;
}

결과값 활용하기​

다른 스텝에서 결과값을 활용하려면 아래와 같이 작성합니다.

return outputs.스텝명.Contents.map((content) => content.Key);

GetObject​

특정 객체의 내용을 조회합니다. 자세한 내용은 AWS S3 공식 문서를 참고해주세요.

get-object

파라미터​

이름타입설명
Bucket (bucket)string객체 목록을 조회할 버킷 이름
Key (key)string조회할 객체 키

쿼리 결과값​

interface Result {
  Body: string;
}

결과값 활용하기​

다른 스텝에서 결과값을 활용하려면 아래와 같이 작성합니다.

return outputs.스텝명.Body;

URL 생성​

객체에 대한 접근 가능한 URL을 생성합니다.

get-url

파라미터​

이름타입설명
Bucket (bucket)string객체 목록을 조회할 버킷 이름
Key (key)string조회할 객체 키

쿼리 결과값​

interface Result {
  Url: string;
}

결과값 활용하기​

다른 스텝에서 결과값을 활용하려면 아래와 같이 작성합니다.

return outputs.스텝명.Url;

PresignGetObject​

객체 다운로드를 위한 서명된 URL을 생성합니다. 자세한 내용은 AWS S3 공식 문서를 참고해주세요.

presign-get-object

쿼리 결과값​

interface Result {
  Url: string;
}

결과값 활용하기​

다른 스텝에서 결과값을 활용하려면 아래와 같이 작성합니다.

return outputs.스텝명.Url;

파라미터​

이름타입설명
Bucket (bucket)string객체 목록을 조회할 버킷 이름
Key (key)string조회할 객체 키
유효 시간 (expiresIn)number유효 시간(초)

PresignPutObject​

객체 업로드를 위한 서명된 URL을 생성합니다. 자세한 내용은 AWS S3 공식 문서를 참고해주세요.

presign-put-object

파라미터​

이름타입설명
Bucket (bucket)string객체 목록을 조회할 버킷 이름
Key (key)string조회할 객체 키
유효 시간 (expiresIn)number유효 시간(초)

쿼리 결과값​

interface Result {
  Url: string;
}

결과값 활용하기​

다른 스텝에서 결과값을 활용하려면 아래와 같이 작성합니다.

return outputs.스텝명.Url;

PutObject​

새로운 객체를 S3에 업로드합니다. 자세한 내용은 AWS S3 공식 문서를 참고해주세요.

put-object

이름타입설명
Bucket (bucket)string객체 목록을 조회할 버킷 이름
Key (key)string조회할 객체 키
Body (body)string업로드할 객체 내용
Acl (acl)string객체 접근 제어 권한
Content MD5 (contentMd5)string객체 내용의 MD5 해시값

쿼리 결과값​

type Result = Record<string, never>;

putObject는 빈 object를 반환합니다.

DeleteObject​

S3에서 객체를 삭제합니다. 자세한 내용은 AWS S3 공식 문서를 참고해주세요.

delete-object

파라미터​

이름타입설명
Bucket (bucket)string객체 목록을 조회할 버킷 이름
Key (key)string조회할 객체 키
Version ID (versionId)string삭제할 객체 버전 ID

쿼리 결과값​

type Result = Record<string, never>;

deleteObject는 빈 object를 반환합니다.