mss-nodejs-sdk

mtyun MSS(Meituan Storage Service) sdk for Node.js.

项目简介

Constructs a service interface object. Each API operation is exposed as a function on service.

$3

MSS, Object Storage Service. Equal to well known Amazon S3.

#### Constructor Details
Constructs a service object. This object has one method for each API operation.

Refer to mss API、
mss-nodejs-sdk / mos-mss API for details.

当前版本

1.1.6

支持环境

node>=6

安装步骤

``js
npm install mos-mss --save --registry=http://r.npm.sankuai.com
`

基础用法

...

示例

`js
var MSS = require('mos-mss');

var client = new MSS({
accessKeyId: '', / required /
accessKeySecret: '', / required /
endpoint: '', / required, such as 'msstest.vip.com', 注意不能包含协议(http://或https://) /
bucket: '' / required /
})

`

options:

- endpoint (String) — The endpoint URI to send requests to. The endpoint should be a string like
'{service}.{region}.amazonaws.com'.
- accessKeyId (String) — your MSS access key ID.
- accessKeySecret (String) — your MSS secret access key.
- bucket (String) your Bucket name.
- secure (Boolean) http(false) or https(true). The default is false.
- signerVersion (String) singer version v2 or v4. The default is v2.

常用API

Refer to mss API、
mss-nodejs-sdk / mos-mss API for details.

- Bucket Operations
- listBucket()
- [createBucket(name[, options])](#createbucketname-options)
- [deleteBucket(name[, options])](#deletebucketname-options)
- [getBucketACL(name[, options])](#getbucketaclname-options)
- [putBucketACL(name, ACL[, options])](#putbucketaclname-acl-options)
- [getBucket(name[, options])](#getbucketname-options)
- [getBucketLifecycle(name[, options])](#getbucketlifecyclename-options)
- [putBucketLifecycle(name[, options])](#putbucketlifecyclename-options)
- [deleteBucketLifecycle(name,[ options])](#deletebucketlifecyclename-options)
- [getBucketPolicy(name[, options])](#getbucketpolicyname-options)
- [putBucketPolicy(name[, options])](#putbucketpolicyname-options)
- [getBucketCors(name[, options])](#getbucketcorsname-options)
- [putBucketCors(name[, options])](#putbucketcorsname-options)
- [deleteBucketCors(name[, options])](#deletebucketcorsname-options)

- Object Operations
- [putObject(key, file[, options])](#putobjectkey-file-options)
- [putStream(key, file[, options])](#putstreamkey-file-options)
- [multipartUpload(key, file[, options])](#multipartuploadkey-file-options)
- closeMultipartUpload(key, uploadId)
- getParts(key, uploadId)
- [getObject(key, path[, options])](#getobjectkey-path-options)
- [getBuffer(key[, options])](#getbufferkey-options)
- [getStream(key[, options])](#getstreamkey-options)
- [listObject([options])](#listobjectoptions)
- [copyObject(from, to[, options])](#copyobjectfrom-to-options)
- [getMeta(key[, options])](#getmetakey-options)
- [deleteObject(key[, options])](#deleteobjectkey-options)
- [deleteMultiple(keys[, options])](#deletemultiplekeys-options)

Bucket Operations

$3

Returns a list of all buckets owned by the authenticated sender of the request.

Examples:

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

var result = client.listBucket();
result.then(function (res) {
console.log(res);
});

`

Parameters:

- query (Object) (defaults to: {})

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- Buckets (Array)
- Name — (String) The name of the bucket.
- CreationDate — (Date) Date the bucket was created.
- Owner (Object)
- DisplayName — (String)
- ID — (String)
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Creates a new bucket.

Examples:

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

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

`
Parameters:

- name (String) Bucket name

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`. Set to `{}`
if a request error occurs. The data object has the following properties:
- x-mss-trace-id (String)
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted
before the bucket itself can be deleted.

Examples:

`js
var MSS = require('mos-mss');

var client = new MSS({
accessKeyId: '',
accessKeySecret: ''
});

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

Parameters:

- name (String) Bucket name

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Gets the access control policy for the bucket.

Examples:

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

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

`

Parameters:

- name (String) Bucket name

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`. Set to `{}`
if a request error occurs. The data object has the following properties:
- Owner (Object)
- DisplayName — (String) Screen name of the grantee.
- ID — (String) The canonical user ID of the grantee.
- Grants — (Array) A list of grants.
- Grantee
- DisplayName — (String) Screen name of the grantee.
- EmailAddress — (String) Email address of the grantee.
- ID — (String) The canonical user ID of the grantee.
- URI — (String) URI of the grantee group.
- Permission — (String) Specifies the permission given to the grantee. Possible values include:
- "FULL_CONTROL"
- "WRITE"
- "WRITE_ACP"
- "READ"
- "READ_ACP"
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Sets the permissions on a bucket using access control lists (ACL).

Examples:

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

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

`

Parameters:

- name (String) Bucket name.
- ACL — (String) The canned ACL to apply to the bucket. Possible values include:
- private
- public-read

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

This operation is useful to determine if a bucket exists and you have permission to access it.mos

Examples:

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

var result = client.getBucket('Bucket Name');
result.then(function (res) {
console.log(res);
//res.code === 200 exists
});

`

Parameters:

- name (String) Bucket name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`. Set to `{}`
if a request error occurs.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Get the bucket object lifecycle.

Examples:

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

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

`

Parameters:

- name (String) Bucket name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. Set to null if a request error occurs.
The data object has the following properties:
- Rule — (Arraynull if the request is successful.

$3

Set the bucket object lifecycle.

Examples:

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

var result = client.putBucketLifecycle('Bucket', {
lifecycleConfig: {
Rule: [
{
Expiration: {
Days: 30
},
ID: 'STRING_VALUE',
Filter: {
Prefix: ''
}
}
]
}
});

result.then(function (res) {
console.log(res);
});

`

Parameters:

- name (String) Bucket name.
- options (Object)
- lifecycleConfiguration — (map)
- Rule — required — (Array

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Deletes the lifecycle configuration from the bucket.

Examples:

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

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

`

Parameters:

- name (String) Bucket name

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Returns the policy of a specified bucket.

Examples:

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

var result = client.getBucketPolicy('test-bucket');
result.then(function (res) {
console.log(res);
});

`

Parameters:

- name (String) Bucket name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. Set to null if a request error occurs.
The data object has the following properties:
- Policy — (String) The bucket policy as a JSON document.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.




$3

Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.

Examples:

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

var result = client.putBucketPolicy('test-bucket', {
policy: {
"Version":"2012-10-17",
"Statement":[
// refer 不相关部分
{
"Sid":"",
"Effect":"Allow",
"Principal": {"AWS": "*"},
"Action":["s3:PutObject", "s3:PutObjectAcl"],
"Resource":["arn:aws:s3:::examplebucket/*"]
},
// refer 相关部分
{
"Sid":"",
"Effect":"Allow",
"Principal":{"AWS": "*"},
"Action":["s3:GetObject"],
"Resource":["arn:aws:s3:::examplebucket/*"],
"Condition":{
"StringLike":{"aws:Referer":["http://www.example.com/", "http://example.com/", ""]}
}
},
{
"Sid":"Allow get requests without referrer",
"Effect":"Deny",
"Principal":{"AWS": "*"},
"Action":["s3:GetObject"],
"Resource":["arn:aws:s3:::examplebucket/*"],
"Condition":{
"StringNotLike":{"aws:Referer":["http://www.example.com/", "http://example.com/", ""]}
}
}
]
}
});
result.then(function (res) {
console.log(res);
});

`

Parameters:

- name (String) Bucket name.

- options (Object)
- policy — (Object) The bucket policy as a JSON document.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Returns the cors configuration for the bucket.

Examples:

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

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

Parameters:

- name (String) Bucket name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. Set to null if a request error occurs.
The data object has the following properties:
- CORSRule — (Array`null` if the request is successful.

$3

Sets the cors configuration for a bucket.

Examples:

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

var result = client.putBucketCors('Bucket', {
CORSConfiguration: {
CORSRule: [
{
AllowedMethod: [
'GET',
/ more items /
],
AllowedOrigin: [
'http://www.example1.com',
'http://www.example2.com',
/ more items /
],
AllowedHeader: [
'*',
/ more items /
],
MaxAgeSeconds: 0
},
/ more items /
]
}
});
result.then(function (res) {
console.log(res);
});

`

Parameters:

- name (String) Bucket name.
- options (Object)
- CorsConfiguration — (map)
- CORSRule — required — (Array

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) - the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Deletes the cors configuration information set for the bucket.

Examples:

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

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

`

Parameters:

- name (String) Bucket name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) - the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.




Object Operations

$3

Adds an object to a bucket.

Examples:

`js
// file: String
var MSS = require('mos-mss');
var path = require('path');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var filePath = path.join(__dirname, './test.json');
var result = client.putObject('ObjectKey', filePath);

result.then(function (res) {
console.log(res);
});

// file: Buffer
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.putObject('ObjectKey', new Buffer('test'), {'headers':{'Content-Type': 'text/css'}});
result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.
- file (String|Buffer|ReadStream) object local path, content buffer or ReadStream content.
if the file is Buffer or ReadStream, must set options.headers.Content-Type
- options (Object)
- headers (Object) extra headers.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- ETag — (String) An ETag is an opaque identifier assigned by a web server to a specific version of
a resource found at a URL.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Adds an object to a bucket.

Examples:

`js
var MSS = require('mos-mss');
var path = require('path');
var fs = require('fs');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});


var filePath = path.join(__dirname, './test.json');
var stream = fs.createReadStream(filePath);

var result = client.putStream('ObjectKey', stream);
result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.
- file (ReadStream) ReadStream content.
- options (Object)
- headers (Object) extra headers.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- ETag — (String) An ETag is an opaque identifier assigned by a web server to a specific version
of a resource found at a URL.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Upload file with MSS multipart.

Examples:

`js
// Piecewise upload
var MSS = require('mos-mss');
var path = require('path');
var fs = require('fs');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
signerVersion: 'v4',
bucket: 'Bucket'
});

