Node.js SDK

{"value":"# \u7b80\u4ecb\n\n\u6b64 SDK \u9002\u7528\u4e8e Node.js v4 \u53ca\u4ee5\u4e0a\u7248\u672c\u3002\u4f7f\u7528\u6b64 SDK \u6784\u5efa\u60a8\u7684\u7f51\u7edc\u5e94\u7528\u7a0b\u5e8f\uff0c\u80fd\u8ba9\u60a8\u4ee5\u975e\u5e38\u4fbf\u6377\u7684\u65b9\u5f0f\u5c06\u6570\u636e\u5b89\u5168\u5730\u5b58\u50a8\u5230\u79c1\u6709\u4e91\u5b58\u50a8\u4e0a\u3002\u65e0\u8bba\u60a8\u7684\u7f51\u7edc\u5e94\u7528\u662f\u4e00\u4e2a\u7f51\u7ad9\u7a0b\u5e8f\uff0c\u8fd8\u662f\u5305\u62ec\u4ece\u4e91\u7aef\uff08\u670d\u52a1\u7aef\u7a0b\u5e8f\uff09\u5230\u7ec8\u7aef\uff08\u624b\u6301\u8bbe\u5907\u5e94\u7528\uff09\u7684\u67b6\u6784\u670d\u52a1\u548c\u5e94\u7528\uff0c\u901a\u8fc7\u79c1\u6709\u4e91\u5b58\u50a8\u53ca\u5176 SDK\uff0c\u90fd\u80fd\u8ba9\u60a8\u5e94\u7528\u7a0b\u5e8f\u7684\u7ec8\u7aef\u7528\u6237\u9ad8\u901f\u4e0a\u4f20\u548c\u4e0b\u8f7d\uff0c\u540c\u65f6\u4e5f\u8ba9\u60a8\u7684\u670d\u52a1\u7aef\u66f4\u52a0\u8f7b\u76c8\u3002\n\nNode.js SDK \u5c5e\u4e8e\u79c1\u6709\u4e91\u5b58\u50a8\u670d\u52a1\u7aefSDK\u4e4b\u4e00\uff0c\u4e3b\u8981\u6709\u5982\u4e0b\u529f\u80fd\uff1a\n\n1. \u63d0\u4f9b\u751f\u6210\u5ba2\u6237\u7aef\u4e0a\u4f20\u6240\u9700\u7684\u4e0a\u4f20\u51ed\u8bc1\u7684\u529f\u80fd\n2. \u63d0\u4f9b\u6587\u4ef6\u4ece\u670d\u52a1\u7aef\u76f4\u63a5\u4e0a\u4f20\u79c1\u6709\u4e91\u5b58\u50a8\u7684\u529f\u80fd\n3. \u63d0\u4f9b\u5bf9\u79c1\u6709\u4e91\u5b58\u50a8\u7a7a\u95f4\u4e2d\u6587\u4ef6\u8fdb\u884c\u7ba1\u7406\u7684\u529f\u80fd\n4. \u63d0\u4f9b\u5bf9\u79c1\u6709\u4e91\u5b58\u50a8\u7a7a\u95f4\u4e2d\u6587\u4ef6\u8fdb\u884c\u5904\u7406\u7684\u529f\u80fd\n\n\n\n# \u5f00\u6e90\n\n- [Node.js SDK \u9879\u76ee\u5730\u5740](https:\/\/github.com\/CDNCloudForU\/nodejs-sdk)\n- [Node.js SDK \u53d1\u5e03\u5730\u5740](https:\/\/github.com\/qiniu\/nodejs-sdk\/releases)\n\n\n\n# \u5b89\u88c5\n\n\u63a8\u8350\u4f7f\u7528`npm`\u6765\u5b89\u88c5\uff1a\n\n```\n$ npm install qiniu\n```\n\n\n\n# \u9274\u6743\n\nNode.js SDK \u7684\u6240\u6709\u529f\u80fd\uff0c\u90fd\u9700\u8981\u5408\u6cd5\u7684\u6388\u6743\u3002\u6388\u6743\u51ed\u8bc1\u7684\u7b7e\u7b97\u9700\u8981\u79c1\u6709\u4e91\u5b58\u50a8\u8d26\u53f7\u4e0b\u7684\u4e00\u5bf9\u6709\u6548\u7684`Access Key`\u548c`Secret Key`\uff0c\u8fd9\u5bf9\u5bc6\u94a5\u53ef\u4ee5\u901a\u8fc7\u5982\u4e0b\u6b65\u9aa4\u83b7\u5f97\uff1a\n\n1. \u5f00\u901a\u79c1\u6709\u4e91\u5b58\u50a8\u5f00\u53d1\u8005\u5e10\u53f7\n2. \u5982\u679c\u5df2\u6709\u8d26\u53f7\uff0c\u76f4\u63a5\u767b\u5f55\u79c1\u6709\u4e91\u5b58\u50a8\u5f00\u53d1\u8005\u540e\u53f0\uff0c\u67e5\u770b Access Key \u548c Secret Key\n\n\n\n# \u6587\u4ef6\u4e0a\u4f20\n\n### \u4e0a\u4f20\u6d41\u7a0b\n\n\u6587\u4ef6\u4e0a\u4f20\u5206\u4e3a\u5ba2\u6237\u7aef\u4e0a\u4f20\uff08\u4e3b\u8981\u662f\u6307\u7f51\u9875\u7aef\u548c\u79fb\u52a8\u7aef\u7b49\u9762\u5411\u7ec8\u7aef\u7528\u6237\u7684\u573a\u666f\uff09\u548c\u670d\u52a1\u7aef\u4e0a\u4f20\u4e24\u79cd\u573a\u666f\uff0c\u5177\u4f53\u53ef\u4ee5\u53c2\u8003\u6587\u6863\u4e1a\u52a1\u6d41\u7a0b\u3002\n\n\u670d\u52a1\u7aefSDK\u5728\u4e0a\u4f20\u65b9\u9762\u4e3b\u8981\u63d0\u4f9b\u4e24\u79cd\u529f\u80fd\uff0c\u4e00\u79cd\u662f\u751f\u6210\u5ba2\u6237\u7aef\u4e0a\u4f20\u6240\u9700\u8981\u7684\u4e0a\u4f20\u51ed\u8bc1\uff0c\u53e6\u5916\u4e00\u79cd\u662f\u76f4\u63a5\u4e0a\u4f20\u6587\u4ef6\u5230\u4e91\u7aef\u3002\n\n\n\n### \u5ba2\u6237\u7aef\u4e0a\u4f20\u51ed\u8bc1\n\n\u5ba2\u6237\u7aef\uff08\u79fb\u52a8\u7aef\u6216\u8005Web\u7aef\uff09\u4e0a\u4f20\u6587\u4ef6\u7684\u65f6\u5019\uff0c\u9700\u8981\u4ece\u5ba2\u6237\u81ea\u5df1\u7684\u4e1a\u52a1\u670d\u52a1\u5668\u83b7\u53d6\u4e0a\u4f20\u51ed\u8bc1\uff0c\u800c\u8fd9\u4e9b\u4e0a\u4f20\u51ed\u8bc1\u662f\u901a\u8fc7\u670d\u52a1\u7aef\u7684SDK\u6765\u751f\u6210\u7684\uff0c\u7136\u540e\u901a\u8fc7\u5ba2\u6237\u81ea\u5df1\u7684\u4e1a\u52a1API\u5206\u53d1\u7ed9\u5ba2\u6237\u7aef\u4f7f\u7528\u3002\u6839\u636e\u4e0a\u4f20\u7684\u4e1a\u52a1\u9700\u6c42\u4e0d\u540c\uff0cNode.js SDK\u652f\u6301\u4e30\u5bcc\u7684\u4e0a\u4f20\u51ed\u8bc1\u751f\u6210\u65b9\u5f0f\u3002\n\n\u521b\u5efa\u5404\u79cd\u4e0a\u4f20\u51ed\u8bc1\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u597d\u5176\u4e2d\u9274\u6743\u5bf9\u8c61`mac`\uff1a\n\n```\nvar accessKey = 'your access key';\nvar secretKey = 'your secret key';\nvar mac = new qiniu.auth.digest.Mac(accessKey, secretKey);\n```\n\n\n\n#### \u7b80\u5355\u4e0a\u4f20\u7684\u51ed\u8bc1\n\n\u6700\u7b80\u5355\u7684\u4e0a\u4f20\u51ed\u8bc1\u53ea\u9700\u8981`AccessKey`\uff0c`SecretKey`\u548c`Bucket`\u5c31\u53ef\u4ee5\u3002\n\n```\nvar options = {\n scope: bucket,\n};\nvar putPolicy = new qiniu.rs.PutPolicy(options);\nvar uploadToken=putPolicy.uploadToken(mac);\n```\n\n\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5728\u4e0d\u6307\u5b9a\u4e0a\u4f20\u51ed\u8bc1\u7684\u6709\u6548\u65f6\u95f4\u60c5\u51b5\u4e0b\uff0c\u9ed8\u8ba4\u6709\u6548\u671f\u4e3a1\u4e2a\u5c0f\u65f6\u3002\u4e5f\u53ef\u4ee5\u81ea\u884c\u6307\u5b9a\u4e0a\u4f20\u51ed\u8bc1\u7684\u6709\u6548\u671f\uff0c\u4f8b\u5982\uff1a\n\n```\n\/\/\u81ea\u5b9a\u4e49\u51ed\u8bc1\u6709\u6548\u671f\uff08\u793a\u4f8b2\u5c0f\u65f6\uff0cexpires\u5355\u4f4d\u4e3a\u79d2\uff0c\u4e3a\u4e0a\u4f20\u51ed\u8bc1\u7684\u6709\u6548\u65f6\u95f4\uff09\nvar options = {\n scope: bucket,\n expires: 7200\n};\nvar putPolicy = new qiniu.rs.PutPolicy(options);\nvar uploadToken=putPolicy.uploadToken(mac);\n```\n\n\n\n#### \u8986\u76d6\u4e0a\u4f20\u7684\u51ed\u8bc1\n\n\u8986\u76d6\u4e0a\u4f20\u9664\u4e86\u9700\u8981`\u7b80\u5355\u4e0a\u4f20`\u6240\u9700\u8981\u7684\u4fe1\u606f\u4e4b\u5916\uff0c\u8fd8\u9700\u8981\u60f3\u8fdb\u884c\u8986\u76d6\u7684\u6587\u4ef6\u540d\u79f0\uff0c\u8fd9\u4e2a\u6587\u4ef6\u540d\u79f0\u540c\u65f6\u53ef\u662f\u5ba2\u6237\u7aef\u4e0a\u4f20\u4ee3\u7801\u4e2d\u6307\u5b9a\u7684\u6587\u4ef6\u540d\uff0c\u4e24\u8005\u5fc5\u987b\u4e00\u81f4\u3002\n\n```\nvar keyToOverwrite = 'qiniu.mp4';\nvar options = {\n scope: bucket + \":\" + keyToOverwrite\n}\nvar putPolicy = new qiniu.rs.PutPolicy(options);\nvar uploadToken=putPolicy.uploadToken(mac);\n```\n\n\n\n#### \u81ea\u5b9a\u4e49\u4e0a\u4f20\u56de\u590d\u7684\u51ed\u8bc1\n\n\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6587\u4ef6\u4e0a\u4f20\u5230\u5b58\u50a8\u4e4b\u540e\uff0c\u5728\u6ca1\u6709\u8bbe\u7f6e`returnBody`\u6216\u8005`\u56de\u8c03`\u76f8\u5173\u7684\u53c2\u6570\u60c5\u51b5\u4e0b\uff0c\u5b58\u50a8\u8fd4\u56de\u7ed9\u4e0a\u4f20\u7aef\u7684\u56de\u590d\u683c\u5f0f\u4e3a`hash`\u548c`key`\uff0c\u4f8b\u5982\uff1a\n\n```\n{\"hash\":\"Ftgm-CkWePC9fzMBTRNmPMhGBcSV\",\"key\":\"qiniu.jpg\"}\n```\n\n\u6709\u65f6\u5019\u6211\u4eec\u5e0c\u671b\u80fd\u81ea\u5b9a\u4e49\u8fd9\u4e2a\u8fd4\u56de\u7684JSON\u683c\u5f0f\u7684\u5185\u5bb9\uff0c\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e`returnBody`\u53c2\u6570\u6765\u5b9e\u73b0\uff0c\u5728`returnBody`\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u79c1\u6709\u4e91\u5b58\u50a8\u652f\u6301\u7684\u9b54\u6cd5\u53d8\u91cf\u548c\u81ea\u5b9a\u4e49\u53d8\u91cf\u3002\n\n```\nvar options = {\n scope: bucket,\n returnBody: '{\"key\":\"$(key)\",\"hash\":\"$(etag)\",\"fsize\":$(fsize),\"bucket\":\"$(bucket)\",\"name\":\"$(x:name)\"}'\n}\nvar putPolicy = new qiniu.rs.PutPolicy(options);\nvar uploadToken=putPolicy.uploadToken(mac);\n```\n\n\u5219\u6587\u4ef6\u4e0a\u4f20\u5230\u5b58\u50a8\u4e4b\u540e\uff0c\u6536\u5230\u7684\u56de\u590d\u5185\u5bb9\u5982\u4e0b\uff1a\n\n```\n{\"key\":\"qiniu.jpg\",\"hash\":\"Ftgm-CkWePC9fzMBTRNmPMhGBcSV\",\"bucket\":\"if-bc\",\"fsize\":39335,\"name\":\"qiniu\"}\n```\n\n\n\n#### \u5e26\u56de\u8c03\u4e1a\u52a1\u670d\u52a1\u5668\u7684\u51ed\u8bc1\n\n\u4e0a\u9762\u751f\u6210\u7684`\u81ea\u5b9a\u4e49\u4e0a\u4f20\u56de\u590d`\u7684\u4e0a\u4f20\u51ed\u8bc1\u9002\u7528\u4e8e\u4e0a\u4f20\u7aef\uff08\u65e0\u8bba\u662f\u5ba2\u6237\u7aef\u8fd8\u662f\u670d\u52a1\u7aef\uff09\u548c\u5b58\u50a8\u670d\u52a1\u5668\u4e4b\u95f4\u8fdb\u884c\u76f4\u63a5\u4ea4\u4e92\u7684\u60c5\u51b5\u4e0b\u3002\u5728\u5ba2\u6237\u7aef\u4e0a\u4f20\u7684\u573a\u666f\u4e4b\u4e0b\uff0c\u6709\u65f6\u5019\u5ba2\u6237\u7aef\u9700\u8981\u5728\u6587\u4ef6\u4e0a\u4f20\u5230\u5b58\u50a8\u4e4b\u540e\uff0c\u4ece\u4e1a\u52a1\u670d\u52a1\u5668\u83b7\u53d6\u76f8\u5173\u7684\u4fe1\u606f\uff0c\u8fd9\u4e2a\u65f6\u5019\u5c31\u8981\u7528\u5230\u5b58\u50a8\u7684\u4e0a\u4f20\u56de\u8c03\u53ca\u76f8\u5173\u56de\u8c03\u53c2\u6570\u7684\u8bbe\u7f6e\u3002\n\n```\nvar options = {\n scope: bucket,\n callbackUrl: 'http:\/\/api.example.com\/qiniu\/upload\/callback',\n callbackBody: '{\"key\":\"$(key)\",\"hash\":\"$(etag)\",\"fsize\":$(fsize),\"bucket\":\"$(bucket)\",\"name\":\"$(x:name)\"}',\n callbackBodyType: 'application\/json'\n}\nvar putPolicy = new qiniu.rs.PutPolicy(options);\nvar uploadToken=putPolicy.uploadToken(mac);\n```\n\n\u5728\u4f7f\u7528\u4e86\u4e0a\u4f20\u56de\u8c03\u7684\u60c5\u51b5\u4e0b\uff0c\u5ba2\u6237\u7aef\u6536\u5230\u7684\u56de\u590d\u5c31\u662f\u4e1a\u52a1\u670d\u52a1\u5668\u54cd\u5e94\u5b58\u50a8\u670d\u52a1\u7684JSON\u683c\u5f0f\u5185\u5bb9\u3002 \u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5efa\u8bae\u4f7f\u7528 `application\/json` \u683c\u5f0f\u6765\u8bbe\u7f6e `callbackBody` \uff0c\u4fdd\u6301\u6570\u636e\u683c\u5f0f\u7684\u7edf\u4e00\u6027\u3002\u5b9e\u9645\u60c5\u51b5\u4e0b\uff0c`callbackBody` \u4e5f\u652f\u6301 `application\/x-www-form-urlencoded` \u683c\u5f0f\u6765\u7ec4\u7ec7\u5185\u5bb9\uff0c\u8fd9\u4e2a\u4e3b\u8981\u770b\u4e1a\u52a1\u670d\u52a1\u5668\u5728\u63a5\u6536\u5230 `callbackBody` \u7684\u5185\u5bb9\u65f6\u5982\u4f55\u89e3\u6790\u3002\u4f8b\u5982\uff1a\n\n```\nvar options = {\n scope: bucket,\n callbackUrl: 'http:\/\/api.example.com\/qiniu\/upload\/callback',\n callbackBody: 'key=$(key)&hash=$(etag)&bucket=$(bucket)&fsize=$(fsize)&name=$(x:name)'\n}\nvar putPolicy = new qiniu.rs.PutPolicy(options);\nvar uploadToken=putPolicy.uploadToken(mac);\n```\n\n\n\n#### \u5e26\u81ea\u5b9a\u4e49\u53c2\u6570\u7684\u51ed\u8bc1\n\nSDK\u652f\u6301\u5ba2\u6237\u7aef\u4e0a\u4f20\u6587\u4ef6\u7684\u65f6\u5019\u5b9a\u4e49\u4e00\u4e9b\u81ea\u5b9a\u4e49\u53c2\u6570\uff0c\u8fd9\u4e9b\u53c2\u6570\u53ef\u4ee5\u5728 `returnBody` \u548c `callbackBody` \u91cc\u9762\u548c\u5b58\u50a8\u725b\u5185\u7f6e\u652f\u6301\u7684\u9b54\u6cd5\u53d8\u91cf\uff08\u5373\u7cfb\u7edf\u53d8\u91cf\uff09\u901a\u8fc7\u76f8\u540c\u7684\u65b9\u5f0f\u6765\u5f15\u7528\u3002\u8fd9\u4e9b\u81ea\u5b9a\u4e49\u7684\u53c2\u6570\u540d\u79f0\u5fc5\u987b\u4ee5 `x:` \u5f00\u5934\u3002\u4f8b\u5982\u5ba2\u6237\u7aef\u4e0a\u4f20\u7684\u65f6\u5019\u6307\u5b9a\u4e86\u81ea\u5b9a\u4e49\u7684\u53c2\u6570`x:name`\u548c`x:age`\u5206\u522b\u662f`string`\u548c`int`\u7c7b\u578b\u3002\u90a3\u4e48\u53ef\u4ee5\u901a\u8fc7\u4e0b\u9762\u7684\u65b9\u5f0f\u5f15\u7528\uff1a\n\n```\nvar options = {\n \/\/\u5176\u4ed6\u4e0a\u4f20\u7b56\u7565\u53c2\u6570...\n returnBody: '{\"key\":\"$(key)\",\"hash\":\"$(etag)\",\"fsize\":$(fsize),\"bucket\":\"$(bucket)\",\"name\":\"$(x:name)\",\"age\":$(x:age)}'\n}\n```\n\n\u6216\u8005\n\n```\nvar options = {\n \/\/\u5176\u4ed6\u4e0a\u4f20\u7b56\u7565\u53c2\u6570...\n callbackBody: '{\"key\":\"$(key)\",\"hash\":\"$(etag)\",\"fsize\":$(fsize),\"bucket\":\"$(bucket)\",\"name\":\"$(x:name)\",\"age\":$(x:age)}',\n}\n```\n\n\n\n#### \u7efc\u5408\u4e0a\u4f20\u51ed\u8bc1\n\n\u4e0a\u9762\u7684\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\u7684\u65b9\u6cd5\uff0c\u90fd\u662f\u901a\u8fc7\u8bbe\u7f6e\u4e0a\u4f20\u7b56\u7565\u76f8\u5173\u7684\u53c2\u6570\u6765\u652f\u6301\u7684\uff0c\u8fd9\u4e9b\u53c2\u6570\u53ef\u4ee5\u901a\u8fc7\u4e0d\u540c\u7684\u7ec4\u5408\u65b9\u5f0f\u6765\u6ee1\u8db3\u4e0d\u540c\u7684\u4e1a\u52a1\u9700\u6c42\uff0c\u53ef\u4ee5\u7075\u6d3b\u5730\u7ec4\u7ec7\u4f60\u6240\u9700\u8981\u7684\u4e0a\u4f20\u51ed\u8bc1\u3002\n\n\n\n### \u670d\u52a1\u7aef\u76f4\u4f20\n\n\u670d\u52a1\u7aef\u76f4\u4f20\u662f\u6307\u5ba2\u6237\u5229\u7528\u670d\u52a1\u7aefSDK\u4ece\u670d\u52a1\u7aef\u76f4\u63a5\u4e0a\u4f20\u6587\u4ef6\u5230\u5b58\u50a8\uff0c\u4ea4\u4e92\u7684\u53cc\u65b9\u4e00\u822c\u90fd\u5728\u673a\u623f\u91cc\u9762\uff0c\u6240\u4ee5\u670d\u52a1\u7aef\u53ef\u4ee5\u81ea\u5df1\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\uff0c\u7136\u540e\u5229\u7528SDK\u4e2d\u7684\u4e0a\u4f20\u903b\u8f91\u8fdb\u884c\u4e0a\u4f20\uff0c\u6700\u540e\u4ece\u5b58\u50a8\u670d\u52a1\u83b7\u53d6\u4e0a\u4f20\u7684\u7ed3\u679c\uff0c\u8fd9\u4e2a\u8fc7\u7a0b\u4e2d\u7531\u4e8e\u53cc\u65b9\u90fd\u662f\u4e1a\u52a1\u670d\u52a1\u5668\uff0c\u6240\u4ee5\u5f88\u5c11\u5229\u7528\u5230\u4e0a\u4f20\u56de\u8c03\u7684\u529f\u80fd\uff0c\u800c\u662f\u76f4\u63a5\u81ea\u5b9a\u4e49`returnBody`\u6765\u83b7\u53d6\u81ea\u5b9a\u4e49\u7684\u56de\u590d\u5185\u5bb9\u3002\n\n\n\n#### \u6784\u5efa\u914d\u7f6e\u7c7b\n\n\u5b58\u50a8\u652f\u6301\u7a7a\u95f4\u521b\u5efa\u5728\u4e0d\u540c\u7684\u673a\u623f\uff0c\u5728\u4f7f\u7528 Node.js SDK \u4e2d\u7684`FormUploader`\u548c`ResumeUploader`\u4e0a\u4f20\u6587\u4ef6\u4e4b\u524d\uff0c\u5fc5\u987b\u8981\u6784\u5efa\u4e00\u4e2a\u4e0a\u4f20\u7528\u7684`config`\u5bf9\u8c61\uff0c\u5728\u8be5\u5bf9\u8c61\u4e2d\uff0c\u53ef\u4ee5\u6307\u5b9a\u7a7a\u95f4\u5bf9\u5e94\u7684`zone`\u4ee5\u53ca\u5176\u4ed6\u7684\u4e00\u4e9b\u5f71\u54cd\u4e0a\u4f20\u7684\u53c2\u6570\u3002\n\n```\nvar config = new qiniu.conf.Config();\n\/\/ \u7a7a\u95f4\u5bf9\u5e94\u7684\u673a\u623f\nconfig.zone = qiniu.zone.Zone_z0;\n\/\/ \u662f\u5426\u4f7f\u7528https\u57df\u540d\n\/\/config.useHttpsDomain = true;\n\/\/ \u4e0a\u4f20\u662f\u5426\u4f7f\u7528cdn\u52a0\u901f\n\/\/config.useCdnDomain = true;\n```\n\n\n\n#### \u6587\u4ef6\u4e0a\u4f20\uff08\u8868\u5355\u65b9\u5f0f\uff09\n\n\u6700\u7b80\u5355\u7684\u5c31\u662f\u4e0a\u4f20\u672c\u5730\u6587\u4ef6\uff0c\u76f4\u63a5\u6307\u5b9a\u6587\u4ef6\u7684\u5b8c\u6574\u8def\u5f84\u5373\u53ef\u4e0a\u4f20\u3002\n\n```\nvar localFile = \"\/Users\/jemy\/Documents\/qiniu.mp4\";\nvar formUploader = new qiniu.form_up.FormUploader(config);\nvar putExtra = new qiniu.form_up.PutExtra();\nvar key='test.mp4';\n\/\/ \u6587\u4ef6\u4e0a\u4f20\nformUploader.putFile(uploadToken, key, localFile, putExtra, function(respErr,\n respBody, respInfo) {\n if (respErr) {\n throw respErr;\n }\n\n if (respInfo.statusCode == 200) {\n console.log(respBody);\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n#### \u5b57\u8282\u6570\u7ec4\u4e0a\u4f20\uff08\u8868\u5355\u65b9\u5f0f\uff09\n\n\u53ef\u4ee5\u652f\u6301\u5c06\u5185\u5b58\u4e2d\u7684\u5b57\u8282\u6570\u7ec4\u4e0a\u4f20\u5230\u7a7a\u95f4\u4e2d\u3002\n\n```\nvar formUploader = new qiniu.form_up.FormUploader(config);\nvar putExtra = new qiniu.form_up.PutExtra();\nvar key='test.txt';\nformUploader.put(uploadToken, key, \"hello world\", putExtra, function(respErr,\n respBody, respInfo) {\n if (respErr) {\n throw respErr;\n }\n\n if (respInfo.statusCode == 200) {\n console.log(respBody);\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n#### \u6570\u636e\u6d41\u4e0a\u4f20\uff08\u8868\u5355\u65b9\u5f0f\uff09\n\n\u8fd9\u91cc\u6f14\u793a\u7684\u662f`ReadableStream`\u5bf9\u8c61\u7684\u4e0a\u4f20\u3002\n\n```\nvar formUploader = new qiniu.form_up.FormUploader(config);\nvar putExtra = new qiniu.form_up.PutExtra();\nvar readableStream = xxx; \/\/ \u53ef\u8bfb\u7684\u6d41\nformUploader.putStream(uploadToken, key, readableStream, putExtra, function(respErr,\n respBody, respInfo) {\n if (respErr) {\n throw respErr;\n }\n\n if (respInfo.statusCode == 200) {\n console.log(respBody);\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n#### \u6587\u4ef6\u5206\u7247\u4e0a\u4f20\uff08\u65ad\u70b9\u7eed\u4f20\uff09\n\n\u53ef\u4ee5\u9009\u62e9\u5206\u7247\u4e0a\u4f20\u7248\u672c\uff0c\u63a8\u8350\u4e0a\u4f20\u65f6\u5236\u5b9a putExtra.version = 'v2'\uff0c\u8868\u793a \u5206\u7247\u4e0a\u4f20 v2 \u7248\uff0c\u9ed8\u8ba4\u5206\u7247\u4e0a\u4f20 v1 \u7248\uff0c\u517c\u5bb9\u5386\u53f2\u60c5\u51b5\u3002\u82e5\u9700\u6df1\u5165\u4e86\u89e3\u4e0a\u4f20\u65b9\u5f0f\u4e4b\u95f4\u7684\u533a\u522b\uff0c\u8bf7\u53c2\u9605\u4e0a\u4f20\u7c7b\u578b\u4e2d \u8868\u5355\u4e0a\u4f20 \u3001\u5206\u7247\u4e0a\u4f20 v1 \u7248\u548c \u5206\u7247\u4e0a\u4f20 v2 \u7248 \u63a5\u53e3\u8bf4\u660e\u3002\n\n```\nvar localFile = \"\/Users\/jemy\/Documents\/qiniu.mp4\";\nvar resumeUploader = new qiniu.resume_up.ResumeUploader(config);\nvar putExtra = new qiniu.resume_up.PutExtra();\n\/\/ \u6269\u5c55\u53c2\u6570\nputExtra.params = {\n \"x:name\": \"\",\n \"x:age\": 27,\n}\nputExtra.fname = 'testfile.mp4';\n\n\/\/ \u5982\u679c\u6307\u5b9a\u4e86\u65ad\u70b9\u8bb0\u5f55\u6587\u4ef6\uff0c\u90a3\u4e48\u4e0b\u6b21\u4f1a\u4ece\u6307\u5b9a\u7684\u8be5\u6587\u4ef6\u5c1d\u8bd5\u8bfb\u53d6\u4e0a\u6b21\u4e0a\u4f20\u7684\u8fdb\u5ea6\uff0c\u4ee5\u5b9e\u73b0\u65ad\u70b9\u7eed\u4f20\nputExtra.resumeRecordFile = 'progress.log';\n\/\/\u5206\u7247\u4e0a\u4f20\u53ef\u6307\u5b9a version \u5b57\u6bb5\uff0cv2 \u8868\u793a\u5206\u7247\u4e0a\u4f20 v2 , \u53ef\u81ea\u5b9a\u4e49\u5206\u7247\u5927\u5c0f\uff0c\u6b64\u5904\u8bbe\u4e3a 6MB\nputExtra.version = 'v2'\nputExtra.partSize = 6 * 1024 * 1024\nvar key = null;\n\/\/ \u6587\u4ef6\u5206\u7247\u4e0a\u4f20\nresumeUploader.putFile(uploadToken, key, localFile, putExtra, function(respErr,\n respBody, respInfo) {\n if (respErr) {\n throw respErr;\n }\n\n if (respInfo.statusCode == 200) {\n console.log(respBody);\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n#### \u6570\u636e\u6d41\u5206\u7247\u4e0a\u4f20\uff08\u65ad\u70b9\u7eed\u4f20\uff09\n\n\u8fd9\u91cc\u6f14\u793a\u7684\u662f`ReadableStream`\u5bf9\u8c61\u7684\u4e0a\u4f20\u3002\n\n```\nvar formUploader = new qiniu.form_up.FormUploader(config);\nvar putExtra = new qiniu.form_up.PutExtra();\nvar readableStream = xxx; \/\/ \u53ef\u8bfb\u7684\u6d41\n\/\/ \u5982\u679c\u6307\u5b9a\u4e86\u65ad\u70b9\u8bb0\u5f55\u6587\u4ef6\uff0c\u90a3\u4e48\u4e0b\u6b21\u4f1a\u4ece\u6307\u5b9a\u7684\u8be5\u6587\u4ef6\u5c1d\u8bd5\u8bfb\u53d6\u4e0a\u6b21\u4e0a\u4f20\u7684\u8fdb\u5ea6\uff0c\u4ee5\u5b9e\u73b0\u65ad\u70b9\u7eed\u4f20\nputExtra.resumeRecordFile = 'progress.log';\n\/\/ \u5206\u7247\u4e0a\u4f20\u53ef\u6307\u5b9a version \u5b57\u6bb5\uff0cv2 \u8868\u793a\u5206\u7247\u4e0a\u4f20 v2 , \u53ef\u81ea\u5b9a\u4e49\u5206\u7247\u5927\u5c0f\uff0c\u6b64\u5904\u8bbe\u4e3a 6MB\nputExtra.version = 'v2';\nputExtra.partSize = 6 * 1024 * 1024;\nformUploader.putStream(uploadToken, key, readableStream, putExtra, function(respErr,\n respBody, respInfo) {\n if (respErr) {\n throw respErr;\n }\n\n if (respInfo.statusCode == 200) {\n console.log(respBody);\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n### \u89e3\u6790\u81ea\u5b9a\u4e49\u56de\u590d\u5185\u5bb9\n\n\u6709\u4e9b\u60c5\u51b5\u4e0b\uff0c\u5b58\u50a8\u8fd4\u56de\u7ed9\u4e0a\u4f20\u7aef\u7684\u5185\u5bb9\u4e0d\u662f\u9ed8\u8ba4\u7684`hash`\u548c`key`\u5f62\u5f0f\uff0c\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u53ef\u80fd\u51fa\u73b0\u5728\u81ea\u5b9a\u4e49`returnBody`\u6216\u8005\u81ea\u5b9a\u4e49\u4e86`callbackBody`\u7684\u60c5\u51b5\u4e0b\uff0c\u524d\u8005\u4e00\u822c\u662f\u670d\u52a1\u7aef\u76f4\u4f20\u7684\u573a\u666f\uff0c\u800c\u540e\u8005\u5219\u662f\u63a5\u53d7\u4e0a\u4f20\u56de\u8c03\u7684\u573a\u666f\uff0c\u8fd9\u4e24\u79cd\u573a\u666f\u4e4b\u4e0b\uff0c\u90fd\u6d89\u53ca\u5230\u9700\u8981\u5c06\u81ea\u5b9a\u4e49\u7684\u56de\u590d\u8fdb\u884c\u5185\u5bb9\u89e3\u6790\uff0c\u4e00\u822c\u5efa\u8bae\u5728\u4ea4\u4e92\u8fc7\u7a0b\u4e2d\uff0c\u90fd\u91c7\u7528`JSON`\u7684\u65b9\u5f0f\uff0c\u8fd9\u6837\u5904\u7406\u8d77\u6765\u65b9\u6cd5\u6bd4\u8f83\u4e00\u81f4\uff0c\u800c\u4e14`JSON`\u7684\u65b9\u6cd5\u6700\u901a\u7528\uff0c\u5728 Node.js \u91cc\u9762\u5904\u7406JSON\u7684\u56de\u590d\u76f8\u5f53\u5730\u65b9\u4fbf\uff0c\u57fa\u672c\u4e0a\u4e86\u89e3\u56de\u590d\u7ed3\u6784\u5c31\u53ef\u4ee5\u5904\u7406\uff0c\u8fd9\u91cc\u4e0d\u518d\u8d58\u8ff0\u3002\n\n\n\n### \u4e1a\u52a1\u670d\u52a1\u5668\u9a8c\u8bc1\u5b58\u50a8\u670d\u52a1\u56de\u8c03\n\n\u5728\u4e0a\u4f20\u7b56\u7565\u91cc\u9762\u8bbe\u7f6e\u4e86\u4e0a\u4f20\u56de\u8c03\u76f8\u5173\u53c2\u6570\u7684\u65f6\u5019\uff0c\u5b58\u50a8\u670d\u52a1\u5728\u6587\u4ef6\u4e0a\u4f20\u5230\u670d\u52a1\u5668\u4e4b\u540e\uff0c\u4f1a\u4e3b\u52a8\u5730\u5411`callbackUrl`\u53d1\u9001POST\u8bf7\u6c42\u7684\u56de\u8c03\uff0c\u56de\u8c03\u7684\u5185\u5bb9\u4e3a`callbackBody`\u6a21\u7248\u6240\u5b9a\u4e49\u7684\u5185\u5bb9\uff0c\u5982\u679c\u8fd9\u4e2a\u6a21\u7248\u91cc\u9762\u5f15\u7528\u4e86\u9b54\u6cd5\u53d8\u91cf\u90a3\u4e48\u8fd9\u4e9b\u53d8\u91cf\u4f1a\u88ab\u81ea\u52a8\u586b\u5145\u5bf9\u5e94\u7684\u503c\uff0c\u7136\u540e\u5728\u53d1\u9001\u7ed9\u4e1a\u52a1\u670d\u52a1\u5668\u3002\n\n\u4e1a\u52a1\u670d\u52a1\u5668\u5728\u6536\u5230\u6765\u81ea\u5b58\u50a8\u670d\u52a1\u7684\u56de\u8c03\u8bf7\u6c42\u7684\u65f6\u5019\uff0c\u53ef\u4ee5\u6839\u636e\u8bf7\u6c42\u5934\u90e8\u7684`Authorization`\u5b57\u6bb5\u6765\u8fdb\u884c\u9a8c\u8bc1\uff0c\u67e5\u770b\u8be5\u8bf7\u6c42\u662f\u5426\u662f\u6765\u81ea\u5b58\u50a8\u670d\u52a1\u7684\u672a\u7ecf\u7be1\u6539\u7684\u8bf7\u6c42\u3002\n\nNode.js SDK\u4e2d\u63d0\u4f9b\u4e86\u4e00\u4e2a\u65b9\u6cd5`qiniu.util.isQiniuCallback`\u6765\u6821\u9a8c\u8be5\u5934\u90e8\u662f\u5426\u5408\u6cd5\uff1a\n\n```\n\/\/ \u6821\u9a8c\u5b58\u50a8\u670d\u52a1\u4e0a\u4f20\u56de\u8c03\u7684Authorization\n\/\/ @param mac AK&SK\u5bf9\u8c61\n\/\/ @param requestURI \u56de\u8c03\u7684URL\u4e2d\u7684requestURI\n\/\/ @param reqBody \u8bf7\u6c42Body\uff0c\u4ec5\u5f53\u8bf7\u6c42\u7684ContentType\u4e3a\n\/\/ application\/x-www-form-urlencoded\u65f6\u624d\u9700\u8981\u4f20\u5165\u8be5\u53c2\u6570\n\/\/ @param callbackAuth \u56de\u8c03\u65f6\u8bf7\u6c42\u7684Authorization\u5934\u90e8\u503c\nexports.isQiniuCallback = function(mac, requestURI, reqBody, callbackAuth) {\n var auth = exports.generateAccessToken(mac, requestURI, reqBody);\n return auth === callbackAuth;\n}\n```\n\n\n\n# \u4e0b\u8f7d\u6587\u4ef6\n\n\u6587\u4ef6\u4e0b\u8f7d\u5206\u4e3a\u516c\u5f00\u7a7a\u95f4\u7684\u6587\u4ef6\u4e0b\u8f7d\u548c\u79c1\u6709\u7a7a\u95f4\u7684\u6587\u4ef6\u4e0b\u8f7d\u3002\n\n\n\n### \u516c\u5f00\u7a7a\u95f4\n\n\u5bf9\u4e8e\u516c\u5f00\u7a7a\u95f4\uff0c\u5176\u8bbf\u95ee\u7684\u94fe\u63a5\u4e3b\u8981\u662f\u5c06\u7a7a\u95f4\u7ed1\u5b9a\u7684\u57df\u540d\uff08\u53ef\u4ee5\u662f\u7a7a\u95f4\u7684\u9ed8\u8ba4\u57df\u540d\u6216\u8005\u662f\u7ed1\u5b9a\u7684\u81ea\u5b9a\u4e49\u57df\u540d\uff09\u62fc\u63a5\u4e0a\u7a7a\u95f4\u91cc\u9762\u7684\u6587\u4ef6\u540d\u5373\u53ef\u8bbf\u95ee\uff0c\u6807\u51c6\u60c5\u51b5\u4e0b\u9700\u8981\u5728\u62fc\u63a5\u94fe\u63a5\u4e4b\u524d\uff0c\u5c06\u6587\u4ef6\u540d\u8fdb\u884c`urlencode`\u4ee5\u517c\u5bb9\u4e0d\u540c\u7684\u5b57\u7b26\u3002\n\n```\nvar mac = new qiniu.auth.digest.Mac(accessKey, secretKey);\nvar config = new qiniu.conf.Config();\nvar bucketManager = new qiniu.rs.BucketManager(mac, config);\nvar publicBucketDomain = 'http:\/\/if-pbl.qiniudn.com';\n\n\/\/ \u516c\u5f00\u7a7a\u95f4\u8bbf\u95ee\u94fe\u63a5\nvar publicDownloadUrl = bucketManager.publicDownloadUrl(publicBucketDomain, key);\nconsole.log(publicDownloadUrl);\n```\n\n\n\n### \u79c1\u6709\u7a7a\u95f4\n\n\u5bf9\u4e8e\u79c1\u6709\u7a7a\u95f4\uff0c\u9996\u5148\u9700\u8981\u6309\u7167\u516c\u5f00\u7a7a\u95f4\u7684\u6587\u4ef6\u8bbf\u95ee\u65b9\u5f0f\u6784\u5efa\u5bf9\u5e94\u7684\u516c\u5f00\u7a7a\u95f4\u8bbf\u95ee\u94fe\u63a5\uff0c\u7136\u540e\u518d\u5bf9\u8fd9\u4e2a\u94fe\u63a5\u8fdb\u884c\u79c1\u6709\u6388\u6743\u7b7e\u540d\u3002\n\n```\nvar mac = new qiniu.auth.digest.Mac(accessKey, secretKey);\nvar config = new qiniu.conf.Config();\nvar bucketManager = new qiniu.rs.BucketManager(mac, config);\nvar privateBucketDomain = 'http:\/\/if-pri.qiniudn.com';\nvar deadline = parseInt(Date.now() \/ 1000) + 3600; \/\/ 1\u5c0f\u65f6\u8fc7\u671f\nvar privateDownloadUrl = bucketManager.privateDownloadUrl(privateBucketDomain, key, deadline);\n```\n\n\n\n# \u8d44\u6e90\u7ba1\u7406\n\n\u8d44\u6e90\u7ba1\u7406\u5305\u62ec\u7684\u4e3b\u8981\u529f\u80fd\u6709\uff1a\n\n\u8d44\u6e90\u7ba1\u7406\u76f8\u5173\u7684\u64cd\u4f5c\u9996\u5148\u8981\u6784\u5efa`BucketManager`\u5bf9\u8c61\uff1a\n\n```\nvar mac = new qiniu.auth.digest.Mac(accessKey, secretKey);\nvar config = new qiniu.conf.Config();\n\/\/config.useHttpsDomain = true;\nconfig.zone = qiniu.zone.Zone_z0;\nvar bucketManager = new qiniu.rs.BucketManager(mac, config);\n```\n\n\n\n## \u83b7\u53d6\u6587\u4ef6\u4fe1\u606f\n\n```\nvar bucket = \"if-pbl\";\nvar key = \"qiniux.mp4\";\n\nbucketManager.stat(bucket, key, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n if (respInfo.statusCode == 200) {\n console.log(respBody.hash);\n console.log(respBody.fsize);\n console.log(respBody.mimeType);\n console.log(respBody.putTime);\n console.log(respBody.type);\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody.error);\n }\n }\n});\n```\n\n\n\n## \u4fee\u6539\u6587\u4ef6MimeType\n\n```\nvar bucket = 'if-pbl';\nvar key = 'qiniu.mp4';\nvar newMime = 'video\/x-mp4';\n\nbucketManager.changeMime(bucket, key, newMime, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/200 is success\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n## \u4fee\u6539\u6587\u4ef6\u5b58\u50a8\u7c7b\u578b\n\n```\nvar bucket = 'if-pbl';\nvar key = 'qiniu.mp4';\n\/\/newType=0\u8868\u793a\u666e\u901a\u5b58\u50a8\uff0cnewType\u4e3a1\u8868\u793a\u4f4e\u9891\u5b58\u50a8\nvar newType = 0;\n\nbucketManager.changeType(bucket, key, newType, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/200 is success\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n## \u79fb\u52a8\u6216\u91cd\u547d\u540d\u6587\u4ef6\n\n\u79fb\u52a8\u64cd\u4f5c\u672c\u8eab\u652f\u6301\u79fb\u52a8\u6587\u4ef6\u5230\u76f8\u540c\uff0c\u4e0d\u540c\u7a7a\u95f4\u4e2d\uff0c\u5728\u79fb\u52a8\u7684\u540c\u65f6\u4e5f\u53ef\u4ee5\u652f\u6301\u6587\u4ef6\u91cd\u547d\u540d\u3002\u552f\u4e00\u7684\u9650\u5236\u6761\u4ef6\u662f\uff0c\u79fb\u52a8\u7684\u6e90\u7a7a\u95f4\u548c\u76ee\u6807\u7a7a\u95f4\u5fc5\u987b\u5728\u540c\u4e00\u4e2a\u673a\u623f\u3002\n\n| \u6e90\u7a7a\u95f4 | \u76ee\u6807\u7a7a\u95f4 | \u6e90\u6587\u4ef6\u540d | \u76ee\u6807\u6587\u4ef6\u540d | \u63cf\u8ff0 |\n| ------- | -------- | -------- | ---------- | --------------------------------- |\n| BucketA | BucketA | KeyA | KeyB | \u76f8\u5f53\u4e8e\u540c\u7a7a\u95f4\u6587\u4ef6\u91cd\u547d\u540d |\n| BucketA | BucketB | KeyA | KeyA | \u79fb\u52a8\u6587\u4ef6\u5230BucketB\uff0c\u6587\u4ef6\u540d\u4e00\u81f4 |\n| BucketA | BucketB | KeyA | KeyB | \u79fb\u52a8\u6587\u4ef6\u5230BucketB\uff0c\u6587\u4ef6\u540d\u53d8\u6210KeyB |\n\n`move`\u64cd\u4f5c\u652f\u6301\u5f3a\u5236\u8986\u76d6\u9009\u9879\uff0c\u5373\u5982\u679c\u76ee\u6807\u6587\u4ef6\u5df2\u5b58\u5728\uff0c\u53ef\u4ee5\u8bbe\u7f6e\u5f3a\u5236\u8986\u76d6\u9009\u9879`force`\u6765\u8986\u76d6\u90a3\u4e2a\u6587\u4ef6\u7684\u5185\u5bb9\u3002\n\n```\nvar srcBucket = \"if-pbl\";\nvar srcKey = \"qiniu.mp4\";\nvar destBucket = \"if-pbl\";\nvar destKey = \"qiniu_new.mp4\";\n\/\/ \u5f3a\u5236\u8986\u76d6\u5df2\u6709\u540c\u540d\u6587\u4ef6\nvar options = {\n force: true\n}\nbucketManager.move(srcBucket, srcKey, destBucket, destKey, options, function(\n err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/200 is success\n console.log(respInfo.statusCode);\n }\n});\n```\n\n\n\n## \u590d\u5236\u6587\u4ef6\u526f\u672c\n\n\u6587\u4ef6\u7684\u590d\u5236\u548c\u6587\u4ef6\u79fb\u52a8\u5176\u5b9e\u64cd\u4f5c\u4e00\u6837\uff0c\u4e3b\u8981\u7684\u533a\u522b\u662f\u79fb\u52a8\u540e\u6e90\u6587\u4ef6\u4e0d\u5b58\u5728\u4e86\uff0c\u800c\u590d\u5236\u7684\u7ed3\u679c\u662f\u6e90\u6587\u4ef6\u8fd8\u5b58\u5728\uff0c\u53ea\u662f\u591a\u4e86\u4e00\u4e2a\u65b0\u7684\u6587\u4ef6\u526f\u672c\u3002\n\n```\nvar srcBucket = \"if-pbl\";\nvar srcKey = \"qiniu.mp4\";\nvar destBucket = \"if-pbl\";\nvar destKey = \"qiniu_new_copy.mp4\";\n\/\/ \u5f3a\u5236\u8986\u76d6\u5df2\u6709\u540c\u540d\u6587\u4ef6\nvar options = {\n force: true\n}\n\nbucketManager.copy(srcBucket, srcKey, destBucket, destKey, options, function(\n err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/200 is success\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n## \u5220\u9664\u7a7a\u95f4\u4e2d\u7684\u6587\u4ef6\n\n```\nvar bucket = \"if-pbl\";\nvar key = \"qiniu_new_copy.mp4\";\n\nbucketManager.delete(bucket, key, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n## \u8bbe\u7f6e\u6216\u66f4\u65b0\u6587\u4ef6\u7684\u751f\u5b58\u65f6\u95f4\n\n\u53ef\u4ee5\u7ed9\u5df2\u7ecf\u5b58\u5728\u4e8e\u7a7a\u95f4\u4e2d\u7684\u6587\u4ef6\u8bbe\u7f6e\u6587\u4ef6\u751f\u5b58\u65f6\u95f4\uff0c\u6216\u8005\u66f4\u65b0\u5df2\u8bbe\u7f6e\u4e86\u751f\u5b58\u65f6\u95f4\u4f46\u5c1a\u672a\u88ab\u5220\u9664\u7684\u6587\u4ef6\u7684\u65b0\u7684\u751f\u5b58\u65f6\u95f4\u3002\n\n```\nvar bucket = \"if-pbl\";\nvar key = \"qiniu_new_copy.mp4\";\nvar days = 10;\n\nbucketManager.deleteAfterDays(bucket, key, days, function(err, respBody,\n respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n## \u83b7\u53d6\u6307\u5b9a\u524d\u7f00\u7684\u6587\u4ef6\u5217\u8868\n\n```\nvar bucket = 'if-pbl';\n\/\/ @param options \u5217\u4e3e\u64cd\u4f5c\u7684\u53ef\u9009\u53c2\u6570\n\/\/ prefix \u5217\u4e3e\u7684\u6587\u4ef6\u524d\u7f00\n\/\/ marker \u4e0a\u4e00\u6b21\u5217\u4e3e\u8fd4\u56de\u7684\u4f4d\u7f6e\u6807\u8bb0\uff0c\u4f5c\u4e3a\u672c\u6b21\u5217\u4e3e\u7684\u8d77\u70b9\u4fe1\u606f\n\/\/ limit \u6bcf\u6b21\u8fd4\u56de\u7684\u6700\u5927\u5217\u4e3e\u6587\u4ef6\u6570\u91cf\n\/\/ delimiter \u6307\u5b9a\u76ee\u5f55\u5206\u9694\u7b26\nvar options = {\n limit: 10,\n prefix: 'images\/',\n};\n\nbucketManager.listPrefix(bucket, options, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n throw err;\n }\n\n if (respInfo.statusCode == 200) {\n \/\/\u5982\u679c\u8fd9\u4e2anextMarker\u4e0d\u4e3a\u7a7a\uff0c\u90a3\u4e48\u8fd8\u6709\u672a\u5217\u4e3e\u5b8c\u6bd5\u7684\u6587\u4ef6\u5217\u8868\uff0c\u4e0b\u6b21\u8c03\u7528listPrefix\u7684\u65f6\u5019\uff0c\n \/\/\u6307\u5b9aoptions\u91cc\u9762\u7684marker\u4e3a\u8fd9\u4e2a\u503c\n var nextMarker = respBody.marker;\n var commonPrefixes = respBody.commonPrefixes;\n console.log(nextMarker);\n console.log(commonPrefixes);\n var items = respBody.items;\n items.forEach(function(item) {\n console.log(item.key);\n \/\/ console.log(item.putTime);\n \/\/ console.log(item.hash);\n \/\/ console.log(item.fsize);\n \/\/ console.log(item.mimeType);\n \/\/ console.log(item.endUser);\n \/\/ console.log(item.type);\n });\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n});\n```\n\n\n\n## \u6293\u53d6\u7f51\u7edc\u8d44\u6e90\u5230\u7a7a\u95f4\n\n```\nvar resUrl = 'http:\/\/devtools.qiniu.com\/qiniu.png';\nvar bucket = \"if-bc\";\nvar key = \"qiniu.png\";\n\nbucketManager.fetch(resUrl, bucket, key, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n if (respInfo.statusCode == 200) {\n console.log(respBody.key);\n console.log(respBody.hash);\n console.log(respBody.fsize);\n console.log(respBody.mimeType);\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n## \u66f4\u65b0\u955c\u50cf\u7a7a\u95f4\u4e2d\u5b58\u50a8\u7684\u6587\u4ef6\u5185\u5bb9\n\n```\nvar bucket = \"if-pbl\";\nvar key = \"qiniu.mp4\";\n\nbucketManager.prefetch(bucket, key, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/200 is success\n console.log(respInfo.statusCode);\n }\n});\n```\n\n\n\n## \u8d44\u6e90\u7ba1\u7406\u6279\u91cf\u64cd\u4f5c\n\n\n\n### \u6279\u91cf\u83b7\u53d6\u6587\u4ef6\u4fe1\u606f\n\n```\n\/\/\u6bcf\u4e2aoperations\u7684\u6570\u91cf\u4e0d\u53ef\u4ee5\u8d85\u8fc71000\u4e2a\uff0c\u5982\u679c\u603b\u6570\u91cf\u8d85\u8fc71000\uff0c\u9700\u8981\u5206\u6279\u53d1\u9001\nvar statOperations = [\n qiniu.rs.statOp(srcBucket, 'qiniu1.mp4'),\n qiniu.rs.statOp(srcBucket, 'qiniu2.mp4'),\n qiniu.rs.statOp(srcBucket, 'qiniu3.mp4'),\n qiniu.rs.statOp(srcBucket, 'qiniu4x.mp4'),\n];\n\nbucketManager.batch(statOperations, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/ 200 is success, 298 is part success\n if (parseInt(respInfo.statusCode \/ 100) == 2) {\n respBody.forEach(function(item) {\n if (item.code == 200) {\n console.log(item.data.fsize + \"\\t\" + item.data.hash + \"\\t\" +\n item.data.mimeType + \"\\t\" + item.data.putTime + \"\\t\" +\n item.data.type);\n } else {\n console.log(item.code + \"\\t\" + item.data.error);\n }\n });\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n### \u6279\u91cf\u4fee\u6539\u6587\u4ef6\u7c7b\u578b\n\n```\n\/\/\u6bcf\u4e2aoperations\u7684\u6570\u91cf\u4e0d\u53ef\u4ee5\u8d85\u8fc71000\u4e2a\uff0c\u5982\u679c\u603b\u6570\u91cf\u8d85\u8fc71000\uff0c\u9700\u8981\u5206\u6279\u53d1\u9001\nvar chgmOperations = [\n qiniu.rs.changeMimeOp(srcBucket, 'qiniu1.mp4', 'video\/x-mp4'),\n qiniu.rs.changeMimeOp(srcBucket, 'qiniu2.mp4', 'video\/x-mp4'),\n qiniu.rs.changeMimeOp(srcBucket, 'qiniu3.mp4', 'video\/x-mp4'),\n qiniu.rs.changeMimeOp(srcBucket, 'qiniu4.mp4', 'video\/x-mp4'),\n];\n\nbucketManager.batch(chgmOperations, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/ 200 is success, 298 is part success\n if (parseInt(respInfo.statusCode \/ 100) == 2) {\n respBody.forEach(function(item) {\n if (item.code == 200) {\n console.log(\"success\");\n } else {\n console.log(item.code + \"\\t\" + item.data.error);\n }\n });\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n### \u6279\u91cf\u5220\u9664\u6587\u4ef6\n\n```\n\/\/\u6bcf\u4e2aoperations\u7684\u6570\u91cf\u4e0d\u53ef\u4ee5\u8d85\u8fc71000\u4e2a\uff0c\u5982\u679c\u603b\u6570\u91cf\u8d85\u8fc71000\uff0c\u9700\u8981\u5206\u6279\u53d1\u9001\nvar deleteOperations = [\n qiniu.rs.deleteOp(srcBucket, 'qiniu1.mp4'),\n qiniu.rs.deleteOp(srcBucket, 'qiniu2.mp4'),\n qiniu.rs.deleteOp(srcBucket, 'qiniu3.mp4'),\n qiniu.rs.deleteOp(srcBucket, 'qiniu4x.mp4'),\n];\n\nbucketManager.batch(deleteOperations, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/ 200 is success, 298 is part success\n if (parseInt(respInfo.statusCode \/ 100) == 2) {\n respBody.forEach(function(item) {\n if (item.code == 200) {\n console.log(item.code + \"\\tsuccess\");\n } else {\n console.log(item.code + \"\\t\" + item.data.error);\n }\n });\n } else {\n console.log(respInfo.deleteusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n### \u6279\u91cf\u590d\u5236\u6587\u4ef6\n\n```\nvar srcBucket = 'if-pbl';\nvar srcKey = 'qiniu.mp4';\nvar destBucket = srcBucket;\n\n\/\/\u6bcf\u4e2aoperations\u7684\u6570\u91cf\u4e0d\u53ef\u4ee5\u8d85\u8fc71000\u4e2a\uff0c\u5982\u679c\u603b\u6570\u91cf\u8d85\u8fc71000\uff0c\u9700\u8981\u5206\u6279\u53d1\u9001\nvar copyOperations = [\n qiniu.rs.copyOp(srcBucket, srcKey, destBucket, 'qiniu1.mp4'),\n qiniu.rs.copyOp(srcBucket, srcKey, destBucket, 'qiniu2.mp4'),\n qiniu.rs.copyOp(srcBucket, srcKey, destBucket, 'qiniu3.mp4'),\n qiniu.rs.copyOp(srcBucket, srcKey, destBucket, 'qiniu4.mp4'),\n];\n\nbucketManager.batch(copyOperations, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/ 200 is success, 298 is part success\n if (parseInt(respInfo.statusCode \/ 100) == 2) {\n respBody.forEach(function(item) {\n if (item.code == 200) {\n console.log(item.code + \"\\tsuccess\");\n } else {\n console.log(item.code + \"\\t\" + item.data.error);\n }\n });\n } else {\n console.log(respInfo.deleteusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n### \u6279\u91cf\u79fb\u52a8\u6216\u91cd\u547d\u540d\u6587\u4ef6\n\n```\nvar srcBucket = 'if-pbl';\nvar destBucket = srcBucket;\n\n\/\/\u6bcf\u4e2aoperations\u7684\u6570\u91cf\u4e0d\u53ef\u4ee5\u8d85\u8fc71000\u4e2a\uff0c\u5982\u679c\u603b\u6570\u91cf\u8d85\u8fc71000\uff0c\u9700\u8981\u5206\u6279\u53d1\u9001\nvar moveOperations = [\n qiniu.rs.moveOp(srcBucket, 'qiniu1.mp4', destBucket, 'qiniu1_move.mp4'),\n qiniu.rs.moveOp(srcBucket, 'qiniu2.mp4', destBucket, 'qiniu2_move.mp4'),\n qiniu.rs.moveOp(srcBucket, 'qiniu3.mp4', destBucket, 'qiniu3_move.mp4'),\n qiniu.rs.moveOp(srcBucket, 'qiniu4.mp4', destBucket, 'qiniu4_move.mp4'),\n];\n\nbucketManager.batch(moveOperations, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/ 200 is success, 298 is part success\n if (parseInt(respInfo.statusCode \/ 100) == 2) {\n respBody.forEach(function(item) {\n if (item.code == 200) {\n console.log(item.code + \"\\tsuccess\");\n } else {\n console.log(item.code + \"\\t\" + item.data.error);\n }\n });\n } else {\n console.log(respInfo.deleteusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n### \u6279\u91cf\u66f4\u65b0\u6587\u4ef6\u7684\u6709\u6548\u671f\n\n```\nvar srcBucket = 'if-pbl';\n\n\/\/\u6bcf\u4e2aoperations\u7684\u6570\u91cf\u4e0d\u53ef\u4ee5\u8d85\u8fc71000\u4e2a\uff0c\u5982\u679c\u603b\u6570\u91cf\u8d85\u8fc71000\uff0c\u9700\u8981\u5206\u6279\u53d1\u9001\nvar deleteAfterDaysOperations = [\n qiniu.rs.deleteAfterDaysOp(srcBucket, 'qiniu1.mp4', 10),\n qiniu.rs.deleteAfterDaysOp(srcBucket, 'qiniu2.mp4', 10),\n qiniu.rs.deleteAfterDaysOp(srcBucket, 'qiniu3.mp4', 10),\n qiniu.rs.deleteAfterDaysOp(srcBucket, 'qiniu4.mp4', 10),\n];\n\nbucketManager.batch(deleteAfterDaysOperations, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/ 200 is success, 298 is part success\n if (parseInt(respInfo.statusCode \/ 100) == 2) {\n respBody.forEach(function(item) {\n if (item.code == 200) {\n console.log(item.code + \"\\tsuccess\");\n } else {\n console.log(item.code + \"\\t\" + item.data.error);\n }\n });\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n### \u6279\u91cf\u66f4\u65b0\u6587\u4ef6\u5b58\u50a8\u7c7b\u578b\n\n```\nvar srcBucket = 'if-pbl';\n\n\/\/\u6bcf\u4e2aoperations\u7684\u6570\u91cf\u4e0d\u53ef\u4ee5\u8d85\u8fc71000\u4e2a\uff0c\u5982\u679c\u603b\u6570\u91cf\u8d85\u8fc71000\uff0c\u9700\u8981\u5206\u6279\u53d1\u9001\n\/\/type=0\u4e3a\u666e\u901a\u5b58\u50a8\uff0ctype=1\u4e3a\u4f4e\u9891\u5b58\u50a8\nvar changeTypeOperations = [\n qiniu.rs.changeTypeOp(srcBucket, 'qiniu1.mp4', 1),\n qiniu.rs.changeTypeOp(srcBucket, 'qiniu2.mp4', 1),\n qiniu.rs.changeTypeOp(srcBucket, 'qiniu3.mp4', 1),\n qiniu.rs.changeTypeOp(srcBucket, 'qiniu4.mp4', 1),\n];\n\nbucketManager.batch(changeTypeOperations, function(err, respBody, respInfo) {\n if (err) {\n console.log(err);\n \/\/throw err;\n } else {\n \/\/ 200 is success, 298 is part success\n if (parseInt(respInfo.statusCode \/ 100) == 2) {\n respBody.forEach(function(item) {\n if (item.code == 200) {\n console.log(\"success\");\n } else {\n console.log(item.code + \"\\t\" + item.data.error);\n }\n });\n } else {\n console.log(respInfo.statusCode);\n console.log(respBody);\n }\n }\n});\n```\n\n\n\n# \u8d21\u732e\u4ee3\u7801\n\n1. Fork\n2. \u521b\u5efa\u60a8\u7684\u7279\u6027\u5206\u652f git checkout -b my-new-feature\n3. \u63d0\u4ea4\u60a8\u7684\u6539\u52a8 git commit -am 'Added some feature'\n4. \u5c06\u60a8\u7684\u4fee\u6539\u8bb0\u5f55\u63d0\u4ea4\u5230\u8fdc\u7a0b git \u4ed3\u5e93 git push origin my-new-feature\n5. \u7136\u540e\u5230 github \u7f51\u7ad9\u7684\u8be5 git \u8fdc\u7a0b\u4ed3\u5e93\u7684 my-new-feature \u5206\u652f\u4e0b\u53d1\u8d77 Pull Request"}