适用于Amazon S3兼容云存储的Minio JavaScript Library

Minio JavaScript Client SDK提供简单的API来访问任何Amazon S3兼容的对象存储服务。

本快速入门指南将向您展示如何安装客户端SDK并执行示例JavaScript程序。有关API和示例的完整列表，请参阅JavaScript客户端API参考文档。

本文假设你已经安装了nodejs 。

使用NPM下载

npm install --save minio

下载并安装源码

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

初使化Minio Client

你需要设置5个属性来链接Minio对象存储服务。

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

示例-文件上传

本示例连接到一个对象存储服务，创建一个存储桶并上传一个文件到存储桶中。

我们在本示例中使用运行在 https://play.minio.io:9000 上的Minio服务，你可以用这个服务来开发和测试。示例中的访问凭据是公开的。

file-uploader.js

var Minio = require('minio')
// Instantiate the minio client with the endpoint
// and access keys as shown below.
var minioClient = new Minio.Client({
    endPoint: 'play.minio.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.
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.
    minioClient.fPutObject('europetrip', 'photos-europe.tar', file, metaData, function(err, etag) {
      if (err) return console.log(err)
      console.log('File uploaded successfully.')
    });
});

运行file-uploader

node file-uploader.js
Bucket created successfully in "us-east-1".
mc ls play/europetrip/
[2016-05-25 23:49:50 PDT]  17MiB photos-europe.tar

API文档

完整的API文档在这里。

• 完整API文档

  API文档 : 操作存储桶

• makeBucket

• listBuckets
• bucketExists
• removeBucket
• listObjects
• listObjectsV2

• listIncompleteUploads

  API文档 : 操作文件对象

• fPutObject

• fGetObject

  API文档 : 操作对象

• getObject

• putObject
• copyObject
• statObject
• removeObject

• removeIncompleteUpload

  API文档 : Presigned操作

• presignedGetObject

• presignedPutObject

• presignedPostPolicy

  API文档 : 存储桶通知

• getBucketNotification

• setBucketNotification
• removeAllBucketNotification

• listenBucketNotification (Minio Extension)

  API文档 : 存储桶策略

• getBucketPolicy

• setBucketPolicy

  完整示例

完整示例 : 操作存储桶

• list-buckets.js
• list-objects.js
• list-objects-v2.js
• bucket-exists.js
• make-bucket.js
• remove-bucket.js

• list-incomplete-uploads.js

  完整示例 : 操作文件对象

• fput-object.js

• fget-object.js

  完整示例 : 操作对象

• put-object.js

• get-object.js
• copy-object.js
• get-partialobject.js
• remove-object.js
• remove-incomplete-upload.js

• stat-object.js

  完整示例 : Presigned操作

• presigned-getobject.js

• presigned-putobject.js

• presigned-postpolicy.js

  完整示例 : 存储桶通知

• get-bucket-notification.js

• set-bucket-notification.js
• remove-all-bucket-notification.js

• listen-bucket-notification.js (Minio Extension)

  完整示例 : 存储桶策略

• get-bucket-policy.js

• set-bucket-policy.js

  了解更多

• 完整文档

• Minio JavaScript Client SDK API文档
• 创建属于你的购物APP-完整示例

  贡献

贡献者指南

原文: https://docs.minio.io/cn/javascript-client-quickstart-guide.html