var write = function (data) {
return fs.writeFileSync(path.join(__dirname, './data/checkpoint.txt'), data);
};

var result = client.multipartUpload('ObjectKey', path.join(__dirname, './img/test-big.json'), {
progress: function (p, checkpoint) {
write(JSON.stringify(checkpoint));
console.log('Progress: ' + p);
}
});

result.then(function (res) {
console.log(res);
});

// Breakpoint upload
var MSS = require('mos-mss');
var path = require('path');
var fs = require('fs');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var read = function () {
return fs.readFileSync(path.join(__dirname, './data/checkpoint.txt'), 'utf-8');
};
var checkpoint = JSON.parse(read());

var object = client.multipartUpload('Bucket', path.join(__dirname, './data/test-big.json'), {
checkpoint: checkpoint,
progress: function (p, checkpoint) {
console.log('Progress: ' + p, checkpoint);
}
});

object.then(function (data) {
console.log(data);
});

`

Parameters:

- key (String) — object name.
- file (String) object local path
- options (Object)
- partSize (Number) — the suggested size for each part.
- checkpoint (Object) — the checkpoint to resume upload.
- headers (Object) extra headers.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- ETag (String) — An ETag is an opaque identifier assigned by a web server to a specific version
of a resource found at a URL.
- Location (String)
- Bucket (String)
- Key (String)
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Abort a multipart upload for object.

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.closeMultipartUpload('Bucket', 'UploadId');

result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.
- uploadId (String) the upload id

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

a list of parts that has been uploaded.

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.getParts('Bucket', 'UploadId');

result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.
- uploadId (String) the upload id

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Retrieves objects from mos S3.

Examples:

`js
var MSS = require('mos-mss');
var path = require('path');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.getObject('test.json', path.join(__dirname, './data/test.json'));

