bucket.js 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410
  1. 'use strict';
  2. const assert = require('assert');
  3. var proto = exports;
  4. /**
  5. * Bucket opertaions
  6. */
  7. // TODO: OSS server currently do not support CORS requests for bucket operations
  8. // proto.listBuckets = function* listBuckets(query, options) {
  9. // // prefix, marker, max-keys
  10. // var result = yield this.request({
  11. // method: 'GET',
  12. // query: query,
  13. // timeout: options && options.timeout,
  14. // ctx: options && options.ctx,
  15. // });
  16. //
  17. // if (result.status === 200) {
  18. // var data = yield this.parseXML(result.data);
  19. // var buckets = data.Buckets || null;
  20. // if (buckets) {
  21. // if (buckets.Bucket) {
  22. // buckets = buckets.Bucket;
  23. // }
  24. // if (!isArray(buckets)) {
  25. // buckets = [buckets];
  26. // }
  27. // buckets = buckets.map(function (item) {
  28. // return {
  29. // name: item.Name,
  30. // region: item.Location,
  31. // creationDate: item.CreationDate,
  32. // };
  33. // });
  34. // }
  35. // return {
  36. // buckets: buckets,
  37. // owner: {
  38. // id: data.Owner.ID,
  39. // displayName: data.Owner.DisplayName,
  40. // },
  41. // isTruncated: data.IsTruncated === 'true',
  42. // nextMarker: data.NextMarker || null,
  43. // res: result.res
  44. // };
  45. // }
  46. //
  47. // throw yield this.requestError(result);
  48. // };
  49. proto.useBucket = function useBucket(name, region) {
  50. this.options.bucket = name;
  51. return this;
  52. };
  53. proto.putBucket = function* putBucket(name, region, options) {
  54. var params = this._bucketRequestParams('PUT', name, '', options);
  55. if (region) {
  56. params.mime = 'xml';
  57. params.content = '<?xml version="1.0" encoding="UTF-8"?>\n' +
  58. '<CreateBucketConfiguration><LocationConstraint>' + region +
  59. '</LocationConstraint></CreateBucketConfiguration>';
  60. }
  61. params.successStatuses = [200];
  62. var result = yield this.request(params);
  63. return {
  64. bucket: result.headers.location && result.headers.location.substring(1) || null,
  65. res: result.res
  66. };
  67. };
  68. proto.deleteBucket = function* deleteBucket(name, region, options) {
  69. var params = this._bucketRequestParams('DELETE', name, '', options);
  70. var result = yield this.request(params);
  71. if (result.status === 200 || result.status === 204) {
  72. return {
  73. res: result.res
  74. };
  75. }
  76. throw yield this.requestError(result);
  77. };
  78. // acl
  79. proto.putBucketACL = function* putBucketACL(name, region, acl, options) {
  80. var params = this._bucketRequestParams('PUT', name, 'acl', options);
  81. params.headers = {
  82. 'x-oss-acl': acl
  83. };
  84. params.successStatuses = [200];
  85. var result = yield this.request(params);
  86. return {
  87. bucket: result.headers.location && result.headers.location.substring(1) || null,
  88. res: result.res
  89. };
  90. };
  91. proto.getBucketACL = function* getBucketACL(name, region, options) {
  92. var params = this._bucketRequestParams('GET', name, 'acl', options);
  93. params.successStatuses = [200];
  94. params.xmlResponse = true;
  95. var result = yield this.request(params);
  96. return {
  97. acl: result.data.AccessControlList.Grant,
  98. owner: {
  99. id: result.data.Owner.ID,
  100. displayName: result.data.Owner.DisplayName,
  101. },
  102. res: result.res
  103. };
  104. };
  105. // logging
  106. proto.putBucketLogging = function* putBucketLogging(name, region, prefix, options) {
  107. var params = this._bucketRequestParams('PUT', name, 'logging', options);
  108. var xml = '<?xml version="1.0" encoding="UTF-8"?>\n<BucketLoggingStatus>\n' +
  109. '<LoggingEnabled>\n<TargetBucket>' + name + '</TargetBucket>\n';
  110. if (prefix) {
  111. xml += '<TargetPrefix>' + prefix + '</TargetPrefix>\n';
  112. }
  113. xml += '</LoggingEnabled>\n</BucketLoggingStatus>';
  114. params.content = xml;
  115. params.mime = 'xml';
  116. params.successStatuses = [200];
  117. var result = yield this.request(params);
  118. return {
  119. res: result.res
  120. };
  121. };
  122. proto.getBucketLogging = function* getBucketLogging(name, region, options) {
  123. var params = this._bucketRequestParams('GET', name, 'logging', options);
  124. params.successStatuses = [200];
  125. params.xmlResponse = true;
  126. var result = yield this.request(params);
  127. var enable = result.data.LoggingEnabled;
  128. return {
  129. enable: !!enable,
  130. prefix: enable && enable.TargetPrefix || null,
  131. res: result.res,
  132. };
  133. };
  134. proto.deleteBucketLogging = function* deleteBucketLogging(name, region, options) {
  135. var params = this._bucketRequestParams('DELETE', name, 'logging', options);
  136. params.successStatuses = [204, 200];
  137. var result = yield this.request(params);
  138. return {
  139. res: result.res,
  140. };
  141. };
  142. // website
  143. proto.putBucketWebsite = function* putBucketWebsite(name, region, config, options) {
  144. // config: index, [error]
  145. var params = this._bucketRequestParams('PUT', name, 'website', options);
  146. config = config || {};
  147. config.index = config.index || 'index.html';
  148. var xml = '<?xml version="1.0" encoding="UTF-8"?>\n<WebsiteConfiguration>\n' +
  149. ' <IndexDocument><Suffix>' + config.index + '</Suffix></IndexDocument>\n';
  150. if (config.error) {
  151. xml += '<ErrorDocument><Key>' + config.error + '</Key></ErrorDocument>\n';
  152. }
  153. xml += '</WebsiteConfiguration>';
  154. params.content = xml;
  155. params.mime = 'xml';
  156. params.successStatuses = [200];
  157. var result = yield* this.request(params);
  158. return {
  159. res: result.res
  160. };
  161. };
  162. proto.getBucketWebsite = function* getBucketWebsite(name, region, options) {
  163. var params = this._bucketRequestParams('GET', name, 'website', options);
  164. params.successStatuses = [200];
  165. params.xmlResponse = true;
  166. var result = yield this.request(params);
  167. return {
  168. index: result.data.IndexDocument.Suffix,
  169. error: result.data.ErrorDocument && result.data.ErrorDocument.Key || null,
  170. res: result.res
  171. };
  172. };
  173. proto.deleteBucketWebsite = function* deleteBucketWebsite(name, region, options) {
  174. var params = this._bucketRequestParams('DELETE', name, 'website', options);
  175. params.successStatuses = [204];
  176. var result = yield this.request(params);
  177. return {
  178. res: result.res
  179. };
  180. };
  181. // lifecycle
  182. proto.putBucketLifecycle = function* putBucketLifecycle(name, region, rules, options) {
  183. // rules: [rule, ...]
  184. // rule: [id], prefix, status, expiration, [days or date]
  185. // status: 'Enabled' or 'Disabled'
  186. var params = this._bucketRequestParams('PUT', name, 'lifecycle', options);
  187. var xml = '<?xml version="1.0" encoding="UTF-8"?>\n<LifecycleConfiguration>\n';
  188. for (var i = 0; i < rules.length; i++) {
  189. var rule = rules[i];
  190. var expiration = rule.days ?
  191. '<Days>' + rule.days + '</Days>'
  192. :
  193. '<Date>' + rule.date + '</Date>';
  194. var id = rule.id ? '<ID>' + rule.id + '</ID>\n' : '';
  195. xml += ' <Rule>\n' + id +
  196. ' <Prefix>' + rule.prefix + '</Prefix>\n' +
  197. ' <Status>' + rule.status + '</Status>\n' +
  198. ' <Expiration>' + expiration + '</Expiration>\n' +
  199. ' </Rule>\n';
  200. }
  201. xml += '</LifecycleConfiguration>';
  202. params.content = xml;
  203. params.mime = 'xml';
  204. params.successStatuses = [200];
  205. var result = yield this.request(params);
  206. return {
  207. res: result.res
  208. };
  209. };
  210. proto.getBucketLifecycle = function* getBucketLifecycle(name, region, options) {
  211. var params = this._bucketRequestParams('GET', name, 'lifecycle', options);
  212. params.successStatuses = [200];
  213. params.xmlResponse = true;
  214. var result = yield this.request(params);
  215. var rules = result.data.Rule || null;
  216. if (rules) {
  217. if (!isArray(rules)) {
  218. rules = [rules];
  219. }
  220. rules = rules.map(function (rule) {
  221. var item = {
  222. id: rule.ID,
  223. prefix: rule.Prefix,
  224. status: rule.Status,
  225. };
  226. if (rule.Expiration.Days) {
  227. item.days = rule.Expiration.Days;
  228. } else {
  229. item.date = rule.Expiration.Date;
  230. }
  231. return item;
  232. });
  233. }
  234. return {
  235. rules: rules,
  236. res: result.res
  237. };
  238. };
  239. proto.deleteBucketLifecycle = function* deleteBucketLifecycle(name, region, options) {
  240. var params = this._bucketRequestParams('DELETE', name, 'lifecycle', options);
  241. params.successStatuses = [204];
  242. var result = yield this.request(params);
  243. return {
  244. res: result.res
  245. };
  246. };
  247. proto.putBucketCORS = function* (name, region, rules, options) {
  248. rules = rules || [];
  249. assert(rules.length, 'rules is required');
  250. rules.forEach(rule => {
  251. assert(rule.allowedOrigin, 'allowedOrigin is required');
  252. assert(rule.allowedMethod, 'allowedMethod is required');
  253. });
  254. var params = this._bucketRequestParams('PUT', name, 'cors', options);
  255. var xml = '<?xml version="1.0" encoding="UTF-8"?>\n<CORSConfiguration>';
  256. for (var i = 0, l = rules.length; i < l; i++) {
  257. var rule = rules[i];
  258. xml += '<CORSRule>';
  259. toArray(rule.allowedOrigin).forEach(function(val) {
  260. xml += '<AllowedOrigin>' + val + '</AllowedOrigin>';
  261. });
  262. toArray(rule.allowedMethod).forEach(function(val) {
  263. xml += '<AllowedMethod>' + val + '</AllowedMethod>';
  264. });
  265. toArray(rule.allowedHeader).forEach(function(val) {
  266. xml += '<AllowedHeader>' + val + '</AllowedHeader>';
  267. });
  268. toArray(rule.exposeHeader).forEach(function(val) {
  269. xml += '<ExposeHeader>' + val + '</ExposeHeader>';
  270. });
  271. if (rule.maxAgeSeconds) {
  272. xml += '<MaxAgeSeconds>' + rule.maxAgeSeconds + '</MaxAgeSeconds>';
  273. }
  274. xml += '</CORSRule>';
  275. }
  276. xml += '</CORSConfiguration>';
  277. params.content = xml;
  278. params.mime = 'xml';
  279. params.successStatuses = [200];
  280. var result = yield this.request(params);
  281. return {
  282. res: result.res
  283. };
  284. };
  285. proto.getBucketCORS = function* (name, region, options) {
  286. var params = this._bucketRequestParams('GET', name, 'cors', options);
  287. params.successStatuses = [200];
  288. params.xmlResponse = true;
  289. var result = yield this.request(params);
  290. var rules = [];
  291. if (result.data && result.data.CORSRule) {
  292. var CORSRule = result.data.CORSRule;
  293. if (!isArray(CORSRule)) CORSRule = [ CORSRule ];
  294. CORSRule.forEach(function(rule) {
  295. var r = {};
  296. for (const name in rule) {
  297. r[name.slice(0, 1).toLowerCase() + name.slice(1, name.length)] = rule[name];
  298. }
  299. rules.push(r);
  300. });
  301. }
  302. return {
  303. rules: rules,
  304. res: result.res
  305. };
  306. };
  307. proto.deleteBucketCORS = function* (name, region, options) {
  308. var params = this._bucketRequestParams('DELETE', name, 'cors', options);
  309. params.successStatuses = [204];
  310. var result = yield this.request(params);
  311. return {
  312. res: result.res
  313. };
  314. };
  315. // referer
  316. proto.putBucketReferer = function* putBucketReferer(name, region, allowEmpty, referers, options) {
  317. var params = this._bucketRequestParams('PUT', name, 'referer', options);
  318. var xml = '<?xml version="1.0" encoding="UTF-8"?>\n<RefererConfiguration>\n';
  319. xml += ' <AllowEmptyReferer>' + (allowEmpty ? 'true' : 'false') + '</AllowEmptyReferer>\n';
  320. if (referers && referers.length > 0) {
  321. xml += ' <RefererList>\n';
  322. for (var i = 0; i < referers.length; i++) {
  323. xml += ' <Referer>' + referers[i] + '</Referer>\n';
  324. }
  325. xml += ' </RefererList>\n';
  326. } else {
  327. xml += ' <RefererList />\n';
  328. }
  329. xml += '</RefererConfiguration>';
  330. params.content = xml;
  331. params.mime = 'xml';
  332. params.successStatuses = [200];
  333. var result = yield this.request(params);
  334. return {
  335. res: result.res,
  336. };
  337. };
  338. proto.getBucketReferer = function* getBucketReferer(name, region, options) {
  339. var params = this._bucketRequestParams('GET', name, 'referer', options);
  340. params.successStatuses = [200];
  341. params.xmlResponse = true;
  342. var result = yield this.request(params);
  343. var referers = result.data.RefererList.Referer || null;
  344. if (referers) {
  345. if (!isArray(referers)) {
  346. referers = [referers];
  347. }
  348. }
  349. return {
  350. allowEmpty: result.data.AllowEmptyReferer === 'true',
  351. referers: referers,
  352. res: result.res
  353. };
  354. };
  355. proto.deleteBucketReferer = function* deleteBucketReferer(name, region, options) {
  356. return yield this.putBucketReferer(name, region, true, null, options);
  357. };
  358. // private apis
  359. proto._bucketRequestParams = function _bucketRequestParams(method, bucket, subres, options) {
  360. return {
  361. method: method,
  362. bucket: bucket,
  363. subres: subres,
  364. timeout: options && options.timeout,
  365. ctx: options && options.ctx,
  366. };
  367. };
  368. function isArray(arr) {
  369. if (Array.isArray) return Array.isArray(arr);
  370. return Object.prototype.toString.call(arr) === '[object Array]';
  371. }
  372. function toArray(obj) {
  373. if (!obj) return [];
  374. if (isArray(obj)) return obj;
  375. return [ obj ];
  376. }