MinIO - 30. Amazon S3 호환 클라우드 스토리지용 MinIO JavaScript 라이브러리

MinIO JavaScript Library for Amazon S3 Compatible Cloud Storage

Amazon S3 호환 클라우드 스토리지용 MinIO JavaScript 라이브러리

The MinIO JavaScript Client SDK provides simple APIs to access any Amazon S3 compatible object storage server.

MinIO JavaScript 클라이언트 SDK는 Amazon S3 호환 객체 스토리지 서버에 액세스할 수 있는 간단한 API를 제공합니다.

This quickstart guide will show you how to install the client SDK and execute an example JavaScript program.

이 빠른 시작 가이드에서는 클라이언트 SDK를 설치하고 예제 JavaScript 프로그램을 실행하는 방법을 보여줍니다.

For a complete list of APIs and examples, please take a look at the JavaScript Client API Reference documentation.

API 및 예제의 전체 목록을 보려면 JavaScript 클라이언트 API 참조 문서를 살펴보세요.

This document assumes that you have a working nodejs setup in place.

이 문서에서는 작동 중인 nodejs 설정이 있다고 가정합니다.

Download from NPM

NPM에서 다운로드

npm install --save minio

Download from Source

소스에서 다운로드

git clone https://github.com/minio/minio-js
cd minio-js
npm install
npm install -g

Using with TypeScript

TypeScript와 함께 사용

npm install --save-dev @types/minio

Initialize MinIO Client

MinIO 클라이언트를 초기화

You need five items in order to connect to MinIO object storage server.

MinIO 객체 스토리지 서버에 연결하려면 5가지 항목이 필요합니다.

Params

매개변수

Description

설명

endPoint

URL to object storage service.

객체 스토리지 서비스의 URL입니다.

port

TCP/IP port number. This input is optional. Default value set to 80 for HTTP and 443 for HTTPs.

TCP/IP 포트 번호. 이 입력은 선택 사항입니다. 기본값은 HTTP의 경우 80, HTTP의 경우 443으로 설정됩니다.

accessKey

Access key is like user ID that uniquely identifies your account.

액세스 키는 귀하의 계정을 고유하게 식별하는 사용자 ID와 같습니다.

secretKey

Secret key is the password to your account.

비밀 키는 귀하의 계정에 대한 비밀번호입니다.

useSSL

Set this value to 'true' to enable secure (HTTPS) access

보안 (HTTPS) 액세스를 활성화하려면 이 값을 'true'로 설정하세요.

var Minio = require('minio')

var minioClient = new Minio.Client({
    endPoint: 'play.min.io',
    port: 9000,
    useSSL: true,
    accessKey: 'Q3AM3UQ867SPQQA43P2F',
    secretKey: 'zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG'
});

Quick Start Example - File Uploader

빠른 시작 예 - 파일 업로더

This example program connects to an object storage server, makes a bucket on the server and then uploads a file to the bucket.

이 예제 프로그램은 객체 스토리지 서버에 연결하여 서버에 버킷을 만든 후 해당 버킷에 파일을 업로드합니다.

We will use the MinIO server running at https://play.min.io in this example. Feel free to use this service for testing and development. Access credentials shown in this example are open to the public.

이 예제에서는 https://play.min.io에서 실행되는 MinIO 서버를 사용합니다. 테스트 및 개발을 위해 이 서비스를 자유롭게 사용해 보세요. 이 예에 표시된 액세스 자격 증명은 대중에게 공개됩니다.

file-uploader.js

var Minio = require('minio')

// Instantiate the minio client with the endpoint // and access keys as shown below.

// 아래와 같이 엔드포인트와 액세스 키를 사용하여 // minio 클라이언트를 인스턴스화합니다.

var minioClient = new Minio.Client({
    endPoint: 'play.min.io',
    port: 9000,
    useSSL: true,
    accessKey: 'Q3AM3UQ867SPQQA43P2F',
    secretKey: 'zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG'
});

// File that needs to be uploaded.

// 업로드가 필요한 파일입니다.

var file = '/tmp/photos-europe.tar'

// Make a bucket called europetrip.

// europetrip이라는 버킷을 만듭니다.

minioClient.makeBucket('europetrip', 'us-east-1', function(err) {
    if (err) return console.log(err)

    console.log('Bucket created successfully in "us-east-1".')

    var metaData = {
        'Content-Type': 'application/octet-stream',
        'X-Amz-Meta-Testing': 1234,
        'example': 5678
    }

// Using fPutObject API upload your file to the bucket europetrip.

// fPutObject API를 사용하여 파일을 버킷 europetrip에 업로드합니다.

minioClient.fPutObject('europetrip', 'photos-europe.tar', file, metaData, function(err, etag) {
      if (err) return console.log(err)
      console.log('File uploaded successfully.')
    });
});

Run file-uploader

파일 업로더 실행

node file-uploader.js

Bucket created successfully in "us-east-1".

"us-east-1"에 버킷이 성공적으로 생성되었습니다.

mc ls play/europetrip/
[2016-05-25 23:49:50 PDT]  17MiB photos-europe.tar

API Reference

API 참조

The full API Reference is available here.

전체 API 참조는 여기에서 확인할 수 있습니다.

Complete API Reference

완전한 API 참조

API Reference : Bucket Operations

API 참조: 버킷 작업

makeBucket
listBuckets
bucketExists
removeBucket
listObjects
listObjectsV2
listIncompleteUploads

API Reference : File Object Operations

API 참조: 파일 객체 작업

fPutObject
fGetObject

API Reference : Object Operations

API 참조: 객체 작업

getObject
putObject
copyObject
statObject
removeObject
removeObjects
removeIncompleteUpload

API Reference : Presigned Operations

API 참조: 사전 서명된 작업

presignedGetObject
presignedPutObject
presignedPostPolicy

API Reference : Bucket Notification Operations

API 참조: 버킷 알림 작업

getBucketNotification
setBucketNotification
removeAllBucketNotification
listenBucketNotification (MinIO Extension)

API Reference : Bucket Policy Operations

API 참조: 버킷 정책 작업

getBucketPolicy
setBucketPolicy

Full Examples

전체 예

Full Examples : Bucket Operations

전체 예: 버킷 작업

list-buckets.js
list-objects.js
list-objects-v2.js
bucket-exists.js
make-bucket.js
remove-bucket.js
list-incomplete-uploads.js

Full Examples : File Object Operations

전체 예: 파일 객체 작업

fput-object.js
fget-object.js

Full Examples : Object Operations

전체 예: 객체 작업

put-object.js
get-object.js
copy-object.js
get-partialobject.js
remove-object.js
remove-incomplete-upload.js
stat-object.js

Full Examples : Presigned Operations

전체 예: 사전 서명된 작업

presigned-getobject.js
presigned-putobject.js
presigned-postpolicy.js

Full Examples: Bucket Notification Operations

전체 예: 버킷 알림 작업

get-bucket-notification.js
set-bucket-notification.js
remove-all-bucket-notification.js
listen-bucket-notification.js (MinIO Extension)

Full Examples: Bucket Policy Operations

전체 예: 버킷 정책 작업

get-bucket-policy.js
set-bucket-policy.js

Explore Further

더 자세히 살펴보세요

Complete Documentation

완전한 문서

MinIO JavaScript Client SDK API Reference

MinIO JavaScript 클라이언트 SDK API 참조

Build your own Shopping App Example- Full Application Example

나만의 쇼핑 앱 예시 구축 - 전체 애플리케이션 예시

Contribute

기여

Contributors Guide

기여자 가이드