result.then(function (data) {
console.log(data);
});
`

Parameters:

- key (String) — object name.
- path (String) - object local path.
- options (Object)
- headers (Object) extra headers.
- query (Object)
- response-content-type (String) - Sets the Content-Type header of the response.
- response-content-language (String) - Sets the Content-Language header of the response.
- response-expires (String) - Sets the Expires header of the response.
- response-cache-control (String) - Sets the Cache-Control header of the response.
- response-content-disposition (String) - Sets the Content-Disposition header of the response.
- response-content-encoding (String) - Sets the Content-Encoding header of the response.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.getBuffer('test');

result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.
- options (Object)
- headers (Object) extra headers.
- query (Object)
- response-content-type (String) - Sets the Content-Type header of the response.
- response-content-language (String) - Sets the Content-Language header of the response.
- response-expires (String) - Sets the Expires header of the response.
- response-cache-control (String) - Sets the Cache-Control header of the response.
- response-content-disposition (String) - Sets the Content-Disposition header of the response.
- response-content-encoding (String) - Sets the Content-Encoding header of the response.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- content (String) — the data.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.




$3

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var writeStream = fs.createWriteStream(path.join(__dirname, './data/test.json'));

var result = client.getStream('ObjectKey');

result.then(function (data) {
data.stream.pipe(writeStream);
data.stream.on('end', function () {
console.log('success');
});
data.stream.on('error', function (err) {
console.log('fail', err);
});
});

`

Parameters:

- key (String) — object name.
- options (Object)
- headers (Object) extra headers.
- query (Object)
- response-content-type (String) - Sets the Content-Type header of the response.
- response-content-language (String) - Sets the Content-Language header of the response.
- response-expires (String) - Sets the Expires header of the response.
- response-cache-control (String) - Sets the Cache-Control header of the response.
- response-content-disposition (String) - Sets the Content-Disposition header of the response.
- response-content-encoding (String) - Sets the Content-Encoding header of the response.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- stream (ReadStream)
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.




$3

Returns all of the objects in a bucket.

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});


var result = client.listObject();
result.then(function (res) {
console.log(res);
});

