安装

相关资源:

MSS服务介绍

美团云存储服务(Meituan Storage Service, 简称 MSS),是美团云对外提供的对象存储服务,其具备高可靠,安全,低成本等特性,并且其 API 兼容 S3。MSS 适合存放非结构化的数据,比如图片,视频,文档,备份等。

MSS基本概念介绍

MSS 的 API 兼容 S3, 其基本概念也和 S3 相同,主要包括 Object, Bucket, Access Key, Secret Key 等。
Object 对应一个文件,包括数据和元数据两部分。元数据以 key-value 的形式构成,它包含一些默认的元数据信息,比如 Content-Type, Etag 等,用户也可以自定义元数据。 Bucket 是 object 的容器,每个 object 都必须包含在一个 bucket 中。用户可以创建任意多个 bucket。
Access Key 和 Secret Key: 用户注册 MSS 时,系统会给用户分配一对 Access Key 和 Secret Key, 用于标识用户,用户在使用 API 使用 MSS 服务时,需要使用这两个 Key。请在美团云管理控制台查询 AccessKey 和 SecretKey。

MSS访问域名

mtmss.com

安装

Node JS中使用

支持的Node.js版本:

  • 8.x
  • 9.x

项目下安装开发包 npm install mos-mss

使用方法

1、如果环境支持 Async/await

var MSS = require('mos-mss');
var client = new MSS({
    accessKeyId: '<accessKeyId>',
    accessKeySecret: '<accessKeySecret>'
});

async function fn() {
    var result = await client.createBucket('Bucket Name');
    console.log(result);
}

2、使用Promise

var MSS = require('mos-mss');
var client = new MSS({
    accessKeyId: '<accessKeyId>',
    accessKeySecret: '<accessKeySecret>'
});

var result = client.createBucket('Bucket Name');
result.then(function (res) {
    console.log(res);
})

确定Endpoint

Region中文名称 Region英文名称 外网Endpoint
华北1区 NorthChina1 mtmss.com
华东1区 EastChina1 eastchina1.mtmss.com

初始化MSSClient

endpoint 默认为 mtmss.com

secure 默认 false (http://)

signerVersion 可选值v2、v4,默认v2

var MSS = require('mos-mss');
var client = new MSS({
    accessKeyId: '<accessKeyId>',
    accessKeySecret: '<accessKeySecret>',
    endpoint: 'eastchina1.mtmss.com',
    bucket: '<bucket name>'
});

接口返回数据结构说明:

  1. 接口返回 code === 200,表示接口访问成功,并且操作成功,例如创建、删除、查询成功。
  2. 接口中 error 表示错误信息,访问接口有异常时,error 会是一个对象或者字符串, 详细返回内容见异常,code 返回相应状态码。
  3. data 存储返回的数据信息。
//删除成功
{
    "code": 200,
    "error": null,
    "data": { }
}


//创建已存在的bucket
{
    "code": 409,
    "error": {
        "Code": "BucketAlreadyExists",
        "Message": "The requested bucket name is not available. db duplicate entry",
        "Resource": "Bucket:test-bucket,Object:",
        "RequestId": "1513048027288690",
        "HostId": "87440f1e40a3710215c108574bdab8ce"
    },
    "data": { }
}


//获取bucket列表
{
    "code": 200,
    "data": {
        "Owner": {
            "ID": "ed0UXlNh10WipH+ZngEwfw==",
            "DisplayName": "ed0UXlNh10WipH+ZngEwfw=="
        },
        "Buckets": [
            {
                "Name": "myBucket",
                "CreationDate": "2017-11-06T04:20:52.000Z"
            },
            {
                "Name": "myBucket12",
                "CreationDate": "2017-11-08T05:28:30.000Z"
            },
            {
                "Name": "test1",
                "CreationDate": "2017-11-15T04:11:12.000Z"
            }
        ]
    }
}