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

NPM

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

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

本文假设你已经安装了nodejs

使用NPM下载

  1. npm install --save minio

下载并安装源码

  1. git clone https://github.com/minio/minio-js
  2. cd minio-js
  3. npm install
  4. npm install -g

初使化Minio Client

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

参数描述
endPoint对象存储服务的URL
portTCP/IP端口号。可选值,如果是使用HTTP的话,默认值是80;如果使用HTTPS的话,默认值是443
accessKeyAccess key是唯一标识你的账户的用户ID。
secretKeySecret key是你账户的密码。
useSSLtrue代表使用HTTPS
  1. varMinio=require('minio')
  2. var minioClient =newMinio.Client({
  3. endPoint:'play.minio.io',
  4. port:9000,
  5. useSSL:true,
  6. accessKey:'Q3AM3UQ867SPQQA43P2F',
  7. secretKey:'zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG'
  8. });

示例-文件上传

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

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

file-uploader.js

  1. varMinio=require('minio')
  2. // Instantiate the minio client with the endpoint
  3. // and access keys as shown below.
  4. var minioClient =newMinio.Client({
  5. endPoint:'play.minio.io',
  6. port:9000,
  7. useSSL:true,
  8. accessKey:'Q3AM3UQ867SPQQA43P2F',
  9. secretKey:'zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG'
  10. });
  11. // File that needs to be uploaded.
  12. var file ='/tmp/photos-europe.tar'
  13. // Make a bucket called europetrip.
  14. minioClient.makeBucket('europetrip','us-east-1',function(err){
  15. if(err)return console.log(err)
  16. console.log('Bucket created successfully in "us-east-1".')
  17. var metaData ={
  18. 'Content-Type':'application/octet-stream',
  19. 'X-Amz-Meta-Testing':1234,
  20. 'example':5678
  21. }
  22. // Using fPutObject API upload your file to the bucket europetrip.
  23. minioClient.fPutObject('europetrip','photos-europe.tar', file, metaData,function(err, etag){
  24. if(err)return console.log(err)
  25. console.log('File uploaded successfully.')
  26. });
  27. });

运行file-uploader

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

API文档

完整的API文档在这里。

完整示例 : 操作存储桶

贡献者指南

Build StatusBuild status

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