`

Parameters:

- options (Object)
- query (Object) query object, see the api list.
- delimiter (String) - A delimiter is a character you use to group keys.
- marker (String) - Specifies the key to start with when listing objects in a bucket.
- max-keys (Integer) - Sets the maximum number of keys returned in the response. The response might
contain fewer keys but will never contain more.
- prefix (String) - Limits the response to keys that begin with the specified prefix.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- Name (String) - Bucket name
- Prefix (String)
- Marker (String)
- MaxKeys (Integer)
- Contents (Array) the list of object.
- Key (String) — object name on mss.
- Etag (String) — object etag.
- LastModified (String) — object last modified GMT date.
- Size (Number) — object size.
- StorageClass (String) — storage class type.
- Owner (Object) — object owner, including ID and DisplayName.
- IsTruncated (Boolean) - A flag that indicates whether or not Amazon S3 returned all of the results that
satisfied the search criteria.
- Delimiter (String)
- NextMarker (String) - When response is truncated (the IsTruncated element value in the response is true),
you can use the key name in this field as marker in the subsequent request to get next set of objects.
Amazon S3 lists objects in alphabetical order Note: This element is returned only if you have delimiter
request parameter specified. If response does not include the NextMaker and it is truncated, you can use the value of the last Key in the response as the marker in the subsequent request to get the next set of object keys.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.




$3

Creates a copy of an object that is already stored in mss S3.

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.copyObject(‘from’, 'to');

result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- Etag (String) — object etag.
- LastModified (String) — object last modified GMT date. - error (Object) — the error object returned
from the request. Set to `null` if the request is successful.




$3

Retrieves objects meta from mos S3.

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.getMeta('ObjectKey');
result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs. The data object has the following properties:
- Etag (String) — object etag.
- LastModified (String) — object last modified GMT date.
- ContentType (String) — content-type.
- ContentLength (String) — content-length.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.

$3

Deletes an object.

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.deleteObject('ObjectKey');

result.then(function (res) {
console.log(res);
});

`

Parameters:

- key (String) — object name.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.




$3

Deletes objects by query.

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.deleteMultiple('array');

result.then(function (res) {
console.log(res);
});

`

Parameters:

- keys (Array) — objects.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (Object) — the de-serialized data returned from the request. The default is `{}`.
Set to `{}` if a request error occurs.
- error (Object) — the error object returned from the request. Set to `null` if the request is successful.




$3

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

var result = client.signatureUrl('ObjectKey');

result.then(function (res) {
console.log(res);
});

`

Parameters:

- name (String) — object name.
- options (Object)
- headers (Object) extra headers.
- query (Object)
- response-content-type (String) - Sets the Content-Type header of the response.
- response-content-language (String) - Sets the Content-Language header of the response.
- response-expires (String) - Sets the Expires header of the response.
- response-cache-control (String) - Sets the Cache-Control header of the response.
- response-content-disposition (String) - Sets the Content-Disposition header of the response.
- response-content-encoding (String) - Sets the Content-Encoding header of the response.

Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 200.
- data (String) — object signature url.

$3

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});
var signValue = client.getUploadSign({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});

`

Parameters:
- options (Object)
- accessKeyId: '',
- accessKeySecret: '',
- bucket: 'Bucket'
Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 0.
- message (String) - message
- data (Object) — {
AWSAccessKeyId: AWSAccessKeyId,
policy: policy,
signature: signature,
key: key
}

$3

Examples:

`js
var MSS = require('mos-mss');
var client = new MSS({
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
});
/**
* params = {
* type:'uploadPart',
partNumber: '**',
uploadId: '*',
key: '*'
}
/
let params = req.body
const uploadConfig = {
accessKeyId: '',
accessKeySecret: '',
bucket: 'Bucket'
},
Object.assign(params,{
uploadConfig:uploadConfig
})
var signValue = client.getMultiUploadSign(params)

``

Parameters:

- options (Object)
- type:用于区分分片步骤，分别包括initMultiUpload，uploadPart，completMultiUpload
- partNumber: 上传分片序号，仅在type=uploadPart使用
- uploadId: 上传uploadId，仅在type=uploadPart及completMultiUpload使用
- uploadConfig:上传时配置对象，包含S3对应的accessKeyId,accessKeySecret,bucket
- key: 文件最后生产的key名称，用于在S3上显示的文件名及后缀
Return:

- res (Object)
- code (Number) — the code number returned from the request. The request is successful when the number is 0.
- message (String) - message
- data (Object) — {
AWSAccessKeyId: AWSAccessKeyId,
Signature: signature,
Date: Date
}

License

MIT

文档链接

整体目录结构

常见问题

常见问题说明

关键词

附录

版权和许可信息

更新日志

$3

更新 readme

$3

规范化加签代码格式。
更新时间： 2020 年 7 月 14 日

$3

修复bug。
更新时间： 2020 年 7 月 14 日

$3

添加文件上传加签方法。
更新时间： 2020 年 7 月 10 日

$3

添加文件上传加签方法。
更新时间： 2020 年 7 月 7 日

$3

更新时间： 2020 年 7 月 3 日
#### feature
- 修改文档说明