새로운Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2변경 내역 보기 →

스토리지

이미지 작업이 완료된 파일 저장.

데이터와 동일한 SDK에서 버킷, 업로드, 서명된 링크 및 즉각적인 이미지 변환이 가능합니다.

4
이미지 출력 형식
2,500 px
최대 변환 크기
storage.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
await aura.storage.createBucket('avatars', {
public: true,
fileSizeLimit: 5 * 1024 * 1024,
allowedMimeTypes: ['image/png', 'image/jpeg'],
})

포함된 내용

파일에 필요한 모든 것. 업로드부터 썸네일까지.

조직

규칙이 있는 버킷

각 버킷에 크기 제한과 허용되는 파일 형식을 설정합니다.

업로드

단순 업로드

원할 때 덮어쓰기하여 한 번의 통화로 파일을 보내세요.

다운로드

Blob 또는 스트림

파일을 Blob으로 다운로드하거나 스트림으로 읽습니다.

공유

서명된 URL

선택한 시간 이후에 만료되는 링크가 포함된 비공개 파일을 공유하세요.

공개 버킷

그렇게 말하면 공개적으로

공개 버킷의 파일은 API 키 없이 누구에게나 제공됩니다. 비공개 버킷에 비공개 파일을 보관하세요.

이미지

즉각적인 이미지 변환

URL 옵션을 사용하여 이미지 크기를 조정하고 자르고 이미지를 JPEG, PNG, WebP 또는 GIF로 변환하세요. 결과는 서버에 캐시됩니다.

파일

복사, 이동 및 나열

버킷 내에서 파일을 복사하거나 이동하고, 접두사로 나열하고, 메타데이터를 읽습니다.

안전

삭제 전 휴지통

파일을 삭제하면 해당 파일이 휴지통으로 이동됩니다. 영구 삭제에는 서비스 역할이 필요합니다.

서버 측

서버에서 서명된 업로드

클라이언트가 키를 보유하지 않고도 업로드할 수 있도록 서비스 역할로 서명된 업로드 URL을 생성하세요.

작동 원리

파일에서 링크로.

  1. 1

    버킷 만들기

    공개 또는 비공개, 크기 제한 및 허용되는 유형을 선택합니다.

  2. 2

    업로드

    파일을 보내십시오. 서버는 해당 키를 반환합니다.

  3. 3

    공유

    공개 URL 또는 만료되는 서명된 URL을 사용하세요.

  4. 4

    변환

    파생된 이미지를 얻으려면 URL에 너비, 높이 또는 형식을 추가하세요.

REST API

일반 HTTP를 선호하시나요? 모든 것이 여기에 있습니다.

SDK는 이러한 경로에 대한 얇은 계층입니다. 각 요청과 함께 프로젝트의 API 키를 보냅니다.

방법엔드포인트설명
GET/v1/storage/buckets버킷을 나열합니다.
POST/v1/storage/buckets버킷을 생성합니다.
PATCH/v1/storage/buckets/{id}버킷 설정을 업데이트합니다.
DELETE/v1/storage/buckets/{id}버킷을 삭제합니다.
POST/v1/storage/{bucket}다중 부분 양식 데이터가 포함된 파일을 업로드합니다.
GET/v1/storage/{bucket}/{key}선택적으로 변환된 파일을 다운로드합니다.
DELETE/v1/storage/{bucket}/{key}파일을 삭제합니다.
GET/v1/storage/{bucket}/meta/{key}파일의 메타데이터를 읽습니다.
POST/v1/storage/{bucket}/copy버킷 내부에 파일을 복사합니다.
POST/v1/storage/{bucket}/move버킷 내부로 파일을 이동합니다.
GET/v1/storage/{bucket}/signed-url시간 제한이 있는 다운로드 URL을 만듭니다.
GET/v1/storage/{bucket}/upload-url서명된 업로드 URL을 만듭니다. 서비스 역할에 예약되어 있습니다.

질문

알아두면 좋아요.

공개 버킷은 정말 공개인가요?+
그렇습니다. URL이 있는 사람은 누구나 API 키 없이 해당 파일을 다운로드할 수 있습니다. 공개 인터넷에 넣을 것만 공용 버킷에 넣으세요.
잠시 동안 비공개 파일을 공유하려면 어떻게 해야 하나요?+
createSignedUrl() 및 수명(초)을 사용하여 서명된 URL을 만듭니다. 링크가 만료되면 작동이 중지됩니다.
이미지 변환의 크기는 얼마나 됩니까?+
너비와 높이는 2,500px로 제한됩니다. 품질 설정은 JPEG에만 적용됩니다.
파일을 다른 버킷에 복사할 수 있나요?+
아직 아님. 단일 버킷 내에서 작업을 복사하고 이동합니다.
재개 가능한 업로드가 지원됩니까?+
아니요. 각 업로드는 단일 멀티파트 요청이므로 하나의 요청에 맞는 파일을 계획하세요.
이미지 변환을 끌 수 있나요?+
그렇습니다. 변환은 기본적으로 켜져 있으며 프로젝트에서 이를 비활성화할 수 있습니다. 그러면 변환이 포함된 요청이 거부됩니다.

파일을 저장할 준비가 되셨나요?

지금 바로 파일을 집으로 가져가세요.

모든 프로젝트에는 스토리지가 포함되어 있습니다. 신용 카드가 필요하지 않습니다.