hexo/node_modules/cos-nodejs-sdk-v5/sdk/base.js

4405 lines
162 KiB
JavaScript
Raw Normal View History

2023-10-03 11:14:36 +08:00
var pkg = require('../package.json');
var REQUEST = require('request');
var mime = require('mime-types');
var Stream = require('stream');
var util = require('./util');
var fs = require('fs');
// Bucket 相关
/**
* 获取用户的 bucket 列表
* @param {Object} params 回调函数必须下面为参数列表
* 无特殊参数
* @param {Function} callback 回调函数必须
*/
function getService(params, callback) {
if (typeof params === 'function') {
callback = params;
params = {};
}
var protocol = this.options.Protocol || (util.isBrowser && location.protocol === 'http:' ? 'http:' : 'https:');
var domain = this.options.ServiceDomain;
var appId = params.AppId || this.options.appId;
var region = params.Region;
if (domain) {
domain = domain
.replace(/\{\{AppId\}\}/gi, appId || '')
.replace(/\{\{Region\}\}/gi, region || '')
.replace(/\{\{.*?\}\}/gi, '');
if (!/^[a-zA-Z]+:\/\//.test(domain)) {
domain = protocol + '//' + domain;
}
if (domain.slice(-1) === '/') {
domain = domain.slice(0, -1);
}
} else if (region) {
domain = protocol + '//cos.' + region + '.myqcloud.com';
} else {
domain = protocol + '//service.cos.myqcloud.com';
}
var SignHost = '';
var standardHost = region ? 'cos.' + region + '.myqcloud.com' : 'service.cos.myqcloud.com';
var urlHost = domain.replace(/^https?:\/\/([^/]+)(\/.*)?$/, '$1');
if (standardHost === urlHost) SignHost = standardHost;
submitRequest.call(
this,
{
Action: 'name/cos:GetService',
url: domain,
method: 'GET',
headers: params.Headers,
SignHost: SignHost,
},
function (err, data) {
if (err) return callback(err);
var buckets =
(data &&
data.ListAllMyBucketsResult &&
data.ListAllMyBucketsResult.Buckets &&
data.ListAllMyBucketsResult.Buckets.Bucket) ||
[];
buckets = util.isArray(buckets) ? buckets : [buckets];
var owner = (data && data.ListAllMyBucketsResult && data.ListAllMyBucketsResult.Owner) || {};
callback(null, {
Buckets: buckets,
Owner: owner,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 创建 Bucket并初始化访问权限
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.ACL 用户自定义文件权限可以设置privatepublic-read默认值private非必须
* @param {String} params.GrantRead 赋予被授权者读的权限格式x-cos-grant-read: uin=" ",uin=" "非必须
* @param {String} params.GrantWrite 赋予被授权者写的权限格式x-cos-grant-write: uin=" ",uin=" "非必须
* @param {String} params.GrantFullControl 赋予被授权者读写权限格式x-cos-grant-full-control: uin=" ",uin=" "非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {String} data.Location 操作地址
*/
function putBucket(params, callback) {
var self = this;
var xml = '';
var conf = {};
if (params.BucketAZConfig) conf.BucketAZConfig = params.BucketAZConfig;
if (params.BucketArchConfig) conf.BucketArchConfig = params.BucketArchConfig;
if (conf.BucketAZConfig || conf.BucketArchConfig) xml = util.json2xml({ CreateBucketConfiguration: conf });
submitRequest.call(
this,
{
Action: 'name/cos:PutBucket',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
body: xml,
},
function (err, data) {
if (err) return callback(err);
var url = getUrl({
protocol: self.options.Protocol,
domain: self.options.Domain,
bucket: params.Bucket,
region: params.Region,
isLocation: true,
});
callback(null, {
Location: url,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 查看是否存在该Bucket是否有权限访问
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Boolean} data.BucketExist Bucket是否存在
* @return {Boolean} data.BucketAuth 是否有 Bucket 的访问权限
*/
function headBucket(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:HeadBucket',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
method: 'HEAD',
},
callback,
);
}
/**
* 获取 Bucket 下的 object 列表
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Prefix 前缀匹配用来规定返回的文件前缀地址非必须
* @param {String} params.Delimiter 定界符为一个符号如果有Prefix则将Prefix到delimiter之间的相同路径归为一类非必须
* @param {String} params.Marker 默认以UTF-8二进制顺序列出条目所有列出条目从marker开始非必须
* @param {String} params.MaxKeys 单次返回最大的条目数量默认1000非必须
* @param {String} params.EncodingType 规定返回值的编码方式非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.ListBucketResult 返回的 object 列表信息
*/
function getBucket(params, callback) {
var reqParams = {};
reqParams['prefix'] = params['Prefix'] || '';
reqParams['delimiter'] = params['Delimiter'];
reqParams['marker'] = params['Marker'];
reqParams['max-keys'] = params['MaxKeys'];
reqParams['encoding-type'] = params['EncodingType'];
submitRequest.call(
this,
{
Action: 'name/cos:GetBucket',
ResourceKey: reqParams['prefix'],
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
qs: reqParams,
},
function (err, data) {
if (err) return callback(err);
var ListBucketResult = data.ListBucketResult || {};
var Contents = ListBucketResult.Contents || [];
var CommonPrefixes = ListBucketResult.CommonPrefixes || [];
Contents = util.isArray(Contents) ? Contents : [Contents];
CommonPrefixes = util.isArray(CommonPrefixes) ? CommonPrefixes : [CommonPrefixes];
var result = util.clone(ListBucketResult);
util.extend(result, {
Contents: Contents,
CommonPrefixes: CommonPrefixes,
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
/**
* 删除 Bucket
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {String} data.Location 操作地址
*/
function deleteBucket(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucket',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
method: 'DELETE',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 设置 Bucket 权限列表
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.ACL 用户自定义文件权限可以设置privatepublic-read默认值private非必须
* @param {String} params.GrantRead 赋予被授权者读的权限格式x-cos-grant-read: uin=" ",uin=" "非必须
* @param {String} params.GrantWrite 赋予被授权者写的权限格式x-cos-grant-write: uin=" ",uin=" "非必须
* @param {String} params.GrantFullControl 赋予被授权者读写权限格式x-cos-grant-full-control: uin=" ",uin=" "非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function putBucketAcl(params, callback) {
var headers = params.Headers;
var xml = '';
if (params['AccessControlPolicy']) {
var AccessControlPolicy = util.clone(params['AccessControlPolicy'] || {});
var Grants = AccessControlPolicy.Grants || AccessControlPolicy.Grant;
Grants = util.isArray(Grants) ? Grants : [Grants];
delete AccessControlPolicy.Grant;
delete AccessControlPolicy.Grants;
AccessControlPolicy.AccessControlList = { Grant: Grants };
xml = util.json2xml({ AccessControlPolicy: AccessControlPolicy });
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
}
// Grant Header 去重
util.each(headers, function (val, key) {
if (key.indexOf('x-cos-grant-') === 0) {
headers[key] = uniqGrant(headers[key]);
}
});
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketACL',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
headers: headers,
action: 'acl',
body: xml,
},
function (err, data) {
if (err) return callback(err);
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 权限列表
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.AccessControlPolicy 访问权限信息
*/
function getBucketAcl(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketACL',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'acl',
},
function (err, data) {
if (err) return callback(err);
var AccessControlPolicy = data.AccessControlPolicy || {};
var Owner = AccessControlPolicy.Owner || {};
var Grant = (AccessControlPolicy.AccessControlList && AccessControlPolicy.AccessControlList.Grant) || [];
Grant = util.isArray(Grant) ? Grant : [Grant];
var result = decodeAcl(AccessControlPolicy);
if (data.headers && data.headers['x-cos-acl']) {
result.ACL = data.headers['x-cos-acl'];
}
result = util.extend(result, {
Owner: Owner,
Grants: Grant,
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
/**
* 设置 Bucket 跨域设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Object} params.CORSConfiguration 相关的跨域设置必须
* @param {Array} params.CORSConfiguration.CORSRules 对应的跨域规则
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function putBucketCors(params, callback) {
var CORSConfiguration = params['CORSConfiguration'] || {};
var CORSRules = CORSConfiguration['CORSRules'] || params['CORSRules'] || [];
CORSRules = util.clone(util.isArray(CORSRules) ? CORSRules : [CORSRules]);
util.each(CORSRules, function (rule) {
util.each(['AllowedOrigin', 'AllowedHeader', 'AllowedMethod', 'ExposeHeader'], function (key) {
var sKey = key + 's';
var val = rule[sKey] || rule[key] || [];
delete rule[sKey];
rule[key] = util.isArray(val) ? val : [val];
});
});
var Conf = { CORSRule: CORSRules };
if (params.ResponseVary) Conf.ResponseVary = params.ResponseVary;
var xml = util.json2xml({ CORSConfiguration: Conf });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketCORS',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'cors',
headers: headers,
},
function (err, data) {
if (err) return callback(err);
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 跨域设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.CORSRules Bucket的跨域设置
*/
function getBucketCors(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketCORS',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'cors',
},
function (err, data) {
if (err) {
if (err.statusCode === 404 && err.error && err.error.Code === 'NoSuchCORSConfiguration') {
var result = {
CORSRules: [],
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
var CORSConfiguration = data.CORSConfiguration || {};
var CORSRules = CORSConfiguration.CORSRules || CORSConfiguration.CORSRule || [];
CORSRules = util.clone(util.isArray(CORSRules) ? CORSRules : [CORSRules]);
var ResponseVary = CORSConfiguration.ResponseVary;
util.each(CORSRules, function (rule) {
util.each(['AllowedOrigin', 'AllowedHeader', 'AllowedMethod', 'ExposeHeader'], function (key) {
var sKey = key + 's';
var val = rule[sKey] || rule[key] || [];
delete rule[key];
rule[sKey] = util.isArray(val) ? val : [val];
});
});
callback(null, {
CORSRules: CORSRules,
ResponseVary: ResponseVary,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 删除 Bucket 跨域设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function deleteBucketCors(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketCORS',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'cors',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode || err.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 地域信息
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据包含地域信息 LocationConstraint
*/
function getBucketLocation(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketLocation',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'location',
},
callback,
);
}
function putBucketPolicy(params, callback) {
var Policy = params['Policy'];
try {
if (typeof Policy === 'string') Policy = JSON.parse(Policy);
} catch (e) {}
if (!Policy || typeof Policy === 'string') return callback(util.error(new Error('Policy format error')));
var PolicyStr = JSON.stringify(Policy);
if (!Policy.version) Policy.version = '2.0';
var headers = params.Headers;
headers['Content-Type'] = 'application/json';
headers['Content-MD5'] = util.binaryBase64(util.md5(PolicyStr));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketPolicy',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
action: 'policy',
body: PolicyStr,
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的读取权限策略
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketPolicy(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketPolicy',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'policy',
rawBody: true,
},
function (err, data) {
if (err) {
if (err.statusCode && err.statusCode === 403) {
return callback(util.error(err, { ErrorStatus: 'Access Denied' }));
}
if (err.statusCode && err.statusCode === 405) {
return callback(util.error(err, { ErrorStatus: 'Method Not Allowed' }));
}
if (err.statusCode && err.statusCode === 404) {
return callback(util.error(err, { ErrorStatus: 'Policy Not Found' }));
}
return callback(err);
}
var Policy = {};
try {
Policy = JSON.parse(data.body);
} catch (e) {}
callback(null, {
Policy: Policy,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 删除 Bucket 跨域设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function deleteBucketPolicy(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketPolicy',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'policy',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode || err.statusCode,
headers: data.headers,
});
},
);
}
/**
* 设置 Bucket 的标签
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Array} params.TagSet 标签设置必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function putBucketTagging(params, callback) {
var Tagging = params['Tagging'] || {};
var Tags = Tagging.TagSet || Tagging.Tags || params['Tags'] || [];
Tags = util.clone(util.isArray(Tags) ? Tags : [Tags]);
var xml = util.json2xml({ Tagging: { TagSet: { Tag: Tags } } });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketTagging',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'tagging',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的标签设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketTagging(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketTagging',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'tagging',
},
function (err, data) {
if (err) {
if (err.statusCode === 404 && err.error && (err.error === 'Not Found' || err.error.Code === 'NoSuchTagSet')) {
var result = {
Tags: [],
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
var Tags = [];
try {
Tags = data.Tagging.TagSet.Tag || [];
} catch (e) {}
Tags = util.clone(util.isArray(Tags) ? Tags : [Tags]);
callback(null, {
Tags: Tags,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 删除 Bucket 标签设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function deleteBucketTagging(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketTagging',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'tagging',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function putBucketLifecycle(params, callback) {
var LifecycleConfiguration = params['LifecycleConfiguration'] || {};
var Rules = LifecycleConfiguration.Rules || params.Rules || [];
Rules = util.clone(Rules);
var xml = util.json2xml({ LifecycleConfiguration: { Rule: Rules } });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketLifecycle',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'lifecycle',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function getBucketLifecycle(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketLifecycle',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'lifecycle',
},
function (err, data) {
if (err) {
if (err.statusCode === 404 && err.error && err.error.Code === 'NoSuchLifecycleConfiguration') {
var result = {
Rules: [],
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
var Rules = [];
try {
Rules = data.LifecycleConfiguration.Rule || [];
} catch (e) {}
Rules = util.clone(util.isArray(Rules) ? Rules : [Rules]);
callback(null, {
Rules: Rules,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function deleteBucketLifecycle(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketLifecycle',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'lifecycle',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function putBucketVersioning(params, callback) {
if (!params['VersioningConfiguration']) {
callback(util.error(new Error('missing param VersioningConfiguration')));
return;
}
var VersioningConfiguration = params['VersioningConfiguration'] || {};
var xml = util.json2xml({ VersioningConfiguration: VersioningConfiguration });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketVersioning',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'versioning',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function getBucketVersioning(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketVersioning',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'versioning',
},
function (err, data) {
if (!err) {
!data.VersioningConfiguration && (data.VersioningConfiguration = {});
}
callback(err, data);
},
);
}
function putBucketReplication(params, callback) {
var ReplicationConfiguration = util.clone(params.ReplicationConfiguration);
var xml = util.json2xml({ ReplicationConfiguration: ReplicationConfiguration });
xml = xml.replace(/<(\/?)Rules>/gi, '<$1Rule>');
xml = xml.replace(/<(\/?)Tags>/gi, '<$1Tag>');
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketReplication',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'replication',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function getBucketReplication(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketReplication',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'replication',
},
function (err, data) {
if (err) {
if (
err.statusCode === 404 &&
err.error &&
(err.error === 'Not Found' || err.error.Code === 'ReplicationConfigurationnotFoundError')
) {
var result = {
ReplicationConfiguration: { Rules: [] },
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
if (!err) {
!data.ReplicationConfiguration && (data.ReplicationConfiguration = {});
}
if (data.ReplicationConfiguration.Rule) {
data.ReplicationConfiguration.Rules = util.makeArray(data.ReplicationConfiguration.Rule);
delete data.ReplicationConfiguration.Rule;
}
callback(err, data);
},
);
}
function deleteBucketReplication(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketReplication',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'replication',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 设置 Bucket 静态网站配置信息
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Object} params.WebsiteConfiguration 地域名称必须
* @param {Object} WebsiteConfiguration.IndexDocument 索引文档必须
* @param {Object} WebsiteConfiguration.ErrorDocument 错误文档非必须
* @param {Object} WebsiteConfiguration.RedirectAllRequestsTo 重定向所有请求非必须
* @param {Array} params.RoutingRules 重定向规则非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function putBucketWebsite(params, callback) {
if (!params['WebsiteConfiguration']) {
callback(util.error(new Error('missing param WebsiteConfiguration')));
return;
}
var WebsiteConfiguration = util.clone(params['WebsiteConfiguration'] || {});
var RoutingRules = WebsiteConfiguration['RoutingRules'] || WebsiteConfiguration['RoutingRule'] || [];
RoutingRules = util.isArray(RoutingRules) ? RoutingRules : [RoutingRules];
delete WebsiteConfiguration.RoutingRule;
delete WebsiteConfiguration.RoutingRules;
if (RoutingRules.length) WebsiteConfiguration.RoutingRules = { RoutingRule: RoutingRules };
var xml = util.json2xml({ WebsiteConfiguration: WebsiteConfiguration });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketWebsite',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'website',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的静态网站配置信息
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketWebsite(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketWebsite',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
action: 'website',
},
function (err, data) {
if (err) {
if (err.statusCode === 404 && err.error.Code === 'NoSuchWebsiteConfiguration') {
var result = {
WebsiteConfiguration: {},
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
var WebsiteConfiguration = data.WebsiteConfiguration || {};
if (WebsiteConfiguration['RoutingRules']) {
var RoutingRules = util.clone(WebsiteConfiguration['RoutingRules'].RoutingRule || []);
RoutingRules = util.makeArray(RoutingRules);
WebsiteConfiguration.RoutingRules = RoutingRules;
}
callback(null, {
WebsiteConfiguration: WebsiteConfiguration,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 删除 Bucket 的静态网站配置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function deleteBucketWebsite(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketWebsite',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'website',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 设置 Bucket 的防盗链白名单或者黑名单
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Object} params.RefererConfiguration 地域名称必须
* @param {String} RefererConfiguration.Status 是否开启防盗链枚举值EnabledDisabled
* @param {String} RefererConfiguration.RefererType 防盗链类型枚举值Black-ListWhite-List必须
* @param {Array} RefererConfiguration.DomianList.Domain 生效域名必须
* @param {String} RefererConfiguration.EmptyReferConfiguration 非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function putBucketReferer(params, callback) {
if (!params['RefererConfiguration']) {
callback(util.error(new Error('missing param RefererConfiguration')));
return;
}
var RefererConfiguration = util.clone(params['RefererConfiguration'] || {});
var DomainList = RefererConfiguration['DomainList'] || {};
var Domains = DomainList['Domains'] || DomainList['Domain'] || [];
Domains = util.isArray(Domains) ? Domains : [Domains];
if (Domains.length) RefererConfiguration.DomainList = { Domain: Domains };
var xml = util.json2xml({ RefererConfiguration: RefererConfiguration });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketReferer',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'referer',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的防盗链白名单或者黑名单
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketReferer(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketReferer',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
action: 'referer',
},
function (err, data) {
if (err) {
if (err.statusCode === 404 && err.error.Code === 'NoSuchRefererConfiguration') {
var result = {
WebsiteConfiguration: {},
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
var RefererConfiguration = data.RefererConfiguration || {};
if (RefererConfiguration['DomainList']) {
var Domains = util.makeArray(RefererConfiguration['DomainList'].Domain || []);
RefererConfiguration.DomainList = { Domains: Domains };
}
callback(null, {
RefererConfiguration: RefererConfiguration,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 设置 Bucket 自定义域名
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function putBucketDomain(params, callback) {
var DomainConfiguration = params['DomainConfiguration'] || {};
var DomainRule = DomainConfiguration.DomainRule || params.DomainRule || [];
DomainRule = util.clone(DomainRule);
var xml = util.json2xml({ DomainConfiguration: { DomainRule: DomainRule } });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketDomain',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'domain',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的自定义域名
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketDomain(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketDomain',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'domain',
},
function (err, data) {
if (err) return callback(err);
var DomainRule = [];
try {
DomainRule = data.DomainConfiguration.DomainRule || [];
} catch (e) {}
DomainRule = util.clone(util.isArray(DomainRule) ? DomainRule : [DomainRule]);
callback(null, {
DomainRule: DomainRule,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 删除 Bucket 自定义域名
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function deleteBucketDomain(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketDomain',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'domain',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 设置 Bucket 的回源
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function putBucketOrigin(params, callback) {
var OriginConfiguration = params['OriginConfiguration'] || {};
var OriginRule = OriginConfiguration.OriginRule || params.OriginRule || [];
OriginRule = util.clone(OriginRule);
var xml = util.json2xml({ OriginConfiguration: { OriginRule: OriginRule } });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketOrigin',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'origin',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的回源
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketOrigin(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketOrigin',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'origin',
},
function (err, data) {
if (err) return callback(err);
var OriginRule = [];
try {
OriginRule = data.OriginConfiguration.OriginRule || [];
} catch (e) {}
OriginRule = util.clone(util.isArray(OriginRule) ? OriginRule : [OriginRule]);
callback(null, {
OriginRule: OriginRule,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 删除 Bucket 的回源
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function deleteBucketOrigin(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketOrigin',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'origin',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 设置 Bucket 的日志记录
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {(Object|String)} params.BucketLoggingStatus 说明日志记录配置的状态如果无子节点信息则意为关闭日志记录必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function putBucketLogging(params, callback) {
var xml = util.json2xml({
BucketLoggingStatus: params['BucketLoggingStatus'] || '',
});
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketLogging',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'logging',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的日志记录
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketLogging(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketLogging',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'logging',
},
function (err, data) {
if (err) return callback(err);
callback(null, {
BucketLoggingStatus: data.BucketLoggingStatus,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 创建/编辑 Bucket 的清单任务
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Id 清单任务的名称必须
* @param {Object} params.InventoryConfiguration 包含清单的配置参数必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function putBucketInventory(params, callback) {
var InventoryConfiguration = util.clone(params['InventoryConfiguration']);
if (InventoryConfiguration.OptionalFields) {
var Field = InventoryConfiguration.OptionalFields || [];
InventoryConfiguration.OptionalFields = {
Field: Field,
};
}
if (
InventoryConfiguration.Destination &&
InventoryConfiguration.Destination.COSBucketDestination &&
InventoryConfiguration.Destination.COSBucketDestination.Encryption
) {
var Encryption = InventoryConfiguration.Destination.COSBucketDestination.Encryption;
if (Object.keys(Encryption).indexOf('SSECOS') > -1) {
Encryption['SSE-COS'] = Encryption['SSECOS'];
delete Encryption['SSECOS'];
}
}
var xml = util.json2xml({
InventoryConfiguration: InventoryConfiguration,
});
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketInventory',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'inventory',
qs: {
id: params['Id'],
},
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的清单任务信息
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Id 清单任务的名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function getBucketInventory(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketInventory',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'inventory',
qs: {
id: params['Id'],
},
},
function (err, data) {
if (err) return callback(err);
var InventoryConfiguration = data['InventoryConfiguration'];
if (
InventoryConfiguration &&
InventoryConfiguration.OptionalFields &&
InventoryConfiguration.OptionalFields.Field
) {
var Field = InventoryConfiguration.OptionalFields.Field;
if (!util.isArray(Field)) {
Field = [Field];
}
InventoryConfiguration.OptionalFields = Field;
}
if (
InventoryConfiguration.Destination &&
InventoryConfiguration.Destination.COSBucketDestination &&
InventoryConfiguration.Destination.COSBucketDestination.Encryption
) {
var Encryption = InventoryConfiguration.Destination.COSBucketDestination.Encryption;
if (Object.keys(Encryption).indexOf('SSE-COS') > -1) {
Encryption['SSECOS'] = Encryption['SSE-COS'];
delete Encryption['SSE-COS'];
}
}
callback(null, {
InventoryConfiguration: InventoryConfiguration,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Bucket 的清单任务信息
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.ContinuationToken COS 响应体中 IsTruncated true NextContinuationToken 节点中存在参数值时您可以将这个参数作为 continuation-token 参数值以获取下一页的清单任务信息非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function listBucketInventory(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:ListBucketInventory',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'inventory',
qs: {
'continuation-token': params['ContinuationToken'],
},
},
function (err, data) {
if (err) return callback(err);
var ListInventoryConfigurationResult = data['ListInventoryConfigurationResult'];
var InventoryConfigurations = ListInventoryConfigurationResult.InventoryConfiguration || [];
InventoryConfigurations = util.isArray(InventoryConfigurations)
? InventoryConfigurations
: [InventoryConfigurations];
delete ListInventoryConfigurationResult['InventoryConfiguration'];
util.each(InventoryConfigurations, function (InventoryConfiguration) {
if (
InventoryConfiguration &&
InventoryConfiguration.OptionalFields &&
InventoryConfiguration.OptionalFields.Field
) {
var Field = InventoryConfiguration.OptionalFields.Field;
if (!util.isArray(Field)) {
Field = [Field];
}
InventoryConfiguration.OptionalFields = Field;
}
if (
InventoryConfiguration.Destination &&
InventoryConfiguration.Destination.COSBucketDestination &&
InventoryConfiguration.Destination.COSBucketDestination.Encryption
) {
var Encryption = InventoryConfiguration.Destination.COSBucketDestination.Encryption;
if (Object.keys(Encryption).indexOf('SSE-COS') > -1) {
Encryption['SSECOS'] = Encryption['SSE-COS'];
delete Encryption['SSE-COS'];
}
}
});
ListInventoryConfigurationResult.InventoryConfigurations = InventoryConfigurations;
util.extend(ListInventoryConfigurationResult, {
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, ListInventoryConfigurationResult);
},
);
}
/**
* 删除 Bucket 的清单任务
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Id 清单任务的名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回数据
*/
function deleteBucketInventory(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketInventory',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'inventory',
qs: {
id: params['Id'],
},
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/* 全球加速 */
function putBucketAccelerate(params, callback) {
if (!params['AccelerateConfiguration']) {
callback(util.error(new Error('missing param AccelerateConfiguration')));
return;
}
var configuration = { AccelerateConfiguration: params.AccelerateConfiguration || {} };
var xml = util.json2xml(configuration);
var headers = {};
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketAccelerate',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'accelerate',
headers: headers,
},
function (err, data) {
if (err) return callback(err);
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function getBucketAccelerate(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketAccelerate',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
action: 'accelerate',
},
function (err, data) {
if (!err) {
!data.AccelerateConfiguration && (data.AccelerateConfiguration = {});
}
callback(err, data);
},
);
}
function putBucketEncryption(params, callback) {
var conf = params.ServerSideEncryptionConfiguration || {};
var Rules = conf.Rule || conf.Rules || [];
var xml = util.json2xml({ ServerSideEncryptionConfiguration: { Rule: Rules } });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutBucketEncryption',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'encryption',
headers: headers,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
function getBucketEncryption(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketEncryption',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'encryption',
},
function (err, data) {
if (err) {
if (err.statusCode === 404 && err.code === 'NoSuchEncryptionConfiguration') {
var result = {
EncryptionConfiguration: { Rules: [] },
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
var Rules = util.makeArray((data.EncryptionConfiguration && data.EncryptionConfiguration.Rule) || []);
data.EncryptionConfiguration = { Rules: Rules };
callback(err, data);
},
);
}
function deleteBucketEncryption(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteBucketReplication',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'encryption',
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
// Object 相关
/**
* 取回对应Object的元数据Head的权限与Get的权限一致
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key 文件名称必须
* @param {String} params.IfModifiedSince 当Object在指定时间后被修改则返回对应Object元信息否则返回304非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 为指定 object 的元数据如果设置了 IfModifiedSince 且文件未修改则返回一个对象NotModified 属性为 true
* @return {Boolean} data.NotModified 是否在 IfModifiedSince 时间点之后未修改该 object则为 true
*/
function headObject(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:HeadObject',
method: 'HEAD',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
VersionId: params.VersionId,
headers: params.Headers,
},
function (err, data) {
if (err) {
var statusCode = err.statusCode;
if (params.Headers['If-Modified-Since'] && statusCode && statusCode === 304) {
return callback(null, {
NotModified: true,
statusCode: statusCode,
});
}
return callback(err);
}
data.ETag = util.attr(data.headers, 'etag', '');
callback(null, data);
},
);
}
function listObjectVersions(params, callback) {
var reqParams = {};
reqParams['prefix'] = params['Prefix'] || '';
reqParams['delimiter'] = params['Delimiter'];
reqParams['key-marker'] = params['KeyMarker'];
reqParams['version-id-marker'] = params['VersionIdMarker'];
reqParams['max-keys'] = params['MaxKeys'];
reqParams['encoding-type'] = params['EncodingType'];
submitRequest.call(
this,
{
Action: 'name/cos:GetBucketObjectVersions',
ResourceKey: reqParams['prefix'],
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
qs: reqParams,
action: 'versions',
},
function (err, data) {
if (err) return callback(err);
var ListVersionsResult = data.ListVersionsResult || {};
var DeleteMarkers = ListVersionsResult.DeleteMarker || [];
DeleteMarkers = util.isArray(DeleteMarkers) ? DeleteMarkers : [DeleteMarkers];
var Versions = ListVersionsResult.Version || [];
Versions = util.isArray(Versions) ? Versions : [Versions];
var result = util.clone(ListVersionsResult);
delete result.DeleteMarker;
delete result.Version;
util.extend(result, {
DeleteMarkers: DeleteMarkers,
Versions: Versions,
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
/**
* 下载 object
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key 文件名称必须
* @param {WriteStream} params.Output 文件写入流非必须
* @param {String} params.IfModifiedSince 当Object在指定时间后被修改则返回对应Object元信息否则返回304非必须
* @param {String} params.IfUnmodifiedSince 如果文件修改时间早于或等于指定时间才返回文件内容否则返回 412 (precondition failed)非必须
* @param {String} params.IfMatch ETag 与指定的内容一致才返回文件否则返回 412 (precondition failed)非必须
* @param {String} params.IfNoneMatch ETag 与指定的内容不一致才返回文件否则返回304 (not modified)非必须
* @param {String} params.ResponseContentType 设置返回头部中的 Content-Type 参数非必须
* @param {String} params.ResponseContentLanguage 设置返回头部中的 Content-Language 参数非必须
* @param {String} params.ResponseExpires 设置返回头部中的 Content-Expires 参数非必须
* @param {String} params.ResponseCacheControl 设置返回头部中的 Cache-Control 参数非必须
* @param {String} params.ResponseContentDisposition 设置返回头部中的 Content-Disposition 参数非必须
* @param {String} params.ResponseContentEncoding 设置返回头部中的 Content-Encoding 参数非必须
* @param {Function} callback 回调函数必须
* @param {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @param {Object} data 为对应的 object 数据包括 body headers
*/
function getObject(params, callback) {
var reqParams = params.Query || {};
var reqParamsStr = params.QueryString || '';
reqParams['response-content-type'] = params['ResponseContentType'];
reqParams['response-content-language'] = params['ResponseContentLanguage'];
reqParams['response-expires'] = params['ResponseExpires'];
reqParams['response-cache-control'] = params['ResponseCacheControl'];
reqParams['response-content-disposition'] = params['ResponseContentDisposition'];
reqParams['response-content-encoding'] = params['ResponseContentEncoding'];
var BodyType;
var self = this;
var outputStream = params.Output;
if (params.ReturnStream) {
outputStream = new Stream.PassThrough();
BodyType = 'stream';
} else if (outputStream && typeof outputStream === 'string') {
outputStream = fs.createWriteStream(outputStream);
BodyType = 'stream';
} else if (outputStream && typeof outputStream.pipe === 'function') {
BodyType = 'stream';
} else {
BodyType = 'buffer';
}
var onProgress = params.onProgress;
var onDownloadProgress = (function () {
var time0 = Date.now();
var size0 = 0;
var FinishSize = 0;
var FileSize = 0;
var progressTimer;
var update = function () {
progressTimer = 0;
if (onProgress && typeof onProgress === 'function') {
var time1 = Date.now();
var speed = parseInt(((FinishSize - size0) / ((time1 - time0) / 1000)) * 100) / 100 || 0;
var percent = parseInt((FinishSize / FileSize) * 100) / 100 || 0;
time0 = time1;
size0 = FinishSize;
try {
onProgress({
loaded: FinishSize,
total: FileSize,
speed: speed,
percent: percent,
});
} catch (e) {}
}
};
return function (info, immediately) {
if (info && info.loaded) {
FinishSize = info.loaded;
FileSize = info.total;
}
if (immediately) {
clearTimeout(progressTimer);
update();
} else {
if (progressTimer) return;
progressTimer = setTimeout(update, self.options.ProgressInterval || 1000);
}
};
})();
// 如果用户自己传入了 output
submitRequest.call(
this,
{
Action: 'name/cos:GetObject',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
VersionId: params.VersionId,
headers: params.Headers,
qs: reqParams,
qsStr: reqParamsStr,
rawBody: true,
outputStream: outputStream,
onDownloadProgress: onDownloadProgress,
},
function (err, data) {
onDownloadProgress(null, true);
if (err) {
var statusCode = err.statusCode;
if (params.Headers['If-Modified-Since'] && statusCode && statusCode === 304) {
return callback(null, { NotModified: true });
}
if (outputStream) outputStream.emit('error', err);
return callback(err);
}
var result = {};
if (data.body) {
if (BodyType === 'buffer') {
result.Body = Buffer.from(data.body);
} else if (BodyType === 'string') {
result.Body = data.body;
}
}
util.extend(result, {
ETag: util.attr(data.headers, 'etag', ''),
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
if (params.ReturnStream) return outputStream;
}
function getObjectStream(params, callback) {
params.ReturnStream = true;
return getObject.call(this, params, callback);
}
/**
* 上传 object
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key 文件名称必须
* @param {Buffer || ReadStream || String} params.Body 上传文件的内容或流或字符串
* @param {String} params.CacheControl RFC 2616 中定义的缓存策略将作为 Object 元数据保存非必须
* @param {String} params.ContentDisposition RFC 2616 中定义的文件名称将作为 Object 元数据保存非必须
* @param {String} params.ContentEncoding RFC 2616 中定义的编码格式将作为 Object 元数据保存非必须
* @param {String} params.ContentLength RFC 2616 中定义的 HTTP 请求内容长度字节必须
* @param {String} params.ContentType RFC 2616 中定义的内容类型MIME将作为 Object 元数据保存非必须
* @param {String} params.Expect 当使用 Expect: 100-continue 在收到服务端确认后才会发送请求内容非必须
* @param {String} params.Expires RFC 2616 中定义的过期时间将作为 Object 元数据保存非必须
* @param {String} params.ACL 允许用户自定义文件权限有效值private | public-read非必须
* @param {String} params.GrantRead 赋予被授权者读取对象的权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.GrantReadAcp 赋予被授权者读取对象的访问控制列表ACL的权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.GrantWriteAcp 赋予被授权者写入对象的访问控制列表ACL的权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.GrantFullControl 赋予被授权者操作对象的所有权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.StorageClass 设置对象的存储级别枚举值STANDARDSTANDARD_IAARCHIVE默认值STANDARD非必须
* @param {String} params.x-cos-meta-* 允许用户自定义的头部信息将作为对象的元数据保存大小限制2KB非必须
* @param {String} params.ContentSha1 RFC 3174 中定义的 160-bit 内容 SHA-1 算法校验非必须
* @param {String} params.ServerSideEncryption 支持按照指定的加密算法进行服务端数据加密格式 x-cos-server-side-encryption: "AES256"非必须
* @param {Function} params.onProgress 上传进度回调函数
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 为对应的 object 数据
* @return {String} data.ETag 为对应上传文件的 ETag
*/
function putObject(params, callback) {
var self = this;
var FileSize = params.ContentLength;
var onProgress = util.throttleOnProgress.call(self, FileSize, params.onProgress);
// 特殊处理 Cache-Control、Content-Type避免代理更改这两个字段导致写入到 Object 属性里
var headers = params.Headers;
if (!headers['Cache-Control'] && !headers['cache-control']) headers['Cache-Control'] = '';
util.getBodyMd5(self.options.UploadCheckContentMd5, params.Body, function (md5) {
if (md5) params.Headers['Content-MD5'] = util.binaryBase64(md5);
if (params.ContentLength !== undefined) {
params.Headers['Content-Length'] = params.ContentLength;
}
onProgress(null, true); // 任务状态开始 uploading
submitRequest.call(
self,
{
Action: 'name/cos:PutObject',
TaskId: params.TaskId,
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
qs: params.Query,
body: params.Body,
onProgress: onProgress,
},
function (err, data) {
if (err) {
onProgress(null, true);
return callback(err);
}
onProgress({ loaded: FileSize, total: FileSize }, true);
if (data) {
var url = getUrl({
ForcePathStyle: self.options.ForcePathStyle,
protocol: self.options.Protocol,
domain: self.options.Domain,
bucket: params.Bucket,
region: !self.options.UseAccelerate ? params.Region : 'accelerate',
object: params.Key,
});
url = url.substr(url.indexOf('://') + 3);
data.Location = url;
if (data.headers && data.headers.etag) data.ETag = data.headers.etag;
return callback(null, data);
}
callback(null, data);
},
);
});
}
/**
* 删除 object
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {Function} callback 回调函数必须
* @param {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @param {Object} data 删除操作成功之后返回的数据
*/
function deleteObject(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteObject',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
VersionId: params.VersionId,
},
function (err, data) {
if (err) {
var statusCode = err.statusCode;
if (statusCode && statusCode === 404) {
return callback(null, { BucketNotFound: true, statusCode: statusCode });
} else {
return callback(err);
}
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 object 权限列表
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.AccessControlPolicy 权限列表
*/
function getObjectAcl(params, callback) {
var reqParams = {};
if (params.VersionId) {
reqParams.versionId = params.VersionId;
}
submitRequest.call(
this,
{
Action: 'name/cos:GetObjectACL',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
qs: reqParams,
action: 'acl',
},
function (err, data) {
if (err) return callback(err);
var AccessControlPolicy = data.AccessControlPolicy || {};
var Owner = AccessControlPolicy.Owner || {};
var Grant = (AccessControlPolicy.AccessControlList && AccessControlPolicy.AccessControlList.Grant) || [];
Grant = util.isArray(Grant) ? Grant : [Grant];
var result = decodeAcl(AccessControlPolicy);
delete result.GrantWrite;
if (data.headers && data.headers['x-cos-acl']) {
result.ACL = data.headers['x-cos-acl'];
}
result = util.extend(result, {
Owner: Owner,
Grants: Grant,
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
/**
* 设置 object 权限列表
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function putObjectAcl(params, callback) {
var headers = params.Headers;
var xml = '';
if (params['AccessControlPolicy']) {
var AccessControlPolicy = util.clone(params['AccessControlPolicy'] || {});
var Grants = AccessControlPolicy.Grants || AccessControlPolicy.Grant;
Grants = util.isArray(Grants) ? Grants : [Grants];
delete AccessControlPolicy.Grant;
delete AccessControlPolicy.Grants;
AccessControlPolicy.AccessControlList = { Grant: Grants };
xml = util.json2xml({ AccessControlPolicy: AccessControlPolicy });
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
}
// Grant Header 去重
util.each(headers, function (val, key) {
if (key.indexOf('x-cos-grant-') === 0) {
headers[key] = uniqGrant(headers[key]);
}
});
submitRequest.call(
this,
{
Action: 'name/cos:PutObjectACL',
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
action: 'acl',
headers: headers,
body: xml,
},
function (err, data) {
if (err) return callback(err);
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* Options Object请求实现跨域访问的预请求即发出一个 OPTIONS 请求给服务器以确认是否可以进行跨域操作
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function optionsObject(params, callback) {
var headers = params.Headers;
headers['Origin'] = params['Origin'];
headers['Access-Control-Request-Method'] = params['AccessControlRequestMethod'];
headers['Access-Control-Request-Headers'] = params['AccessControlRequestHeaders'];
submitRequest.call(
this,
{
Action: 'name/cos:OptionsObject',
method: 'OPTIONS',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: headers,
},
function (err, data) {
if (err) {
if (err.statusCode && err.statusCode === 403) {
return callback(null, {
OptionsForbidden: true,
statusCode: err.statusCode,
});
}
return callback(err);
}
var headers = data.headers || {};
callback(null, {
AccessControlAllowOrigin: headers['access-control-allow-origin'],
AccessControlAllowMethods: headers['access-control-allow-methods'],
AccessControlAllowHeaders: headers['access-control-allow-headers'],
AccessControlExposeHeaders: headers['access-control-expose-headers'],
AccessControlMaxAge: headers['access-control-max-age'],
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* @param {Object} 参数列表
* @param {String} Bucket Bucket 名称
* @param {String} Region 地域名称
* @param {String} Key 文件名称
* @param {String} CopySource 源文件URL绝对路径可以通过versionid子资源指定历史版本
* @param {String} ACL 允许用户自定义文件权限有效值privatepublic-read默认值private
* @param {String} GrantRead 赋予被授权者读的权限格式 x-cos-grant-read: uin=" ",uin=" "当需要给子账户授权时uin="RootAcountID/SubAccountID"当需要给根账户授权时uin="RootAcountID"
* @param {String} GrantWrite 赋予被授权者写的权限格式 x-cos-grant-write: uin=" ",uin=" "当需要给子账户授权时uin="RootAcountID/SubAccountID"当需要给根账户授权时uin="RootAcountID"
* @param {String} GrantFullControl 赋予被授权者读写权限格式 x-cos-grant-full-control: uin=" ",uin=" "当需要给子账户授权时uin="RootAcountID/SubAccountID"当需要给根账户授权时uin="RootAcountID"
* @param {String} MetadataDirective 是否拷贝元数据枚举值Copy, Replaced默认值Copy假如标记为Copy忽略Header中的用户元数据信息直接复制假如标记为Replaced按Header信息修改元数据当目标路径和原路径一致即用户试图修改元数据时必须为Replaced
* @param {String} CopySourceIfModifiedSince 当Object在指定时间后被修改则执行操作否则返回412可与x-cos-copy-source-If-None-Match一起使用与其他条件联合使用返回冲突
* @param {String} CopySourceIfUnmodifiedSince 当Object在指定时间后未被修改则执行操作否则返回412可与x-cos-copy-source-If-Match一起使用与其他条件联合使用返回冲突
* @param {String} CopySourceIfMatch 当Object的ETag和给定一致时则执行操作否则返回412可与x-cos-copy-source-If-Unmodified-Since一起使用与其他条件联合使用返回冲突
* @param {String} CopySourceIfNoneMatch 当Object的ETag和给定不一致时则执行操作否则返回412可与x-cos-copy-source-If-Modified-Since一起使用与其他条件联合使用返回冲突
* @param {String} StorageClass 存储级别枚举值存储级别枚举值Standard, Standard_IAArchive默认值Standard
* @param {String} CacheControl 指定所有缓存机制在整个请求/响应链中必须服从的指令
* @param {String} ContentDisposition MIME 协议的扩展MIME 协议指示 MIME 用户代理如何显示附加的文件
* @param {String} ContentEncoding HTTP 中用来对采用何种编码格式传输正文进行协定的一对头部字段
* @param {String} ContentLength 设置响应消息的实体内容的大小单位为字节
* @param {String} ContentType RFC 2616 中定义的 HTTP 请求内容类型MIME例如text/plain
* @param {String} Expect 请求的特定的服务器行为
* @param {String} Expires 响应过期的日期和时间
* @param {String} params.ServerSideEncryption 支持按照指定的加密算法进行服务端数据加密格式 x-cos-server-side-encryption: "AES256"非必须
* @param {String} ContentLanguage 指定内容语言
* @param {String} x-cos-meta-* 允许用户自定义的头部信息将作为 Object 元数据返回大小限制2K
*/
function putObjectCopy(params, callback) {
// 特殊处理 Cache-Control
var headers = params.Headers;
if (!headers['Cache-Control'] && !headers['cache-control']) headers['Cache-Control'] = '';
var CopySource = params.CopySource || '';
var m = util.getSourceParams.call(this, CopySource);
if (!m) {
callback(util.error(new Error('CopySource format error')));
return;
}
var SourceBucket = m.Bucket;
var SourceRegion = m.Region;
var SourceKey = decodeURIComponent(m.Key);
submitRequest.call(
this,
{
Scope: [
{
action: 'name/cos:GetObject',
bucket: SourceBucket,
region: SourceRegion,
prefix: SourceKey,
},
{
action: 'name/cos:PutObject',
bucket: params.Bucket,
region: params.Region,
prefix: params.Key,
},
],
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
VersionId: params.VersionId,
headers: params.Headers,
},
function (err, data) {
if (err) return callback(err);
var result = util.clone(data.CopyObjectResult || {});
util.extend(result, {
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
function uploadPartCopy(params, callback) {
var CopySource = params.CopySource || '';
var m = util.getSourceParams.call(this, CopySource);
if (!m) {
callback(util.error(new Error('CopySource format error')));
return;
}
var SourceBucket = m.Bucket;
var SourceRegion = m.Region;
var SourceKey = decodeURIComponent(m.Key);
submitRequest.call(
this,
{
Scope: [
{
action: 'name/cos:GetObject',
bucket: SourceBucket,
region: SourceRegion,
prefix: SourceKey,
},
{
action: 'name/cos:PutObject',
bucket: params.Bucket,
region: params.Region,
prefix: params.Key,
},
],
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
VersionId: params.VersionId,
qs: {
partNumber: params['PartNumber'],
uploadId: params['UploadId'],
},
headers: params.Headers,
},
function (err, data) {
if (err) return callback(err);
var result = util.clone(data.CopyPartResult || {});
util.extend(result, {
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
function deleteMultipleObject(params, callback) {
var Objects = params.Objects || [];
var Quiet = params.Quiet;
Objects = util.isArray(Objects) ? Objects : [Objects];
var xml = util.json2xml({ Delete: { Object: Objects, Quiet: Quiet || false } });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
var Scope = util.map(Objects, function (v) {
return {
action: 'name/cos:DeleteObject',
bucket: params.Bucket,
region: params.Region,
prefix: v.Key,
};
});
submitRequest.call(
this,
{
Scope: Scope,
method: 'POST',
Bucket: params.Bucket,
Region: params.Region,
body: xml,
action: 'delete',
headers: headers,
},
function (err, data) {
if (err) return callback(err);
var DeleteResult = data.DeleteResult || {};
var Deleted = DeleteResult.Deleted || [];
var Errors = DeleteResult.Error || [];
Deleted = util.isArray(Deleted) ? Deleted : [Deleted];
Errors = util.isArray(Errors) ? Errors : [Errors];
var result = util.clone(DeleteResult);
util.extend(result, {
Error: Errors,
Deleted: Deleted,
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
function restoreObject(params, callback) {
var headers = params.Headers;
if (!params['RestoreRequest']) {
callback(util.error(new Error('missing param RestoreRequest')));
return;
}
var RestoreRequest = params.RestoreRequest || {};
var xml = util.json2xml({ RestoreRequest: RestoreRequest });
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:RestoreObject',
method: 'POST',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
VersionId: params.VersionId,
body: xml,
action: 'restore',
headers: headers,
},
callback,
);
}
/**
* 设置 Object 的标签
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Object名称必须
* @param {String} params.Region 地域名称必须
* @param {Array} params.TagSet 标签设置必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/42998
* @return {Object} data 返回数据
*/
function putObjectTagging(params, callback) {
var Tagging = params['Tagging'] || {};
var Tags = Tagging.TagSet || Tagging.Tags || params['Tags'] || [];
Tags = util.clone(util.isArray(Tags) ? Tags : [Tags]);
var xml = util.json2xml({ Tagging: { TagSet: { Tag: Tags } } });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:PutObjectTagging',
method: 'PUT',
Bucket: params.Bucket,
Key: params.Key,
Region: params.Region,
body: xml,
action: 'tagging',
headers: headers,
VersionId: params.VersionId,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 获取 Object 的标签设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/42998
* @return {Object} data 返回数据
*/
function getObjectTagging(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:GetObjectTagging',
method: 'GET',
Key: params.Key,
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
action: 'tagging',
VersionId: params.VersionId,
},
function (err, data) {
if (err) {
if (err.statusCode === 404 && err.error && (err.error === 'Not Found' || err.error.Code === 'NoSuchTagSet')) {
var result = {
Tags: [],
statusCode: err.statusCode,
};
err.headers && (result.headers = err.headers);
callback(null, result);
} else {
callback(err);
}
return;
}
var Tags = [];
try {
Tags = data.Tagging.TagSet.Tag || [];
} catch (e) {}
Tags = util.clone(util.isArray(Tags) ? Tags : [Tags]);
callback(null, {
Tags: Tags,
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 删除 Object 标签设置
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Object名称必须
* @param {String} params.Region 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/42998
* @return {Object} data 返回的数据
*/
function deleteObjectTagging(params, callback) {
submitRequest.call(
this,
{
Action: 'name/cos:DeleteObjectTagging',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
action: 'tagging',
VersionId: params.VersionId,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
return callback(err);
}
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 使用 SQL 语句从指定对象CSV 格式或者 JSON 格式中检索内容
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Object名称必须
* @param {String} params.Region 地域名称必须
* @param {Object} params.SelectRequest 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/42998
* @return {Object} data 返回的数据
*/
function selectObjectContent(params, callback) {
var SelectType = params['SelectType'];
if (!SelectType) return callback(util.error(new Error('missing param SelectType')));
var SelectRequest = params['SelectRequest'] || {};
var xml = util.json2xml({ SelectRequest: SelectRequest });
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
var outputStream;
var selectResult = {};
var SelectStream = require('./select-stream');
if (params.ReturnStream && params.DataType === 'raw') {
// 流 && raw 直接原样数据吐回
outputStream = new Stream.PassThrough();
} else {
// 包含 params.ReturnStream || !params.ReturnStream
outputStream = new SelectStream();
outputStream.on('message:progress', function (progress) {
if (typeof params.onProgress === 'function') params.onProgress(progress);
});
outputStream.on('message:stats', function (stats) {
selectResult.stats = stats;
});
outputStream.on('message:error', function (error) {
selectResult.error = error;
});
}
submitRequest.call(
this,
{
Action: 'name/cos:GetObject',
method: 'POST',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
action: 'select',
qs: {
'select-type': params['SelectType'],
},
VersionId: params.VersionId,
body: xml,
rawBody: true,
outputStream: outputStream,
},
function (err, data) {
if (err && err.statusCode === 204) {
return callback(null, { statusCode: err.statusCode });
} else if (err) {
if (outputStream) outputStream.emit('error', err);
return callback(err);
} else if (selectResult.error) {
return callback(
util.extend(selectResult.error, {
statusCode: data.statusCode,
headers: data.headers,
}),
);
}
var result = {
statusCode: data.statusCode,
headers: data.headers,
};
// 只要流里有解析出 stats就返回 Stats
if (selectResult.stats) result.Stats = selectResult.stats;
// 只要有 records就返回 Payload
if (selectResult.records) result.Payload = Buffer.concat(selectResult.records);
callback(null, result);
},
);
if (!params.ReturnStream && params.DataType !== 'raw') {
selectResult.records = [];
outputStream.pipe(
new Stream.Writable({
write: function (chunk, encoding, callback) {
selectResult.records.push(chunk);
callback();
},
writev: function (chunks, encoding, callback) {
chunks.forEach(function (item) {
selectResult.records.push(chunks);
});
callback();
},
}),
);
outputStream.pipe(outputStream);
}
if (params.ReturnStream) return outputStream;
}
/**
* 使用 SQL 语句从指定对象CSV 格式或者 JSON 格式中检索内容
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Object名称必须
* @param {String} params.Region 地域名称必须
* @param {Object} params.SelectRequest 地域名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/42998
* @return {Object} data 返回的数据
* @return {Object} Stream 返回值
*/
function selectObjectContentStream(params, callback) {
params.ReturnStream = true;
return selectObjectContent.call(this, params, callback);
}
// 分块上传
/**
* 初始化分块上传
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {String} params.UploadId object名称必须
* @param {String} params.CacheControl RFC 2616 中定义的缓存策略将作为 Object 元数据保存非必须
* @param {String} params.ContentDisposition RFC 2616 中定义的文件名称将作为 Object 元数据保存 非必须
* @param {String} params.ContentEncoding RFC 2616 中定义的编码格式将作为 Object 元数据保存非必须
* @param {String} params.ContentType RFC 2616 中定义的内容类型MIME将作为 Object 元数据保存非必须
* @param {String} params.Expires RFC 2616 中定义的过期时间将作为 Object 元数据保存非必须
* @param {String} params.ACL 允许用户自定义文件权限非必须
* @param {String} params.GrantRead 赋予被授权者读的权限 非必须
* @param {String} params.GrantWrite 赋予被授权者写的权限 非必须
* @param {String} params.GrantFullControl 赋予被授权者读写权限 非必须
* @param {String} params.StorageClass 设置Object的存储级别枚举值StandardStandard_IAArchive非必须
* @param {String} params.ServerSideEncryption 支持按照指定的加密算法进行服务端数据加密格式 x-cos-server-side-encryption: "AES256"非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function multipartInit(params, callback) {
// 特殊处理 Cache-Control
var headers = params.Headers;
// 特殊处理 Cache-Control、Content-Type
if (!headers['Cache-Control'] && !headers['cache-control']) headers['Cache-Control'] = '';
if (!headers['Content-Type'] && !headers['content-type'])
headers['Content-Type'] = (params.Body && params.Body.type) || '';
submitRequest.call(
this,
{
Action: 'name/cos:InitiateMultipartUpload',
method: 'POST',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
action: 'uploads',
headers: params.Headers,
qs: params.Query,
},
function (err, data) {
if (err) return callback(err);
data = util.clone(data || {});
if (data && data.InitiateMultipartUploadResult) {
return callback(
null,
util.extend(data.InitiateMultipartUploadResult, {
statusCode: data.statusCode,
headers: data.headers,
}),
);
}
callback(null, data);
},
);
}
/**
* 分块上传
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {Buffer || Stream || String} params.Body 上传文件对象或字符串
* @param {String} params.ContentLength RFC 2616 中定义的 HTTP 请求内容长度字节非必须
* @param {String} params.Expect 当使用 Expect: 100-continue 在收到服务端确认后才会发送请求内容非必须
* @param {String} params.ServerSideEncryption 支持按照指定的加密算法进行服务端数据加密格式 x-cos-server-side-encryption: "AES256"非必须
* @param {String} params.ContentSha1 RFC 3174 中定义的 160-bit 内容 SHA-1 算法校验值非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.ETag 返回的文件分块 sha1
*/
function multipartUpload(params, callback) {
var self = this;
util.getFileSize('multipartUpload', params, function () {
util.getBodyMd5(self.options.UploadCheckContentMd5, params.Body, function (md5) {
if (md5) params.Headers['Content-MD5'] = util.binaryBase64(md5);
submitRequest.call(
self,
{
Action: 'name/cos:UploadPart',
TaskId: params.TaskId,
method: 'PUT',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
qs: {
partNumber: params['PartNumber'],
uploadId: params['UploadId'],
},
headers: params.Headers,
onProgress: params.onProgress,
body: params.Body || null,
},
function (err, data) {
if (err) return callback(err);
callback(null, {
ETag: util.attr(data.headers, 'etag', ''),
statusCode: data.statusCode,
headers: data.headers,
});
},
);
});
});
}
/**
* 完成分块上传
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {Array} params.Parts 分块信息列表必须
* @param {String} params.Parts[i].PartNumber 块编号必须
* @param {String} params.Parts[i].ETag 分块的 sha1 校验值
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.CompleteMultipartUpload 完成分块上传后的文件信息包括Location, Bucket, Key ETag
*/
function multipartComplete(params, callback) {
var self = this;
var UploadId = params.UploadId;
var Parts = params['Parts'];
for (var i = 0, len = Parts.length; i < len; i++) {
if (Parts[i]['ETag'].indexOf('"') === 0) {
continue;
}
Parts[i]['ETag'] = '"' + Parts[i]['ETag'] + '"';
}
var xml = util.json2xml({ CompleteMultipartUpload: { Part: Parts } });
// CSP/ceph CompleteMultipartUpload 接口 body 写死了限制 1MB这里醉倒 10000 片时xml 字符串去掉空格853KB
xml = xml.replace(/\n\s*/g, '');
var headers = params.Headers;
headers['Content-Type'] = 'application/xml';
headers['Content-MD5'] = util.binaryBase64(util.md5(xml));
submitRequest.call(
this,
{
Action: 'name/cos:CompleteMultipartUpload',
method: 'POST',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
qs: {
uploadId: UploadId,
},
body: xml,
headers: headers,
},
function (err, data) {
if (err) return callback(err);
var url = getUrl({
ForcePathStyle: self.options.ForcePathStyle,
protocol: self.options.Protocol,
domain: self.options.Domain,
bucket: params.Bucket,
region: params.Region,
object: params.Key,
isLocation: true,
});
var res = data.CompleteMultipartUploadResult || {};
if (res.ProcessResults) {
if (res && res.ProcessResults) {
res.UploadResult = {
OriginalInfo: {
Key: res.Key,
Location: url,
ETag: res.ETag,
ImageInfo: res.ImageInfo,
},
ProcessResults: res.ProcessResults,
};
delete res.ImageInfo;
delete res.ProcessResults;
}
}
var result = util.extend(res, {
Location: url,
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
/**
* 分块上传任务列表查询
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Delimiter 定界符为一个符号如果有Prefix则将Prefix到delimiter之间的相同路径归为一类定义为Common Prefix然后列出所有Common Prefix如果没有Prefix则从路径起点开始非必须
* @param {String} params.EncodingType 规定返回值的编码方式非必须
* @param {String} params.Prefix 前缀匹配用来规定返回的文件前缀地址非必须
* @param {String} params.MaxUploads 单次返回最大的条目数量默认1000非必须
* @param {String} params.KeyMarker 与upload-id-marker一起使用 </Br>upload-id-markerObjectNamekey-marker </Br>upload-id-markerObjectNamekey-markerObjectNamekey-markerUploadIdupload-id-marker
* @param {String} params.UploadIdMarker 与key-marker一起使用 </Br>key-markerupload-id-marker </Br>key-markerObjectNamekey-markerObjectNamekey-markerUploadIdupload-id-marker
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.ListMultipartUploadsResult 分块上传任务信息
*/
function multipartList(params, callback) {
var reqParams = {};
reqParams['delimiter'] = params['Delimiter'];
reqParams['encoding-type'] = params['EncodingType'];
reqParams['prefix'] = params['Prefix'] || '';
reqParams['max-uploads'] = params['MaxUploads'];
reqParams['key-marker'] = params['KeyMarker'];
reqParams['upload-id-marker'] = params['UploadIdMarker'];
reqParams = util.clearKey(reqParams);
submitRequest.call(
this,
{
Action: 'name/cos:ListMultipartUploads',
ResourceKey: reqParams['prefix'],
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
headers: params.Headers,
qs: reqParams,
action: 'uploads',
},
function (err, data) {
if (err) return callback(err);
if (data && data.ListMultipartUploadsResult) {
var Upload = data.ListMultipartUploadsResult.Upload || [];
Upload = util.isArray(Upload) ? Upload : [Upload];
data.ListMultipartUploadsResult.Upload = Upload;
}
var result = util.clone(data.ListMultipartUploadsResult || {});
util.extend(result, {
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
/**
* 上传的分块列表查询
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {String} params.UploadId 标示本次分块上传的ID必须
* @param {String} params.EncodingType 规定返回值的编码方式非必须
* @param {String} params.MaxParts 单次返回最大的条目数量默认1000非必须
* @param {String} params.PartNumberMarker 默认以UTF-8二进制顺序列出条目所有列出条目从marker开始非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
* @return {Object} data.ListMultipartUploadsResult 分块信息
*/
function multipartListPart(params, callback) {
var reqParams = {};
reqParams['uploadId'] = params['UploadId'];
reqParams['encoding-type'] = params['EncodingType'];
reqParams['max-parts'] = params['MaxParts'];
reqParams['part-number-marker'] = params['PartNumberMarker'];
submitRequest.call(
this,
{
Action: 'name/cos:ListParts',
method: 'GET',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
qs: reqParams,
},
function (err, data) {
if (err) return callback(err);
var ListPartsResult = data.ListPartsResult || {};
var Part = ListPartsResult.Part || [];
Part = util.isArray(Part) ? Part : [Part];
ListPartsResult.Part = Part;
var result = util.clone(ListPartsResult);
util.extend(result, {
statusCode: data.statusCode,
headers: data.headers,
});
callback(null, result);
},
);
}
/**
* 抛弃分块上传
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {String} params.UploadId 标示本次分块上传的ID必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function multipartAbort(params, callback) {
var reqParams = {};
reqParams['uploadId'] = params['UploadId'];
submitRequest.call(
this,
{
Action: 'name/cos:AbortMultipartUpload',
method: 'DELETE',
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
headers: params.Headers,
qs: reqParams,
},
function (err, data) {
if (err) return callback(err);
callback(null, {
statusCode: data.statusCode,
headers: data.headers,
});
},
);
}
/**
* 追加上传
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {{Buffer || ReadStream || String}} params.Body 上传文件对象或字符串
* @param {Number} params.Position 追加操作的起始点单位为字节必须
* @param {String} params.CacheControl RFC 2616 中定义的缓存策略将作为 Object 元数据保存非必须
* @param {String} params.ContentDisposition RFC 2616 中定义的文件名称将作为 Object 元数据保存非必须
* @param {String} params.ContentEncoding RFC 2616 中定义的编码格式将作为 Object 元数据保存非必须
* @param {String} params.ContentLength RFC 2616 中定义的 HTTP 请求内容长度字节必须
* @param {String} params.ContentType RFC 2616 中定义的内容类型MIME将作为 Object 元数据保存非必须
* @param {String} params.Expect 当使用 Expect: 100-continue 在收到服务端确认后才会发送请求内容非必须
* @param {String} params.Expires RFC 2616 中定义的过期时间将作为 Object 元数据保存非必须
* @param {String} params.ACL 允许用户自定义文件权限有效值private | public-read非必须
* @param {String} params.GrantRead 赋予被授权者读取对象的权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.GrantReadAcp 赋予被授权者读取对象的访问控制列表ACL的权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.GrantWriteAcp 赋予被授权者写入对象的访问控制列表ACL的权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.GrantFullControl 赋予被授权者操作对象的所有权限格式id="[OwnerUin]"可使用半角逗号,分隔多组被授权者非必须
* @param {String} params.StorageClass 设置对象的存储级别枚举值STANDARDSTANDARD_IAARCHIVE默认值STANDARD非必须
* @param {String} params.x-cos-meta-* 允许用户自定义的头部信息将作为对象的元数据保存大小限制2KB非必须
* @param {String} params.ContentSha1 RFC 3174 中定义的 160-bit 内容 SHA-1 算法校验非必须
* @param {String} params.ServerSideEncryption 支持按照指定的加密算法进行服务端数据加密格式 x-cos-server-side-encryption: "AES256"非必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function appendObject(params, callback) {
// 特殊处理 Cache-Control、Content-Type避免代理更改这两个字段导致写入到 Object 属性里
var headers = params.Headers;
if (!headers['Cache-Control'] && !headers['cache-control']) headers['Cache-Control'] = '';
submitRequest.call(
this,
{
Action: 'name/cos:AppendObject',
method: 'POST',
Bucket: params.Bucket,
Region: params.Region,
action: 'append',
Key: params.Key,
body: params.Body,
qs: {
position: params.Position,
},
headers: params.Headers,
},
function (err, data) {
if (err) return callback(err);
callback(null, data);
},
);
}
/**
* cos 内置请求
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function request(params, callback) {
var Query = params.Query || {};
// 处理 url
if (params.Url) {
var m = params.Url.match(/^https?:\/\/([^/]+)(\/[^?#]*)?(\?[^#]*)?(#.*)?$/);
var urlPath = (m && m[2]) || '';
if (urlPath && !params.Key) params.Key = urlPath.substr(1);
}
submitRequest.call(
this,
{
method: params.Method,
Bucket: params.Bucket,
Region: params.Region,
Key: params.Key,
action: params.Action,
headers: params.Headers,
qs: Query,
body: params.Body,
url: params.Url,
rawBody: params.RawBody,
},
function (err, data) {
if (err) return callback(err);
if (data && data.body) {
data.Body = data.body;
delete data.body;
}
callback(err, data);
},
);
}
/**
* 获取签名
* @param {Object} params 参数对象必须
* @param {String} params.Method 请求方法必须
* @param {String} params.Key object名称必须
* @param {String} params.Expires 名超时时间单位秒可选
* @return {String} data 返回签名字符串
*/
function getAuth(params) {
var self = this;
return util.getAuth({
SecretId: params.SecretId || this.options.SecretId || '',
SecretKey: params.SecretKey || this.options.SecretKey || '',
Bucket: params.Bucket,
Region: params.Region,
Method: params.Method,
Key: params.Key,
Query: params.Query,
Headers: params.Headers,
Expires: params.Expires,
UseRawKey: self.options.UseRawKey,
SystemClockOffset: self.options.SystemClockOffset,
});
}
function getV4Auth(params) {
return util.getV4Auth({
SecretId: params.SecretId || this.options.SecretId || '',
SecretKey: params.SecretKey || this.options.SecretKey || '',
Bucket: params.Bucket,
Key: params.Key,
Expires: params.Expires,
});
}
/**
* 获取文件下载链接
* @param {Object} params 参数对象必须
* @param {String} params.Bucket Bucket名称必须
* @param {String} params.Region 地域名称必须
* @param {String} params.Key object名称必须
* @param {String} params.Method 请求的方法可选
* @param {String} params.Expires 签名超时时间单位秒可选
* @param {Function} callback 回调函数必须
* @return {Object} err 请求失败的错误如果请求成功则为空https://cloud.tencent.com/document/product/436/7730
* @return {Object} data 返回的数据
*/
function getObjectUrl(params, callback) {
var self = this;
var useAccelerate = params.UseAccelerate === undefined ? self.options.UseAccelerate : params.UseAccelerate;
var url = getUrl({
ForcePathStyle: self.options.ForcePathStyle,
protocol: params.Protocol || self.options.Protocol,
domain: params.Domain || self.options.Domain,
bucket: params.Bucket,
region: useAccelerate ? 'accelerate' : params.Region,
object: params.Key,
});
var queryParamsStr = '';
if (params.Query) {
queryParamsStr += util.obj2str(params.Query);
}
if (params.QueryString) {
queryParamsStr += (queryParamsStr ? '&' : '') + params.QueryString;
}
var syncUrl = url;
if (params.Sign !== undefined && !params.Sign) {
queryParamsStr && (syncUrl += '?' + queryParamsStr);
callback(null, { Url: syncUrl });
return syncUrl;
}
// 签名加上 Host避免跨桶访问
var SignHost = getSignHost.call(this, {
Bucket: params.Bucket,
Region: params.Region,
UseAccelerate: params.UseAccelerate,
Url: url,
});
var AuthData = getAuthorizationAsync.call(
this,
{
Action: (params.Method || '').toUpperCase() === 'PUT' ? 'name/cos:PutObject' : 'name/cos:GetObject',
Bucket: params.Bucket || '',
Region: params.Region || '',
Method: params.Method || 'get',
Key: params.Key,
Expires: params.Expires,
Headers: params.Headers,
Query: params.Query,
SignHost: SignHost,
ForceSignHost: params.ForceSignHost === false ? false : self.options.ForceSignHost, // getObjectUrl支持传参ForceSignHost
},
function (err, AuthData) {
if (!callback) return;
if (err) {
callback(err);
return;
}
// 兼容万象url qUrlParamList需要再encode一次
var replaceUrlParamList = function (url) {
var urlParams = url.match(/q-url-param-list.*?(?=&)/g)[0];
var encodedParams =
'q-url-param-list=' + encodeURIComponent(urlParams.replace(/q-url-param-list=/, '')).toLowerCase();
var reg = new RegExp(urlParams, 'g');
var replacedUrl = url.replace(reg, encodedParams);
return replacedUrl;
};
var signUrl = url;
signUrl +=
'?' +
(AuthData.Authorization.indexOf('q-signature') > -1
? replaceUrlParamList(AuthData.Authorization)
: 'sign=' + encodeURIComponent(AuthData.Authorization));
AuthData.SecurityToken && (signUrl += '&x-cos-security-token=' + AuthData.SecurityToken);
AuthData.ClientIP && (signUrl += '&clientIP=' + AuthData.ClientIP);
AuthData.ClientUA && (signUrl += '&clientUA=' + AuthData.ClientUA);
AuthData.Token && (signUrl += '&token=' + AuthData.Token);
queryParamsStr && (signUrl += '&' + queryParamsStr);
setTimeout(function () {
callback(null, { Url: signUrl });
});
},
);
if (AuthData) {
syncUrl +=
'?' + AuthData.Authorization + (AuthData.SecurityToken ? '&x-cos-security-token=' + AuthData.SecurityToken : '');
queryParamsStr && (syncUrl += '&' + queryParamsStr);
} else {
queryParamsStr && (syncUrl += '?' + queryParamsStr);
}
return syncUrl;
}
/**
* 私有方法
*/
function decodeAcl(AccessControlPolicy) {
var result = {
GrantFullControl: [],
GrantWrite: [],
GrantRead: [],
GrantReadAcp: [],
GrantWriteAcp: [],
ACL: '',
};
var GrantMap = {
FULL_CONTROL: 'GrantFullControl',
WRITE: 'GrantWrite',
READ: 'GrantRead',
READ_ACP: 'GrantReadAcp',
WRITE_ACP: 'GrantWriteAcp',
};
var AccessControlList = (AccessControlPolicy && AccessControlPolicy.AccessControlList) || {};
var Grant = AccessControlList.Grant;
if (Grant) {
Grant = util.isArray(Grant) ? Grant : [Grant];
}
var PublicAcl = { READ: 0, WRITE: 0, FULL_CONTROL: 0 };
Grant &&
Grant.length &&
util.each(Grant, function (item) {
if (
item.Grantee.ID === 'qcs::cam::anyone:anyone' ||
item.Grantee.URI === 'http://cam.qcloud.com/groups/global/AllUsers'
) {
PublicAcl[item.Permission] = 1;
} else if (item.Grantee.ID !== AccessControlPolicy.Owner.ID) {
result[GrantMap[item.Permission]].push('id="' + item.Grantee.ID + '"');
}
});
if (PublicAcl.FULL_CONTROL || (PublicAcl.WRITE && PublicAcl.READ)) {
result.ACL = 'public-read-write';
} else if (PublicAcl.READ) {
result.ACL = 'public-read';
} else {
result.ACL = 'private';
}
util.each(GrantMap, function (item) {
result[item] = uniqGrant(result[item].join(','));
});
return result;
}
// Grant 去重
function uniqGrant(str) {
var arr = str.split(',');
var exist = {};
var i, item;
for (i = 0; i < arr.length; ) {
item = arr[i].trim();
if (exist[item]) {
arr.splice(i, 1);
} else {
exist[item] = true;
arr[i] = item;
i++;
}
}
return arr.join(',');
}
// 生成操作 url
function getUrl(params) {
var longBucket = params.bucket;
var shortBucket = longBucket.substr(0, longBucket.lastIndexOf('-'));
var appId = longBucket.substr(longBucket.lastIndexOf('-') + 1);
var domain = params.domain;
var region = params.region;
var object = params.object;
// 兼容不带冒号的http、https
if (['http', 'https'].includes(params.protocol)) {
params.protocol = params.protocol + ':';
}
var protocol = params.protocol || (util.isBrowser && location.protocol === 'http:' ? 'http:' : 'https:');
if (!domain) {
if (['cn-south', 'cn-south-2', 'cn-north', 'cn-east', 'cn-southwest', 'sg'].indexOf(region) > -1) {
domain = '{Region}.myqcloud.com';
} else {
domain = 'cos.{Region}.myqcloud.com';
}
if (!params.ForcePathStyle) {
domain = '{Bucket}.' + domain;
}
}
domain = domain
.replace(/\{\{AppId\}\}/gi, appId)
.replace(/\{\{Bucket\}\}/gi, shortBucket)
.replace(/\{\{Region\}\}/gi, region)
.replace(/\{\{.*?\}\}/gi, '');
domain = domain
.replace(/\{AppId\}/gi, appId)
.replace(/\{BucketName\}/gi, shortBucket)
.replace(/\{Bucket\}/gi, longBucket)
.replace(/\{Region\}/gi, region)
.replace(/\{.*?\}/gi, '');
if (!/^[a-zA-Z]+:\/\//.test(domain)) {
domain = protocol + '//' + domain;
}
// 去掉域名最后的斜杆
if (domain.slice(-1) === '/') {
domain = domain.slice(0, -1);
}
var url = domain;
if (params.ForcePathStyle) {
url += '/' + longBucket;
}
url += '/';
if (object) {
url += util.camSafeUrlEncode(object).replace(/%2F/g, '/');
}
if (params.isLocation) {
url = url.replace(/^https?:\/\//, '');
}
return url;
}
var getSignHost = function (opt) {
if (!opt.Bucket || !opt.Region) return '';
var useAccelerate = opt.UseAccelerate === undefined ? this.options.UseAccelerate : opt.UseAccelerate;
var url =
opt.Url ||
getUrl({
ForcePathStyle: this.options.ForcePathStyle,
protocol: this.options.Protocol,
domain: this.options.Domain,
bucket: opt.Bucket,
region: useAccelerate ? 'accelerate' : opt.Region,
});
var urlHost = url.replace(/^https?:\/\/([^/]+)(\/.*)?$/, '$1');
var standardHostReg = new RegExp('^([a-z\\d-]+-\\d+\\.)?(cos|cosv6|ci|pic)\\.([a-z\\d-]+)\\.myqcloud\\.com$');
if (standardHostReg.test(urlHost)) return urlHost;
return '';
};
// 异步获取签名
function getAuthorizationAsync(params, callback) {
var headers = util.clone(params.Headers);
var headerHost = '';
util.each(headers, function (v, k) {
(v === '' || ['content-type', 'cache-control'].indexOf(k.toLowerCase()) > -1) && delete headers[k];
if (k.toLowerCase() === 'host') headerHost = v;
});
// ForceSignHost明确传入false才不加入host签名
var forceSignHost = params.ForceSignHost === false ? false : true;
// Host 加入签名计算
if (!headerHost && params.SignHost && forceSignHost) headers.Host = params.SignHost;
// 获取凭证的回调,避免用户 callback 多次
var cbDone = false;
var cb = function (err, AuthData) {
if (cbDone) return;
cbDone = true;
if (AuthData && AuthData.XCosSecurityToken && !AuthData.SecurityToken) {
AuthData = util.clone(AuthData);
AuthData.SecurityToken = AuthData.XCosSecurityToken;
delete AuthData.XCosSecurityToken;
}
callback && callback(err, AuthData);
};
var self = this;
var Bucket = params.Bucket || '';
var Region = params.Region || '';
// PathName
var KeyName = params.Key || '';
if (self.options.ForcePathStyle && Bucket) {
KeyName = Bucket + '/' + KeyName;
}
var Pathname = '/' + KeyName;
// Action、ResourceKey
var StsData = {};
var Scope = params.Scope;
if (!Scope) {
var Action = params.Action || '';
var ResourceKey = params.ResourceKey || params.Key || '';
Scope = params.Scope || [
{
action: Action,
bucket: Bucket,
region: Region,
prefix: ResourceKey,
},
];
}
var ScopeKey = util.md5(JSON.stringify(Scope));
// STS
self._StsCache = self._StsCache || [];
(function () {
var i, AuthData;
for (i = self._StsCache.length - 1; i >= 0; i--) {
AuthData = self._StsCache[i];
var compareTime = Math.round(util.getSkewTime(self.options.SystemClockOffset) / 1000) + 30;
if ((AuthData.StartTime && compareTime < AuthData.StartTime) || compareTime >= AuthData.ExpiredTime) {
self._StsCache.splice(i, 1);
continue;
}
if (!AuthData.ScopeLimit || (AuthData.ScopeLimit && AuthData.ScopeKey === ScopeKey)) {
StsData = AuthData;
break;
}
}
})();
var calcAuthByTmpKey = function () {
var KeyTime = '';
if (StsData.StartTime && params.Expires)
KeyTime = StsData.StartTime + ';' + (StsData.StartTime + params.Expires * 1);
else if (StsData.StartTime && StsData.ExpiredTime) KeyTime = StsData.StartTime + ';' + StsData.ExpiredTime;
var Authorization = util.getAuth({
SecretId: StsData.TmpSecretId,
SecretKey: StsData.TmpSecretKey,
Method: params.Method,
Pathname: Pathname,
Query: params.Query,
Headers: headers,
Expires: params.Expires,
UseRawKey: self.options.UseRawKey,
SystemClockOffset: self.options.SystemClockOffset,
KeyTime: KeyTime,
ForceSignHost: forceSignHost,
});
var AuthData = {
Authorization: Authorization,
SecurityToken: StsData.SecurityToken || StsData.XCosSecurityToken || '',
Token: StsData.Token || '',
ClientIP: StsData.ClientIP || '',
ClientUA: StsData.ClientUA || '',
};
cb(null, AuthData);
};
var checkAuthError = function (AuthData) {
if (AuthData.Authorization) {
// 检查签名格式
var formatAllow = false;
var auth = AuthData.Authorization;
if (auth) {
if (auth.indexOf(' ') > -1) {
formatAllow = false;
} else if (
auth.indexOf('q-sign-algorithm=') > -1 &&
auth.indexOf('q-ak=') > -1 &&
auth.indexOf('q-sign-time=') > -1 &&
auth.indexOf('q-key-time=') > -1 &&
auth.indexOf('q-url-param-list=') > -1
) {
formatAllow = true;
} else {
try {
auth = Buffer.from(auth, 'base64').toString();
if (
auth.indexOf('a=') > -1 &&
auth.indexOf('k=') > -1 &&
auth.indexOf('t=') > -1 &&
auth.indexOf('r=') > -1 &&
auth.indexOf('b=') > -1
) {
formatAllow = true;
}
} catch (e) {}
}
}
if (!formatAllow) return util.error(new Error('getAuthorization callback params format error'));
} else {
if (!AuthData.TmpSecretId) return util.error(new Error('getAuthorization callback params missing "TmpSecretId"'));
if (!AuthData.TmpSecretKey)
return util.error(new Error('getAuthorization callback params missing "TmpSecretKey"'));
if (!AuthData.SecurityToken && !AuthData.XCosSecurityToken)
return util.error(new Error('getAuthorization callback params missing "SecurityToken"'));
if (!AuthData.ExpiredTime) return util.error(new Error('getAuthorization callback params missing "ExpiredTime"'));
if (AuthData.ExpiredTime && AuthData.ExpiredTime.toString().length !== 10)
return util.error(new Error('getAuthorization callback params "ExpiredTime" should be 10 digits'));
if (AuthData.StartTime && AuthData.StartTime.toString().length !== 10)
return util.error(new Error('getAuthorization callback params "StartTime" should be 10 StartTime'));
}
return false;
};
// 先判断是否有临时密钥
if (StsData.ExpiredTime && StsData.ExpiredTime - util.getSkewTime(self.options.SystemClockOffset) / 1000 > 60) {
// 如果缓存的临时密钥有效并还有超过60秒有效期就直接使用
calcAuthByTmpKey();
} else if (self.options.getAuthorization) {
// 外部计算签名或获取临时密钥
self.options.getAuthorization.call(
self,
{
Bucket: Bucket,
Region: Region,
Method: params.Method,
Key: KeyName,
Pathname: Pathname,
Query: params.Query,
Headers: headers,
Scope: Scope,
SystemClockOffset: self.options.SystemClockOffset,
ForceSignHost: forceSignHost,
},
function (AuthData) {
if (typeof AuthData === 'string') AuthData = { Authorization: AuthData };
var AuthError = checkAuthError(AuthData);
if (AuthError) return cb(AuthError);
if (AuthData.Authorization) {
cb(null, AuthData);
} else {
StsData = AuthData || {};
StsData.Scope = Scope;
StsData.ScopeKey = ScopeKey;
self._StsCache.push(StsData);
calcAuthByTmpKey();
}
},
);
} else if (self.options.getSTS) {
// 外部获取临时密钥
self.options.getSTS.call(
self,
{
Bucket: Bucket,
Region: Region,
},
function (data) {
StsData = data || {};
StsData.Scope = Scope;
StsData.ScopeKey = ScopeKey;
if (!StsData.TmpSecretId) StsData.TmpSecretId = StsData.SecretId;
if (!StsData.TmpSecretKey) StsData.TmpSecretKey = StsData.SecretKey;
var AuthError = checkAuthError(StsData);
if (AuthError) return cb(AuthError);
self._StsCache.push(StsData);
calcAuthByTmpKey();
},
);
} else {
// 内部计算获取签名
return (function () {
var Authorization = util.getAuth({
SecretId: params.SecretId || self.options.SecretId,
SecretKey: params.SecretKey || self.options.SecretKey,
Method: params.Method,
Pathname: Pathname,
Query: params.Query,
Headers: headers,
Expires: params.Expires,
UseRawKey: self.options.UseRawKey,
SystemClockOffset: self.options.SystemClockOffset,
ForceSignHost: forceSignHost,
});
var AuthData = {
Authorization: Authorization,
SecurityToken: self.options.SecurityToken || self.options.XCosSecurityToken,
};
cb(null, AuthData);
return AuthData;
})();
}
return '';
}
// 调整时间偏差
function allowRetry(err) {
var allowRetry = false;
var isTimeError = false;
var serverDate = (err.headers && (err.headers.date || err.headers.Date)) || (err.error && err.error.ServerTime);
try {
var errorCode = err.error.Code;
var errorMessage = err.error.Message;
if (
errorCode === 'RequestTimeTooSkewed' ||
(errorCode === 'AccessDenied' && errorMessage === 'Request has expired')
) {
isTimeError = true;
}
} catch (e) {}
if (err) {
if (isTimeError && serverDate) {
var serverTime = Date.parse(serverDate);
if (
this.options.CorrectClockSkew &&
Math.abs(util.getSkewTime(this.options.SystemClockOffset) - serverTime) >= 30000
) {
console.error('error: Local time is too skewed.');
this.options.SystemClockOffset = serverTime - Date.now();
allowRetry = true;
}
} else if (Math.floor(err.statusCode / 100) === 5) {
allowRetry = true;
} else if (err.code === 'ECONNRESET') {
allowRetry = true;
}
}
return allowRetry;
}
// 获取签名并发起请求
function submitRequest(params, callback) {
var self = this;
// 处理 headers
!params.headers && (params.headers = {});
params.headers['User-Agent'] = self.options.UserAgent || 'cos-nodejs-sdk-v5-' + pkg.version;
// 处理 query
!params.qs && (params.qs = {});
params.VersionId && (params.qs.versionId = params.VersionId);
params.qs = util.clearKey(params.qs);
// 清理 undefined 和 null 字段
params.headers && (params.headers = util.clearKey(params.headers));
params.qs && (params.qs = util.clearKey(params.qs));
var Query = util.clone(params.qs);
params.action && (Query[params.action] = '');
var SignHost =
params.SignHost || getSignHost.call(this, { Bucket: params.Bucket, Region: params.Region, Url: params.url });
var next = function (tryTimes) {
var oldClockOffset = self.options.SystemClockOffset;
getAuthorizationAsync.call(
self,
{
Bucket: params.Bucket || '',
Region: params.Region || '',
Method: params.method,
Key: params.Key,
Query: Query,
Headers: params.headers,
SignHost: SignHost,
Action: params.Action,
ResourceKey: params.ResourceKey,
Scope: params.Scope,
ForceSignHost: self.options.ForceSignHost,
},
function (err, AuthData) {
if (err) return callback(err);
params.AuthData = AuthData;
_submitRequest.call(self, params, function (err, data) {
if (
err &&
!(params.body && params.body.pipe) &&
!params.outputStream &&
tryTimes < 2 &&
(oldClockOffset !== self.options.SystemClockOffset || allowRetry.call(self, err))
) {
if (params.headers) {
delete params.headers.Authorization;
delete params.headers['token'];
delete params.headers['clientIP'];
delete params.headers['clientUA'];
params.headers['x-cos-security-token'] && delete params.headers['x-cos-security-token'];
params.headers['x-ci-security-token'] && delete params.headers['x-ci-security-token'];
}
next(tryTimes + 1);
} else {
callback(err, data);
}
});
},
);
};
next(1);
}
// 发起请求
function _submitRequest(params, callback) {
var self = this;
var TaskId = params.TaskId;
if (TaskId && !self._isRunningTask(TaskId)) return;
var bucket = params.Bucket;
var region = params.Region;
var object = params.Key;
var method = params.method || 'GET';
var url = params.url || params.Url;
var body = params.body;
var rawBody = params.rawBody;
// 处理 readStream and body
var readStream;
if (body && typeof body.pipe === 'function') {
readStream = body;
body = null;
}
// url
if (this.options.UseAccelerate) {
region = 'accelerate';
}
url =
url ||
getUrl({
ForcePathStyle: self.options.ForcePathStyle,
protocol: self.options.Protocol,
domain: self.options.Domain,
bucket: bucket,
region: region,
object: object,
});
if (params.action) {
url = url + '?' + params.action;
}
if (params.qsStr) {
if (url.indexOf('?') > -1) {
url = url + '&' + params.qsStr;
} else {
url = url + '?' + params.qsStr;
}
}
var opt = {
method: method,
url: url,
headers: params.headers,
qs: params.qs,
body: body,
};
// 兼容ci接口
var token = 'x-cos-security-token';
if (util.isCIHost(url)) {
token = 'x-ci-security-token';
}
// 获取签名
opt.headers.Authorization = params.AuthData.Authorization;
params.AuthData.Token && (opt.headers['token'] = params.AuthData.Token);
params.AuthData.ClientIP && (opt.headers['clientIP'] = params.AuthData.ClientIP);
params.AuthData.ClientUA && (opt.headers['clientUA'] = params.AuthData.ClientUA);
params.AuthData.SecurityToken && (opt.headers[token] = params.AuthData.SecurityToken);
// 清理 undefined 和 null 字段
opt.headers && (opt.headers = util.clearKey(opt.headers));
opt = util.clearKey(opt);
var Ip = this.options.Ip;
if (Ip) {
opt.url = opt.url.replace(/^(https?:\/\/)([^\/]+)/, function (str, pre, Host) {
opt.headers.Host = Host;
return pre + Ip;
});
}
if (this.options.StrictSsl !== true) {
opt.strictSSL = this.options.StrictSsl;
}
if (this.options.Proxy) {
opt.proxy = this.options.Proxy;
}
if (typeof this.options.Tunnel === 'boolean') {
opt.tunnel = this.options.Tunnel;
}
if (this.options.Timeout) {
opt.timeout = this.options.Timeout;
}
if (this.options.KeepAlive) {
opt.forever = true;
}
if (!this.options.FollowRedirect) {
opt.followRedirect = false;
}
// 修复 Content-Type: false 的 Bug原因 request 模块会获取 request('mime-types).lookup(readStream.path) 作为 Content-Type
// 问题代码位置https://github.com/request/request/blob/v2.88.1/request.js#L500
if (readStream) {
var hasContentType = false;
util.each(opt.headers, function (val, key) {
if (key.toLowerCase() === 'content-type') hasContentType = true;
});
if (
!hasContentType && // 1. not set Content-Type
readStream.readable &&
readStream.path &&
readStream.mode && // 2. isFileReadStream
!mime.lookup(readStream.path) // 3. mime return false
) {
opt.headers['Content-Type'] = 'application/octet-stream';
}
}
// 特殊处理内容到写入流的情况,等待流 finish 后才 callback
if (params.outputStream) callback = util.callbackAfterStreamFinish(params.outputStream, callback);
self.emit('before-send', opt);
var sender = REQUEST(opt);
var retResponse;
var hasReturned;
var cb = function (err, data) {
TaskId && self.off('inner-kill-task', killTask);
if (hasReturned) return;
hasReturned = true;
var attrs = {};
retResponse && retResponse.statusCode && (attrs.statusCode = retResponse.statusCode);
retResponse && retResponse.headers && (attrs.headers = retResponse.headers);
if (err) {
err = util.extend(err || {}, attrs);
callback(err, null);
} else {
data = util.extend(data || {}, attrs);
callback(null, data);
}
if (sender) {
sender.removeAllListeners && sender.removeAllListeners();
sender.on('error', function () {});
sender = null;
}
};
// 在 request 分配的 socket 上挂载 _lastBytesWritten 属性,记录该 socket 已经发送的字节数
var markLastBytesWritten = function () {
try {
Object.defineProperty(sender.req.connection, '_lastBytesWritten', {
enumerable: true,
configurable: true,
writable: true,
value: sender.req.connection.bytesWritten,
});
} catch (e) {}
};
sender.on('error', function (err) {
markLastBytesWritten();
cb(util.error(err));
});
sender.on('response', function (response) {
retResponse = response;
var responseContentLength = response.headers['content-length'] || 0;
var chunkList = [];
var statusCode = response.statusCode;
var statusSuccess = Math.floor(statusCode / 100) === 2; // 200 202 204 206
if (statusSuccess && params.outputStream) {
sender.on('end', function () {
cb(null, {});
});
} else if (responseContentLength >= process.binding('buffer').kMaxLength && opt.method !== 'HEAD') {
cb(
util.error(
new Error(
'file size large than ' +
process.binding('buffer').kMaxLength +
', please use "Output" Stream to getObject.',
),
),
);
} else {
var dataHandler = function (chunk) {
chunkList.push(chunk);
};
var endHandler = function () {
try {
var bodyBuf = Buffer.concat(chunkList);
} catch (e) {
cb(util.error(e));
return;
}
var body = bodyBuf.toString();
// 不对 body 进行转换body 直接挂载返回
if (rawBody && statusSuccess) return cb(null, { body: bodyBuf });
// 解析 xml body
var json = {};
try {
json = (body && body.indexOf('<') > -1 && body.indexOf('>') > -1 && util.xml2json(body)) || {};
} catch (e) {}
// 处理返回值
var xmlError = json && json.Error;
if (statusSuccess) {
// 正确返回,状态码 2xx 时body 不会有 Error
cb(null, json);
} else if (xmlError) {
// 正常返回了 xml body且有 Error 节点
cb(util.error(new Error(xmlError.Message), { code: xmlError.Code, error: xmlError }));
} else if (statusCode) {
// 有错误的状态码
cb(util.error(new Error(response.statusMessage), { code: '' + statusCode }));
} else {
// 无状态码,或者获取不到状态码
cb(util.error(new Error('statusCode error')));
}
chunkList = null;
};
sender.on('data', dataHandler);
sender.on('end', endHandler);
}
});
// kill task
var killTask = function (data) {
if (data.TaskId === TaskId) {
readStream && readStream.isSdkCreated && readStream.close && readStream.close(); // 如果是 SDK 里从 FilePath 创建的读流,要主动取消
sender && sender.abort && sender.abort();
self.off('inner-kill-task', killTask);
}
};
TaskId && self.on('inner-kill-task', killTask);
// 请求结束时,在 request 分配的 socket 上挂载 _lastBytesWritten 属性,记录该 socket 已经发送的字节数
sender.once('end', function () {
markLastBytesWritten();
});
// upload progress
if (params.onProgress && typeof params.onProgress === 'function') {
var contentLength = opt.headers['Content-Length'];
var time0 = Date.now();
var size0 = 0;
sender.on('drain', function () {
var time1 = Date.now();
var loaded = 0;
try {
// 已经上传的字节数 = socket当前累计发送的字节数 - 头部长度 - socket以前发送的字节数
loaded =
sender.req.connection.bytesWritten -
sender.req._header.length -
(sender.req.connection._lastBytesWritten || 0);
} catch (e) {}
var total = contentLength;
var speed = parseInt(((loaded - size0) / ((time1 - time0) / 1000)) * 100) / 100 || 0;
var percent = parseInt((loaded / total) * 100) / 100 || 0;
time0 = time1;
size0 = loaded;
params.onProgress({
loaded: loaded,
total: total,
speed: speed,
percent: percent,
});
});
}
// download progress
if (params.onDownloadProgress && typeof params.onDownloadProgress === 'function') {
var time0 = Date.now();
var size0 = 0;
var loaded = 0;
var total = 0;
sender.on('response', function (res) {
total = res.headers['content-length'];
sender.on('data', function (chunk) {
loaded += chunk.length;
var time1 = Date.now();
var speed = parseInt(((loaded - size0) / ((time1 - time0) / 1000)) * 100) / 100 || 0;
var percent = parseInt((loaded / total) * 100) / 100 || 0;
time0 = time1;
size0 = loaded;
params.onDownloadProgress({
loaded: loaded,
total: total,
speed: speed,
percent: percent,
});
});
});
}
// pipe 输入
if (readStream) {
readStream.on('error', function (err) {
sender && sender.abort && sender.abort();
cb(err);
});
readStream.pipe(sender);
}
// pipe 输出
if (params.outputStream) {
params.outputStream.on('error', function (err) {
sender && sender.abort && sender.abort();
cb(err);
});
sender.pipe(params.outputStream);
}
return sender;
}
var API_MAP = {
// Bucket 相关方法
getService: getService, // Bucket
putBucket: putBucket,
headBucket: headBucket, // Bucket
getBucket: getBucket,
deleteBucket: deleteBucket,
putBucketAcl: putBucketAcl, // BucketACL
getBucketAcl: getBucketAcl,
putBucketCors: putBucketCors, // BucketCors
getBucketCors: getBucketCors,
deleteBucketCors: deleteBucketCors,
getBucketLocation: getBucketLocation, // BucketLocation
getBucketPolicy: getBucketPolicy, // BucketPolicy
putBucketPolicy: putBucketPolicy,
deleteBucketPolicy: deleteBucketPolicy,
putBucketTagging: putBucketTagging, // BucketTagging
getBucketTagging: getBucketTagging,
deleteBucketTagging: deleteBucketTagging,
putBucketLifecycle: putBucketLifecycle, // BucketLifecycle
getBucketLifecycle: getBucketLifecycle,
deleteBucketLifecycle: deleteBucketLifecycle,
putBucketVersioning: putBucketVersioning, // BucketVersioning
getBucketVersioning: getBucketVersioning,
putBucketReplication: putBucketReplication, // BucketReplication
getBucketReplication: getBucketReplication,
deleteBucketReplication: deleteBucketReplication,
putBucketWebsite: putBucketWebsite, // BucketWebsite
getBucketWebsite: getBucketWebsite,
deleteBucketWebsite: deleteBucketWebsite,
putBucketReferer: putBucketReferer, // BucketReferer
getBucketReferer: getBucketReferer,
putBucketDomain: putBucketDomain, // BucketDomain
getBucketDomain: getBucketDomain,
deleteBucketDomain: deleteBucketDomain,
putBucketOrigin: putBucketOrigin, // BucketOrigin
getBucketOrigin: getBucketOrigin,
deleteBucketOrigin: deleteBucketOrigin,
putBucketLogging: putBucketLogging, // BucketLogging
getBucketLogging: getBucketLogging,
putBucketInventory: putBucketInventory, // BucketInventory
getBucketInventory: getBucketInventory,
listBucketInventory: listBucketInventory,
deleteBucketInventory: deleteBucketInventory,
putBucketAccelerate: putBucketAccelerate,
getBucketAccelerate: getBucketAccelerate,
putBucketEncryption: putBucketEncryption,
getBucketEncryption: getBucketEncryption,
deleteBucketEncryption: deleteBucketEncryption,
// Object 相关方法
getObject: getObject,
getObjectStream: getObjectStream,
headObject: headObject,
listObjectVersions: listObjectVersions,
putObject: putObject,
deleteObject: deleteObject,
getObjectAcl: getObjectAcl,
putObjectAcl: putObjectAcl,
optionsObject: optionsObject,
putObjectCopy: putObjectCopy,
deleteMultipleObject: deleteMultipleObject,
restoreObject: restoreObject,
putObjectTagging: putObjectTagging,
getObjectTagging: getObjectTagging,
deleteObjectTagging: deleteObjectTagging,
selectObjectContent: selectObjectContent,
selectObjectContentStream: selectObjectContentStream,
appendObject: appendObject,
// 分块上传相关方法
uploadPartCopy: uploadPartCopy,
multipartInit: multipartInit,
multipartUpload: multipartUpload,
multipartComplete: multipartComplete,
multipartList: multipartList,
multipartListPart: multipartListPart,
multipartAbort: multipartAbort,
// 工具方法
request: request,
getObjectUrl: getObjectUrl,
getAuth: getAuth,
getV4Auth: getV4Auth,
};
function warnOldApi(apiName, fn, proto) {
util.each(['Cors', 'Acl'], function (suffix) {
if (apiName.slice(-suffix.length) === suffix) {
var oldName = apiName.slice(0, -suffix.length) + suffix.toUpperCase();
var apiFn = util.apiWrapper(apiName, fn);
var warned = false;
proto[oldName] = function () {
!warned &&
console.warn('warning: cos.' + oldName + ' has been deprecated. Please Use cos.' + apiName + ' instead.');
warned = true;
apiFn.apply(this, arguments);
};
}
});
}
module.exports.init = function (COS, task) {
task.transferToTaskMethod(API_MAP, 'putObject');
util.each(API_MAP, function (fn, apiName) {
COS.prototype[apiName] = util.apiWrapper(apiName, fn);
warnOldApi(apiName, fn, COS.prototype);
});
};